The Temperature object stores the data for temperature predefined fields.
The Temperature object is derived from the PredefinedField object.
import load mdb.models[name].predefinedFields[name]
This method creates a Temperature object.
mdb.models[name].Temperature
Required arguments
A String specifying the repository key.
A String specifying the name of the step in which the predefined field is created.
A Region object specifying the region to which the predefined field is applied. Region is ignored if the predefined field has a distributionType member available, and distributionType=FROM_FILE .
Optional arguments
A SymbolicConstant specifying how the predefined field varies spatially. Possible values are UNIFORM, USER_DEFINED, FROM_FILE, FIELD, FROM_FILE_AND_USER_DEFINED, and DISCRETE_FIELD. The default value is UNIFORM.
A SymbolicConstant specifying how the predefined field is distributed over the cross section of the region. Possible values are
The default value is CONSTANT_THROUGH_THICKNESS.
CONSTANT_THROUGH_THICKNESS
GRADIENTS_THROUGH_SHELL_CS
GRADIENTS_THROUGH_BEAM_CS
POINTS_THROUGH_SECTION
A String specifying the name of the AnalyticalField or DiscreteField object associated with this predefined field. The field argument applies only when distributionType=FIELD or distributionType=DISCRETE_FIELD. The default value is an empty string.
A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the predefined field has no amplitude reference. The default value is UNSET.
Note: amplitude should be given only if it is valid for the specified step.
A String specifying the name of the file from which the temperature values are to be read when distributionType=FROM_FILE or distributionType=FROM_FILE_AND_USER_DEFINED.
An Int specifying the first step from which temperature values are to be read or the SymbolicConstant FIRST_STEP or LAST_STEP. This argument is valid only when distributionType=FROM_FILE or distributionType=FROM_FILE_AND_USER_DEFINED. The default value is None.
An Int specifying the first increment of the step set in beginStep or the SymbolicConstants STEP_START or STEP_END. This argument is valid only when distributionType=FROM_FILE or distributionType=FROM_FILE_AND_USER_DEFINED. The default value is None.
An Int specifying the last step from which temperature values are to be read or the SymbolicConstants FIRST_STEP and LAST_STEP. This argument is valid only when distributionType=FROM_FILE or distributionType=FROM_FILE_AND_USER_DEFINED. The default value is None.
An Int specifying the last increment of the step set in endStep or the SymbolicConstants STEP_START and STEP_END. This argument is valid only when distributionType=FROM_FILE or distributionType=FROM_FILE_AND_USER_DEFINED. The default value is None.
A SymbolicConstant specifying whether to interpolate a field read from an output database or results file. Possible values are OFF, ON or MIDSIDE_ONLY. The default value is OFF.
A Sequence of Doubles specifying the temperature values when distributionType=UNIFORM or FIELD. The value of the magnitudes argument is a function of the crossSectionDistribution argument, as shown in the following list:
If crossSectionDistribution=CONSTANT_THROUGH_THICKNESS then magnitudes is a Double specifying the temperature.
If crossSectionDistribution=GRADIENTS_THROUGH_SHELL_CS then magnitudes is a sequence of Doubles specifying the mean value and the gradient in the thickness direction.
If crossSectionDistribution=GRADIENTS_THROUGH_BEAM_CS then magnitudes is a sequence of Doubles specifying the mean value, the gradient in the N1 direction, and the gradient in the N2 direction.
If crossSectionDistribution=POINTS_THROUGH_SECTION then magnitudes is a sequence of Doubles specifying the temperature at each point.
A Float specifying the absolute value by which a driven node of the field can lie outside the region of the elements of the global model. The default value is 0.0. This argument cannot be used with midside.
A Float specifying the fraction of the average element size in the global model by which a driven node of the field can lie outside the region of the elements of the global model. The default value is 0.0. This argument cannot be used with midside.
Return value
A Temperature object.
Exceptions
This method moves the TemperatureState object from one step to a different step.
Required arguments
A String specifying the name of the step from which the PredefinedFieldState is moved.
A String specifying the name of the step to which the PredefinedFieldState is moved.
Optional arguments
Return value
Exceptions
TextError.
This method modifies the data for an existing Temperature object in the step where it is created.
Required arguments
Optional arguments
The optional arguments to setValues are the same as the arguments to the Temperature method, except for the name and createStepName arguments.
Return value
Exceptions
This method modifies the propagating data for an existing Temperature object in the specified step.
Required argument
A String specifying the name of the step in which the predefined field is modified.
Optional arguments
The optional arguments to setValuesInStep are the same as the optional arguments to the Temperature method, except for the distributionType and crossSectionDistribution arguments.
None.Return value
Exceptions
The Temperature object can have the following members:
A String specifying the repository key.
A SymbolicConstant specifying how the predefined field varies spatially. Possible values are UNIFORM, USER_DEFINED, FROM_FILE, FIELD, FROM_FILE_AND_USER_DEFINED, and DISCRETE_FIELD. The default value is UNIFORM.
A String specifying the name of the AnalyticalField or DiscreteField object associated with this predefined field. The field argument applies only when distributionType=FIELD or distributionType=DISCRETE_FIELD. The default value is an empty string.
A Region object specifying the region to which the predefined field is applied. Region is ignored if the predefined field has an instances member available. Region is also ignored if the predefined field has a distributionType member available, and distributionType=FROM_FILE or FROM_FILE_AND_USER_DEFINED.