Home
Thermal Solver
Contains thermal solver related guides, such as the TMG reference manual, thermal API guide, and error message list.
Thermal solver API guide
Allows you to create or add functionality to enhance the thermal solver capabilities.
Plugin functions in expressions
Simcenter 3D method definitions
AddOptionalArg
This method defines optional arguments foryour plugin function. You can call AddOptionalArg, only after call the AddArg method.

Thermal Solver
Contains thermal solver related guides, such as the TMG reference manual, thermal API guide, and error message list.
- Thermal solver guides
  Maya HTT's thermal solver is included in Simcenter 3D and in Simcenter Femap. This page contains links to thermal solver guides, which help you understand how the thermal solver works.
- Thermal solver theory
  Describes the theory and methods of the thermal solver.
- Thermal solver API guide
  Allows you to create or add functionality to enhance the thermal solver capabilities.
  - Introduction
  - Supported compilers
  - User written subroutines
    This section describes two types of user-written subroutines.
  - Plugin functions in expressions
    - Workflow for using a plugin function
    - API methods for plugin function
      You use the predefined API methods to define your plugin function. API methods are divided into methods supported by Simcenter 3D and methods supported by the thermal solver.
    - Simcenter 3D method definitions
      - AddArg
        This method defines required arguments to your plugin function.
      - AddFunction
        This method is used to register a function pointer with the expression. It returns an IFunctionDefinition interface that allows you to define any arguments this function requires.
      - AddOptionalArg
        This method defines optional arguments foryour plugin function. You can call AddOptionalArg, only after call the AddArg method.
      - GetDensity
        Returns the material's density for a given temperature and pressure.
      - GetElemID
        Returns the current element ID.
      - GetEnthalpy
        Returns the material's enthalpy for a given temperature and pressure.
      - GetFieldProperty
        Returns the value for the material property, if the property is available as a field. The name of the property is specified by the argument string.
      - GetFluidMassFlowRate
        Returns the fluid mass flow rate computed at the element centroid to which the thermal streams, thermal voids, or thermal convecting zones boundary condition is applied.
      - GetFluidMaterial
        Returns the fluid material associated to the element to which the thermal streams, thermal voids, or thermal convecting zones boundary condition is applied.
      - GetFluidPressure
        Returns the fluid pressure computed at the element centroid to which the thermal streams, thermal voids, or thermal convecting zones boundary condition is applied.
      - GetFluidTemp
        Returns the fluid temperature computed at the element centroid to which the thermal streams, thermal voids, or thermal convecting zones boundary condition is applied.
      - GetMaterial
        Returns the material associated to the element.
      - GetNodeID
        Returns a true or false value depending on if the quantity is computed on nodes or not. Use it in conjunction with the Finite Element Method. When the operation is successful, the function puts the node ID associated with the current expression call in the argument.
      - GetRadius
        Returns the radius of the element centroid with respect to the absolute cylindrical coordinate system.
      - GetRotationalSpeed
        Returns the rotational speed computed at the element centroid.
      - GetScalarProperty
        Returns the value for the material property, if the property is available as a scalar. The name of the property is specified by the argument string.
      - GetSpecificHeat
        Returns the material's specific heat for a given temperature and pressure.
      - GetUnitSystem
        Returns the unit system of the solution.
      - GetTemperature
        Returns the temperature of the current element.
      - GetThermalConductivity
        Returns the material's thermal conductivity for a given temperature and pressure.
      - GetThickness
        Returns the element thickness. For solid elements, it returns 0 thickness.
      - GetTime
        Returns the current time of a transient solution.
      - GetX, GetY, GetZ
        Return the X, Y, and Z coordinates of the element centroid with respect to the absolute coordinate system.
      - HasProperty
        This method checks if the thermal solver supports the property for a given material.
      - Set
        This method specifies power orders using the mass, length, time (MLT) system. When you add your plugin function, you must specify the unit dimensions of the physical quantity that is returned by your function, and for any arguments used by your function. The unit dimensions are specified through the instance of class Measure.
      - StopRun
        Aborts the solve from within a plugin function.
    - Thermal solver method definitions

AddOptionalArg

This method defines optional arguments foryour plugin function. You can call AddOptionalArg, only after call the AddArg method.

Calling convention:

int AddOptionalArg( const char* name, const char* desc, ArgType type, Measure dimens, DefValue  defaultVal)


Argument	Data type	Description
name	const char*	Name of the optional argument.
desc	const char*	Description of the optional argument.
type	ArgType	Type of the optional argument.
dimens	Measure	Unit dimension for the returned value.
defaultVal	DefValue	Default value.

You can find a definition of this function in the CaeUtils_Exp_IFunctionDefinition.hxx header file.

For the example, see the AddFunction method.