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=NOT_SET,
modelType=STANDARD_EXPLICIT,
universalGas=None,
copyConstraints=1,
copyConnectors=1,
copyInteractions=1,
)[source]

Bases: ModelBase

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

Note

This object can be accessed by:

mdb.models[name]

Public Data Attributes:

Inherited from ModelBase

name

A String specifying the repository key.

stefanBoltzmann

None or a Float specifying the Stefan-Boltzmann constant.

absoluteZero

None or a Float specifying the absolute zero constant.

waveFormulation

A SymbolicConstant specifying the type of incident wave formulation to be used in acoustic problems.

universalGas

None or a Float specifying the universal gas constant.

noPartsInputFile

A Boolean specifying whether an input file should be written without parts and assemblies.

endRestartStep

A Boolean specifying that the step specified by restartStep should be terminated at the increment specified by restartIncrement.

shellToSolid

A Boolean specifying that a shell global model drives a solid submodel.

lastChangedCount

A Float specifying the time stamp that indicates when the model was last changed.

description

A String specifying the purpose and contents of the Model object.

restartJob

A String specifying the name of the job that generated the restart data.

restartStep

A String specifying the name of the step where the restart analysis will start.

globalJob

A String specifying the name of the job that generated the results for the global model.

copyConstraints

A boolean specifying the status of constraints created in a model, in the model which instances this model.

copyConnectors

A boolean specifying the status of connectors created in a model, in the model which instances this model.

copyInteractions

A boolean specifying the status of interactions created in a model, in the model which instances this model.

keywordBlock

A KeywordBlock object.

amplitudes

A repository of Amplitude objects.

profiles

A repository of Profile objects.

boundaryConditions

A repository of BoundaryCondition objects.

constraints

A repository of ConstrainedSketchConstraint objects.

analyticalFields

A repository of AnalyticalField objects.

discreteFields

A repository of DiscreteField objects.

predefinedFields

A repository of PredefinedField objects.

interactions

A repository of Interaction objects.

interactionProperties

A repository of InteractionProperty objects.

contactControls

A repository of ContactControl objects.

contactInitializations

A repository of ContactInitialization objects.

contactStabilizations

A repository of ContactStabilization objects.

linkedInstances

A tuple of tuples of Strings specifying the linked child PartInstance name in the current model to the corresponding parent PartInstance name in a different model.

linkedParts

A tuple of tuples of Strings specifying the linked child Part name in the current model to the corresponding parent Part name in a different model.

loads

A repository of Load objects.

materials

A repository of Material objects.

calibrations

A repository of Calibration objects.

sections

A repository of Section objects.

remeshingRules

A repository of RemeshingRule objects.

sketches

A repository of ConstrainedSketch objects.

parts

A repository of Part objects.

steps

A repository of Step objects.

featureOptions

A FeatureOptions object.

adaptiveMeshConstraints

A repository of AdaptiveMeshConstraint objects.

adaptiveMeshControls

A repository of AdaptiveMeshControl objects.

timePoints

A repository of TimePoint objects.

filters

A repository of Filter objects.

integratedOutputSections

A repository of IntegratedOutputSection objects.

fieldOutputRequests

A repository of FieldOutputRequest objects.

historyOutputRequests

A repository of HistoryOutputRequest objects.

optimizationTasks

A repository of OptimizationTask objects.

restartIncrement

An Int specifying the increment, interval, iteration or cycle where the restart analysis will start.

rootAssembly

An Assembly object.

Public Methods:

FluidCavityPressure(name, fluidCavity, ...)

This method creates a FluidCavityPressure object.

InitialState(name, instances, fileName[, ...])

This method creates an InitialState predefined field object.

KinematicHardening(name, region[, ...])

This method creates a KinematicHardening object.

MaterialAssignment(name, instanceList[, ...])

This method creates a MaterialAssignment predefined field object.

PorePressure(name, region[, ...])

This method creates a PorePressure predefined field object.

Temperature(name, createStepName, region[, ...])

This method creates a Temperature object.

Velocity(name, region, velocity1, velocity2, ...)

This method creates a Velocity predefined field object.

Saturation(name, region[, distributionType, ...])

This method creates a Saturation predefined field object.

Stress(name, region[, distributionType, ...])

This method creates a Stress predefined field object.

Field(name, createStepName, region[, ...])

This method creates a Field object.

VoidsRatio(name, region[, distributionType, ...])

This method creates a PorePressure predefined field object.

Inherited from ModelBase

__init__(name[, description, ...])

This method creates a Model object.

ModelFromInputFile(name, inputFileName)

This method creates a Model object by reading the keywords in an input file and creating the corresponding Abaqus/CAE objects.

ModelFromOdbFile(name, odbFileName)

This method creates a Model object by reading an output database and creating any corresponding Abaqus/CAE objects.

ModelFromNastranFile(modelName, inputFileName)

This method creates a Model object by reading the keywords in a Nastran bulk data file or Nastran input file and creating any corresponding Abaqus/CAE objects.

setValues([description, noPartsInputFile, ...])

This method modifies the Model object.


Member Details:

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

This method creates a Field object.

Note

This function can be accessed by:

mdb.models[name].Field

Added in version 2018: The Field method was added.

Parameters:
name

A String specifying the repository key.

createStepName

A String specifying the name of the step in which the predefined field is created.

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=''

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=None

An Int specifying the field variable number.

distributionType=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=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=''

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=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=''

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=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=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=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=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=0

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=''

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.

Returns:

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
Parameters:
name

A String specifying the repository key.

fluidCavity

A String specifying the name of a Fluid Cavity Interaction.

fluidPressure

A Float specifying the initial fluid pressure.

Returns:

A FluidCavityPressure object.

Return type:

FluidCavityPressure

InitialState(
name,
instances,
fileName,
endStep=LAST_STEP,
endIncrement=STEP_END,
updateReferenceConfiguration=0,
)[source]

This method creates an InitialState predefined field object.

Note

This function can be accessed by:

mdb.models[name].InitialState
Parameters:
name

A String specifying the repository key.

instances

A PartInstanceArray object specifying the instances to which the predefined field is applied.

fileName

A String specifying the name of the job that generated the initial state data.

endStep=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=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=0

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=KINEMATIC_HARDENING,
rebarLayerNames=(),
distributionType=MAGNITUDE,
)[source]

This method creates a KinematicHardening object.

Note

This function can be accessed by:

mdb.models[name].KinematicHardening
Parameters:
name

A String specifying the repository key.

region

A Region object specifying the region to which the predefined field is applied.

numBackStress=1

An Int specifying the number of backstresses. The default value is 1.

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. The default value is an empty sequence.

sectPtNum=()

A sequence of Ints specifying section point numbers. This argument is valid only when definition = SECTION_PTS.

definition=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=()

A sequence of Strings specifying rebar layer names. This argument is valid only when definition = REBAR.

distributionType=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=0,
assignmentList=(),
fieldList=(),
colorList=(),
)[source]

This method creates a MaterialAssignment predefined field object.

Note

This function can be accessed by:

mdb.models[name].MaterialAssignment
Parameters:
name

A String specifying the repository key.

instanceList

A PartInstanceArray object specifying the part instances to which the predefined field is applied. All instances must be assigned the same Eulerian section.

useFields=0

A Boolean specifying whether the volume fraction data will be uniform or defined by discrete fields. The default value is OFF.

assignmentList=()

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=()

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=()

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

PorePressure(
name,
region,
distributionType=UNIFORM,
porePressure1=0,
porePressure2=0,
coord1=0,
coord2=0,
pressure2Distribution=MAGNITUDE,
pressure2Field='',
variation=CONSTANT_RATIO,
fileName='',
increment=LAST_INCREMENT,
step=LAST_STEP,
interpolate=0,
)[source]

This method creates a PorePressure predefined field object.

Note

This function can be accessed by:

mdb.models[name].PorePressure
Parameters:
name

A String specifying the repository key.

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=UNIFORM

A SymbolicConstant specifying whether the load is uniform. Possible values are UNIFORM, FROM_FILE and USER_DEFINED. The default value is UNIFORM.

porePressure1=0

The initial pore pressure in the first region in your model.

porePressure2=0

The pore pressure of the second location in your model

coord1=0

Vertical position of the first location in your model for which you are specifying initial pore pressure.

coord2=0

The vertical position of the second location in your model.

pressure2Distribution=MAGNITUDE

A SymbolicConstant specifying either the magnitude of a uniform distribution for pore pressure at the second elevation or an analytical field to define a spatially varying initial pore pressure at the second elevation. Possible values are MAGNITUDE and ANALYTICAL_FIELD.

pressure2Field=''

A String specifying the name of the AnalyticalField object associated with this predefined field. The pressure2Field argument applies only when distributionType = ANALYTICAL_FIELD.

variation=CONSTANT_RATIO

A SymbolicConstant selecting the elevation distribution options, either Linear or Constant. Possible values are CONSTANT_RATIO and VARIABLE_RATIO.

fileName=''

A String specifying the name of the file from which the Field values are to be read when distributionType = FROM_FILE.

increment=LAST_INCREMENT

The SymbolicConstant LAST_INCREMENT or an Int specifying the increment, interval or iteration of the step when distributionType = FROM_FILE.

step=LAST_STEP

The SymbolicConstant LAST_STEP or an Int specifying the increment, interval or iteration of the step when distributionType = FROM_FILE.

interpolate=0

A Boolean specifying whether to interpolate a field read from an output database or results file.

Returns:

A PorePressure object.

Saturation(name, region, distributionType=UNIFORM, field='', value=0)[source]

This method creates a Saturation predefined field object.

Note

This function can be accessed by:

mdb.models[name].Saturation
Parameters:
name

A String specifying the repository key.

region

A Region object specifying the region to which the predefined field is applied.

distributionType=UNIFORM

A SymbolicConstant specifying whether the load is uniform. Possible values are UNIFORM, and FIELD. The default value is UNIFORM.

field=''

A String specifying the name of the AnalyticalField object associated with this predefined field. The field argument applies only when distributionType = FIELD. The default value is an empty string.

value=0

A float specifying an initial saturation value for the region between 0.0 (for no saturation) and 1.0 (for full saturation).

Returns:

A Saturation object.

Stress(
name,
region,
distributionType=UNIFORM,
sigma11=0,
sigma22=0,
sigma33=0,
sigma12=0,
sigma13=0,
sigma23=0,
)[source]

This method creates a Stress predefined field object.

Note

This function can be accessed by:

mdb.models[name].Stress

Added in version 2017: The Stress method was added.

Parameters:
name

A String specifying the repository key.

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=UNIFORM

A SymbolicConstant specifying whether the load is uniform. Possible values are UNIFORM and FROM_FILE. The default value is UNIFORM.

sigma11=0

A Float specifying the first principal component of the stress.

sigma22=0

A Float specifying the second principal component of the stress.

sigma33=0

A Float specifying the third principal component of the stress.

sigma12=0

A Float specifying the first shear component of the stress.

sigma13=0

A Float specifying the second shear component of the stress.

sigma23=0

A Float specifying the third shear component of the stress.

Returns:

A Stress object.

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

This method creates a Temperature object.

Note

This function can be accessed by:

mdb.models[name].Temperature
Parameters:
name

A String specifying the repository key.

createStepName

A String specifying the name of the step in which the predefined field is created.

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=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=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=''

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=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=''

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=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=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=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=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=0

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=''

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=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=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=MAGNITUDE,
)[source]

This method creates a Velocity predefined field object.

Note

This function can be accessed by:

mdb.models[name].Velocity
Parameters:
name

A String specifying the repository key.

region

A Region object specifying the region to which the predefined field is applied.

velocity1

A Float specifying the first component of the velocity.

velocity2

A Float specifying the second component of the velocity.

velocity3

A Float specifying the third component of the velocity.

omega

A Float specifying the angular velocity.

axisBegin

A sequence of Floats specifying the X-, Y-, and Z coordinates of the starting point of the axis about which omega is defined.

axisEnd

A sequence of Floats specifying the X-, Y-, and Z coordinates of the end point of the axis about which omega is defined.

field=''

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=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

VoidsRatio(
name,
region,
distributionType=UNIFORM,
voidsRatio1=0,
voidsRatio2=0,
coord1=0,
coord2=0,
ratio2Distribution=MAGNITUDE,
ratio2Field='',
variation=CONSTANT_RATIO,
fileName='',
increment=LAST_INCREMENT,
step=LAST_STEP,
interpolate=0,
)[source]

This method creates a PorePressure predefined field object.

Note

This function can be accessed by:

mdb.models[name].PorePressure
Parameters:
name

A String specifying the repository key.

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=UNIFORM

A SymbolicConstant specifying whether the load is uniform. Possible values are UNIFORM, FROM_FILE and USER_DEFINED. The default value is UNIFORM.

voidsRatio1=0

The initial void ratio in the first region in your model.

voidsRatio2=0

The void ratio of the second location in your model

coord1=0

Vertical position of the first location in your model for which you are specifying initial void ratio.

coord2=0

The vertical position of the second location in your model

ratio2Distribution=MAGNITUDE

A SymbolicConstant specifying either the magnitude of a uniform distribution for void ratio at the second elevation or an analytical field to define a spatially varying initial void ratio at the second elevation. Possible values are MAGNITUDE and ANALYTICAL_FIELD.

ratio2Field=''

A String specifying the name of the AnalyticalField object associated with this predefined field. The ratio2Field argument applies only when distributionType = ANALYTICAL_FIELD.

variation=CONSTANT_RATIO

A SymbolicConstant selecting the elevation distribution options, either Linear or Constant. Possible values are CONSTANT_RATIO and VARIABLE_RATIO.

fileName=''

A String specifying the name of the file from which the Field values are to be read when distributionType = FROM_FILE.

increment=LAST_INCREMENT

The SymbolicConstant LAST_INCREMENT or an Int specifying the increment, interval or iteration of the step when distributionType = FROM_FILE.

step=LAST_STEP

The SymbolicConstant LAST_STEP or an Int specifying the increment, interval or iteration of the step when distributionType = FROM_FILE.

interpolate=0

A Boolean specifying whether to interpolate a field read from an output database or results file.

Returns:

A VoidsRatio object.

Other Classes

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

Bases: PredefinedField

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

Added in version 2018: The Field class was added.

Member Details:

distributionType : --is-rst--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 : --is-rst--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.

Parameters:
fromStepName

A String specifying the name of the step from which the PredefinedFieldState is moved.

toStepName

A String specifying the name of the step to which the PredefinedFieldState is moved.

Raises:

TextError

name : --is-rst--str = ''[source]

A String specifying the repository key.

region : --is-rst--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=UNIFORM,
crossSectionDistribution=CONSTANT_THROUGH_THICKNESS,
field='',
amplitude=UNSET,
fileName='',
beginStep=None,
beginIncrement=None,
endStep=None,
endIncrement=None,
interpolate=0,
magnitudes='',
)[source]

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

Parameters:
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. This argument is a required argument if distributionType = FROM_FILE or distributionType = FROM_FILE_AND_USER_DEFINED.

fieldVariableNum=None

An Int specifying the field variable number.

distributionType=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=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=''

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=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=''

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=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=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=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=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=0

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=''

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=UNSET,
fileName='',
beginStep=None,
beginIncrement=None,
endStep=None,
endIncrement=None,
interpolate=0,
magnitudes='',
)[source]

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

Parameters:
stepName

A String specifying the name of the step in which the predefined field is modified.

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. This argument is a required argument if distributionType = FROM_FILE or distributionType = FROM_FILE_AND_USER_DEFINED.

fieldVariableNum=None

An Int specifying the field variable number.

field=''

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=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=''

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=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=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=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=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=0

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=''

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.

class PredefinedField[source]

Bases: object

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]

Member Details:

delete(indices)[source]

This method allows you to delete existing fields.

Parameters:
indices

A sequence of Ints specifying the index of each field to delete.

fieldList : --is-rst--:py:class:`~abaqus.PredefinedField.IMAField.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.

Parameters:
fromStepName

A String specifying the name of the step from which the PredefinedFieldState object is moved.

toStepName

A String specifying the name of the step to which the PredefinedFieldState object is moved.

Raises:

TextError

name : --is-rst--:py:class:`str` = ''[source]

A String specifying the repository key.

region : --is-rst--:py:class:`~abaqus.Region.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.

class FieldState[source]

Bases: PredefinedFieldState

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]

Added in version 2018: The FieldState class was added.

Member Details:

amplitude : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.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 : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the amplitudeState member. Possible values are UNSET, SET, and UNCHANGED.

beginIncrement : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[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 : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the beginIncrement member. Possible values are UNSET, SET, and UNCHANGED.

beginStep : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.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 : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the beginStep member. Possible values are UNSET, SET, and UNCHANGED.

endIncrement : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[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 : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the endIncrement member. Possible values are UNSET, SET, and UNCHANGED.

endStep : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[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 : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the endStep member. Possible values are UNSET, SET, and UNCHANGED.

fileName : --is-rst--:py:class:`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 : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the fileName member. Possible values are UNSET, SET, and UNCHANGED.

magnitudes : --is-rst--:py:class:`tuple`\ \[:py:class:`float`, :py:data:`...<Ellipsis>`] = ()[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 : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A tuple of SymbolicConstants specifying the propagation state of each item of the magnitudes member. Possible values are UNSET, SET, and UNCHANGED.

outputVariable : --is-rst--:py:class:`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 : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[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.

class PredefinedFieldState[source]

Bases: object

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]

Member Details:

status : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[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.

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

Bases: PredefinedField

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

Member Details:

fluidCavity : --is-rst--str[source]

A String specifying the name of a Fluid Cavity Interaction.

fluidPressure : --is-rst--float[source]

A Float specifying the initial fluid pressure.

region : --is-rst--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.

class IMAField[source]

Bases: object

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

Member Details:

discfieldList : --is-rst--:py:class:`tuple`\ \[:py:class:`str`, :py:data:`...<Ellipsis>`] = ()[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 : --is-rst--:py:class:`~abaqus.Region.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.

class IMARegion[source]

Bases: object

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

Member Details:

fractionList : --is-rst--:py:class:`tuple`\ \[:py:class:`float`, :py:data:`...<Ellipsis>`] = ()[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 : --is-rst--:py:class:`~abaqus.Region.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.

class InitialState(
name,
instances,
fileName,
endStep=LAST_STEP,
endIncrement=STEP_END,
updateReferenceConfiguration=0,
)[source]

Bases: PredefinedField

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

Member Details:

endIncrement : --is-rst--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 : --is-rst--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 : --is-rst--str[source]

A String specifying the name of the job that generated the initial state data.

instances : --is-rst--PartInstanceArray[source]

A PartInstanceArray object specifying the instances to which the predefined field is applied.

setValues(
endStep=LAST_STEP,
endIncrement=STEP_END,
updateReferenceConfiguration=0,
)[source]

This method modifies the InitialState object.

Parameters:
endStep=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=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=0

A Boolean specifying whether to update the reference configuration based on the import data. The default value is OFF.

updateReferenceConfiguration : --is-rst--Boolean = 0[source]

A Boolean specifying whether to update the reference configuration based on the import data. The default value is OFF.

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

Bases: PredefinedField

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

Member Details:

backStress : --is-rst--tuple[tuple[float, ...], ...] = ()[source]

A sequence of sequences of Floats specifying the initial backstress tensor for kinematic hardening models. The default value is an empty sequence.

definition : --is-rst--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 : --is-rst--SymbolicConstant = 'MAGNITUDE'[source]

A SymbolicConstant specifying whether the load is uniform. Possible values are MAGNITUDE and ANALYTICAL_FIELD. The default value is MAGNITUDE.

equivPlasticStrain : --is-rst--tuple[float, ...] = ()[source]

A sequence of Floats specifying the initial equivalent Plastic strain.

field : --is-rst--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 : --is-rst--int = 1[source]

An Int specifying the number of backstresses. The default value is 1.

rebarLayerNames : --is-rst--tuple[str, ...] = ()[source]

A sequence of Strings specifying rebar layer names. This argument is valid only when definition = REBAR.

sectPtNum : --is-rst--tuple[int, ...] = ()[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=KINEMATIC_HARDENING,
rebarLayerNames=(),
distributionType=MAGNITUDE,
)[source]

This method modifies the KinematicHardening object.

Parameters:
numBackStress=1

An Int specifying the number of backstresses. The default value is 1.

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. The default value is an empty sequence.

sectPtNum=()

A sequence of Ints specifying section point numbers. This argument is valid only when definition = SECTION_PTS.

definition=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=()

A sequence of Strings specifying rebar layer names. This argument is valid only when definition = REBAR.

distributionType=MAGNITUDE

A SymbolicConstant specifying whether the load is uniform. Possible values are MAGNITUDE and ANALYTICAL_FIELD. The default value is MAGNITUDE.

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

Bases: PredefinedField

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

Member Details:

assignmentList : --is-rst--:py:class:`~typing.Sequence`\ \[:py:class:`tuple`\ \[:py:class:`~abaqus.Region.Region.Region`, :py:class:`tuple`\ \[:py:class:`float`, :py:data:`...<Ellipsis>`]]] = ()[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 : --is-rst--:py:class:`~typing.Sequence`\ \[:py:class:`tuple`\ \[:py:class:`int`, :py:class:`int`, :py:class:`int`]] = ()[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 : --is-rst--:py:class:`~typing.Sequence`\ \[:py:class:`tuple`\ \[:py:class:`~abaqus.Region.Region.Region`, :py:class:`tuple`\ \[:py:class:`str`, :py:data:`...<Ellipsis>`]]] = ()[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 : --is-rst--:py:class:`~typing.List`\ \[:py:class:`~abaqus.Assembly.PartInstance.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 : --is-rst--:py:class:`~abaqus.Region.Region.Region` = <abaqus.Region.Region.Region object>[source]

A Region object specifying the region to which the predefined field is applied.

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

This method modifies the MaterialAssignment object.

Parameters:
useFields=0

A Boolean specifying whether the volume fraction data will be uniform or defined by discrete fields. The default value is OFF.

assignmentList=()

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=()

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=()

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 : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]

A Boolean specifying whether the volume fraction data will be uniform or defined by discrete fields. The default value is OFF.

class PorePressure(
name,
region,
distributionType=UNIFORM,
porePressure1=0,
porePressure2=0,
coord1=0,
coord2=0,
pressure2Distribution=MAGNITUDE,
pressure2Field='',
variation=CONSTANT_RATIO,
fileName='',
increment=LAST_INCREMENT,
step=LAST_STEP,
interpolate=0,
)[source]

Bases: PredefinedField

The PorePressure object stores the data for an initial pore pressure predefined field. The PorePressure 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

Member Details:

setValues(
distributionType=UNIFORM,
porePressure1=0,
porePressure2=0,
coord1=0,
coord2=0,
pressure2Distribution=MAGNITUDE,
pressure2Field=Ellipsis,
variation=CONSTANT_RATIO,
fileName=Ellipsis,
increment=Ellipsis,
step=Ellipsis,
interpolate=Ellipsis,
)[source]

This method modifies the PorePressure object.

Parameters:
distributionType=UNIFORM

A SymbolicConstant specifying whether the load is uniform. Possible values are UNIFORM, FROM_FILE and USER_DEFINED. The default value is UNIFORM.

porePressure1=0

The initial pore pressure in the first region in your model.

porePressure2=0

The pore pressure of the second location in your model

coord1=0

Vertical position of the first location in your model for which you are specifying initial pore pressure.

coord2=0

The vertical position of the second location in your model.

pressure2Distribution=MAGNITUDE

A SymbolicConstant specifying either the magnitude of a uniform distribution for pore pressure at the second elevation or an analytical field to define a spatially varying initial pore pressure at the second elevation. Possible values are MAGNITUDE and ANALYTICAL_FIELD.

pressure2Field=Ellipsis

A String specifying the name of the AnalyticalField object associated with this predefined field. The pressure2Field argument applies only when distributionType = ANALYTICAL_FIELD.

variation=CONSTANT_RATIO

A SymbolicConstant selecting the elevation distribution options, either Linear or Constant. Possible values are CONSTANT_RATIO and VARIABLE_RATIO.

fileName=Ellipsis

A String specifying the name of the file from which the Field values are to be read when distributionType = FROM_FILE.

increment=Ellipsis

The SymbolicConstant LAST_INCREMENT or an Int specifying the increment, interval or iteration of the step when distributionType = FROM_FILE.

step=Ellipsis

The SymbolicConstant LAST_STEP or an Int specifying the increment, interval or iteration of the step when distributionType = FROM_FILE.

interpolate=Ellipsis

A Boolean specifying whether to interpolate a field read from an output database or results file.

Returns:

None

class Saturation(name, region, distributionType=UNIFORM, field='', value=0)[source]

Bases: PredefinedField

The Saturation object stores the data for a saturation predefined field. The Saturation 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

Member Details:

setValues(name, region, distributionType=UNIFORM, field='', value=0)[source]

This method modifies the Saturation object.

Parameters:
name

A String specifying the repository key.

region

A Region object specifying the region to which the predefined field is applied.

distributionType=UNIFORM

A SymbolicConstant specifying whether the load is uniform. Possible values are UNIFORM, and FIELD. The default value is UNIFORM.

field=''

A String specifying the name of the AnalyticalField object associated with this predefined field. The field argument applies only when distributionType = FIELD. The default value is an empty string.

value=0

A float specifying an initial saturation value for the region between 0.0 (for no saturation) and 1.0 (for full saturation).

Returns:

None

class Stress(
name,
region,
distributionType=UNIFORM,
sigma11=0,
sigma22=0,
sigma33=0,
sigma12=0,
sigma13=0,
sigma23=0,
)[source]

Bases: PredefinedField

The Stress object stores the data for an initial stress predefined field. The Stress 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

Added in version 2017: The Stress class was added.

Member Details:

setValues(
distributionType=UNIFORM,
sigma11=0,
sigma22=0,
sigma33=0,
sigma12=0,
sigma13=0,
sigma23=0,
)[source]

This method modifies the Stress object.

Parameters:
distributionType=UNIFORM

A SymbolicConstant specifying whether the load is uniform. Possible values are UNIFORM and FROM_FILE. The default value is UNIFORM.

sigma11=0

A Float specifying the first principal component of the stress.

sigma22=0

A Float specifying the second principal component of the stress.

sigma33=0

A Float specifying the third principal component of the stress.

sigma12=0

A Float specifying the first shear component of the stress.

sigma13=0

A Float specifying the second shear component of the stress.

sigma23=0

A Float specifying the third shear component of the stress.

Return type:

None

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

Bases: PredefinedField

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

Member Details:

distributionType : --is-rst--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 : --is-rst--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.

Parameters:
fromStepName

A String specifying the name of the step from which the PredefinedFieldState is moved.

toStepName

A String specifying the name of the step to which the PredefinedFieldState is moved.

Raises:

TextError

name : --is-rst--str = ''[source]

A String specifying the repository key.

region : --is-rst--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=UNIFORM,
crossSectionDistribution=CONSTANT_THROUGH_THICKNESS,
field='',
amplitude=UNSET,
fileName='',
beginStep=None,
beginIncrement=None,
endStep=None,
endIncrement=None,
interpolate=0,
magnitudes='',
absoluteExteriorTolerance=0,
exteriorTolerance=0,
)[source]

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

Parameters:
distributionType=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=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=''

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=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=''

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=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=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=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=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=0

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=''

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=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=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=UNSET,
fileName='',
beginStep=None,
beginIncrement=None,
endStep=None,
endIncrement=None,
interpolate=0,
magnitudes='',
absoluteExteriorTolerance=0,
exteriorTolerance=0,
)[source]

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

Parameters:
stepName

A String specifying the name of the step in which the predefined field is modified.

field=''

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=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=''

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=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=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=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=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=0

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=''

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=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=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.

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

Bases: PredefinedField

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

Member Details:

axisBegin : --is-rst--tuple[float, ...] = ()[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 : --is-rst--tuple[float, ...] = ()[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 : --is-rst--SymbolicConstant = 'MAGNITUDE'[source]

A SymbolicConstant specifying whether the load is uniform. Possible values are MAGNITUDE and FIELD_ANALYTICAL. The default value is MAGNITUDE.

field : --is-rst--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 : --is-rst--float[source]

A Float specifying the angular velocity.

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

This method modifies the Velocity object.

Parameters:
field=''

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=MAGNITUDE

A SymbolicConstant specifying whether the load is uniform. Possible values are MAGNITUDE and FIELD_ANALYTICAL. The default value is MAGNITUDE.

velocity1 : --is-rst--float[source]

A Float specifying the first component of the velocity.

velocity2 : --is-rst--float[source]

A Float specifying the second component of the velocity.

velocity3 : --is-rst--float[source]

A Float specifying the third component of the velocity.

class VoidsRatio(
name,
region,
distributionType=UNIFORM,
voidsRatio1=0,
voidsRatio2=0,
coord1=0,
coord2=0,
ratio2Distribution=MAGNITUDE,
ratio2Field='',
variation=CONSTANT_RATIO,
fileName='',
increment=LAST_INCREMENT,
step=LAST_STEP,
interpolate=0,
)[source]

Bases: PredefinedField

The VoidsRatio object stores the data for an initial void ratio predefined field. The VoidsRatio 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

Member Details:

setValues(
distributionType=UNIFORM,
voidsRatio1=0,
voidsRatio2=0,
coord1=0,
coord2=0,
ratio2Distribution=MAGNITUDE,
ratio2Field=Ellipsis,
variation=CONSTANT_RATIO,
fileName=Ellipsis,
increment=Ellipsis,
step=Ellipsis,
interpolate=Ellipsis,
)[source]

This method modifies the VoidsRatio object.

Parameters:
distributionType=UNIFORM

A SymbolicConstant specifying whether the load is uniform. Possible values are UNIFORM, FROM_FILE and USER_DEFINED. The default value is UNIFORM.

voidsRatio1=0

The initial void ratio in the first region in your model.

voidsRatio2=0

The void ratio of the second location in your model

coord1=0

Vertical position of the first location in your model for which you are specifying initial void ratio.

coord2=0

The vertical position of the second location in your model

ratio2Distribution=MAGNITUDE

A SymbolicConstant specifying either the magnitude of a uniform distribution for void ratio at the second elevation or an analytical field to define a spatially varying initial void ratio at the second elevation. Possible values are MAGNITUDE and ANALYTICAL_FIELD.

ratio2Field=Ellipsis

A String specifying the name of the AnalyticalField object associated with this predefined field. The ratio2Field argument applies only when distributionType = ANALYTICAL_FIELD.

variation=CONSTANT_RATIO

A SymbolicConstant selecting the elevation distribution options, either Linear or Constant. Possible values are CONSTANT_RATIO and VARIABLE_RATIO.

fileName=Ellipsis

A String specifying the name of the file from which the Field values are to be read when distributionType = FROM_FILE.

increment=Ellipsis

The SymbolicConstant LAST_INCREMENT or an Int specifying the increment, interval or iteration of the step when distributionType = FROM_FILE.

step=Ellipsis

The SymbolicConstant LAST_STEP or an Int specifying the increment, interval or iteration of the step when distributionType = FROM_FILE.

interpolate=Ellipsis

A Boolean specifying whether to interpolate a field read from an output database or results file.

Returns:

None

class TemperatureState[source]

Bases: PredefinedFieldState

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]

Member Details:

amplitude : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.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 : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the amplitudeState member. Possible values are UNSET, SET, and UNCHANGED.

beginIncrement : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[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 : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the beginIncrement member. Possible values are UNSET, SET, and UNCHANGED.

beginStep : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.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 : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the beginStep member. Possible values are UNSET, SET, and UNCHANGED.

endIncrement : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[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 : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the endIncrement member. Possible values are UNSET, SET, and UNCHANGED.

endStep : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[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 : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the endStep member. Possible values are UNSET, SET, and UNCHANGED.

fileName : --is-rst--:py:class:`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 : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the fileName member. Possible values are UNSET, SET, and UNCHANGED.

magnitudes : --is-rst--:py:class:`tuple`\ \[:py:class:`float`, :py:data:`...<Ellipsis>`] = ()[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 : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A tuple of SymbolicConstants specifying the propagation state of each item of the magnitudes member. Possible values are UNSET, SET, and UNCHANGED.

midside : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[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 : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the midside member. Possible values are UNSET, SET, and UNCHANGED.

status : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[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.

class TiffOptions[source]

Bases: object

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

Member Details:

setValues(imageSize=SIZE_ON_SCREEN)[source]

This method modifies the TiffOptions object.

Parameters:
imageSize=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 – imageSize must be SIZE_ON_SCREEN or a sequence of 2 Ints in the range, (minWidth, minHeight) <= (width, height) <= (maxWidth, maxHeight).