Predefined Field#

A PredefinedField object stores the non-propagating data of a predefined field as well as a number of instances of the corresponding PredefinedFieldState object. The PredefinedFieldState object stores the propagating data of the predefined field in a single step. A specific type of PredefinedField object and a specific type of PredefinedFieldState object are designed for each type of predefined field. Instances of the PredefinedFieldState object are created and deleted internally by its corresponding PredefinedField object.

Create predefined fields#

class PredefinedFieldModel(name, description='', stefanBoltzmann=None, absoluteZero=None, waveFormulation=abaqusConstants.NOT_SET, modelType=abaqusConstants.STANDARD_EXPLICIT, universalGas=None, copyConstraints=ON, copyConnectors=ON, copyInteractions=ON)[source]#

Abaqus creates a Model object named Model-1 when a session is started.

Note

This object can be accessed by:

mdb.models[name]

Note

Check PredefinedFieldModel on help.3ds.com/0.1..

Field(name, createStepName, region, outputVariable='', fieldVariableNum=None, distributionType=abaqusConstants.UNIFORM, crossSectionDistribution=abaqusConstants.CONSTANT_THROUGH_THICKNESS, field='', amplitude=abaqusConstants.UNSET, fileName='', beginStep=None, beginIncrement=None, endStep=None, endIncrement=None, interpolate=OFF, magnitudes='')[source]#

This method creates a Field object.

Note

This function can be accessed by:

mdb.models[name].Field

New in version 2018: The Field method was added.

Note

Check Field on help.3ds.com/0.1..

Parameters:

name (str) – A String specifying the repository key.
createStepName (str) – A String specifying the name of the step in which the predefined field is created.
region (Region) – 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.
outputVariable (str, default: '') – A String specifying the scalar nodal output variable that will be read from an output database and used to initialize a specified predefined field. This argument is a required argument if distributionType = FROM_FILE or distributionType = FROM_FILE_AND_USER_DEFINED.
fieldVariableNum (Optional[int], default: None) – An Int specifying the field variable number.
distributionType (SymbolicConstant, default: UNIFORM) – 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.
crossSectionDistribution (SymbolicConstant, default: CONSTANT_THROUGH_THICKNESS) –
A SymbolicConstant specifying how the predefined field is distributed over the cross-section of the region. Possible values are
- CONSTANT_THROUGH_THICKNESS
- GRADIENTS_THROUGH_SHELL_CS
- GRADIENTS_THROUGH_BEAM_CS
- POINTS_THROUGH_SECTION
The default value is CONSTANT_THROUGH_THICKNESS.
field (str, default: '') – 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.
amplitude (str, default: UNSET) –
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.
fileName (str, default: '') – A String specifying the name of the file from which the Field values are to be read when distributionType = FROM_FILE or distributionType = FROM_FILE_AND_USER_DEFINED.
beginStep (Optional[SymbolicConstant], default: None) – An Int specifying the first step from which Field 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.
beginIncrement (Optional[SymbolicConstant], default: 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.
endStep (Optional[SymbolicConstant], default: None) – An Int specifying the last step from which Field 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.
endIncrement (Optional[SymbolicConstant], default: 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.
interpolate (SymbolicConstant, default: OFF) – 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.
magnitudes (str, default: '') –
A Sequence of Doubles specifying the Field 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, magnitudes is a Double specifying the Field.
- If crossSectionDistribution = GRADIENTS_THROUGH_SHELL_CS, magnitudes is a sequence of Doubles specifying the mean value and the gradient in the thickness direction.
- If crossSectionDistribution = GRADIENTS_THROUGH_BEAM_CS, 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, magnitudes is a sequence of Doubles specifying the Field at each point.

Return type:

A Field object.

FluidCavityPressure(name, fluidCavity, fluidPressure)[source]#

This method creates a FluidCavityPressure object.

Note

This function can be accessed by:

mdb.models[name].FluidCavityPressure

Note

Check FluidCavityPressure on help.3ds.com/0.1..

Parameters:

name (str) – A String specifying the repository key.
fluidCavity (str) – A String specifying the name of a Fluid Cavity Interaction.
fluidPressure (float) – A Float specifying the initial fluid pressure.

Returns:

A FluidCavityPressure object.

Return type:

FluidCavityPressure

InitialState(name, instances, fileName, endStep=abaqusConstants.LAST_STEP, endIncrement=abaqusConstants.STEP_END, updateReferenceConfiguration=OFF)[source]#

This method creates an InitialState predefined field object.

Note

This function can be accessed by:

mdb.models[name].InitialState

Note

Check InitialState on help.3ds.com/0.1..

Parameters:

name (str) – A String specifying the repository key.
instances (List[PartInstance]) – A PartInstanceArray object specifying the instances to which the predefined field is applied.
fileName (str) – A String specifying the name of the job that generated the initial state data.
endStep (SymbolicConstant, default: LAST_STEP) – The SymbolicConstant LAST_STEP or an Int specifying the step from which the initial state values are to be read or the SymbolicConstant LAST_STEP. The default value is LAST_STEP.
endIncrement (SymbolicConstant, default: STEP_END) – The SymbolicConstant STEP_END or an Int specifying the increment, interval or iteration of the step set in endStep or the SymbolicConstant STEP_END. The default value is STEP_END.
updateReferenceConfiguration (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to update the reference configuration based on the import data. The default value is OFF.

Returns:

An InitialState object.

Return type:

InitialState

KinematicHardening(name, region, numBackStress=1, equivPlasticStrain=(), backStress=(), sectPtNum=(), definition=abaqusConstants.KINEMATIC_HARDENING, rebarLayerNames=(), distributionType=abaqusConstants.MAGNITUDE)[source]#

This method creates a KinematicHardening object.

Note

This function can be accessed by:

mdb.models[name].KinematicHardening

Note

Check KinematicHardening on help.3ds.com/0.1..

Parameters:

name (str) – A String specifying the repository key.
region (Region) – A Region object specifying the region to which the predefined field is applied.
numBackStress (int, default: 1) – An Int specifying the number of backstresses. The default value is 1.
equivPlasticStrain (tuple, default: ()) – A sequence of Floats specifying the initial equivalent Plastic strain.
backStress (tuple, default: ()) – A sequence of sequences of Floats specifying the initial backstress tensor for kinematic hardening models. The default value is an empty sequence.
sectPtNum (tuple, default: ()) – A sequence of Ints specifying section point numbers. This argument is valid only when definition = SECTION_PTS.
definition (SymbolicConstant, default: KINEMATIC_HARDENING) – A SymbolicConstant specifying different types of kinematic hardening. Possible values are KINEMATIC_HARDENING, CRUSHABLE_FOAM, REBAR, SECTION_PTS, and USER_DEFINED. The default value is KINEMATIC_HARDENING.
rebarLayerNames (tuple, default: ()) – A sequence of Strings specifying rebar layer names. This argument is valid only when definition = REBAR.
distributionType (SymbolicConstant, default: MAGNITUDE) – A SymbolicConstant specifying whether the load is uniform. Possible values are MAGNITUDE and ANALYTICAL_FIELD. The default value is MAGNITUDE.

Returns:

A KinematicHardening object.

Return type:

KinematicHardening

MaterialAssignment(name, instanceList, useFields=OFF, assignmentList=(), fieldList=(), colorList=())[source]#

This method creates a MaterialAssignment predefined field object.

Note

This function can be accessed by:

mdb.models[name].MaterialAssignment

Note

Check MaterialAssignment on help.3ds.com/0.1..

Parameters:

name (str) – A String specifying the repository key.
instanceList (List[PartInstance]) – A PartInstanceArray object specifying the part instances to which the predefined field is applied. All instances must be assigned the same Eulerian section.
useFields (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the volume fraction data will be uniform or defined by discrete fields. The default value is OFF.
assignmentList (tuple, default: ()) – A sequence of tuples specifying the uniform volume fractions to be assigned. This argument is valid only when useFields = FALSE. Each tuple contains two entries:A Region object.A tuple of Floats specifying the uniform volume fraction values. The length of the tuple must match the number of material instance names specified in the Eulerain section assigned to part instances specified by instanceList.
fieldList (tuple, default: ()) – A sequence of tuples specifying the discrete volume fractions to be assigned. This argument is valid only when useFields = TRUE. Each tuple contains two entries:A Region object.A tuple of Strings specifying Discrete Field names. The length of the tuple must match the number of material instance names specified in the Eulerain section assigned to part instances specified by instanceList.
colorList (tuple, default: ()) – A sequence of three Ints specifying colors used to display the material instance assignments. This is a sequence of R,G,B colors, where the values are represented by integers between 0 and 255. The default value is an empty sequence.

Returns:

A MaterialAssignment object.

Return type:

MaterialAssignment

Stress(name, region, distributionType=abaqusConstants.UNIFORM, sigma11=None, sigma22=None, sigma33=None, sigma12=None, sigma13=None, sigma23=None)[source]#

This method creates a Stress predefined field object.

Note

This function can be accessed by:

mdb.models[name].Stress

New in version 2017: The Stress method was added.

Note

Check Stress on help.3ds.com/0.1..

Parameters:

name (str) – A String specifying the repository key.
region (Region) – A Region object specifying the region to which the predefined field is applied. Region is ignored if the predefined field has distributionType = FROM_FILE.
distributionType (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying whether the load is uniform. Possible values are UNIFORM and FROM_FILE. The default value is UNIFORM.
sigma11 (Optional[float], default: None) – A Float specifying the first principal component of the stress.
sigma22 (Optional[float], default: None) – A Float specifying the second principal component of the stress.
sigma33 (Optional[float], default: None) – A Float specifying the third principal component of the stress.
sigma12 (Optional[float], default: None) – A Float specifying the first shear component of the stress.
sigma13 (Optional[float], default: None) – A Float specifying the second shear component of the stress.
sigma23 (Optional[float], default: None) – A Float specifying the third shear component of the stress.

Return type:

A Stress object.

Temperature(name, createStepName, region, distributionType=abaqusConstants.UNIFORM, crossSectionDistribution=abaqusConstants.CONSTANT_THROUGH_THICKNESS, field='', amplitude=abaqusConstants.UNSET, fileName='', beginStep=None, beginIncrement=None, endStep=None, endIncrement=None, interpolate=OFF, magnitudes='', absoluteExteriorTolerance=0, exteriorTolerance=0)[source]#

This method creates a Temperature object.

Note

This function can be accessed by:

mdb.models[name].Temperature

Note

Check Temperature on help.3ds.com/0.1..

Parameters:

name (str) – A String specifying the repository key.
createStepName (str) – A String specifying the name of the step in which the predefined field is created.
region (Region) – 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 .
distributionType (SymbolicConstant, default: UNIFORM) – 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.
crossSectionDistribution (SymbolicConstant, default: CONSTANT_THROUGH_THICKNESS) –
A SymbolicConstant specifying how the predefined field is distributed over the cross section of the region. Possible values are
- CONSTANT_THROUGH_THICKNESS
- GRADIENTS_THROUGH_SHELL_CS
- GRADIENTS_THROUGH_BEAM_CS
- POINTS_THROUGH_SECTION
The default value is CONSTANT_THROUGH_THICKNESS.
field (str, default: '') – 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.
amplitude (str, default: UNSET) – 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.
fileName (str, default: '') – 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.
beginStep (Optional[SymbolicConstant], default: None) – 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.
beginIncrement (Optional[SymbolicConstant], default: 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.
endStep (Optional[SymbolicConstant], default: 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.
endIncrement (Optional[SymbolicConstant], default: 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.
interpolate (SymbolicConstant, default: OFF) – 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.
magnitudes (str, default: '') –
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.
absoluteExteriorTolerance (float, default: 0) – 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.
exteriorTolerance (float, default: 0) – 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.

Returns:

A Temperature object.

Return type:

Temperature

Velocity(name, region, velocity1, velocity2, velocity3, omega, axisBegin, axisEnd, field='', distributionType=abaqusConstants.MAGNITUDE)[source]#

This method creates a Velocity predefined field object.

Note

This function can be accessed by:

mdb.models[name].Velocity

Note

Check Velocity on help.3ds.com/0.1..

Parameters:

name (str) – A String specifying the repository key.
region (Region) – A Region object specifying the region to which the predefined field is applied.
velocity1 (float) – A Float specifying the first component of the velocity.
velocity2 (float) – A Float specifying the second component of the velocity.
velocity3 (float) – A Float specifying the third component of the velocity.
omega (float) – A Float specifying the angular velocity.
axisBegin (tuple) – A sequence of Floats specifying the X-, Y-, and Z- coordinates of the starting point of the axis about which omega is defined.
axisEnd (tuple) – A sequence of Floats specifying the X-, Y-, and Z- coordinates of the end point of the axis about which omega is defined.
field (str, default: '') – A String specifying the name of the AnalyticalField object associated with this predefined field. The field argument applies only when distributionType = FIELD_ANALYTICAL. The default value is an empty string.
distributionType (SymbolicConstant, default: MAGNITUDE) – A SymbolicConstant specifying whether the load is uniform. Possible values are MAGNITUDE and FIELD_ANALYTICAL. The default value is MAGNITUDE.

Returns:

A Velocity object.

Return type:

Velocity

Object features#

Field#

class Field(name, createStepName, region, outputVariable='', fieldVariableNum=None, distributionType=abaqusConstants.UNIFORM, crossSectionDistribution=abaqusConstants.CONSTANT_THROUGH_THICKNESS, field='', amplitude=abaqusConstants.UNSET, fileName='', beginStep=None, beginIncrement=None, endStep=None, endIncrement=None, interpolate=OFF, magnitudes='')[source]#

The Field object stores the data for field predefined fields. The Field object is derived from the PredefinedField object. distributionType=FROM_FILE or FROM_FILE_AND_USER_DEFINED.

Note

This object can be accessed by:

import load
mdb.models[name].predefinedFields[name]

The corresponding analysis keywords are:

INITIAL CONDITIONS
FIELD

New in version 2018: The Field class was added.

Note

Check Field on help.3ds.com/0.1..

Public Data Attributes:

`name`	A String specifying the repository key.
`distributionType`	A SymbolicConstant specifying how the predefined field varies spatially.
`field`	A String specifying the name of the AnalyticalField or DiscreteField object associated with this predefined field.
`region`	A Region object specifying the region to which the predefined field is applied.

Inherited from PredefinedField

`name`	A String specifying the repository key.
`region`	A Region object specifying the region to which the predefined field is applied.
`fieldList`	An IMAField for MaterialAssignment predefined field。

Public Methods:

`__init__`(name, createStepName, region[, ...])	This method creates a Field object.
`move`(fromStepName, toStepName)	This method moves the FieldState object from one step to a different step.
`setValues`([outputVariable, ...])	This method modifies the data for an existing Field object in the step where it is created.
`setValuesInStep`(stepName[, outputVariable, ...])	This method modifies the propagating data for an existing Field object in the specified step.

Inherited from PredefinedField

`move`(fromStepName, toStepName)	This method moves the FieldState object from one step to a different step.
`resume`()	This method resumes the predefined field that was previously suppressed.
`suppress`()	This method suppresses the predefined field.
`delete`(indices)	This method allows you to delete existing fields.

distributionType: SymbolicConstant = UNIFORM[source]#: 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.

field: str = ''[source]#: 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.

move(fromStepName, toStepName)[source]#

This method moves the FieldState object from one step to a different step.

Note

Check Field.move on help.3ds.com/0.1..

Parameters:

fromStepName (str) – A String specifying the name of the step from which the PredefinedFieldState is moved.
toStepName (str) – A String specifying the name of the step to which the PredefinedFieldState is moved.

Raises:

TextError. –

name: str = ''[source]#: A String specifying the repository key.

region: Region = <abaqus.Region.Region.Region object>[source]#: 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.

setValues(outputVariable='', fieldVariableNum=None, distributionType=abaqusConstants.UNIFORM, crossSectionDistribution=abaqusConstants.CONSTANT_THROUGH_THICKNESS, field='', amplitude=abaqusConstants.UNSET, fileName='', beginStep=None, beginIncrement=None, endStep=None, endIncrement=None, interpolate=OFF, magnitudes='')[source]#

This method modifies the data for an existing Field object in the step where it is created.

Note

Check Field.setValues on help.3ds.com/0.1..

Parameters:

outputVariable (str, default: '') – A String specifying the scalar nodal output variable that will be read from an output database and used to initialize a specified predefined field. This argument is a required argument if distributionType = FROM_FILE or distributionType = FROM_FILE_AND_USER_DEFINED.
fieldVariableNum (Optional[int], default: None) – An Int specifying the field variable number.
distributionType (SymbolicConstant, default: UNIFORM) – 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.
crossSectionDistribution (SymbolicConstant, default: CONSTANT_THROUGH_THICKNESS) – A SymbolicConstant specifying how the predefined field is distributed over the cross-section of the region. Possible values are - CONSTANT_THROUGH_THICKNESS - GRADIENTS_THROUGH_SHELL_CS - GRADIENTS_THROUGH_BEAM_CS - POINTS_THROUGH_SECTION The default value is CONSTANT_THROUGH_THICKNESS.
field (str, default: '') – 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.
amplitude (str, default: UNSET) – 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.
fileName (str, default: '') – A String specifying the name of the file from which the Field values are to be read when distributionType = FROM_FILE or distributionType = FROM_FILE_AND_USER_DEFINED.
beginStep (Optional[SymbolicConstant], default: None) – An Int specifying the first step from which Field 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.
beginIncrement (Optional[SymbolicConstant], default: 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.
endStep (Optional[SymbolicConstant], default: None) – An Int specifying the last step from which Field 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.
endIncrement (Optional[SymbolicConstant], default: 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.
interpolate (SymbolicConstant, default: OFF) – 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.
magnitudes (str, default: '') – A Sequence of Doubles specifying the Field 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, magnitudes is a Double specifying the Field. - If crossSectionDistribution = GRADIENTS_THROUGH_SHELL_CS, magnitudes is a sequence of Doubles specifying the mean value and the gradient in the thickness direction. - If crossSectionDistribution = GRADIENTS_THROUGH_BEAM_CS, 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, magnitudes is a sequence of Doubles specifying the Field at each point.

setValuesInStep(stepName, outputVariable='', fieldVariableNum=None, field='', amplitude=abaqusConstants.UNSET, fileName='', beginStep=None, beginIncrement=None, endStep=None, endIncrement=None, interpolate=OFF, magnitudes='')[source]#

This method modifies the propagating data for an existing Field object in the specified step.

Note

Check Field.setValuesInStep on help.3ds.com/0.1..

Parameters:

stepName (str) – A String specifying the name of the step in which the predefined field is modified.
outputVariable (str, default: '') – A String specifying the scalar nodal output variable that will be read from an output database and used to initialize a specified predefined field. This argument is a required argument if distributionType = FROM_FILE or distributionType = FROM_FILE_AND_USER_DEFINED.
fieldVariableNum (Optional[int], default: None) – An Int specifying the field variable number.
field (str, default: '') – 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.
amplitude (str, default: UNSET) – 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.
fileName (str, default: '') – A String specifying the name of the file from which the Field values are to be read when distributionType = FROM_FILE or distributionType = FROM_FILE_AND_USER_DEFINED.
beginStep (Optional[SymbolicConstant], default: None) – An Int specifying the first step from which Field 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.
beginIncrement (Optional[SymbolicConstant], default: 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.
endStep (Optional[SymbolicConstant], default: None) – An Int specifying the last step from which Field 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.
endIncrement (Optional[SymbolicConstant], default: 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.
interpolate (SymbolicConstant, default: OFF) – 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.
magnitudes (str, default: '') – A Sequence of Doubles specifying the Field 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, magnitudes is a Double specifying the Field. - If crossSectionDistribution = GRADIENTS_THROUGH_SHELL_CS, magnitudes is a sequence of Doubles specifying the mean value and the gradient in the thickness direction. - If crossSectionDistribution = GRADIENTS_THROUGH_BEAM_CS, 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, magnitudes is a sequence of Doubles specifying the Field at each point.

FieldState#

class FieldState[source]#

The FieldState object stores the propagating data of a field in a step. One instance of this object is created internally by the Field object for each step. The FieldState object has no constructor or methods. The FieldState object is derived from the PredefinedFieldState object.

Note

This object can be accessed by:

import load
mdb.models[name].steps[name].predefinedFieldStates[name]

New in version 2018: The FieldState class was added.

Note

Check FieldState on help.3ds.com/0.1..

Public Data Attributes:

`outputVariable`	A String specifying the scalar nodal output variable that will be read from an output database and used to initialize a specified predefined field.
`fileNameState`	A SymbolicConstant specifying the propagation state of the fileName member.
`beginStep`	A SymbolicConstant or an Int specifying the first step from which field values are to be read.
`beginStepState`	A SymbolicConstant specifying the propagation state of the beginStep member.
`beginIncrement`	None or an Int specifying the first increment of the step set in beginStep or the SymbolicConstants STEP_START or STEP_END.
`beginIncrementState`	A SymbolicConstant specifying the propagation state of the beginIncrement member.
`endStep`	None or an Int specifying the last step from which field values are to be read or the SymbolicConstants FIRST_STEP and LAST_STEP.
`endStepState`	A SymbolicConstant specifying the propagation state of the endStep member.
`endIncrement`	None or an Int specifying the last increment of the step set in endStep or the SymbolicConstants STEP_START and STEP_END.
`endIncrementState`	A SymbolicConstant specifying the propagation state of the endIncrement member.
`amplitudeState`	A SymbolicConstant specifying the propagation state of the amplitudeState member.
`fileName`	A String specifying the name of the file from which the field values are to be read when distributionType = FROM_FILE or distributionType = FROM_FILE_AND_USER_DEFINED.
`amplitude`	The SymbolicConstant UNSET or a String specifying the name of the amplitude reference.
`magnitudesState`	A tuple of SymbolicConstants specifying the propagation state of each item of the magnitudes member.
`magnitudes`	A tuple of Floats specifying the field values when distributionType = UNIFORM or distributionType = FIELD.
`status`	A SymbolicConstant specifying the propagation state of the PredefinedFieldState object.

Inherited from PredefinedFieldState

status

A SymbolicConstant specifying the propagation state of the PredefinedFieldState object.

amplitude: SymbolicConstant = UNSET[source]#: The SymbolicConstant UNSET or a String specifying the name of the amplitude reference. The SymbolicConstant 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.

amplitudeState: Optional[SymbolicConstant] = None[source]#: A SymbolicConstant specifying the propagation state of the amplitudeState member. Possible values are UNSET, SET, and UNCHANGED.

beginIncrement: Optional[SymbolicConstant] = None[source]#: None or 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.

beginIncrementState: Optional[SymbolicConstant] = None[source]#: A SymbolicConstant specifying the propagation state of the beginIncrement member. Possible values are UNSET, SET, and UNCHANGED.

beginStep: SymbolicConstant = NONE[source]#: A SymbolicConstant or an Int specifying the first step from which field values are to be read. This argument is valid only when distribution = FROM_FILE or distribution = FROM_FILE_AND_USER_DEFINED. Possible values are FIRST_STEP, LAST_STEP, and NONE. The default value is NONE.

beginStepState: Optional[SymbolicConstant] = None[source]#: A SymbolicConstant specifying the propagation state of the beginStep member. Possible values are UNSET, SET, and UNCHANGED.

endIncrement: Optional[SymbolicConstant] = None[source]#: None or 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.

endIncrementState: Optional[SymbolicConstant] = None[source]#: A SymbolicConstant specifying the propagation state of the endIncrement member. Possible values are UNSET, SET, and UNCHANGED.

endStep: Optional[SymbolicConstant] = None[source]#: None or an Int specifying the last step from which field 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.

endStepState: Optional[SymbolicConstant] = None[source]#: A SymbolicConstant specifying the propagation state of the endStep member. Possible values are UNSET, SET, and UNCHANGED.

fileName: str = ''[source]#: A String specifying the name of the file from which the field values are to be read when distributionType = FROM_FILE or distributionType = FROM_FILE_AND_USER_DEFINED.

fileNameState: Optional[SymbolicConstant] = None[source]#: A SymbolicConstant specifying the propagation state of the fileName member. Possible values are UNSET, SET, and UNCHANGED.

magnitudes: tuple = ()[source]#

A tuple of Floats specifying the field values when distributionType = UNIFORM or distributionType = 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, magnitudes is a Double specifying the field.
If crossSectionDistribution = GRADIENTS_THROUGH_SHELL_CS, magnitudes is a sequence of Doubles specifying the mean value and the gradient in the thickness direction.
If crossSectionDistribution = GRADIENTS_THROUGH_BEAM_CS, 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, magnitudes is a sequence of Doubles specifying the field at each point.

magnitudesState: Optional[SymbolicConstant] = None[source]#: A tuple of SymbolicConstants specifying the propagation state of each item of the magnitudes member. Possible values are UNSET, SET, and UNCHANGED.

outputVariable: str = ''[source]#: A String specifying the scalar nodal output variable that will be read from an output database and used to initialize a specified predefined field. This argument is a required argument if distributionType = FROM_FILE or distributionType = FROM_FILE_AND_USER_DEFINED.

status: Optional[SymbolicConstant] = None[source]#

A SymbolicConstant specifying the propagation state of the PredefinedFieldState object. Possible values are:

NOT_YET_ACTIVE
CREATED
PROPAGATED
MODIFIED
DEACTIVATED
DEACTIVATED_TO_INITIAL
NO_LONGER_ACTIVE
RESET_TO_INITIAL
TO_BE_COMPUTED
PROPAGATED_FROM_COMPUTED
BUILT_INTO_BASE_STATE
TYPE_NOT_APPLICABLE
INSTANCE_NOT_APPLICABLE

This member exists in all PredefinedFieldState objects, but different predefined fields use different subsets of the entire list of possible values depending on propagation rules.

PredefinedField#

class PredefinedField[source]#

The PredefinedField object is the base object for the objects in the predefined field repository. The methods and members of the PredefinedField object are common to all objects derived from PredefinedField. An instance of any PredefinedField object can be obtained through the predefined field repository of the Model object. An instance of any PredefinedFieldState object can be obtained through the predefined field repository of the Step object.

Note

This object can be accessed by:

import load
mdb.models[name].predefinedFields[name]

Note

Check PredefinedField on help.3ds.com/0.1..

Public Data Attributes:

`name`	A String specifying the repository key.
`region`	A `Region` object specifying the region to which the predefined field is applied.
`fieldList`	An IMAField for MaterialAssignment predefined field。

Public Methods:

`move`(fromStepName, toStepName)	This method moves a specific PredefinedFieldState object from one step to a different step.
`resume`()	This method resumes the predefined field that was previously suppressed.
`suppress`()	This method suppresses the predefined field.
`delete`(indices)	This method allows you to delete existing fields.

delete(indices)[source]#

This method allows you to delete existing fields.

Note

Check PredefinedField.delete on help.3ds.com/0.1..

Parameters:: indices (tuple) – A sequence of Ints specifying the index of each field to delete.

fieldList: IMAField = <abaqus.PredefinedField.IMAField.IMAField object>[source]#: An IMAField for MaterialAssignment predefined field。

move(fromStepName, toStepName)[source]#

This method moves a specific PredefinedFieldState object from one step to a different step.

Note

Check PredefinedField.move on help.3ds.com/0.1..

Parameters:

fromStepName (str) – A String specifying the name of the step from which the PredefinedFieldState object is moved.
toStepName (str) – A String specifying the name of the step to which the PredefinedFieldState object is moved.

Raises:

TextError –

name: str = ''[source]#: A String specifying the repository key.

region: Region = <abaqus.Region.Region.Region object>[source]#: 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.

resume()[source]#: This method resumes the predefined field that was previously suppressed.

suppress()[source]#: This method suppresses the predefined field.

PredefinedFieldState#

class PredefinedFieldState[source]#

The PredefinedFieldState object is the base object for the objects in the predefinedFieldState repository of the Step object. The members of the PredefinedFieldState object are common to all objects derived from PredefinedFieldState. The PredefinedFieldState object has no constructor or methods.

Note

This object can be accessed by:

import load
mdb.models[name].steps[name].predefinedFieldStates[name]

Note

Check PredefinedFieldState on help.3ds.com/0.1..

Public Data Attributes:

status

A SymbolicConstant specifying the propagation state of the PredefinedFieldState object.

status: Optional[SymbolicConstant] = None[source]#

A SymbolicConstant specifying the propagation state of the PredefinedFieldState object. Possible values are:

NOT_YET_ACTIVE
CREATED
PROPAGATED
MODIFIED
DEACTIVATED
DEACTIVATED_TO_INITIAL
NO_LONGER_ACTIVE
RESET_TO_INITIAL
TO_BE_COMPUTED
PROPAGATED_FROM_COMPUTED
BUILT_INTO_BASE_STATE
TYPE_NOT_APPLICABLE
INSTANCE_NOT_APPLICABLE

This member exists in all PredefinedFieldState objects, but different predefined fields use different subsets of the entire list of possible values depending on propagation rules.

FluidCavityPressure#

class FluidCavityPressure(name, fluidCavity, fluidPressure)[source]#

The FluidCavityPressure object stores the data for initial fluid cavity pressures. The base class region argument can not be specifed with this object. The FluidCavityPressure object is derived from the PredefinedField object.

Note

This object can be accessed by:

import load
mdb.models[name].predefinedFields[name]

The corresponding analysis keywords are:

INITIAL CONDITIONS

Note

Check FluidCavityPressure on help.3ds.com/0.1..

Public Data Attributes:

region

A Region object on which the fluidCavity interaction is specified.

Inherited from PredefinedField

`name`	A String specifying the repository key.
`region`	A `Region` object on which the fluidCavity interaction is specified.
`fieldList`	An IMAField for MaterialAssignment predefined field。

Public Methods:

`__init__`(name, fluidCavity, fluidPressure)	This method creates a FluidCavityPressure object.
`setValues`(args, *kwargs)	This method modifies the FluidCavityPressure object.

Inherited from PredefinedField

`move`(fromStepName, toStepName)	This method moves a specific PredefinedFieldState object from one step to a different step.
`resume`()	This method resumes the predefined field that was previously suppressed.
`suppress`()	This method suppresses the predefined field.
`delete`(indices)	This method allows you to delete existing fields.

fluidCavity: str[source]#: A String specifying the name of a Fluid Cavity Interaction.

fluidPressure: float[source]#: A Float specifying the initial fluid pressure.

region: Region = <abaqus.Region.Region.Region object>[source]#: A Region object on which the fluidCavity interaction is specified.

setValues(*args, **kwargs)[source]#: This method modifies the FluidCavityPressure object.

IMAField#

class IMAField[source]#

A IMAField is an object used to define material instance name volume fractions for the MaterialAssignment predefined field.

Note

This object can be accessed by:

import load
mdb.models[name].predefinedFields[name].fieldList

Note

Check IMAField on help.3ds.com/0.1..

Public Data Attributes:

`region`	A `Region` object specifying the sub-region of the selected part instance to which the volume fractions will be applied.
`discFieldList`	A tuple of Strings specifying the name of the discrete fields that contain the volume fraction data.

discFieldList: tuple = ()[source]#: A tuple of Strings specifying the name of the discrete fields that contain the volume fraction data. The length of the tuple corresponds to the number of material instance names, as established by the assigned Eulerian section.

region: Region = <abaqus.Region.Region.Region object>[source]#: A Region object specifying the sub-region of the selected part instance to which the volume fractions will be applied.

IMARegion#

class IMARegion[source]#

A IMARegion is an object used to define material instance name volume fractions for the MaterialAssignment predefined field.

Note

This object can be accessed by:

import load
mdb.models[name].predefinedFields[name].assignmentList

Note

Check IMARegion on help.3ds.com/0.1..

Public Data Attributes:

`region`	A `Region` object specifying the sub-region of the selected part instance to which the volume fractions will be applied.
`fractionList`	A tuple of Floats specifying the volume fractions, per material instance name.

fractionList: Optional[float] = None[source]#: A tuple of Floats specifying the volume fractions, per material instance name. The length of the tuple corresponds to the number of material instance names, as established by the assigned Eulerian section.

region: Region = <abaqus.Region.Region.Region object>[source]#: A Region object specifying the sub-region of the selected part instance to which the volume fractions will be applied.

InitialState#

class InitialState(name, instances, fileName, endStep=abaqusConstants.LAST_STEP, endIncrement=abaqusConstants.STEP_END, updateReferenceConfiguration=OFF)[source]#

The InitialState object stores the data for an initial state predefined field. The InitialState object is derived from the PredefinedField object.

Note

This object can be accessed by:

import load
mdb.models[name].predefinedFields[name]

The corresponding analysis keywords are:

INSTANCE

Note

Check InitialState on help.3ds.com/0.1..

Public Data Attributes:

`endStep`	The SymbolicConstant LAST_STEP or an Int specifying the step from which the initial state values are to be read or the SymbolicConstant LAST_STEP.
`endIncrement`	The SymbolicConstant STEP_END or an Int specifying the increment, interval or iteration of the step set in endStep or the SymbolicConstant STEP_END.
`updateReferenceConfiguration`	A Boolean specifying whether to update the reference configuration based on the import data.

Inherited from PredefinedField

`name`	A String specifying the repository key.
`region`	A `Region` object specifying the region to which the predefined field is applied.
`fieldList`	An IMAField for MaterialAssignment predefined field。

Public Methods:

`__init__`(name, instances, fileName[, ...])	This method creates an InitialState predefined field object.
`setValues`([endStep, endIncrement, ...])	This method modifies the InitialState object.

Inherited from PredefinedField

`move`(fromStepName, toStepName)	This method moves a specific PredefinedFieldState object from one step to a different step.
`resume`()	This method resumes the predefined field that was previously suppressed.
`suppress`()	This method suppresses the predefined field.
`delete`(indices)	This method allows you to delete existing fields.

endIncrement: SymbolicConstant = STEP_END[source]#: The SymbolicConstant STEP_END or an Int specifying the increment, interval or iteration of the step set in endStep or the SymbolicConstant STEP_END. The default value is STEP_END.

endStep: SymbolicConstant = LAST_STEP[source]#: The SymbolicConstant LAST_STEP or an Int specifying the step from which the initial state values are to be read or the SymbolicConstant LAST_STEP. The default value is LAST_STEP.

fileName: str[source]#: A String specifying the name of the job that generated the initial state data.

instances: List[PartInstance][source]#: A PartInstanceArray object specifying the instances to which the predefined field is applied.

setValues(endStep=abaqusConstants.LAST_STEP, endIncrement=abaqusConstants.STEP_END, updateReferenceConfiguration=OFF)[source]#

This method modifies the InitialState object.

Note

Check InitialState.setValues on help.3ds.com/0.1..

Parameters:

endStep (SymbolicConstant, default: LAST_STEP) – The SymbolicConstant LAST_STEP or an Int specifying the step from which the initial state values are to be read or the SymbolicConstant LAST_STEP. The default value is LAST_STEP.
endIncrement (SymbolicConstant, default: STEP_END) – The SymbolicConstant STEP_END or an Int specifying the increment, interval or iteration of the step set in endStep or the SymbolicConstant STEP_END. The default value is STEP_END.
updateReferenceConfiguration (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to update the reference configuration based on the import data. The default value is OFF.

updateReferenceConfiguration: Union[AbaqusBoolean, bool] = OFF[source]#: A Boolean specifying whether to update the reference configuration based on the import data. The default value is OFF.

KinematicHardening#

class KinematicHardening(name, region, numBackStress=1, equivPlasticStrain=(), backStress=(), sectPtNum=(), definition=abaqusConstants.KINEMATIC_HARDENING, rebarLayerNames=(), distributionType=abaqusConstants.MAGNITUDE)[source]#

The KinematicHardening object stores the data for initial equivalent Plastic strains and, if relevant, the initial backstress tensor. The KinematicHardening object is derived from the PredefinedField object.

Note

This object can be accessed by:

import load
mdb.models[name].predefinedFields[name]

The corresponding analysis keywords are:

INITIAL CONDITIONS

Note

Check KinematicHardening on help.3ds.com/0.1..

Public Data Attributes:

`field`	A String specifying the name of the AnalyticalField object associated with this predefined field.
`numBackStress`	An Int specifying the number of backstresses.
`equivPlasticStrain`	A sequence of Floats specifying the initial equivalent Plastic strain.
`backStress`	A sequence of sequences of Floats specifying the initial backstress tensor for kinematic hardening models.
`sectPtNum`	A sequence of Ints specifying section point numbers.
`definition`	A SymbolicConstant specifying different types of kinematic hardening.
`rebarLayerNames`	A sequence of Strings specifying rebar layer names.
`distributionType`	A SymbolicConstant specifying whether the load is uniform.

Inherited from PredefinedField

`name`	A String specifying the repository key.
`region`	A `Region` object specifying the region to which the predefined field is applied.
`fieldList`	An IMAField for MaterialAssignment predefined field。

Public Methods:

`__init__`(name, region[, numBackStress, ...])	This method creates a KinematicHardening object.
`setValues`([numBackStress, ...])	This method modifies the KinematicHardening object.

Inherited from PredefinedField

`move`(fromStepName, toStepName)	This method moves a specific PredefinedFieldState object from one step to a different step.
`resume`()	This method resumes the predefined field that was previously suppressed.
`suppress`()	This method suppresses the predefined field.
`delete`(indices)	This method allows you to delete existing fields.

backStress: tuple = ()[source]#: A sequence of sequences of Floats specifying the initial backstress tensor for kinematic hardening models. The default value is an empty sequence.

definition: SymbolicConstant = KINEMATIC_HARDENING[source]#: A SymbolicConstant specifying different types of kinematic hardening. Possible values are KINEMATIC_HARDENING, CRUSHABLE_FOAM, REBAR, SECTION_PTS, and USER_DEFINED. The default value is KINEMATIC_HARDENING.

distributionType: SymbolicConstant = MAGNITUDE[source]#: A SymbolicConstant specifying whether the load is uniform. Possible values are MAGNITUDE and ANALYTICAL_FIELD. The default value is MAGNITUDE.

equivPlasticStrain: tuple = ()[source]#: A sequence of Floats specifying the initial equivalent Plastic strain.

field: str = ''[source]#: A String specifying the name of the AnalyticalField object associated with this predefined field. The field argument applies only when distributionType = ANALYTICAL_FIELD. The default value is an empty string.

numBackStress: int = 1[source]#: An Int specifying the number of backstresses. The default value is 1.

rebarLayerNames: tuple = ()[source]#: A sequence of Strings specifying rebar layer names. This argument is valid only when definition = REBAR.

sectPtNum: tuple = ()[source]#: A sequence of Ints specifying section point numbers. This argument is valid only when definition = SECTION_PTS.

setValues(numBackStress=1, equivPlasticStrain=(), backStress=(), sectPtNum=(), definition=abaqusConstants.KINEMATIC_HARDENING, rebarLayerNames=(), distributionType=abaqusConstants.MAGNITUDE)[source]#

This method modifies the KinematicHardening object.

Note

Check KinematicHardening.setValues on help.3ds.com/0.1..

Parameters:

numBackStress (int, default: 1) – An Int specifying the number of backstresses. The default value is 1.
equivPlasticStrain (tuple, default: ()) – A sequence of Floats specifying the initial equivalent Plastic strain.
backStress (tuple, default: ()) – A sequence of sequences of Floats specifying the initial backstress tensor for kinematic hardening models. The default value is an empty sequence.
sectPtNum (tuple, default: ()) – A sequence of Ints specifying section point numbers. This argument is valid only when definition = SECTION_PTS.
definition (SymbolicConstant, default: KINEMATIC_HARDENING) – A SymbolicConstant specifying different types of kinematic hardening. Possible values are KINEMATIC_HARDENING, CRUSHABLE_FOAM, REBAR, SECTION_PTS, and USER_DEFINED. The default value is KINEMATIC_HARDENING.
rebarLayerNames (tuple, default: ()) – A sequence of Strings specifying rebar layer names. This argument is valid only when definition = REBAR.
distributionType (SymbolicConstant, default: MAGNITUDE) – A SymbolicConstant specifying whether the load is uniform. Possible values are MAGNITUDE and ANALYTICAL_FIELD. The default value is MAGNITUDE.

MaterialAssignment#

class MaterialAssignment(name, instanceList, useFields=OFF, assignmentList=(), fieldList=(), colorList=())[source]#

The MaterialAssignment object stores the data for an initial material assignment predefined field, for use with an Eulerian analysis. The MaterialAssignment object is derived from the PredefinedField object.

Note

This object can be accessed by:

import load
mdb.models[name].predefinedFields[name]

The corresponding analysis keywords are:

INITIAL CONDITIONS

Note

Check MaterialAssignment on help.3ds.com/0.1..

Public Data Attributes:

`region`	A `Region` object specifying the region to which the predefined field is applied.
`useFields`	A Boolean specifying whether the volume fraction data will be uniform or defined by discrete fields.
`assignmentList`	A sequence of tuples specifying the uniform volume fractions to be assigned.
`fieldList`	A sequence of tuples specifying the discrete volume fractions to be assigned.
`colorList`	A sequence of three Ints specifying colors used to display the material instance assignments.

Inherited from PredefinedField

`name`	A String specifying the repository key.
`region`	A `Region` object specifying the region to which the predefined field is applied.
`fieldList`	A sequence of tuples specifying the discrete volume fractions to be assigned.

Public Methods:

`__init__`(name, instanceList[, useFields, ...])	This method creates a MaterialAssignment predefined field object.
`setValues`([useFields, assignmentList, ...])	This method modifies the MaterialAssignment object.

Inherited from PredefinedField

`move`(fromStepName, toStepName)	This method moves a specific PredefinedFieldState object from one step to a different step.
`resume`()	This method resumes the predefined field that was previously suppressed.
`suppress`()	This method suppresses the predefined field.
`delete`(indices)	This method allows you to delete existing fields.

assignmentList: tuple = ()[source]#: A sequence of tuples specifying the uniform volume fractions to be assigned. This argument is valid only when useFields = FALSE. Each tuple contains two entries:A Region object.A tuple of Floats specifying the uniform volume fraction values. The length of the tuple must match the number of material instance names specified in the Eulerain section assigned to part instances specified by instanceList.

colorList: tuple = ()[source]#: A sequence of three Ints specifying colors used to display the material instance assignments. This is a sequence of R,G,B colors, where the values are represented by integers between 0 and 255. The default value is an empty sequence.

fieldList: tuple = ()[source]#: A sequence of tuples specifying the discrete volume fractions to be assigned. This argument is valid only when useFields = TRUE. Each tuple contains two entries:A Region object.A tuple of Strings specifying Discrete Field names. The length of the tuple must match the number of material instance names specified in the Eulerain section assigned to part instances specified by instanceList.

instanceList: List[PartInstance][source]#: A PartInstanceArray object specifying the part instances to which the predefined field is applied. All instances must be assigned the same Eulerian section.

region: Region = <abaqus.Region.Region.Region object>[source]#: A Region object specifying the region to which the predefined field is applied.

setValues(useFields=OFF, assignmentList=(), fieldList=(), colorList=())[source]#

This method modifies the MaterialAssignment object.

Note

Check MaterialAssignment.setValues on help.3ds.com/0.1..

Parameters:

useFields (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the volume fraction data will be uniform or defined by discrete fields. The default value is OFF.
assignmentList (tuple, default: ()) – A sequence of tuples specifying the uniform volume fractions to be assigned. This argument is valid only when useFields = FALSE. Each tuple contains two entries:A Region object.A tuple of Floats specifying the uniform volume fraction values. The length of the tuple must match the number of material instance names specified in the Eulerain section assigned to part instances specified by instanceList.
fieldList (tuple, default: ()) – A sequence of tuples specifying the discrete volume fractions to be assigned. This argument is valid only when useFields = TRUE. Each tuple contains two entries:A Region object.A tuple of Strings specifying Discrete Field names. The length of the tuple must match the number of material instance names specified in the Eulerain section assigned to part instances specified by instanceList.
colorList (tuple, default: ()) – A sequence of three Ints specifying colors used to display the material instance assignments. This is a sequence of R,G,B colors, where the values are represented by integers between 0 and 255. The default value is an empty sequence.

useFields: Union[AbaqusBoolean, bool] = OFF[source]#: A Boolean specifying whether the volume fraction data will be uniform or defined by discrete fields. The default value is OFF.

Temperature#

class Temperature(name, createStepName, region, distributionType=abaqusConstants.UNIFORM, crossSectionDistribution=abaqusConstants.CONSTANT_THROUGH_THICKNESS, field='', amplitude=abaqusConstants.UNSET, fileName='', beginStep=None, beginIncrement=None, endStep=None, endIncrement=None, interpolate=OFF, magnitudes='', absoluteExteriorTolerance=0, exteriorTolerance=0)[source]#

The Temperature object stores the data for temperature predefined fields. The Temperature object is derived from the PredefinedField object.

Note

This object can be accessed by:

import load
mdb.models[name].predefinedFields[name]

The corresponding analysis keywords are:

INITIAL CONDITIONS
TEMPERATURE

Note

Check Temperature on help.3ds.com/0.1..

Public Data Attributes:

`name`	A String specifying the repository key.
`distributionType`	A SymbolicConstant specifying how the predefined field varies spatially.
`field`	A String specifying the name of the AnalyticalField or DiscreteField object associated with this predefined field.
`region`	A `Region` object specifying the region to which the predefined field is applied.

Inherited from PredefinedField

`name`	A String specifying the repository key.
`region`	A `Region` object specifying the region to which the predefined field is applied.
`fieldList`	An IMAField for MaterialAssignment predefined field。

Public Methods:

`__init__`(name, createStepName, region[, ...])	This method creates a Temperature object.
`move`(fromStepName, toStepName)	This method moves the TemperatureState object from one step to a different step.
`setValues`([distributionType, ...])	This method modifies the data for an existing Temperature object in the step where it is created.
`setValuesInStep`(stepName[, field, ...])	This method modifies the propagating data for an existing Temperature object in the specified step.

Inherited from PredefinedField

`move`(fromStepName, toStepName)	This method moves the TemperatureState object from one step to a different step.
`resume`()	This method resumes the predefined field that was previously suppressed.
`suppress`()	This method suppresses the predefined field.
`delete`(indices)	This method allows you to delete existing fields.

distributionType: SymbolicConstant = UNIFORM[source]#: 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.

field: str = ''[source]#: 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.

move(fromStepName, toStepName)[source]#

This method moves the TemperatureState object from one step to a different step.

Note

Check Temperature.move on help.3ds.com/0.1..

Parameters:

fromStepName (str) – A String specifying the name of the step from which the PredefinedFieldState is moved.
toStepName (str) – A String specifying the name of the step to which the PredefinedFieldState is moved.

Raises:

TextError –

name: str = ''[source]#: A String specifying the repository key.

region: Region = <abaqus.Region.Region.Region object>[source]#: 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.

setValues(distributionType=abaqusConstants.UNIFORM, crossSectionDistribution=abaqusConstants.CONSTANT_THROUGH_THICKNESS, field='', amplitude=abaqusConstants.UNSET, fileName='', beginStep=None, beginIncrement=None, endStep=None, endIncrement=None, interpolate=OFF, magnitudes='', absoluteExteriorTolerance=0, exteriorTolerance=0)[source]#

This method modifies the data for an existing Temperature object in the step where it is created.

Note

Check Temperature.setValues on help.3ds.com/0.1..

Parameters:

distributionType (SymbolicConstant, default: UNIFORM) – 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.
crossSectionDistribution (SymbolicConstant, default: CONSTANT_THROUGH_THICKNESS) –
A SymbolicConstant specifying how the predefined field is distributed over the cross section of the region. Possible values are
- CONSTANT_THROUGH_THICKNESS
- GRADIENTS_THROUGH_SHELL_CS
- GRADIENTS_THROUGH_BEAM_CS
- POINTS_THROUGH_SECTION
The default value is CONSTANT_THROUGH_THICKNESS.
field (str, default: '') – 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.
amplitude (str, default: UNSET) – 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.
fileName (str, default: '') – 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.
beginStep (Optional[SymbolicConstant], default: None) – 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.
beginIncrement (Optional[SymbolicConstant], default: 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.
endStep (Optional[SymbolicConstant], default: 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.
endIncrement (Optional[SymbolicConstant], default: 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.
interpolate (SymbolicConstant, default: OFF) – 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.
magnitudes (str, default: '') –
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.
absoluteExteriorTolerance (float, default: 0) – 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.
exteriorTolerance (float, default: 0) – 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.

setValuesInStep(stepName, field='', amplitude=abaqusConstants.UNSET, fileName='', beginStep=None, beginIncrement=None, endStep=None, endIncrement=None, interpolate=OFF, magnitudes='', absoluteExteriorTolerance=0, exteriorTolerance=0)[source]#

This method modifies the propagating data for an existing Temperature object in the specified step.

Note

Check Temperature.setValuesInStep on help.3ds.com/0.1..

Parameters:

stepName (str) – A String specifying the name of the step in which the predefined field is modified.
field (str, default: '') – 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.
amplitude (str, default: UNSET) – 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.
fileName (str, default: '') – 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.
beginStep (Optional[SymbolicConstant], default: None) – 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.
beginIncrement (Optional[SymbolicConstant], default: 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.
endStep (Optional[SymbolicConstant], default: 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.
endIncrement (Optional[SymbolicConstant], default: 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.
interpolate (SymbolicConstant, default: OFF) – 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.
magnitudes (str, default: '') –
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.
absoluteExteriorTolerance (float, default: 0) – 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.
exteriorTolerance (float, default: 0) – 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.

TemperatureState#

class TemperatureState[source]#

The TemperatureState object stores the propagating data of a temperature in a step. One instance of this object is created internally by the Temperature object for each step. The TemperatureState object has no constructor or methods. The TemperatureState object is derived from the PredefinedFieldState object.

Note

This object can be accessed by:

import load
mdb.models[name].steps[name].predefinedFieldStates[name]

Note

Check TemperatureState on help.3ds.com/0.1..

Public Data Attributes:

`fileNameState`	A SymbolicConstant specifying the propagation state of the fileName member.
`beginStep`	A SymbolicConstant or an Int specifying the first step from which temperature values are to be read.
`beginStepState`	A SymbolicConstant specifying the propagation state of the beginStep member.
`beginIncrement`	None or an Int specifying the first increment of the step set in beginStep or the SymbolicConstants STEP_START or STEP_END.
`beginIncrementState`	A SymbolicConstant specifying the propagation state of the beginIncrement member.
`endStep`	None or an Int specifying the last step from which temperature values are to be read or the SymbolicConstants FIRST_STEP and LAST_STEP.
`endStepState`	A SymbolicConstant specifying the propagation state of the endStep member.
`endIncrement`	None or an Int specifying the last increment of the step set in endStep or the SymbolicConstants STEP_START and STEP_END.
`endIncrementState`	A SymbolicConstant specifying the propagation state of the endIncrement member.
`midside`	A Boolean specifying that temperatures in second-order elements are to be interpolated from corner node temperatures.
`midsideState`	A SymbolicConstant specifying the propagation state of the midside member.
`amplitudeState`	A SymbolicConstant specifying the propagation state of the amplitudeState member.
`fileName`	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.
`amplitude`	The SymbolicConstant UNSET or a String specifying the name of the amplitude reference.
`magnitudesState`	A tuple of SymbolicConstants specifying the propagation state of each item of the magnitudes member.
`magnitudes`	A tuple of Floats specifying the temperature values when distributionType = UNIFORM or distributionType = FIELD.
`status`	A SymbolicConstant specifying the propagation state of the PredefinedFieldState object.

Inherited from PredefinedFieldState

status

A SymbolicConstant specifying the propagation state of the PredefinedFieldState object.

amplitude: SymbolicConstant = UNSET[source]#: The SymbolicConstant UNSET or a String specifying the name of the amplitude reference. The SymbolicConstant 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.

amplitudeState: Optional[SymbolicConstant] = None[source]#: A SymbolicConstant specifying the propagation state of the amplitudeState member. Possible values are UNSET, SET, and UNCHANGED.

beginIncrement: Optional[SymbolicConstant] = None[source]#: None or 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.

beginIncrementState: Optional[SymbolicConstant] = None[source]#: A SymbolicConstant specifying the propagation state of the beginIncrement member. Possible values are UNSET, SET, and UNCHANGED.

beginStep: SymbolicConstant = NONE[source]#: A SymbolicConstant or an Int specifying the first step from which temperature values are to be read. This argument is valid only when distribution = FROM_FILE or distribution = FROM_FILE_AND_USER_DEFINED. Possible values are FIRST_STEP, LAST_STEP, and NONE. The default value is NONE.

beginStepState: Optional[SymbolicConstant] = None[source]#: A SymbolicConstant specifying the propagation state of the beginStep member. Possible values are UNSET, SET, and UNCHANGED.

endIncrement: Optional[SymbolicConstant] = None[source]#: None or 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.

endIncrementState: Optional[SymbolicConstant] = None[source]#: A SymbolicConstant specifying the propagation state of the endIncrement member. Possible values are UNSET, SET, and UNCHANGED.

endStep: Optional[SymbolicConstant] = None[source]#: None or 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.

endStepState: Optional[SymbolicConstant] = None[source]#: A SymbolicConstant specifying the propagation state of the endStep member. Possible values are UNSET, SET, and UNCHANGED.

fileName: str = ''[source]#: 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.

fileNameState: Optional[SymbolicConstant] = None[source]#: A SymbolicConstant specifying the propagation state of the fileName member. Possible values are UNSET, SET, and UNCHANGED.

magnitudes: tuple = ()[source]#: A tuple of Floats specifying the temperature values when distributionType = UNIFORM or distributionType = 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.

magnitudesState: Optional[SymbolicConstant] = None[source]#: A tuple of SymbolicConstants specifying the propagation state of each item of the magnitudes member. Possible values are UNSET, SET, and UNCHANGED.

midside: Union[AbaqusBoolean, bool] = OFF[source]#: A Boolean specifying that temperatures in second-order elements are to be interpolated from corner node temperatures. This argument is valid only when distributionType = FROM_FILE or distributionType = FROM_FILE_AND_USER_DEFINED.

midsideState: Optional[SymbolicConstant] = None[source]#: A SymbolicConstant specifying the propagation state of the midside member. Possible values are UNSET, SET, and UNCHANGED.

status: Optional[SymbolicConstant] = None[source]#

A SymbolicConstant specifying the propagation state of the PredefinedFieldState object. Possible values are:

NOT_YET_ACTIVE
CREATED
PROPAGATED
MODIFIED
DEACTIVATED
DEACTIVATED_TO_INITIAL
NO_LONGER_ACTIVE
RESET_TO_INITIAL
TO_BE_COMPUTED
PROPAGATED_FROM_COMPUTED
BUILT_INTO_BASE_STATE
TYPE_NOT_APPLICABLE
INSTANCE_NOT_APPLICABLE

This member exists in all PredefinedFieldState objects, but different predefined fields use different subsets of the entire list of possible values depending on propagation rules.

TiffOptions#

class TiffOptions[source]#

The TiffOptions object stores the settings that Abaqus uses when printing in TIFF format. The TiffOptions object has no constructor. Abaqus creates the tiffOptions member when a session is started.

Note

This object can be accessed by:

session.tiffOptions

Note

Check TiffOptions on help.3ds.com/0.1..

Public Methods:

setValues([imageSize])

This method modifies the TiffOptions object.

setValues(imageSize=abaqusConstants.SIZE_ON_SCREEN)[source]#

This method modifies the TiffOptions object.

Note

Check TiffOptions.setValues on help.3ds.com/0.1..

Parameters:

imageSize (SymbolicConstant, default: SIZE_ON_SCREEN) – The SymbolicConstant SIZE_ON_SCREEN or a pair of Ints specifying the width and height of the image in pixels. Possible values are (minWidth, minHeight) ≤ imageSize ≤ (maxWidth and maxHeight). The default value is SIZE_ON_SCREEN. Note:The minimum value of width and height (minWidth and minHeight ) is the number of pixels that occupy 10 mm at the current screen resolution. The value is typically around 50 pixels and may be different for width and height. The maximum value of width and height (maxWidth and maxHeight ) is the largest number of pixels supported by the system graphics and will be at least as large as the screen dimensions.

Raises:

RangeError – If either the width or height arguments of imageSize are out of range (where minWidth and minHeight are the number of pixels corresponding to approximately 10 mm for a given display and maxWidth and maxHeight are the largest allowable number of pixels supported by the system graphics).
RangeError – (minWidth, minHeight) <= (width, height) <= (maxWidth, maxHeight).

Velocity#

class Velocity(name, region, velocity1, velocity2, velocity3, omega, axisBegin, axisEnd, field='', distributionType=abaqusConstants.MAGNITUDE)[source]#

The Velocity object stores the data for an initial velocity predefined field. The Velocity object is derived from the PredefinedField object.

Note

This object can be accessed by:

import load
mdb.models[name].predefinedFields[name]

The corresponding analysis keywords are:

INITIAL CONDITIONS

Note

Check Velocity on help.3ds.com/0.1..

Public Data Attributes:

`field`	A String specifying the name of the AnalyticalField object associated with this predefined field.
`distributionType`	A SymbolicConstant specifying whether the load is uniform.

Inherited from PredefinedField

`name`	A String specifying the repository key.
`region`	A `Region` object specifying the region to which the predefined field is applied.
`fieldList`	An IMAField for MaterialAssignment predefined field。

Public Methods:

`__init__`(name, region, velocity1, velocity2, ...)	This method creates a Velocity predefined field object.
`setValues`([field, distributionType])	This method modifies the Velocity object.

Inherited from PredefinedField

`move`(fromStepName, toStepName)	This method moves a specific PredefinedFieldState object from one step to a different step.
`resume`()	This method resumes the predefined field that was previously suppressed.
`suppress`()	This method suppresses the predefined field.
`delete`(indices)	This method allows you to delete existing fields.

axisBegin: tuple[source]#: A sequence of Floats specifying the X-, Y-, and Z- coordinates of the starting point of the axis about which omega is defined.

axisEnd: tuple[source]#: A sequence of Floats specifying the X-, Y-, and Z- coordinates of the end point of the axis about which omega is defined.

distributionType: SymbolicConstant = MAGNITUDE[source]#: A SymbolicConstant specifying whether the load is uniform. Possible values are MAGNITUDE and FIELD_ANALYTICAL. The default value is MAGNITUDE.

field: str = ''[source]#: A String specifying the name of the AnalyticalField object associated with this predefined field. The field argument applies only when distributionType = FIELD_ANALYTICAL. The default value is an empty string.

omega: float[source]#: A Float specifying the angular velocity.

setValues(field='', distributionType=abaqusConstants.MAGNITUDE)[source]#

This method modifies the Velocity object.

Note

Check Velocity.setValues on help.3ds.com/0.1..

Parameters:

field (str, default: '') – A String specifying the name of the AnalyticalField object associated with this predefined field. The field argument applies only when distributionType = FIELD_ANALYTICAL. The default value is an empty string.
distributionType (SymbolicConstant, default: MAGNITUDE) – A SymbolicConstant specifying whether the load is uniform. Possible values are MAGNITUDE and FIELD_ANALYTICAL. The default value is MAGNITUDE.

velocity1: float[source]#: A Float specifying the first component of the velocity.

velocity2: float[source]#: A Float specifying the second component of the velocity.

velocity3: float[source]#: A Float specifying the third component of the velocity.