Material Object

The Material Object lets you define or change materials. Each material defines the material constants of the associated solids.

• General

• Appearance

• Basic Material Parameters

• Surface Impedance Materials

• Electric Conductivity

• Magnetic Conductivity

• Dispersion

• Tensor Formulas

• Temperature Dependent Materials

• Thermal Material Properties

• Mechanics Material Properties

• Queries

• Default Settings

General

Reset

Sets all internal settings to their defaults.

Create

Creates a new material. All necessary settings have to be made previously.

Name ( name name )

Sets the name for the new material to be created using .Create.

Folder ( name foldername )

Sets the name for the new material folder to be created using .Create. If the name is empty, then the material does not belong to a folder.

Type ( enum{"PEC", "Normal", "Anisotropic", "Lossy Metal", "Corrugated wall", "Ohmic sheet", "Tensor formula"} key )

Sets the type for the material to be defined.  

SetMaterialUnit( enum FrequencyUnit, enum LengthUnit )

Sets the frequency and length units for the material to be defined.

All relevant units for the frequency, like for the reference tangent delta (electric or magnetic), for the dispersion, tangent delta or surface impedance list will be displayed and interpreted accordingly to this frequency scale unit.

In similar way all (possibly) corrugation properties or coating of the material will be will be displayed and interpreted accordingly to the given length scale unit.

Available enum values for the FrequencyUnit field are { "Hz", "KHz", "MHz", "GHz", "THz", "PHz" }.

Available enum values for the LengthUnit field are { "m", "cm", "mm", "um", "nm", "ft", "mil", "in" }.

Once that frequency and length units are defined by means of  SetMaterialUnit command, successive project changes in terms of global unit scale will not affect the material properties.

On the contrary a material defined without unit settings inherits the project global units. This means that in case of changes of the global units also the material properties will be scaled accordingly.

Delete ( name name )

Deletes an existing material with the specified name and all shapes the material is assigned to.

Rename ( name sOldName, name sNewName )

Renames the object specified by sOldName to sNewName.

NewFolder ( name foldername )

Creates a new folder with the given name.

DeleteFolder ( name foldername )

Deletes an existing folder and all the containing elements.

RenameFolder ( name oldFoldername, name newFoldername )

Changes the name of an existing folder.

Appearance

Colour ( double red, double green, double blue )

Sets the color for a new material by double values ranging from 0 to 1.

Transparency ( double dValue )

Allows to changes the appearance from opaque (dValue = 0) to a transparency value up to 100. Setting will be ignored if .Wireframe is set.

Wireframe ( bool switch )

If switch is True, all solids associated with this material will be displayed as a wireframe.

Reflection( bool switch )

If switch is True, all solids associated with this material are displayed using reflective surfaces (usually applied to metallic surfaces).

Allowoutline( bool switch )

Determine whether outlines are allowed to be drawn for solids belonging to this material. The actual visibility of outlines also depends on the setting of the global outline state as well as the current selection. If switch is False, outlines will never be drawn for the corresponding solids.

Transparentoutline( bool switch )

If switch is True, outlines are also displayed when the corresponding solids are drawn transparently.

ChangeColour

Changes the appearance for an existing material specified by the .Name method to the settings given by the .Colour, .Transparency or .Wireframe method. Changes to other parameters will not be taken. The execution of this method will - in contrast to .Create - not be regarded as a structural change and though not require the deletion of results.

Basic Material Parameters

Epsilon / EpsilonX / EpsilonY / EpsilonZ ( double dValue )

Defines the relative electric permittivity. In case of diagonal anisotropic material, the parameters for the specific components of the diagonal electric permittivity tensor can be set with the respective methods.

Mue / MueX / MueY / MueZ ( double dValue )

Defines the relative permeability. In case of diagonal anisotropic material, the parameters for the specific components of the diagonal permeability tensor can be set with the respective methods.

Rho ( double dValue )

Sets the material density value of the material in kg/m³, i.e. used for SAR calculations.

This setting is important for transient thermal simulations.

AddCoatedMaterial ( double materialname, double thickness )

Used for the coated materials feature. This function defines one layer. Materialname is the name of the material which is used for the coat and thickness defines the thickness of this material.

Surface Impedance Materials

Corrugation  ( double depth, double gapwidth, double toothwidth )

Sets the parameter for the Corrugated wall material type, which is a planar surface with a periodically repeated rectangular corrugation with a certain depth, gapwidth, and a small toothwidth. The corrugation depth must be much larger than the corrugation width for the model to be valid. The number of corrugations per wavelength should be large, with ten per wavelength being the lowest limit. There is a resonance in the effective material behavior when the corrugation depth is close to a quarter wavelength and its odd multiples.

When truly modeling these surfaces the mesh would end up with a very high number of mesh cells in order to represent all details. However, in many cases such as S-Parameter calculations  the exact field solution inside the corrugation is not of interest. Then it is sufficient to replace the real corrugation by a appropriate material with the same macroscopic properties. Much like the lossy metal, a surface impedance model is used to relate fields on the corrugated wall surface.

The theoretical formula for corrugated wall surface impedance may be directly computed by the frequency domain solvers but due to its high non-linear frequency dependence is not straightforward applicable to the transient solver. To this purpose a specific fitting and representation of the impedance, based on a proprietary resonance expansion mode algorithm, will be automatically computed. This model leads to an accurate representation and results within the simulation frequency bandwidth.

Please note that this type of material is available only for the transient solver and the tetrahedral frequency domain solver.

OhmicSheetImpedance ( double resistance, double reactance )

Defines the impedance value (resistance and reactance) of an Ohmic sheet material type. A surface impedance model is used to relate fields on the ohmic sheet surface. The complex impedance will be assumed defined or measured in correspondence of the reference frequency provided by the command OhmicSheetFreq.

Frequency domain solvers may assume and compute a constant (i.e. frequency independent) complex impedance for the Ohmic sheet. This constant model may be generally "non-physical" (due to the so called Kramers&endash;Kronig relations) and may lead to "non-causal" effects. Therefore, for the transient solver, a first order (Debye) model of the impedance will be assumed which exactly interpolates the user given impedance in correspondence of the reference frequency.

Please note that this type of material is available only for the transient solver and the tetrahedral frequency domain solver.

To define a frequency-dependent ohmic sheet, please use the command .SetTabulatedSurfaceImpedanceModel with a "Transparent" surface impedance model.

OhmicSheetFreq ( double frequency )

Defines the reference frequency value of an Ohmic sheet material type where the corresponding impedance will be defined or measured. This value will be used to compute the first order (Debye) model and to exactly interpolate the user given impedance value (resistance and reactance).

In case the reference frequency will not be provided the center value of the frequency simulation range will be automatically assumed.

Please note that this type of material is available only for the transient solver and the tetrahedral frequency domain solver.

SetTabulatedSurfaceImpedanceModel ( enum{"Opaque", "Transparent"} model )

Enables an isotropic Tabulated surface impedance (resistance and reactance versus frequency), where model defines the way fields on opposite sides of infinitely thin sheets couple. With an "Opaque" model, there is no coupling between front and back side of surface impedance sheets, while "Transparent" means that the electric field on both sides of a sheet is the same. The actual material data is defined by calling .AddTabulatedSurfaceImpedanceValue.

Please note that this type of material is available only for the transient solver and the tetrahedral frequency domain solver.

AddTabulatedSurfaceImpedanceFittingValue ( double frequency, double resistance, double reactance, double weight)

AddTabulatedSurfaceImpedanceValue ( double frequency, double resistance, double reactance )

Defines an entry of the frequency-dependent, tabulated impedance values by means of resistance and reactance of a Tabulated surface impedance material type. The frequency is given in the currently active unit for frequencies. See also .SetTabulatedSurfaceImpedanceModel.

Moreover a weight, i.e. a double value greater than/equal to 0.0, is assigned to each frequency in order to direct the interpolation algorithm and to enforce a reduced error in correspondence of the given frequency point.

Please note that this type of material is available only for the transient solver and the tetrahedral frequency domain solver.

DispersiveFittingSchemeTabSI ( enum {"Nth Order"} key )

Sets the required fitting scheme for the tabulated surface impedance. Actually only Nth Order general fitting is allowed, due to its generality and wide application range.

MaximalOrderNthModelFitTabSI ( int iValue )

Set the maximum allowed order for the nth fit interpolation scheme ("Nth Order"), for the tabulated surface impedance. The maximum number of poles is directly related both to the fitting accuracy and to the model complexity and therefore to simulation memory and computational time requirements.

UseOnlyDataInSimFreqRangeNthModelTabSI ( bool switch )

Allow the nth order fit interpolation scheme ("Nth Order"), for the tabulated surface impedance, to use only the frequency data points that lie within the "frequency range settings" defined by the user. Activating this switch enables an accurate data fitting of the material resonances which occur in the simulation bandwidth of interest using possibly a reduced number of poles and zeroes with respect to the complete data fitting. And this, in turn, translates into benefits for the simulation complexity in terms of memory and computational time.

Electric Conductivity

Sigma / SigmaX / SigmaY / SigmaZ ( double dValue )

Set the electric conductivity. In case of diagonal anisotropic material, the parameters for the specific components of the diagonal tensor can be set with the respective methods. Has no effect if .TanDGiven is set to True.

AddJEValue ( double dJValue, double dEValue)

This method enables you to define a specific nonlinear J-E curve by adding point by point. Based on this curve, the dependency of electric conductivity on E-field is computed. Has no effect if .TanDGiven is set to True. Please note that not all solvers can currently support the nonlinear electric conductivity.

ResetJEList

Deletes the nonlinear J-E curve.

TanD / TanDX / TanDY / TanDZ ( double dValue )

Set the electric tangent(delta). Only valid if .TanDGiven is set to True. In case of diagonal anisotropic material, the parameters for the specific components of the diagonal tensor can be set with the respective methods.

TanDGiven ( bool switch )

There are two ways to define lossy materials. Either a value for conductivity (s) can be given, or a value for tangent(delta). The two values are correlated by: tan(delta) = s/(e * e0 * 2 * p * f). If switch is True and though tan(delta) is used to define losses,  the frequency for which tan(delta) has been determined must been given by the .TanDFreq method.

TanDFreq ( double dValue )

If .TanDGiven is set to True, specify the frequency at which tan(delta) has been determined.

TanDModel ( enum {"ConstSigma", "ConstTanD", "DispTanD"} key )

Sets the model type for tan(delta) of a material.

ConstTanDModelOrderEps ( int iValue )

Sets the order for the ConstTanD model which corresponds to the number of poles used in the internal material representation. An order=1 corresponds to a Debye model.

AddTanDValueWeightedEps ( double dFrequency, double dTanD, double dWeight )

AddTanDValueXYZWeightedEps ( double dFrequency, double dTanDX, double dTanDY, double dTanDZ, double dWeight )

This method offers the possibility to define a specific tangent delta dispersion curve, which is then fitted to the model of a first order Debye dispersion. Use with .TanDModel set to "DispTanD". Note, that the real part of the permittivity is given by the .Epsilon method. Thus, due to the frequency dependent material behavior the values correspond only at the center frequency.

Use this method to add a tangent delta value with the corresponding frequency to the dispersion curve represented by a list. In case of diagonal anisotropic material, use the .AddTanDValueXYZWeightedEps method to define the components of the diagonal tensor.

Moreover (both in the isotropic and anisotropic case) a weight, i.e. a double value greater than/equal to 0.0, is assigned to each frequency in order to direct the interpolation algorithm and to enforce a reduced error in correspondence of the given frequency point.

ResetTanDListEps

Reset the list of tan(delta) values set by the .AddTanDValueWeightedEps and AddTanDValueXYZWeightedEps  methods.

Magnetic Conductivity

SigmaM / SigmaMX / SigmaMY / SigmaMZ ( double dValue )

Set the magnetic conductivity. In case of diagonal anisotropic material, the parameters for the specific components of the diagonal tensor can be set with the respective methods. Has no effect if .TanDMGiven is set to True.

TanDM / TanDMX / TanDMY / TanDMZ ( double dValue )

Set the magnetic tan(delta). Only valid if .TanDMGiven is set to True. In case of diagonal anisotropic material, the parameters for the specific components of the diagonal tensor can be set with the respective methods.

TanDMGiven ( bool switch )

As for electric conductivity, there are two ways to define magnetic lossy materials. If switch is True, tan(delta) is used to define losses. Usage of the .TanDMFreq method is mandatory in this case.

TanDMFreq ( double dValue )

If .TanDMGiven is set to True, specify the frequency at which tan(delta) has been determined.

TanDMModel ( enum {"ConstSigma", "ConstTanD", "DispTanD"} key )

Sets the model type for tan(delta) of a material.

ConstTanDModelOrderMue ( int iValue )

Sets the order for the ConstTanD model which corresponds to the number of poles used in the internal material representation. An order=1 corresponds to a Debye model.

AddTanDValueWeightedMue ( double dFrequency, double dTanDM, double dWeight )

AddTanDValueXYZWeightedMue ( double dFrequency, double dTanDMX, double dTanDMY, double dTanDMZ, double dWeight )

This method offers the possibility to define a specific tangent delta dispersion curve, which is then fitted to the model of a first order Debye dispersion. Use with .TanDMModel set to "DispTanD". Note, that the real part of the permeability is given by the .Mue method. Thus, due to the frequency dependent material behavior the values correspond only at the center frequency.

Use this method to add a tangent delta value with the corresponding frequency to the dispersion curve represented by a list. In case of diagonal anisotropic material, use the .AddTanDValueXYZWeightedMue method to define the components of the diagonal tensor.

Moreover (both in the isotropic and anisotropic case) a weight, i.e. a double value greater than/equal to 0.0, is assigned to each frequency in order to direct the interpolation algorithm and to enforce a reduced error in correspondence of the given frequency point.

ResetTanDListMue

Reset the list of tan(delta) values set by the .AddTanDValueWeightedMue and AddTanDValueXYZWeightedMue methods.

Dispersion

DispModelEps ( enum{"None", "Debye1st", "Debye2nd", "Drude", "Lorentz", "General1st", "General2nd, General", "NonLinear2nd", "NonLinear3rd", "NonLinearKerr", "NonLinearRaman"} key }

DispModelMue ( enum{"None", "Debye1st", "Debye2nd", "Drude", "Lorentz", "Gyrotropic", "General1st", "General2nd", "NonLinear2nd", "NonLinear3rd", "NonLinearKerr", "NonLinearRaman"} key }

Sets the dispersion model for dielectric / magnetic dispersion.

These material dispersions are specified by several coefficients, describing the corresponding dispersive behavior. Please find the meaning of the coefficients in the following list, for epsilon and mue respectively. Note, that in case of general 1st or 2nd order models the parameters have no special physical meaning, but represent mathematical coefficients of general polynomials.

The following table describes the coefficient for the linear dispersive materials.

In case of the nonlinear dispersive material the parameter correspondence is described by the following table.

EpsInfinity / EpsInfinityX / EpsInfinityY / EpsInfinityZ ( double dValue )

Define the permittivity high frequency limit for one of the dispersion models specified with the DispModelEps method.

DispCoeff0Eps / DispCoeff0EpsX / DispCoeff0EpsY / DispCoeff0EpsZ ( double dValue )

DispCoeff1Eps / DispCoeff1EpsX / DispCoeff1EpsY / DispCoeff1EpsZ ( double dValue )

DispCoeff2Eps / DispCoeff2EpsX / DispCoeff2EpsY / DispCoeff2EpsZ ( double dValue )

DispCoeff3Eps / DispCoeff3EpsX / DispCoeff3EpsY / DispCoeff3EpsZ ( double dValue )

DispCoeff4Eps / DispCoeff4EpsX / DispCoeff4EpsY / DispCoeff4EpsZ ( double dValue )

Define specific dielectric dispersion model parameters of dispersions model for the linear and nonlinear material. The settings depend on the dispersion model selected by the DispModelEps method. In case of diagonal anisotropic material, the parameters for the specific components of the diagonal tensor can be set with the respective methods. The infinity value for the linear dispersive model has to be defined with the EpsInfinity method whereas the DispCoeff0Eps method is used in correspondence of the nonlinear material.

AddDispEpsPole1stOrder / AddDispEpsPole1stOrderX/Y/Z ( double alpha0,  double beta0 )

AddDispEpsPole2ndOrder / AddDispEpsPole2ndOrderX/Y/Z ( double alpha0,  double alpha1, double beta0 ,  double beta1 )

These commands allow the specification of a higher order dispersion model in form of an arbitrary summation of first or second order pole descriptions. These commands apply to the dielectric dispersion and only work together with the "General" model defined with the DispModelEps method. The corresponding infinity value has to be defined with the EpsInfinity method.

AddDispMuePole1stOrder / AddDispMuePole1stOrderX/Y/Z ( double alpha0,  double beta0 )

AddDispMuePole2ndOrder / AddDispMuePole2ndOrderX/Y/Z ( double alpha0,  double alpha1, double beta0 ,  double beta1 )

These commands allow the specification of a higher order dispersion model in form of an arbitrary summation of first or second order pole descriptions. These commands apply to the magnetic dispersion and only work together with the "General" model defined with the DispModelMue method. The corresponding infinity value has to be defined with the MueInfinity method.

MueInfinity / MueInfinityX / MueInfinityY / MueInfinityZ ( double dValue )

DispCoeff0Mue / DispCoeff0MueX / DispCoeff0MueY / DispCoeff0MueZ ( double dValue )

DispCoeff1Mue / DispCoeff1MueX / DispCoeff1MueY / DispCoeff1MueZ ( double dValue )

DispCoeff2Mue / DispCoeff2MueX / DispCoeff2MueY / DispCoeff2MueZ ( double dValue )

DispCoeff3Mue / DispCoeff3MueX / DispCoeff3MueY / DispCoeff3MueZ ( double dValue )

DispCoeff4Mue / DispCoeff4MueX / DispCoeff4MueY / DispCoeff4MueZ ( double dValue )

Define specific magnetic dispersion model parameters of dispersions model for the linear and nonlinear material. The settings depend on the dispersion model selected by the DispModelMue method. In case of diagonal anisotropic material, the parameters for the specific components of the diagonal tensor can be set with the respective methods. The infinity value for the linear dispersive model has to be defined with the MueInfinity method whereas the DispCoeff0Mue method is used in correspondence of the nonlinear material.

DispCoeff0Mue / DispCoeff0MueX / DispCoeff0MueY / DispCoeff0MueZ ( double dValue )

Define the magnetic dispersion model parameters for the nonlinear material, as shown in the previous table. The settings depend on the dispersion model selected by the DispModelMue method. In case of diagonal anisotropic material, the parameters for the specific components of the diagonal tensor can be set with the respective methods.

UseSISystem ( bool switch )

The Gauss or SI unit system can be selected for different input parameters of the gyrotropic material.

GyroFreqMue ( double dValue )

Reference frequency for the conversion of gyrotropic material parameters given in Gauss units into the SI system.

AddDispersionFittingValueEps ( double dFrequency, double dRe, double dIm, double dWeight  )

AddDispersionFittingValueMue ( double dFrequency, double dRe, double dIm, double dWeight  )

AddDispersionFittingValueXYZEps ( double dFrequency, double dReX, double dImX, double dReY, double dImY, double dReZ, double dImZ, double dWeight  )

AddDispersionFittingValueXYZMue ( double dFrequency, double dReX, double dImX, double dReY, double dImY, double dReZ, double dImZ, double dWeight  )

Use this method to add a complex material value eps/mue with the corresponding frequency to the dispersion curve represented by a list. The weight specifies with which priority the values are considered. In case of diagonal anisotropic material, use the AddGeneralDispersionValueXYZEps/AddGeneralDispersionValueXYZMue method to define the components of the diagonal tensor.

This method offers the possibility to define a specific electric/magnetic material dispersion curve, which is then fitted to the model defined by function

DispersiveFittingSchemeEps/DispersiveFittingSchemeMue. The user defined dispersion fit is activated by the function UseGeneralDispersionEps/UseGeneralDispersionMue.

DispersiveFittingSchemeEps ( enum {"Conductivity", "1st Order", "2nd Order", "Nth Order"} key )

DispersiveFittingSchemeMue ( enum {"Conductivity", "1st Order", "2nd Order", "Nth Order"} key )

Sets the required fitting scheme.

MaximalOrderNthModelFitEps ( int iValue )

MaximalOrderNthModelFitMue ( int iValue )

Set the maximum allowed order for the nth fit interpolation scheme ("Nth Order"), for the eps or mue interpolation, respectively. The maximum number of poles is directly related both to the fitting accuracy and to the model complexity and therefore to simulation memory and computational time requirements.

UseOnlyDataInSimFreqRangeNthModelEps ( bool switch )

UseOnlyDataInSimFreqRangeNthModelMue ( bool switch )

Allow the nth order fit for the eps or mue interpolation scheme, respectively, ("Nth Order") to use only the frequency data points that lie within the "frequency range settings" defined by the user. Activating this switch enables an accurate data fitting of the material resonances which occur in the simulation bandwidth of interest using possibly a reduced number of poles and zeroes with respect to the complete data fitting. And this, in turn, translates into benefits for the simulation complexity in terms of memory and computational time.

UseGeneralDispersionEps ( bool switch )

UseGeneralDispersionMue ( bool switch )

Use this function to activate/deactivate the user defined dispersion.

Tensor Formulas

The following methods apply if used together with .Type("Tensor formula").

TensorFormulaFor ( enum { "epsilon_r", "mu_r"} key )

Call to begin the definition of a dispersive material, the material properties of which are described by complex tensors with each entry given by a formula. You may either define the relative permittivity or permeability, or both. If not specified otherwise, tensor values on its diagonal will be interpreted as One, and other entries as Zero. An alignment vector can be specified independently for each material property to rotate the tensor. Details are given below.

TensorFormulaReal ( int row, int column, expression formula )

Use this method to continue the definition of a dispersive material's complex tensor. Provide the formula for the real part's value at the given row and column. The character "f" is used as a placeholder for the frequency in Hz. The real part of the tensor is one on the main diagonal and zero elsewhere if not specified. Admissible values for row and column are 0, 1, and 2.

TensorFormulaImag ( int row, int column, expression formula )

Use this method to continue the definition of a dispersive material's complex tensor. Provide the formula for the negative imaginary part's value at the given row and column. Since the negative imaginary part is given, formulas on the main diagonal that evaluate to a positive value introduce losses into the structure, while a negative value for the negative imaginary part results in an active material. The character "f" is used as a placeholder for the frequency in Hz. The imaginary part of the tensor is zero if not specified. Values for the integer tensor indices are zero to two.

TensorAlignment ( double x, double y, double z )

Defines a rotation of the tensor. By default, the alignment vector is x=0, y=0, z=1, and no rotation will be applied. The tensor is then taken as-is. For other alignment vectors, the rotation transformation is defined such that it maps the alignment vector onto the z-axis. After applying the tensor, the result vector is mapped back by the inverse transformation.

This allows to specify the formulas for the z-direction, and consider the actual material alignment in space later on. Please note that this approach is for tensors which have a different material behavior in one designated direction and the same properties perpendicular to that direction, as is the case for some material models for biased ferrites. If a rotation around the designated direction is required, it must be entered manually, since the TensorAlignment vector does not provide enough information to define that rotation.

Also note that the alignment vector needs to be set for each material property separately. Thus call TensorAlignment after each call to TensorFormulaFor.

Temperature Dependent Materials

AddTemperatureDepEps ( double dTemperature, double dValue )

This method enables you to define a specific temperature dependency curve for electric permittivity by adding point by point. Use with set to "Normal".

ResetTemperatureDepEps

Deletes the temperature dependency curve for electric permittivity.

AddTemperatureDepMue ( double dTemperature, double dValue )

With this method a new point for temperature dependency of magnetic permeability can be specified. Use with set to "Normal".

ResetTemperatureDepMue

Deletes the temperature dependency curve for magnetic permeability.

AddTemperatureDepSigma ( double dTemperature, double dValue )

With this method a new point for temperature dependency of electric conductivity can be specified. Use with set to "Normal".

ResetTemperatureDepSigma

Deletes the temperature dependency curve for electric conductivity.

Thermal Material Properties

ThermalType (enum {"PTC", "Normal", "Anisotropic"} key )

Allows to set the thermal material type:

ThermalConductivity / ThermalConductivityX / ThermalConductivityY / ThermalConductivityZ ( double dValue )

Defines the thermal conductivity of a material. In case of diagonal anisotropic material, the parameters for the specific components of the diagonal thermal conductivity tensor can be set with the respective methods.

HeatCapacity ( double dValue )

This parameter defines the specific heat capacity in [kJ / (K kg)]. This setting is relevant only for transient thermal simulations.

BloodFlow ( double dValue )

The Bloodflow coefficient is a parameter of the bioheat equation. It determines the influence of blood at a certain temperature inside the tissue volume V. The reference temperature for the bloodflow (usually: 37 C) can be defined in the thermal solver specials dialog boxes of the stationary- and the transient solver.

MetabolicRate ( double dValue )

The Basal metabolic is a parameter of the bioheat equation. It describes the amount of heat  which is produced by tissue per volume V.

VoxelConvection ( double dValue )

This parameter allows to consider convection processes on voxel models. Typically this parameter is used with a material describing skin. For coarse voxel models it is advisable to use fat in addition. Only voxel-background material surfaces are taken into account.

ResetNLThermalCond

Delete the nonlinear thermal conductivity curve.

AddNLThermalCond ( double dTemperature, double dValue )

Adds a new data point for the dependence of isotropic thermal conductivity on temperature. Parameter dTemperature must be specified in the current temperature units. If anisotropic thermal type has been selected, all three components of thermal conductivity are set to dValue.

AddNLThermalCondAniso ( double dTemperature, double dValueX, double dValueY, double dValueZ )

Adds a new data point for the dependence of anisotropic thermal conductivity on temperature. Parameter dTemperature must be specified in the current temperature units. If normal thermal type has been selected, thermal conductivity is set to dValueX.

ResetNLHeatCap

Delete the nonlinear specific heat capacity curve.

AddNLHeatCap ( double dTemperature, double dValue )

Adds a new data point for the dependence of specific heat capacity on temperature. Parameter dTemperature must be specified in the current temperature units.

Mechanics Material Properties

MechanicsType (enum {"Unused", "Isotropic"} key )

This list allows to select if the material should be used with isotropic properties for the simulation.

YoungsModulus ( double dValue )

This parameter defines the stiffness of an isotropic elastic material. It is normally measured in GPa, or kN/mm2. The typical values vary between 0.01 GPa (rubber) and over 1000 GPa (diamond). It is important to know the value of this material parameter very well, since it has a large influence on the accuracy of the solution.

PoissonsRatio ( double dValue )

This parameter defines the scale of the transverse contraction of a longitudinally stretched body. This parameter can vary between -1 and 0.5, whereas most of the materials are characterized by a positive Poisson's ratio.

ThermalExpansionRate ( double dValue )

The expansion coefficient is the strain of a body, if its temperature changes by 1 K. This value is utilized to compute strain induced by an external temperature field.

ResetTempDepYoungsModulus

Delete the temperature dependent Young's modulus curve.

AddTempDepYoungsModulus ( double dTemperature, double dValue )

Adds a new data point for the dependence of Young's modulus on temperature. Parameter dTemperature must be specified in Kelvin.

Queries

GetNumberOfMaterials long

Returns the number of materials.

GetNameOfMaterialFromIndex ( long index ) string

Returns the material name for the material specified by the zero-based index index < .GetNumberOfMaterials - 1.

GetTypeOfMaterial( name name) string

Returns the material type.

GetColour ( name name, double_ref red, double_ref green, double_ref blue )

Returns the current color values of the material named name in the parameters red, green and blue. The color values vary between 0 and 1.

GetEpsilon ( name name, double_ref EpsX, double_ref EpsY, double_ref EpsZ )

GetMue ( name name, double_ref MueX, double_ref MueY, double_ref MueZ )

GetSigma ( name name, double_ref SigmaX, double_ref SigmaY, double_ref SigmaZ )

GetSigmaM ( name name, double_ref SigmaMX, double_ref SigmaMY, double_ref SigmaMZ )

GetRho ( name name, double_ref Rho )

GetCorrugation ( name name, double_ref depth, double_ref gapwidth, double_ref toothwidth ) bool

GetOhmicSheetImpedance  ( name name, double_ref resistance, double_ref reactance ) bool

Returns the specific material parameter for the material specified by name in the respective double variables.

Exists  ( name name ) bool

Returns True if the material specified by name exists.

Default Settings

.Type ("Normal")

.Colour ("0", "1", "1")

.Wireframe ("False")

.Transparency ("0")

.Epsilon ("1.0")

.Mue ("1.0")

.Rho ("0.0")

.Sigma ("0.0")

.TanD ("0.0")

.TanDFreq ("0.0")

.TanDGiven ("False")

.TanDModel ("ConstTanD")

.SigmaM ("0.0")

.TanDM ("0.0")

.TanDMFreq ("0.0")

.TanDMGiven ("False")

.DispModelEps ("None")

.DispModelMue ("None")

.MueInfinity ("1.0")

.EpsInfinity ("1.0")

.DispCoeff1Eps ("0.0")

.DispCoeff2Eps ("0.0")

.DispCoeff3Eps ("0.0")

.DispCoeff4Eps ("0.0")

.DispCoeff1Mue ("0.0")

.DispCoeff2Mue ("0.0")

.DispCoeff3Mue ("0.0")

.DispCoeff4Mue ("0.0")

.AddDispEpsPole1stOrder ("0.0", "0.0")

.AddDispEpsPole2ndOrder ("0.0", "0.0", "0.0", "0.0")