Skip to main content

ZOS-API interface 2024 R1

ZOSAPI.Tools.IMaterialsCatalog Interface Reference

Last update: 17.07.2025
Inheritance diagram for ZOSAPI.Tools.IMaterialsCatalog:

Public Member Functions

string[] GetAllCatalogs ()
 
string[] GetAllMaterials ()
 
string GetCoefficientName (int coeff)
 
double GetFitCoefficient (int coeff)
 Returns the individual dispersion coefficient (0-indexed)
 
void SetFitCoefficient (int coeff, double Value)
 Changes the individual dispersion coefficient (0-indexed)
 
bool SaveCatalog ()
 Saves modified Material data. Needs to be applied for each modified glass.
 
IInternalTransmissionData GetInternalTransmissionData ()
 
IInternalBirefringenceData GetInternalBirefringenceData ()
 
- Public Member Functions inherited from ZOSAPI.Tools.ISystemTool
bool Run ()
 Start the tool. Note that for synchronous tools (see IsAsynchronous), this call will block until completion. If it is asynchronous it will start running but return immediately.
 
bool RunAndWaitForCompletion ()
 Sames as calling Run followed by WaitForCompletion.
 
bool WaitForCompletion ()
 Waits for the asynchronous tool to complete.
 
bool Cancel ()
 Cancels the currently running asynchronous tool.
 
bool Close ()
 Closes this tool and frees up and associated resources.
 
RunStatus WaitWithTimeout (double timeOutSeconds)
 Waits for the currently running tool to complete, with a specified time out value. Note that if the timeout is exceeded this method will return, however the tool will continue to run. Also note that this method will not start the tool running if it is not already.
 
RunStatus RunAndWaitWithTimeout (double timeOutSeconds)
 Starts the tool running, and waits for it to complete with the specified timeout value. Note that if the timeout is exceeded this method will return, however the tool will continue to run.
 

Properties

string SelectedCatalog [get, set]
 
string SelectedMaterial [get, set]
 
int NumberOfFitCoefficients [get]
 
string CatalogComment [get, set]
 
MaterialFormulas MaterialFormula [get, set]
 
MaterialStatuses MaterialStatus [get, set]
 
double D0 [get, set]
 
double D1 [get, set]
 
double D2 [get, set]
 
double E0 [get, set]
 
double E1 [get, set]
 
double Ltk [get, set]
 
double TCE [get, set]
 
double Temp [get, set]
 
double p [get, set]
 
double dPgF [get, set]
 
double MinimumWavelength [get, set]
 
double MaximumWavelength [get, set]
 
bool IgnoreThermalExpansion [get, set]
 
bool ExcludeSubstitution [get, set]
 
bool MetaMaterial [get, set]
 
string MeltFreq [get, set]
 
string Comment [get, set]
 
string RelCost [get, set]
 
string CR [get, set]
 
string FR [get, set]
 
string SR [get, set]
 
string AR [get, set]
 
string PR [get, set]
 
double Nd [get]
 
double Vd [get]
 
double YoungsModulus [get]
 
bool HasYoungsModulus [get]
 
double PoissonRatio [get]
 
bool HasPoissonRatio [get]
 
double KnoopHardness [get]
 
bool HasKnoopHardness [get]
 
double SpecificHeatCapacity [get]
 
bool HasSpecificHeatCapacity [get]
 
double HeatConductivity [get]
 
bool HasHeatConductivity [get]
 
- Properties inherited from ZOSAPI.Tools.ISystemTool
int Progress [get]
 Gets the progress of the current tool, if supported.
 
string Status [get]
 Gets the status of the current tool, if supporoted.
 
bool IsRunning [get]
 Gets a value indicating whether the tool is currently running asynchronously.
 
bool CanCancel [get]
 Gets a value indicating whether the tool can be cancelled.
 
bool IsAsynchronous [get]
 Gets a value indicating whether the tool runs asynchronously (i.e. on a thread).
 
bool IsFiniteDuration [get]
 Gets a value indicating whether this tool will complete on its own.
 
bool IsValid [get]
 Gets a value indicating whether the input settings are valid.
 
bool Succeeded [get]
 Gets a value indicating whether the tool execution succeeded.
 
string ErrorMessage [get]
 If Succeeded is false, get the error messages; otherwise, null.
 

Member Function Documentation

◆ GetAllCatalogs()

string[] ZOSAPI.Tools.IMaterialsCatalog.GetAllCatalogs ( )

◆ GetAllMaterials()

string[] ZOSAPI.Tools.IMaterialsCatalog.GetAllMaterials ( )

◆ GetCoefficientName()

string ZOSAPI.Tools.IMaterialsCatalog.GetCoefficientName ( int  coeff)

◆ GetFitCoefficient()

double ZOSAPI.Tools.IMaterialsCatalog.GetFitCoefficient ( int  coeff)

Returns the individual dispersion coefficient (0-indexed)

Parameters
coeff
Returns

◆ GetInternalBirefringenceData()

IInternalBirefringenceData ZOSAPI.Tools.IMaterialsCatalog.GetInternalBirefringenceData ( )

◆ GetInternalTransmissionData()

IInternalTransmissionData ZOSAPI.Tools.IMaterialsCatalog.GetInternalTransmissionData ( )

◆ SaveCatalog()

bool ZOSAPI.Tools.IMaterialsCatalog.SaveCatalog ( )

Saves modified Material data. Needs to be applied for each modified glass.

Returns

◆ SetFitCoefficient()

void ZOSAPI.Tools.IMaterialsCatalog.SetFitCoefficient ( int  coeff,
double  Value 
)

Changes the individual dispersion coefficient (0-indexed)

Parameters
coeff
Value

Property Documentation

◆ AR

string ZOSAPI.Tools.IMaterialsCatalog.AR
getset

◆ CatalogComment

string ZOSAPI.Tools.IMaterialsCatalog.CatalogComment
getset

◆ Comment

string ZOSAPI.Tools.IMaterialsCatalog.Comment
getset

◆ CR

string ZOSAPI.Tools.IMaterialsCatalog.CR
getset

◆ D0

double ZOSAPI.Tools.IMaterialsCatalog.D0
getset

◆ D1

double ZOSAPI.Tools.IMaterialsCatalog.D1
getset

◆ D2

double ZOSAPI.Tools.IMaterialsCatalog.D2
getset

◆ dPgF

double ZOSAPI.Tools.IMaterialsCatalog.dPgF
getset

◆ E0

double ZOSAPI.Tools.IMaterialsCatalog.E0
getset

◆ E1

double ZOSAPI.Tools.IMaterialsCatalog.E1
getset

◆ ExcludeSubstitution

bool ZOSAPI.Tools.IMaterialsCatalog.ExcludeSubstitution
getset

◆ FR

string ZOSAPI.Tools.IMaterialsCatalog.FR
getset

◆ HasHeatConductivity

bool ZOSAPI.Tools.IMaterialsCatalog.HasHeatConductivity
get

◆ HasKnoopHardness

bool ZOSAPI.Tools.IMaterialsCatalog.HasKnoopHardness
get

◆ HasPoissonRatio

bool ZOSAPI.Tools.IMaterialsCatalog.HasPoissonRatio
get

◆ HasSpecificHeatCapacity

bool ZOSAPI.Tools.IMaterialsCatalog.HasSpecificHeatCapacity
get

◆ HasYoungsModulus

bool ZOSAPI.Tools.IMaterialsCatalog.HasYoungsModulus
get

◆ HeatConductivity

double ZOSAPI.Tools.IMaterialsCatalog.HeatConductivity
get

◆ IgnoreThermalExpansion

bool ZOSAPI.Tools.IMaterialsCatalog.IgnoreThermalExpansion
getset

◆ KnoopHardness

double ZOSAPI.Tools.IMaterialsCatalog.KnoopHardness
get

◆ Ltk

double ZOSAPI.Tools.IMaterialsCatalog.Ltk
getset

◆ MaterialFormula

MaterialFormulas ZOSAPI.Tools.IMaterialsCatalog.MaterialFormula
getset

◆ MaterialStatus

MaterialStatuses ZOSAPI.Tools.IMaterialsCatalog.MaterialStatus
getset

◆ MaximumWavelength

double ZOSAPI.Tools.IMaterialsCatalog.MaximumWavelength
getset

◆ MeltFreq

string ZOSAPI.Tools.IMaterialsCatalog.MeltFreq
getset

◆ MetaMaterial

bool ZOSAPI.Tools.IMaterialsCatalog.MetaMaterial
getset

◆ MinimumWavelength

double ZOSAPI.Tools.IMaterialsCatalog.MinimumWavelength
getset

◆ Nd

double ZOSAPI.Tools.IMaterialsCatalog.Nd
get

◆ NumberOfFitCoefficients

int ZOSAPI.Tools.IMaterialsCatalog.NumberOfFitCoefficients
get

◆ p

double ZOSAPI.Tools.IMaterialsCatalog.p
getset

◆ PoissonRatio

double ZOSAPI.Tools.IMaterialsCatalog.PoissonRatio
get

◆ PR

string ZOSAPI.Tools.IMaterialsCatalog.PR
getset

◆ RelCost

string ZOSAPI.Tools.IMaterialsCatalog.RelCost
getset

◆ SelectedCatalog

string ZOSAPI.Tools.IMaterialsCatalog.SelectedCatalog
getset

◆ SelectedMaterial

string ZOSAPI.Tools.IMaterialsCatalog.SelectedMaterial
getset

◆ SpecificHeatCapacity

double ZOSAPI.Tools.IMaterialsCatalog.SpecificHeatCapacity
get

◆ SR

string ZOSAPI.Tools.IMaterialsCatalog.SR
getset

◆ TCE

double ZOSAPI.Tools.IMaterialsCatalog.TCE
getset

◆ Temp

double ZOSAPI.Tools.IMaterialsCatalog.Temp
getset

◆ Vd

double ZOSAPI.Tools.IMaterialsCatalog.Vd
get

◆ YoungsModulus

double ZOSAPI.Tools.IMaterialsCatalog.YoungsModulus
get

Connect with Ansys