Load

A specific type of load object and a specific type of load state object are designed for each type of load. A load object stores the nonpropagating data of a load as well as a number of instances of the corresponding load state object, each of which stores the propagating data of the load in a single step. Instances of the load state object are created and deleted internally by its corresponding load object.

Load Case commands are used for configuring load cases in specific types of steps that may use them.

Load

The Load object is the abstract base type for other Load objects. The Load object has no explicit constructor. The methods and members of the Load object are common to all objects derived from Load.

Create loads

class LoadModel(
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.

tableCollections

A repository of TableCollection objects.

eventSeriesTypes

A repository of EventSeriesType objects.

eventSeriesDatas

A repository of EventSeriesData objects.

restartIncrement

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

rootAssembly

An Assembly object.

Public Methods:

BodyCharge(name, createStepName, region, ...)

This method creates a BodyCharge object.

BodyConcentrationFlux(name, createStepName, ...)

This method creates a BodyConcentrationFlux object.

BodyCurrent(name, createStepName, region, ...)

This method creates a BodyCurrent object.

BodyCurrentDensity(name, createStepName, ...)

This method creates a BodyCurrentDensity object.

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

This method creates a BodyForce object.

BodyHeatFlux(name, createStepName, region, ...)

This method creates a BodyHeatFlux object.

BoltLoad(name, createStepName, region, ...)

This method creates a BoltLoad object.

ConcCharge(name, createStepName, region, ...)

This method creates a ConcCharge object.

ConcConcFlux(name, createStepName, region, ...)

This method creates a ConcConcFlux object.

ConcCurrent(name, createStepName, region, ...)

This method creates a ConcCurrent object.

ConcentratedForce(name, createStepName, region)

This method creates a ConcentratedForce object.

ConcentratedHeatFlux(name, createStepName, ...)

This method creates a ConcentratedHeatFlux object.

ConcPoreFluid(name, createStepName, region, ...)

This method creates a ConcPoreFluid object.

ConnectorForce(name, createStepName[, ...])

This method creates a ConnectorForce object on a wire region.

ConnectorMoment(name, createStepName[, ...])

This method creates a ConnectorMoment object on a wire region.

CoriolisForce(name, createStepName, region, ...)

This method creates a CoriolisForce object.

Gravity(name, createStepName[, ...])

This method creates a Gravity object.

InertiaRelief(name, createStepName[, u1, ...])

This method creates an InertiaRelief object.

InwardVolAccel(name, createStepName, region, ...)

This method creates a InwardVolAccel object.

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

This method creates a LineLoad object.

Moment(name, createStepName, region[, cm1, ...])

This method creates a Moment object.

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

This method creates a PEGLoad object.

PipePressure(name, createStepName, region, ...)

This method creates a Pressure object.

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

This method creates a Pressure object.

RotationalBodyForce(name, createStepName, ...)

This method creates a RotationalBodyForce object.

ShellEdgeLoad(name, createStepName, region, ...)

This method creates a ShellEdgeLoad object.

SubmodelSB(name, createStepName, region, ...)

This method creates a SubmodelSB object.

SubstructureLoad(name, createStepName, ...)

This method creates a SubstructureLoad object.

SurfaceCharge(name, createStepName, region, ...)

This method creates a SurfaceCharge object.

SurfaceConcentrationFlux(name, ...[, field, ...])

This method creates a SurfaceConcentrationFlux object.

SurfaceCurrent(name, createStepName, region, ...)

This method creates a SurfaceCurrent object.

SurfaceCurrentDensity(name, createStepName, ...)

This method creates a SurfaceCurrentDensity object.

SurfaceHeatFlux(name, createStepName, ...[, ...])

This method creates a SurfaceHeatFlux object.

SurfacePoreFluid(name, createStepName, ...)

This method creates a SurfacePoreFluid object.

SurfaceTraction(name, createStepName, ...[, ...])

This method creates a SurfaceTraction 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:

BodyCharge(
name,
createStepName,
region,
magnitude,
amplitude=UNSET,
distributionType=UNIFORM,
field='',
)[source]

This method creates a BodyCharge object.

Note

This function can be accessed by:

mdb.models[name].BodyCharge
Parameters:
name

A String specifying the load repository key.

createStepName

A String specifying the name of the step in which the load is created. This must be the first analysis step name.

region

A Region object specifying the region to which the load is applied.

magnitude

A Float specifying the load magnitude.

amplitude=UNSET

A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

distributionType=UNIFORM

A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

field=''

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

Returns:

A BodyCharge object.

Return type:

BodyCharge

BodyConcentrationFlux(
name,
createStepName,
region,
magnitude,
field='',
distributionType=UNIFORM,
amplitude=UNSET,
)[source]

This method creates a BodyConcentrationFlux object.

Note

This function can be accessed by:

mdb.models[name].BodyConcentrationFlux
Parameters:
name

A String specifying the load repository key.

createStepName

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

region

A Region object specifying the region to which the load is applied.

magnitude

A Float specifying the body concentration flux magnitude. magnitude is optional if distributionType = USER_DEFINED.

field=''

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

distributionType=UNIFORM

A SymbolicConstant specifying how the body concentration flux is distributed spatially. Possible values are UNIFORM, USER_DEFINED, and FIELD. The default value is UNIFORM.

amplitude=UNSET

A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

Returns:

A BodyConcentrationFlux object.

Return type:

BodyConcentrationFlux

BodyCurrent(
name,
createStepName,
region,
magnitude,
amplitude=UNSET,
distributionType=UNIFORM,
field='',
)[source]

This method creates a BodyCurrent object.

Note

This function can be accessed by:

mdb.models[name].BodyCurrent
Parameters:
name

A String specifying the load repository key.

createStepName

A String specifying the name of the step in which the load is created. This must be the first analysis step name.

region

A Region object specifying the region to which the load is applied.

magnitude

A Float specifying the load magnitude.

amplitude=UNSET

A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

distributionType=UNIFORM

A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

field=''

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

Returns:

A BodyCurrent object.

Return type:

BodyCurrent

BodyCurrentDensity(
name,
createStepName,
region,
comp1,
comp2,
comp3,
amplitude=UNSET,
distributionType=UNIFORM,
)[source]

This method creates a BodyCurrentDensity object.

Note

This function can be accessed by:

mdb.models[name].BodyCurrentDensity
Parameters:
name

A String specifying the load repository key.

createStepName

A String specifying the name of the step in which the load is created. This must be the first analysis step name.

region

A Region object specifying the region to which the load is applied.

comp1

A Complex specifying the first component of the load.

comp2

A Complex specifying the second component of the load.

comp3

A Complex specifying the third component of the load.

amplitude=UNSET

A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

distributionType=UNIFORM

A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and USER_DEFINED. The default value is UNIFORM.

Returns:

A BodyCurrentDensity object.

Return type:

BodyCurrentDensity

BodyForce(
name,
createStepName,
region,
field='',
distributionType=UNIFORM,
comp1=None,
comp2=None,
comp3=None,
amplitude=UNSET,
)[source]

This method creates a BodyForce object.

Note

This function can be accessed by:

mdb.models[name].BodyForce
Parameters:
name

A String specifying the load repository key.

createStepName

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

region

A Region object specifying the region to which the load is applied.

field=''

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

distributionType=UNIFORM

A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM, USER_DEFINED, and FIELD. The default value is UNIFORM.

comp1=None

A Float or a Complex specifying the body force component in the 1-direction. Note: Although comp1, comp2, and comp3 are optional arguments, at least one of them must be nonzero unless distributionType = USER_DEFINED.

comp2=None

A Float or a Complex specifying the body force component in the 2-direction.

comp3=None

A Float or a Complex specifying the body force component in the 3-direction.

amplitude=UNSET

A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

Returns:

A BodyForce object.

Return type:

BodyForce

BodyHeatFlux(
name,
createStepName,
region,
magnitude,
field='',
distributionType=UNIFORM,
amplitude=UNSET,
)[source]

This method creates a BodyHeatFlux object.

Note

This function can be accessed by:

mdb.models[name].BodyHeatFlux
Parameters:
name

A String specifying the load repository key.

createStepName

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

region

A Region object specifying the region to which the load is applied.

magnitude

A Float specifying the body heat flux magnitude. magnitude is optional if distributionType = USER_DEFINED.

field=''

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

distributionType=UNIFORM

A SymbolicConstant specifying how the body heat flux is distributed spatially. Possible values are UNIFORM, USER_DEFINED, and FIELD. The default value is UNIFORM.

amplitude=UNSET

A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

Returns:

A BodyHeatFlux object.

Return type:

BodyHeatFlux

BoltLoad(
name,
createStepName,
region,
magnitude,
datumAxis,
boltMethod=APPLY_FORCE,
amplitude=UNSET,
preTenSecPartLevel=False,
)[source]

This method creates a BoltLoad object.

Note

This function can be accessed by:

mdb.models[name].BoltLoad
Parameters:
name

A String specifying the load repository key.

createStepName

A String specifying the name of the step in which the load is created. This must be the first analysis step name.

region

A Region object specifying the region to which the load is applied.

magnitude

A Float specifying the bolt load magnitude.

datumAxis

A DatumAxis object specifying the orientation of the pre-tension section normal. Note: datumAxis is applicable only for Solid and Shell regions; it has no meaning for Wire regions.

boltMethod=APPLY_FORCE

A SymbolicConstant specifying the method of applying the bolt load. Possible values are APPLY_FORCE and ADJUST_LENGTH. The default value is APPLY_FORCE.

amplitude=UNSET

A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

preTenSecPartLevel=False

A Boolean specifying whether the pre-tension section is to be defined at the part level. The default value is False. You should provide the preTenSecPartLevel argument only if the selected region belongs to a dependent part instance. A pre-tension section cannot be defined at the part level for independent and model instances.

Added in version 2018: The preTenSecPartLevel argument was added.

Returns:

A BoltLoad object.

Return type:

BoltLoad

Raises:

TextError

ConcCharge(
name,
createStepName,
region,
magnitude,
distributionType=UNIFORM,
field='',
amplitude=UNSET,
)[source]

This method creates a ConcCharge object.

Note

This function can be accessed by:

mdb.models[name].ConcCharge
Parameters:
name

A String specifying the load repository key.

createStepName

A String specifying the name of the step in which the load is created. This must be the first analysis step name.

region

A Region object specifying the region to which the load is applied.

magnitude

A Float specifying the load magnitude.

distributionType=UNIFORM

A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

field=''

A String specifying the name of the AnalyticalField object associated with this load. The field argument applies only when distributionType = 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 load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

Returns:

A ConcCharge object.

Return type:

ConcCharge

ConcConcFlux(
name,
createStepName,
region,
magnitude,
distributionType=UNIFORM,
field='',
amplitude=UNSET,
)[source]

This method creates a ConcConcFlux object.

Note

This function can be accessed by:

mdb.models[name].ConcConcFlux
Parameters:
name

A String specifying the load repository key.

createStepName

A String specifying the name of the step in which the load is created. This must be the first analysis step name.

region

A Region object specifying the region to which the load is applied.

magnitude

A Float specifying the load magnitude.

distributionType=UNIFORM

A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

field=''

A String specifying the name of the AnalyticalField object associated with this load. The field argument applies only when distributionType = 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 load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

Returns:

A ConcConcFlux object.

Return type:

ConcConcFlux

ConcCurrent(
name,
createStepName,
region,
magnitude,
distributionType=UNIFORM,
field='',
amplitude=UNSET,
)[source]

This method creates a ConcCurrent object.

Note

This function can be accessed by:

mdb.models[name].ConcCurrent
Parameters:
name

A String specifying the load repository key.

createStepName

A String specifying the name of the step in which the load is created. This must be the first analysis step name.

region

A Region object specifying the region to which the load is applied.

magnitude

A Float specifying the load magnitude.

distributionType=UNIFORM

A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

field=''

A String specifying the name of the AnalyticalField object associated with this load. The field argument applies only when distributionType = 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 load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

Returns:

A ConcCurrent object.

Return type:

ConcCurrent

ConcPoreFluid(
name,
createStepName,
region,
magnitude,
distributionType=UNIFORM,
field='',
amplitude=UNSET,
)[source]

This method creates a ConcPoreFluid object.

Note

This function can be accessed by:

mdb.models[name].ConcPoreFluid
Parameters:
name

A String specifying the load repository key.

createStepName

A String specifying the name of the step in which the load is created. This must be the first analysis step name.

region

A Region object specifying the region to which the load is applied.

magnitude

A Float specifying the load magnitude.

distributionType=UNIFORM

A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

field=''

A String specifying the name of the AnalyticalField object associated with this load. The field argument applies only when distributionType = 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 load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

Returns:

A ConcPoreFluid object.

Return type:

ConcPoreFluid

ConcentratedForce(
name,
createStepName,
region,
distributionType=UNIFORM,
field='',
cf1=None,
cf2=None,
cf3=None,
amplitude=UNSET,
follower=0,
localCsys=None,
)[source]

This method creates a ConcentratedForce object.

Note

This function can be accessed by:

mdb.models[name].ConcentratedForce
Parameters:
name

A String specifying the load repository key.

createStepName

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

region

A Region object specifying the region to which the load is applied.

distributionType=UNIFORM

A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

field=''

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

cf1=None

A Float or a Complex specifying the concentrated force component in the 1-direction. Although cf1, cf2, and cf3 are optional arguments, at least one of them must be nonzero.

cf2=None

A Float or a Complex specifying the concentrated force component in the 2-direction.

cf3=None

A Float or a Complex specifying the concentrated force component in the 3-direction.

amplitude=UNSET

A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

follower=0

A Boolean specifying whether the direction of the force rotates with the rotation at each node of the region. You should provide the follower argument only if it is valid for the specified step. The default value is OFF.

localCsys=None

None or a DatumCsys object specifying the local coordinate system of the load’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. When this member is queried, it returns an Int. The default value is None.

Returns:

A ConcentratedForce object.

Return type:

ConcentratedForce

ConcentratedHeatFlux(
name,
createStepName,
region,
magnitude,
distributionType=UNIFORM,
field='',
amplitude=UNSET,
dof=11,
)[source]

This method creates a ConcentratedHeatFlux object.

Note

This function can be accessed by:

mdb.models[name].ConcentratedHeatFlux
Parameters:
name

A String specifying the load repository key.

createStepName

A String specifying the name of the step in which the load is created. This must be the first analysis step name.

region

A Region object specifying the region to which the load is applied.

magnitude

A Float specifying the load magnitude.

distributionType=UNIFORM

A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

field=''

A String specifying the name of the AnalyticalField object associated with this load. The field argument applies only when distributionType = 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 load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

dof=11

An Int specifying the degree of freedom of the node, to which the concentrated heat flux should be applied. The default value is 11.

Returns:

A ConcentratedHeatFlux object.

Return type:

ConcentratedHeatFlux

ConnectorForce(
name,
createStepName,
region='',
fastenerName='',
fastenerSetName='',
f1=None,
f2=None,
f3=None,
amplitude=UNSET,
)[source]

This method creates a ConnectorForce object on a wire region. Alternatively, the load may also be applied to a wire set referenced from an assembled fastener template model.

Note

This function can be accessed by:

mdb.models[name].ConnectorForce
Parameters:
name

A String specifying the load repository key.

createStepName

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

region=''

The wire region to which the load is applied. This argument is not valid when fastenerName and fastenerSetName are specified.

fastenerName=''

A String specifying the name of the assembled fastener to which the load will be applied. This argument is not valid when region is specified. When this argument is specified, fastenerSetName must also be specified. The default value is an empty string.

fastenerSetName=''

A String specifying the assembled fastener template model set to which the load will be applied. This argument is not valid when region is specified. When this argument is specified, fastenerName must also be specified. The default value is an empty string.

f1=None

A Float or a Complex specifying the connector force component in the connector’s local 1-direction. Note: Although f1, f2, and f3 are optional arguments, at least one of them must be nonzero.

f2=None

A Float or a Complex specifying the connector force component in the connector’s local 2-direction.

f3=None

A Float or a Complex specifying the connector force component in the connector’s local 3-direction.

amplitude=UNSET

A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

Returns:

A ConnectorForce object.

Return type:

ConnectorForce

ConnectorMoment(
name,
createStepName,
region='',
fastenerName='',
fastenerSetName='',
m1=None,
m2=None,
m3=None,
amplitude=UNSET,
)[source]

This method creates a ConnectorMoment object on a wire region. Alternatively, the load may also be applied to a wire set referenced from an assembled fastener template model.

Note

This function can be accessed by:

mdb.models[name].ConnectorMoment
Parameters:
name

A String specifying the load repository key.

createStepName

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

region=''

The wire region to which the load is applied. This argument is not valid when fastenerName and fastenerSetName are specified.

fastenerName=''

A String specifying the name of the assembled fastener to which the load will be applied. This argument is not valid when region is specified. When this argument is specified, fastenerSetName must also be specified. The default value is an empty string.

fastenerSetName=''

A String specifying the assembled fastener template model set to which the load will be applied. This argument is not valid when region is specified. When this argument is specified, fastenerName must also be specified. The default value is an empty string.

m1=None

A Float or a Complex specifying the moment component in the connector’s local 4-direction.

m2=None

A Float or a Complex specifying the moment component in the connector’s local 5-direction.

m3=None

A Float or a Complex specifying the moment component in the connector’s local 6-direction.

amplitude=UNSET

A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

Returns:

A ConnectorMoment object.

Return type:

ConnectorMoment

CoriolisForce(
name,
createStepName,
region,
magnitude,
point1,
point2,
amplitude=UNSET,
distributionType=UNIFORM,
field='',
)[source]

This method creates a CoriolisForce object.

Note

This function can be accessed by:

mdb.models[name].CoriolisForce
Parameters:
name

A String specifying the load repository key.

createStepName

A String specifying the name of the step in which the load is created. This must be the first analysis step name.

region

A Region object specifying the region to which the load is applied.

magnitude

A Float specifying the load magnitude.

point1

A sequence of Floats specifying the first point on the axis of rotation for the load.

point2

A sequence of Floats specifying the second point on the axis of rotation for the load.

amplitude=UNSET

A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

distributionType=UNIFORM

A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

field=''

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

Returns:

A CoriolisForce object.

Return type:

CoriolisForce

Gravity(
name,
createStepName,
distributionType=UNIFORM,
field='',
region=None,
comp1=None,
comp2=None,
comp3=None,
amplitude=UNSET,
)[source]

This method creates a Gravity object.

Note

This function can be accessed by:

mdb.models[name].Gravity
Parameters:
name

A String specifying the load repository key.

createStepName

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

distributionType=UNIFORM

A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

field=''

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

region=None

A Region object specifying the region to which the load is applied.

comp1=None

A Float or a Complex specifying the component of the load in the 1-direction. Note: Although comp1, comp2, and comp3 are optional arguments, at least one of them must be nonzero.

comp2=None

A Float or a Complex specifying the component of the load in the 2-direction.

comp3=None

A Float or a Complex specifying the component of the load in the 3-direction.

amplitude=UNSET

A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

Returns:

A Gravity object.

Return type:

Gravity

InertiaRelief(
name,
createStepName,
u1=0,
u2=0,
u3=0,
ur1=0,
ur2=0,
ur3=0,
referencePoint=(),
localCoordinates=None,
)[source]

This method creates an InertiaRelief object.

Note

This function can be accessed by:

mdb.models[name].InertiaRelief
Parameters:
name

A String specifying the load repository key.

createStepName

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

u1=0

A Boolean specifying the 1-direction as a free direction. Note: Although u1, u2, u3, ur1, ur2, and ur3 are optional arguments, at least one of them must be specified. Further, any specified set of free directions cannot include only two rotational degrees of freedom.

u2=0

A Boolean specifying the 2-direction as a free direction.

u3=0

A Boolean specifying the 3-direction as a free direction.

ur1=0

A Boolean specifying the rotation about the 1-direction as a free direction.

ur2=0

A Boolean specifying the rotation about the 2-direction as a free direction.

ur3=0

A Boolean specifying the rotation about the 3-direction as a free direction.

referencePoint=()

A sequence of Floats specifying the X, Y and Z coordinates of a fixed rotation point or a point on the rotation axis or a point on the symmetry line, about which rotations are defined. Such a point must be specified only for certain combinations of free directions.

localCoordinates=None

None or a DatumCsys object specifying the local coordinate system of the rigid body degrees of freedom for the inertia relief load. If localCoordinates = None, the free directions are defined in the global coordinate system. When this member is queried, it returns an Int. The default value is None.

Returns:

An InertiaRelief object.

Return type:

InertiaRelief

InwardVolAccel(
name,
createStepName,
region,
magnitude,
distributionType=UNIFORM,
field='',
amplitude=UNSET,
)[source]

This method creates a InwardVolAccel object.

Note

This function can be accessed by:

mdb.models[name].InwardVolAccel
Parameters:
name

A String specifying the load repository key.

createStepName

A String specifying the name of the step in which the load is created. This must be the name of the first analysis step.

region

A Region object specifying the region to which the load is applied.

magnitude

A Float specifying the load magnitude.

distributionType=UNIFORM

A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

field=''

A String specifying the name of the AnalyticalField object associated with this load. The field argument applies only when distributionType = 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 load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

Returns:

An InwardVolAccel object.

Return type:

InwardVolAccel

LineLoad(
name,
createStepName,
region,
distributionType=UNIFORM,
field='',
comp1=None,
comp2=None,
comp3=None,
amplitude=UNSET,
system=GLOBAL,
)[source]

This method creates a LineLoad object.

Note

This function can be accessed by:

mdb.models[name].LineLoad
Parameters:
name

A String specifying the load repository key.

createStepName

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

region

A Region object specifying the region to which the load is applied.

distributionType=UNIFORM

A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM, USER_DEFINED, and FIELD. The default value is UNIFORM.

field=''

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

comp1=None

A Float or a Complex specifying the component of the load in the global or the beam local 1-direction. Note: Although comp1, comp2, and comp3 are optional arguments, at least one of them must be nonzero unless distributionType = USER_DEFINED.

comp2=None

A Float or a Complex specifying the component of the load in the global or the beam local 2-direction.

comp3=None

A Float or a Complex specifying the component of the load in the global 3-direction.

amplitude=UNSET

A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

system=GLOBAL

A SymbolicConstant specifying whether the load is applied in a global or the beam local frame of reference. Possible values are GLOBAL and LOCAL. The default value is GLOBAL.

Returns:

A LineLoad object.

Return type:

LineLoad

Moment(
name,
createStepName,
region,
cm1=None,
cm2=None,
cm3=None,
amplitude=UNSET,
follower=0,
localCsys=None,
distributionType=UNIFORM,
field='',
)[source]

This method creates a Moment object.

Note

This function can be accessed by:

mdb.models[name].Moment
Parameters:
name

A String specifying the load repository key.

createStepName

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

region

A Region object specifying the region to which the load is applied.

cm1=None

A Float or a Complex specifying the load component in the 4-direction. Note: Although comp1, comp2, and comp3 are optional arguments, at least one of them must be nonzero.

cm2=None

A Float or a Complex specifying the load component in the 5- direction.

cm3=None

A Float or a Complex specifying the load component in the 6-direction.

amplitude=UNSET

A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

follower=0

A Boolean specifying whether the direction of the force rotates with the rotation of the node. You should provide the follower argument only if it is valid for the specified step. The default value is OFF.

localCsys=None

None or a DatumCsys object specifying the ID of the Datum coordinate system used as the local coordinate system of the load. If localCsys = None, the load is defined in the global coordinate system. When this member is queried, it returns an Int. The default value is None.

distributionType=UNIFORM

A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

field=''

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

Returns:

A Moment object.

Return type:

Moment

PEGLoad(
name,
createStepName,
region,
distributionType=UNIFORM,
field='',
comp1=None,
comp2=None,
comp3=None,
amplitude=UNSET,
)[source]

This method creates a PEGLoad object.

Note

This function can be accessed by:

mdb.models[name].PEGLoad
Parameters:
name

A String specifying the load repository key.

createStepName

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

region

A Region object specifying the region to which the load is applied.

distributionType=UNIFORM

A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

field=''

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

comp1=None

A Float or a Complex specifying the load component at dof 1 of reference node 1. Note: Although comp1, comp2, and comp3 are optional arguments, at least one of them must be nonzero.

comp2=None

A Float or a Complex specifying the load component at dof 1 of reference node 2.

comp3=None

A Float or a Complex specifying the load component at dof 2 of reference node 2.

amplitude=UNSET

A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

Returns:

A PEGLoad object.

Return type:

PEGLoad

PipePressure(
name,
createStepName,
region,
magnitude,
diameter,
hZero,
hReference,
field='',
amplitude=UNSET,
distributionType=UNIFORM,
side=INTERNAL,
)[source]

This method creates a Pressure object.

Note

This function can be accessed by:

mdb.models[name].PipePressure
Parameters:
name

A String specifying the load repository key.

createStepName

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

region

A Region object specifying the region to which the load is applied.

magnitude

A Float specifying the pressure magnitude. Note: magnitude is optional if distributionType = USER_DEFINED.

diameter

A Float specifying the effective inner or outer diameter.

hZero

A Float specifying the height of the zero pressure level when distributionType = HYDROSTATIC.

hReference

A Float specifying the height of the reference pressure level when distributionType = HYDROSTATIC.

field=''

A String specifying the name of the AnalyticalField object associated with this load. The field argument applies only when distributionType = 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 load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

distributionType=UNIFORM

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

side=INTERNAL

A SymbolicConstant specifying whether the pressure is applied internally or externally. Possible values are INTERNAL and EXTERNAL. The default value is INTERNAL.

Returns:

A PipePressure object.

Return type:

PipePressure

Pressure(
name,
createStepName,
region,
magnitude=0.0,
hZero=0.0,
hReference=0.0,
field='',
refPoint='',
distributionType=UNIFORM,
amplitude=UNSET,
)[source]

This method creates a Pressure object.

Note

This function can be accessed by:

mdb.models[name].Pressure
Parameters:
name

A String specifying the load repository key.

createStepName

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

region

A Region object specifying the region to which the load is applied.

magnitude=0.0

A Float or a Complex specifying the pressure magnitude. Note: magnitude is optional if distributionType = USER_DEFINED.

hZero=0.0

A Float specifying the height of the zero pressure level when distributionType = HYDROSTATIC.

hReference=0.0

A Float specifying the height of the reference pressure level when distributionType = HYDROSTATIC.

field=''

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

refPoint=''

A Region specifying the reference point from which the relative velocity is determined when distributionType = STAGNATION or VISCOUS.

distributionType=UNIFORM

A SymbolicConstant specifying how the pressure is distributed spatially. Possible values are UNIFORM, USER_DEFINED, FIELD, HYDROSTATIC, STAGNATION, VISCOUS, TOTAL_FORCE, and DISCRETE_FIELD. The default value is UNIFORM.

amplitude=UNSET

A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

Returns:

A Pressure object.

Return type:

Pressure

RotationalBodyForce(
name,
createStepName,
region,
magnitude,
point1,
point2,
distributionType=UNIFORM,
field='',
centrifugal=0,
rotaryAcceleration=0,
amplitude=UNSET,
)[source]

This method creates a RotationalBodyForce object.

Note

This function can be accessed by:

mdb.models[name].RotationalBodyForce
Parameters:
name

A String specifying the load repository key.

createStepName

A String specifying the name of the step in which the load is created. This must be the first analysis step name.

region

A Region object specifying the region to which the load is applied.

magnitude

A Float specifying the load magnitude.

point1

A sequence of Floats specifying the first point on the axis of rotation for the load.

point2

A sequence of Floats specifying the second point on the axis of rotation for the load.

distributionType=UNIFORM

A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

field=''

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

centrifugal=0

A Boolean specifying whether or not the effect of the load is centrifugal. The default value is OFF. Note: At least one of centrifugal or rotaryAcceleration must be specified and only one must have the value ON.

rotaryAcceleration=0

A Boolean specifying whether or not the effect of the load is rotary acceleration. The default value is OFF. Note: At least one of centrifugal or rotaryAcceleration must be specified and only one must have the value ON.

amplitude=UNSET

A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

Returns:

A RotationalBodyForce object.

Return type:

RotationalBodyForce

ShellEdgeLoad(
name,
createStepName,
region,
magnitude,
distributionType=UNIFORM,
field='',
amplitude=UNSET,
angle=0,
axis=AXIS_1,
localCsys=GENERAL,
userCsys=GENERAL,
directionVector=(),
follower=1,
resultant=0,
traction=NORMAL,
)[source]

This method creates a ShellEdgeLoad object.

Note

This function can be accessed by:

mdb.models[name].ShellEdgeLoad
Parameters:
name

A String specifying the load repository key.

createStepName

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

region

A Region object specifying the region to which the load is applied.

magnitude

A Float or Complex specifying the load magnitude. magnitude is optional if distributionType = USER_DEFINED

distributionType=UNIFORM

A SymbolicConstant specifying how the shell edge load is distributed spatially. Possible values are UNIFORM, USER_DEFINED, and FIELD. The default value is UNIFORM.

field=''

A String specifying the name of the AnalyticalField object associated with this load. The field argument applies only when distributionType = 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 load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

angle=0

A Float specifying an additional rotation of directionVector about an axis. The default value is 0.This parameter is available only if traction is GENERAL.

axis=AXIS_1

A SymbolicConstant specifying the axis about which to apply an additional rotation of directionVector. Possible values are AXIS_1, AXIS_2, AXIS_3. The default value is AXIS_1.This parameter is available only if traction is GENERAL.

localCsys=GENERAL

A DatumCsys object specifying the local coordinate system of the load’s degrees of freedom. The default value is None, indicating that the degrees of freedom are defined in the global coordinate system or by the userCsys parameter if defined. This parameter is available only if traction is GENERAL. When this member is queried, it returns an Int.

userCsys=GENERAL

A String specifying a CSYS defined by a user-subroutine. The default value is None, indicating that the degrees of freedom are defined in the global coordinate system or by the localCsys parameter if defined. This parameter is available only if traction is GENERAL.

directionVector=()

A tuple of two points specifying the direction of the load. Each point is specified as a point region or a tuple of coordinates. If traction is SHEAR, then directionVector will be projected onto the region surface. This parameter is available only if traction is GENERAL.

follower=1

A Boolean specifying whether the direction of the force changes with rotation. The default value is ON. This parameter may be modified only if traction is GENERAL. You should provide the follower argument only if it is valid for the specified step.

resultant=0

A Boolean specifying whether to maintain a constant resultant force by defining traction per unit undeformed area. If resultant is OFF, traction is defined per unit deformed area. The default value is OFF. You should provide the resultant argument only if it is valid for the specified step.

traction=NORMAL

A SymbolicConstant specifying how to apply surface traction. Possible values are NORMAL, TRANSVERSE, SHEAR, MOMENT and GENERAL. The default value is NORMAL.

Returns:

A ShellEdgeLoad object.

Return type:

ShellEdgeLoad

SubmodelSB(
name,
createStepName,
region,
globalStep,
globalDrivingRegion='',
absoluteExteriorTolerance=None,
exteriorTolerance=0,
globalIncrement=0,
)[source]

This method creates a SubmodelSB object.

Note

This function can be accessed by:

mdb.models[name].SubmodelSB
Parameters:
name

A String specifying the load repository key.

createStepName

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

region

A Region object specifying the region to which the load is applied.

globalStep

A String specifying the step in the global model from which Abaqus reads the values of the variables that will drive the submodel analysis. The String indicates the position of the step in the sequence of analysis steps. For example, globalStep = ‘1’ indicates the first step.

globalDrivingRegion=''

A String specifying the element set in the global model that will be searched for elements whose responses will be used to drive the submodel. An empty string indicates that the entire global model will be searched. The default value is an empty string.

absoluteExteriorTolerance=None

None or a Float specifying the absolute value by which a driven node of the submodel can lie outside the region of the elements of the global model. The default value is None.

exteriorTolerance=0

None or a Float specifying the fraction of the average element size in the global model by which a driven node of the submodel can lie outside the region of the elements of the global model. The default value is 0.05.

globalIncrement=0

An Int specifying the increment number in the global model step from which the solution will be used to specify the values of the driven variables. If globalIncrement = 0, the solution from the last increment will be used. The globalIncrement argument is applicable only for linear perturbation steps. The default value is 0.

Returns:

A SubmodelSB object.

Return type:

SubmodelSB

SubstructureLoad(
name,
createStepName,
region,
loadCaseNames,
magnitude,
amplitude=UNSET,
)[source]

This method creates a SubstructureLoad object.

Note

This function can be accessed by:

mdb.models[name].SubstructureLoad
Parameters:
name

A String specifying the load repository key.

createStepName

A String specifying the name of the step in which the substructure load is created.

region

A Region object specifying the region to which the load is applied.

loadCaseNames

A list of names of the load cases that should be activated by this substructure load.

magnitude

A Float specifying the multiplier for the load case magnitude.

amplitude=UNSET

A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

Returns:

A SubstructureLoad object.

Return type:

SubstructureLoad

SurfaceCharge(
name,
createStepName,
region,
magnitude,
distributionType=UNIFORM,
field='',
amplitude=UNSET,
)[source]

This method creates a SurfaceCharge object.

Note

This function can be accessed by:

mdb.models[name].SurfaceCharge
Parameters:
name

A String specifying the load repository key.

createStepName

A String specifying the name of the step in which the load is created. This must be the first analysis step name.

region

A Region object specifying the region to which the load is applied.

magnitude

A Float specifying the load magnitude.

distributionType=UNIFORM

A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

field=''

A String specifying the name of the AnalyticalField object associated with this load. The field argument applies only when distributionType = 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 load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

Returns:

A SurfaceCharge object.

Return type:

SurfaceCharge

SurfaceConcentrationFlux(
name,
createStepName,
region,
magnitude,
field='',
distributionType=UNIFORM,
amplitude=UNSET,
)[source]

This method creates a SurfaceConcentrationFlux object.

Note

This function can be accessed by:

mdb.models[name].SurfaceConcentrationFlux
Parameters:
name

A String specifying the load repository key.

createStepName

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

region

A Region object specifying the region to which the load is applied.

magnitude

A Float specifying the surface concentration flux magnitude. magnitude is optional if distributionType = USER_DEFINED.

field=''

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

distributionType=UNIFORM

A SymbolicConstant specifying how the surface concentration flux is distributed spatially. Possible values are UNIFORM, USER_DEFINED, and FIELD. The default value is UNIFORM.

amplitude=UNSET

A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

Returns:

A SurfaceConcentrationFlux object.

Return type:

SurfaceConcentrationFlux

SurfaceCurrent(
name,
createStepName,
region,
magnitude,
distributionType=UNIFORM,
field='',
amplitude=UNSET,
)[source]

This method creates a SurfaceCurrent object.

Note

This function can be accessed by:

mdb.models[name].SurfaceCurrent
Parameters:
name

A String specifying the load repository key.

createStepName

A String specifying the name of the step in which the load is created. This must be the first analysis step name.

region

A Region object specifying the region to which the load is applied.

magnitude

A Float specifying the load magnitude.

distributionType=UNIFORM

A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

field=''

A String specifying the name of the AnalyticalField object associated with this load. The field argument applies only when distributionType = 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 load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

Returns:

A SurfaceCurrent object.

Return type:

SurfaceCurrent

SurfaceCurrentDensity(
name,
createStepName,
region,
comp1,
comp2,
comp3,
distributionType=UNIFORM,
amplitude=UNSET,
)[source]

This method creates a SurfaceCurrentDensity object.

Note

This function can be accessed by:

mdb.models[name].SurfaceCurrentDensity
Parameters:
name

A String specifying the load repository key.

createStepName

A String specifying the name of the step in which the load is created. This must be the first analysis step name.

region

A Region object specifying the region to which the load is applied.

comp1

A Complex specifying the first component of the load.

comp2

A Complex specifying the second component of the load.

comp3

A Complex specifying the third component of the load.

distributionType=UNIFORM

A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and USER_DEFINED. The default value is UNIFORM.

amplitude=UNSET

A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

Returns:

A SurfaceCurrentDensity object.

Return type:

SurfaceCurrentDensity

SurfaceHeatFlux(
name,
createStepName,
region,
magnitude,
field='',
distributionType=UNIFORM,
amplitude=UNSET,
)[source]

This method creates a SurfaceHeatFlux object.

Note

This function can be accessed by:

mdb.models[name].SurfaceHeatFlux
Parameters:
name

A String specifying the load repository key.

createStepName

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

region

A Region object specifying the region to which the load is applied.

magnitude

A Float specifying the surface heat flux magnitude. magnitude is optional if distributionType = USER_DEFINED.

field=''

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

distributionType=UNIFORM

A SymbolicConstant specifying how the surface heat flux is distributed spatially. Possible values are UNIFORM, USER_DEFINED, and FIELD. The default value is UNIFORM.

amplitude=UNSET

A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

Returns:

A SurfaceHeatFlux object.

Return type:

SurfaceHeatFlux

SurfacePoreFluid(
name,
createStepName,
region,
magnitude,
field='',
distributionType=UNIFORM,
amplitude=UNSET,
)[source]

This method creates a SurfacePoreFluid object.

Note

This function can be accessed by:

mdb.models[name].SurfacePoreFluid
Parameters:
name

A String specifying the load repository key.

createStepName

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

region

A Region object specifying the region to which the load is applied.

magnitude

A Float specifying the surface pore fluid flow magnitude. magnitude is optional if distributionType = USER_DEFINED.

field=''

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

distributionType=UNIFORM

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

amplitude=UNSET

A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

Returns:

A SurfacePoreFluid object.

Return type:

SurfacePoreFluid

SurfaceTraction(
name,
createStepName,
region,
magnitude,
distributionType=UNIFORM,
field='',
amplitude=UNSET,
angle=0,
axis=AXIS_1,
localCsys=None,
userCsys='',
directionVector=(),
follower=1,
resultant=0,
traction=SHEAR,
)[source]

This method creates a SurfaceTraction object.

Note

This function can be accessed by:

mdb.models[name].SurfaceTraction
Parameters:
name

A String specifying the load repository key.

createStepName

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

region

A Region object specifying the region to which the load is applied.

magnitude

A Float or Complex specifying the load magnitude. magnitude is optional if distributionType = USER_DEFINED.

distributionType=UNIFORM

A SymbolicConstant specifying how the surface traction is distributed spatially. Possible values are UNIFORM, USER_DEFINED, and FIELD. The default value is UNIFORM.

field=''

A String specifying the name of the AnalyticalField object associated with this load. The field argument applies only when distributionType = 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 load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

angle=0

A Float specifying an additional rotation of directionVector about an axis. The default value is 0.0.

axis=AXIS_1

A SymbolicConstant specifying the axis about which to apply an additional rotation of directionVector. Possible values are AXIS_1, AXIS_2, and AXIS_3. The default value is AXIS_1.

localCsys=None

None or a DatumCsys object specifying the local coordinate system of the load’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system or by the userCsys parameter if defined. When this member is queried, it returns an Int. The default value is None.

userCsys=''

A String specifying a CSYS defined by a user-subroutine. If userCsys = None, the degrees of freedom are defined in the global coordinate system or by the localCsys parameter if defined. The default value is “None”.

directionVector=()

A VertexArray object of length 2 specifying the direction of the load. Instead of through a ConstrainedSketchVertex, each point may be specified through a tuple of coordinates. If traction is SHEAR, then directionVector will be projected onto the region surface. This parameter is available only if traction is GENERAL or SHEAR.

follower=1

A Boolean specifying whether the direction of the force changes with rotation. The default value is ON.This parameter may be modified only if traction is GENERAL. You should provide the follower argument only if it is valid for the specified step.

resultant=0

A Boolean specifying whether the to maintain a constant resultant force by defining traction per unit undeformed area. If resultant is OFF, traction is defined per unit deformed area. The default value is OFF.You should provide the resultant argument only if it is valid for the specified step.

traction=SHEAR

A SymbolicConstant specifying how to apply surface traction. Possible values are SHEAR and GENERAL. The default value is SHEAR.

Returns:

A SurfaceTraction object.

Return type:

SurfaceTraction

Other Classes

class BodyCharge(
name,
createStepName,
region,
magnitude,
amplitude=UNSET,
distributionType=UNIFORM,
field='',
)[source]

Bases: Load

The BodyCharge object stores the data for a body charge. The BodyCharge object is derived from the Load object.

Note

This object can be accessed by:

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

Member Details:

distributionType : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'UNIFORM'[source]

A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

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

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

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

A String specifying the load 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 load is applied.

setValues(amplitude=UNSET, distributionType=UNIFORM, field='')[source]

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

Parameters:
amplitude=UNSET

A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

distributionType=UNIFORM

A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

field=''

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

setValuesInStep(stepName, magnitude=None, amplitude='')[source]

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

Parameters:
stepName

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

magnitude=None

A Float specifying the load magnitude.

amplitude=''

A String or a SymbolicConstant specifying the name of the amplitude reference. Possible values for the SymbolicConstant are UNCHANGED and FREED. UNCHANGED should be used if the amplitude is propagated from the previous static analysis step. FREED should be used if the load is changed to have no amplitude reference. You should provide the amplitude argument only if it is valid for the specified step.

class Load[source]

Bases: object

The Load object is the abstract base type for other Load objects. The Load object has no explicit constructor. The methods and members of the Load object are common to all objects derived from Load.

Note

This object can be accessed by:

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

Member Details:

deactivate(stepName)[source]

This method deactivates the load in the specified step and all its subsequent steps.

Parameters:
stepName

A String specifying the name of the step in which the load is deactivated.

delete(indices)[source]

This method allows you to delete existing loads.

Parameters:
indices

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

move(fromStepName, toStepName)[source]

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

Parameters:
fromStepName

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

toStepName

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

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

A String specifying the load 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 load is applied.

reset(stepName)[source]

This method resets the load state of the specified step to the state of the previous general analysis step.

Parameters:
stepName

A String specifying the name of the step in which the load state is reset.

resume()[source]

This method resumes the load that was previously suppressed.

suppress()[source]

This method suppresses the load.

class BodyChargeState[source]

Bases: LoadState

The BodyChargeState object stores the propagating data of a body charge in a step. One instance of this object is created internally by the BodyCharge object for each step. The instance is also deleted internally by the BodyCharge object. The BodyChargeState object has no constructor or methods. The BodyChargeState object is derived from the LoadState object.

Note

This object can be accessed by:

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

The corresponding analysis keywords are:

  • DECHARGE

Member Details:

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

A String specifying the name of the amplitude reference. The String is empty if the load has no amplitude reference.

amplitudeState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

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

magnitude : --is-rst--:py:class:`float` | :py:obj:`None` = None[source]

A Float specifying the load magnitude.

magnitudeState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the load magnitude. Possible values are UNSET, SET, UNCHANGED, and FREED.

status : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

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

  • NOT_YET_ACTIVE

  • CREATED

  • PROPAGATED

  • MODIFIED

  • DEACTIVATED

  • NO_LONGER_ACTIVE

  • TYPE_NOT_APPLICABLE

  • INSTANCE_NOT_APPLICABLE

  • BUILT_INTO_BASE_STATE

class LoadState[source]

Bases: object

The LoadState object is the abstract base type for other LoadState objects. The LoadState object has no explicit constructor or methods. The members of the LoadState object are common to all objects derived from LoadState.

Note

This object can be accessed by:

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

Member Details:

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

A String specifying the name of the amplitude reference. The String is empty if the load has no amplitude reference.

amplitudeState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

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

status : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

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

  • NOT_YET_ACTIVE

  • CREATED

  • PROPAGATED

  • MODIFIED

  • DEACTIVATED

  • NO_LONGER_ACTIVE

  • TYPE_NOT_APPLICABLE

  • INSTANCE_NOT_APPLICABLE

  • BUILT_INTO_BASE_STATE

class BodyConcentrationFlux(
name,
createStepName,
region,
magnitude,
field='',
distributionType=UNIFORM,
amplitude=UNSET,
)[source]

Bases: Load

The BodyConcentrationFlux object defines body concentration flux from a region or into a region. The BodyConcentrationFlux object is derived from the Load object.

Note

This object can be accessed by:

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

Member Details:

distributionType : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'UNIFORM'[source]

A SymbolicConstant specifying how the body concentration flux is distributed spatially. Possible values are UNIFORM, USER_DEFINED, and FIELD. The default value is UNIFORM.

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

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

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

A String specifying the load 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 load is applied.

setValues(field='', distributionType=UNIFORM, amplitude=UNSET)[source]

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

Parameters:
field=''

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

distributionType=UNIFORM

A SymbolicConstant specifying how the body concentration flux is distributed spatially. Possible values are UNIFORM, USER_DEFINED, and FIELD. The default value is UNIFORM.

amplitude=UNSET

A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

setValuesInStep(stepName, magnitude=None, amplitude='')[source]

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

Parameters:
stepName

A String specifying the name of the step in which the Body heat flux is modified.

magnitude=None

A Float specifying the Body concentration flux magnitude.

amplitude=''

A String or a SymbolicConstant specifying the name of the amplitude reference. Possible values for the SymbolicConstant are UNCHANGED and FREED. UNCHANGED should be used if the amplitude is propagated from the previous analysis step. FREED should be used if the load has no amplitude reference. You should provide the amplitude argument only if it is valid for the specified step.

class BodyConcentrationFluxState[source]

Bases: LoadState

The BodyConcentrationFluxState object stores the propagating data for a BodyConcentrationFlux object in a step. One instance of this object is created internally by the BodyConcentrationFlux object for each step. The instance is also deleted internally by the BodyConcentrationFlux object. The BodyConcentrationFluxState object has no constructor or methods. The BodyConcentrationFluxState object is derived from the LoadState object.

Note

This object can be accessed by:

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

The corresponding analysis keywords are:

  • CFLUX

Member Details:

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

A String specifying the name of the amplitude reference. The String is empty if the load has no amplitude reference.

amplitudeState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

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

magnitude : --is-rst--:py:class:`float` | :py:obj:`None` = None[source]

A Float specifying the body concentration flux magnitude.

magnitudeState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the body concentration flux magnitude. Possible values are UNSET, SET, UNCHANGED, and MODIFIED.

status : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

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

  • NOT_YET_ACTIVE

  • CREATED

  • PROPAGATED

  • MODIFIED

  • DEACTIVATED

  • NO_LONGER_ACTIVE

  • TYPE_NOT_APPLICABLE

  • INSTANCE_NOT_APPLICABLE

  • BUILT_INTO_BASE_STATE

class BodyCurrent(
name,
createStepName,
region,
magnitude,
amplitude=UNSET,
distributionType=UNIFORM,
field='',
)[source]

Bases: Load

The BodyCurrent object stores the data for a body current. The BodyCurrent object is derived from the Load object.

Note

This object can be accessed by:

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

Member Details:

distributionType : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'UNIFORM'[source]

A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

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

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

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

A String specifying the load 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 load is applied.

setValues(amplitude=UNSET, distributionType=UNIFORM, field='')[source]

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

Parameters:
amplitude=UNSET

A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

distributionType=UNIFORM

A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

field=''

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

setValuesInStep(stepName, magnitude=None, amplitude='')[source]

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

Parameters:
stepName

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

magnitude=None

A Float specifying the load magnitude.

amplitude=''

A String or a SymbolicConstant specifying the name of the amplitude reference. Possible values for the SymbolicConstant are UNCHANGED and FREED. UNCHANGED should be used if the amplitude is propagated from the previous static analysis step. FREED should be used if the load is changed to have no amplitude reference. You should provide the amplitude argument only if it is valid for the specified step.

class BodyCurrentDensity(
name,
createStepName,
region,
comp1,
comp2,
comp3,
amplitude=UNSET,
distributionType=UNIFORM,
)[source]

Bases: Load

The BodyCurrentDensity object stores the data for a body current. The BodyCurrentDensity object is derived from the Load object.

Note

This object can be accessed by:

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

Member Details:

distributionType : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'UNIFORM'[source]

A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and USER_DEFINED. The default value is UNIFORM.

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

A String specifying the load 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 load is applied.

setValues(amplitude=UNSET, distributionType=UNIFORM)[source]

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

Parameters:
amplitude=UNSET

A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

distributionType=UNIFORM

A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and USER_DEFINED. The default value is UNIFORM.

setValuesInStep(stepName, comp1='', comp2='', comp3='', amplitude='')[source]

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

Parameters:
stepName

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

comp1=''

A Complex specifying the first component of the load.

comp2=''

A Complex specifying the second component of the load.

comp3=''

A Complex specifying the third component of the load.

amplitude=''

A String or a SymbolicConstant specifying the name of the amplitude reference. Possible values for the SymbolicConstant are UNCHANGED and FREED. UNCHANGED should be used if the amplitude is propagated from the previous static analysis step. FREED should be used if the load is changed to have no amplitude reference. You should provide the amplitude argument only if it is valid for the specified step.

class BodyCurrentState[source]

Bases: LoadState

The BodyCurrentState object stores the propagating data of a body current in a step. One instance of this object is created internally by the BodyCurrent object for each step. The instance is also deleted internally by the BodyCurrent object. The BodyCurrentState object has no constructor or methods. The BodyCurrentState object is derived from the LoadState object.

Note

This object can be accessed by:

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

The corresponding analysis keywords are:

  • DECURRENT

Member Details:

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

A String specifying the name of the amplitude reference. The String is empty if the load has no amplitude reference.

amplitudeState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

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

magnitude : --is-rst--:py:class:`float` | :py:obj:`None` = None[source]

A Float specifying the load magnitude.

magnitudeState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the load magnitude. Possible values are UNSET, SET, UNCHANGED, and FREED.

status : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

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

  • NOT_YET_ACTIVE

  • CREATED

  • PROPAGATED

  • MODIFIED

  • DEACTIVATED

  • NO_LONGER_ACTIVE

  • TYPE_NOT_APPLICABLE

  • INSTANCE_NOT_APPLICABLE

  • BUILT_INTO_BASE_STATE

class BodyForce(
name,
createStepName,
region,
field='',
distributionType=UNIFORM,
comp1=None,
comp2=None,
comp3=None,
amplitude=UNSET,
)[source]

Bases: Load

The BodyForce object defines a distributed load. The BodyForce object is derived from the Load object.

Note

This object can be accessed by:

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

The corresponding analysis keywords are:

  • DLOAD

Member Details:

distributionType : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'UNIFORM'[source]

A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM, USER_DEFINED, and FIELD. The default value is UNIFORM.

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

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

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

A String specifying the load 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 load is applied.

setValues(
field='',
distributionType=UNIFORM,
comp1=None,
comp2=None,
comp3=None,
amplitude=UNSET,
)[source]

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

Parameters:
field=''

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

distributionType=UNIFORM

A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM, USER_DEFINED, and FIELD. The default value is UNIFORM.

comp1=None

A Float or a Complex specifying the body force component in the 1-direction. Note: Although comp1, comp2, and comp3 are optional arguments, at least one of them must be nonzero unless distributionType = USER_DEFINED.

comp2=None

A Float or a Complex specifying the body force component in the 2-direction.

comp3=None

A Float or a Complex specifying the body force component in the 3-direction.

amplitude=UNSET

A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

setValuesInStep(
stepName,
comp1=Ellipsis,
comp2=Ellipsis,
comp3=Ellipsis,
amplitude='',
)[source]

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

Parameters:
stepName

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

comp1=Ellipsis

A Float, a Complex, or the SymbolicConstant UNCHANGED specifying the body force component in the 1-direction. UNCHANGED should be used if the body force component is propagated from the previous analysis step.

comp2=Ellipsis

A Float, a Complex, or the SymbolicConstant UNCHANGED specifying the body force component in the 2-direction. UNCHANGED should be used if the body force component is propagated from the previous analysis step.

comp3=Ellipsis

A Float, a Complex, or the SymbolicConstant UNCHANGED specifying the body force component in the 3-direction. UNCHANGED should be used if the body force component is propagated from the previous analysis step.

amplitude=''

A String or a SymbolicConstant specifying the name of the amplitude reference. Possible values for the SymbolicConstant are UNCHANGED and FREED. UNCHANGED should be used if the amplitude is propagated from the previous analysis step. FREED should be used if the load is changed to have no amplitude reference. You should provide the amplitude argument only if it is valid for the specified step.

class BodyForceState[source]

Bases: LoadState

The BodyForceState object stores the propagating data of a body force in a step. One instance of this object is created internally by the BodyForce object for each step. The instance is also deleted internally by the BodyForce object. The BodyForceState object has no constructor or methods. The BodyForceState object is derived from the LoadState object.

Note

This object can be accessed by:

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

The corresponding analysis keywords are:

  • DLOAD

Member Details:

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

A String specifying the name of the amplitude reference. The String is empty if the load has no amplitude reference.

amplitudeState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

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

comp1 : --is-rst--:py:class:`float` | :py:obj:`None` = None[source]

A Float or a Complex specifying the body force component in the 1-direction.

comp1State : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the body force component in the 1-direction. Possible values are UNSET, SET, UNCHANGED, and MODIFIED.

comp2 : --is-rst--:py:class:`float` | :py:obj:`None` = None[source]

A Float or a Complex specifying the body force component in the 2-direction.

comp2State : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the body force component in the 2-direction. Possible values are UNSET, SET, UNCHANGED, and MODIFIED.

comp3 : --is-rst--:py:class:`float` | :py:obj:`None` = None[source]

A Float or a Complex specifying the body force component in the 3-direction.

comp3State : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the body force component in the 3-direction. Possible values are UNSET, SET, UNCHANGED, and MODIFIED.

status : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

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

  • NOT_YET_ACTIVE

  • CREATED

  • PROPAGATED

  • MODIFIED

  • DEACTIVATED

  • NO_LONGER_ACTIVE

  • TYPE_NOT_APPLICABLE

  • INSTANCE_NOT_APPLICABLE

  • BUILT_INTO_BASE_STATE

class BodyHeatFlux(
name,
createStepName,
region,
magnitude,
field='',
distributionType=UNIFORM,
amplitude=UNSET,
)[source]

Bases: Load

The BodyHeatFlux object defines body heat flux from a region or into a region. The BodyHeatFlux object is derived from the Load object.

Note

This object can be accessed by:

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

Member Details:

distributionType : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'UNIFORM'[source]

A SymbolicConstant specifying how the body heat flux is distributed spatially. Possible values are UNIFORM, USER_DEFINED, and FIELD. The default value is UNIFORM.

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

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

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

A String specifying the load 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 load is applied.

setValues(field='', distributionType=UNIFORM, amplitude=UNSET)[source]

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

Parameters:
field=''

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

distributionType=UNIFORM

A SymbolicConstant specifying how the body heat flux is distributed spatially. Possible values are UNIFORM, USER_DEFINED, and FIELD. The default value is UNIFORM.

amplitude=UNSET

A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

setValuesInStep(stepName, magnitude=None, amplitude='')[source]

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

Parameters:
stepName

A String specifying the name of the step in which the body heat flux is modified.

magnitude=None

A Float specifying the body heat flux magnitude.

amplitude=''

A String or a SymbolicConstant specifying the name of the amplitude reference. Possible values for the SymbolicConstant are UNCHANGED and FREED. UNCHANGED should be used if the amplitude is propagated from the previous analysis step. FREED should be used if the load has no amplitude reference. You should provide the amplitude argument only if it is valid for the specified step.

class BodyHeatFluxState[source]

Bases: LoadState

The BodyHeatFluxState object stores the propagating data for a Body BodyHeatFlux object in a step. One instance of this object is created internally by the BodyHeatFlux object for each step. The instance is also deleted internally by the BodyHeatFlux object. The BodyHeatFluxState object has no constructor or methods. The BodyHeatFluxState object is derived from the LoadState object.

Note

This object can be accessed by:

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

The corresponding analysis keywords are:

  • DFLUX

Member Details:

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

A String specifying the name of the amplitude reference. The String is empty if the load has no amplitude reference.

amplitudeState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

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

magnitude : --is-rst--:py:class:`float` | :py:obj:`None` = None[source]

A Float specifying the Body heat flux magnitude.

magnitudeState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the Body heat flux magnitude. Possible values are UNSET, SET, UNCHANGED, and MODIFIED.

status : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

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

  • NOT_YET_ACTIVE

  • CREATED

  • PROPAGATED

  • MODIFIED

  • DEACTIVATED

  • NO_LONGER_ACTIVE

  • TYPE_NOT_APPLICABLE

  • INSTANCE_NOT_APPLICABLE

  • BUILT_INTO_BASE_STATE

class BoltLoad(
name,
createStepName,
region,
magnitude,
datumAxis,
boltMethod=APPLY_FORCE,
amplitude=UNSET,
preTenSecPartLevel=False,
)[source]

Bases: Load

The BoltLoad object defines a bolt load. The BoltLoad object is derived from the Load object.

Note

This object can be accessed by:

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

The corresponding analysis keywords are:

  • PRE-TENSION SECTION
    • NODE

  • NSET

Member Details:

datumAxis : --is-rst--:py:class:`~abaqus.Datum.DatumAxis.DatumAxis` = <abaqus.Datum.DatumAxis.DatumAxis object>[source]

A DatumAxis object specifying the orientation of the pre-tension section normal. Note: datumAxis is required only for Solid and Shell regions; it has no meaning for Wire regions.

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

A String specifying the load 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 load is applied.

setValues(
boltMethod=APPLY_FORCE,
datumAxis=None,
amplitude=UNSET,
preTenSecPartLevel=False,
)[source]

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

Parameters:
boltMethod=APPLY_FORCE

A SymbolicConstant specifying the method of applying the bolt load. Possible values are APPLY_FORCE and ADJUST_LENGTH. The default value is APPLY_FORCE.

datumAxis=None

A DatumAxis object specifying the orientation of the pre-tension section normal. Note: datumAxis is applicable only for Solid and Shell regions; it has no meaning for Wire regions.

amplitude=UNSET

A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

preTenSecPartLevel=False

A Boolean specifying whether the pre-tension section is to be defined at the part level. The default value is False. You should provide the preTenSecPartLevel argument only if the selected region belongs to a dependent part instance. A pre-tension section cannot be defined at the part level for independent and model instances.

setValuesInStep(stepName, boltMethod=APPLY_FORCE, magnitude=None, amplitude='')[source]

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

Parameters:
stepName

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

boltMethod=APPLY_FORCE

A SymbolicConstant specifying the type of bolt load. Possible values are APPLY_FORCE, ADJUST_LENGTH, and FIX_LENGTH. The default is APPLY_FORCE.

magnitude=None

A Float specifying the bolt load magnitude.

amplitude=''

A String or a SymbolicConstant specifying the name of the amplitude reference. Possible values for the SymbolicConstant are UNCHANGED and FREED. UNCHANGED should be used if the amplitude is propagated from the previous analysis step. FREED should be used if the load is changed to have no amplitude reference. You should provide the amplitude argument only if it is valid for the specified step.

class BoltLoadState[source]

Bases: LoadState

The BoltLoadState object stores the propagating data of a bolt load in a step. One instance of this object is created internally by the BoltLoad object for each step. The instance is also deleted internally by the BoltLoad object. The BoltLoadState object has no constructor or methods. The BoltLoadState object is derived from the LoadState object.

Note

This object can be accessed by:

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

The corresponding analysis keywords are:

  • CLOAD

  • BOUNDARY

Member Details:

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

A String specifying the name of the amplitude reference. The String is empty if the load has no amplitude reference.

amplitudeState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

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

boltMethod : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the type of bolt load. Possible values are APPLY_FORCE, ADJUST_LENGTH, and FIX_LENGTH.

boltMethodState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the bolt load type. Possible values are UNSET, SET, UNCHANGED, and MODIFIED.

magnitude : --is-rst--:py:class:`float` | :py:obj:`None` = None[source]

A Float specifying the bolt load magnitude.

magnitudeState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the bolt load magnitude. Possible values are UNSET, SET, UNCHANGED, and MODIFIED.

status : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

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

  • NOT_YET_ACTIVE

  • CREATED

  • PROPAGATED

  • MODIFIED

  • DEACTIVATED

  • NO_LONGER_ACTIVE

  • TYPE_NOT_APPLICABLE

  • INSTANCE_NOT_APPLICABLE

  • BUILT_INTO_BASE_STATE

class ConcCharge(
name,
createStepName,
region,
magnitude,
distributionType=UNIFORM,
field='',
amplitude=UNSET,
)[source]

Bases: Load

The ConcCharge object stores the data for a concentrated charge. The ConcCharge object is derived from the Load object.

Note

This object can be accessed by:

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

Member Details:

distributionType : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'UNIFORM'[source]

A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

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

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

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

A String specifying the load 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 load is applied.

setValues(distributionType=UNIFORM, field='', amplitude=UNSET)[source]

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

Parameters:
distributionType=UNIFORM

A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

field=''

A String specifying the name of the AnalyticalField object associated with this load. The field argument applies only when distributionType = 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 load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

setValuesInStep(stepName, magnitude=None, amplitude='')[source]

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

Parameters:
stepName

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

magnitude=None

A Float specifying the load magnitude.

amplitude=''

A String or a SymbolicConstant specifying the name of the amplitude reference. Possible values for the SymbolicConstant are UNCHANGED and FREED. UNCHANGED should be used if the amplitude is propagated from the previous static analysis step. FREED should be used if the load is changed to have no amplitude reference. You should provide the amplitude argument only if it is valid for the specified step.

class ConcConcFlux(
name,
createStepName,
region,
magnitude,
distributionType=UNIFORM,
field='',
amplitude=UNSET,
)[source]

Bases: Load

The ConcConcFlux object stores the data for a concentrated concentration flux. The ConcConcFlux object is derived from the Load object.

Note

This object can be accessed by:

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

Member Details:

distributionType : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'UNIFORM'[source]

A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

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

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

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

A String specifying the load 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 load is applied.

setValues(distributionType=UNIFORM, field='', amplitude=UNSET)[source]

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

Parameters:
distributionType=UNIFORM

A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

field=''

A String specifying the name of the AnalyticalField object associated with this load. The field argument applies only when distributionType = 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 load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

setValuesInStep(stepName, magnitude=None, amplitude='')[source]

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

Parameters:
stepName

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

magnitude=None

A Float specifying the load magnitude.

amplitude=''

A String or a SymbolicConstant specifying the name of the amplitude reference. Possible values for the SymbolicConstant are UNCHANGED and FREED. UNCHANGED should be used if the amplitude is propagated from the previous static analysis step. FREED should be used if the load is changed to have no amplitude reference. You should provide the amplitude argument only if it is valid for the specified step.

class ConcCurrent(
name,
createStepName,
region,
magnitude,
distributionType=UNIFORM,
field='',
amplitude=UNSET,
)[source]

Bases: Load

The ConcCurrent object stores the data for a concentrated current. The ConcCurrent object is derived from the Load object.

Note

This object can be accessed by:

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

Member Details:

distributionType : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'UNIFORM'[source]

A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

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

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

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

A String specifying the load 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 load is applied.

setValues(distributionType=UNIFORM, field='', amplitude=UNSET)[source]

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

Parameters:
distributionType=UNIFORM

A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

field=''

A String specifying the name of the AnalyticalField object associated with this load. The field argument applies only when distributionType = 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 load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

setValuesInStep(stepName, magnitude=None, amplitude='')[source]

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

Parameters:
stepName

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

magnitude=None

A Float specifying the load magnitude.

amplitude=''

A String or a SymbolicConstant specifying the name of the amplitude reference. Possible values for the SymbolicConstant are UNCHANGED and FREED. UNCHANGED should be used if the amplitude is propagated from the previous static analysis step. FREED should be used if the load is changed to have no amplitude reference. You should provide the amplitude argument only if it is valid for the specified step.

class ConcCurrentState[source]

Bases: LoadState

The ConcCurrentState object stores the propagating data of a concentrated current in a step. One instance of this object is created internally by the ConcCurrent object for each step. The instance is also deleted internally by the ConcCurrent object. The ConcCurrentState object has no constructor or methods. The ConcCurrentState object is derived from the LoadState object.

Note

This object can be accessed by:

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

The corresponding analysis keywords are:

  • CECURRENT

Member Details:

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

A String specifying the name of the amplitude reference. The String is empty if the load has no amplitude reference.

amplitudeState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

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

magnitude : --is-rst--:py:class:`float` | :py:obj:`None` = None[source]

A Float specifying the load magnitude.

magnitudeState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the load magnitude. Possible values are UNSET, SET, UNCHANGED, and FREED.

status : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

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

  • NOT_YET_ACTIVE

  • CREATED

  • PROPAGATED

  • MODIFIED

  • DEACTIVATED

  • NO_LONGER_ACTIVE

  • TYPE_NOT_APPLICABLE

  • INSTANCE_NOT_APPLICABLE

  • BUILT_INTO_BASE_STATE

class ConcPoreFluid(
name,
createStepName,
region,
magnitude,
distributionType=UNIFORM,
field='',
amplitude=UNSET,
)[source]

Bases: Load

The ConcPoreFluid object stores the data for a concentrated pore fluid flow load. The ConcPoreFluid object is derived from the Load object.

Note

This object can be accessed by:

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

Member Details:

distributionType : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'UNIFORM'[source]

A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

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

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

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

A String specifying the load 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 load is applied.

setValues(distributionType=UNIFORM, field='', amplitude=UNSET)[source]

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

Parameters:
distributionType=UNIFORM

A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

field=''

A String specifying the name of the AnalyticalField object associated with this load. The field argument applies only when distributionType = 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 load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

setValuesInStep(stepName, magnitude=None, amplitude='')[source]

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

Parameters:
stepName

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

magnitude=None

A Float specifying the load magnitude.

amplitude=''

A String or a SymbolicConstant specifying the name of the amplitude reference. Possible values for the SymbolicConstant are UNCHANGED and FREED. UNCHANGED should be used if the amplitude is propagated from the previous static analysis step. FREED should be used if the load is changed to have no amplitude reference. You should provide the amplitude argument only if it is valid for the specified step.

class ConcentratedChargeState[source]

Bases: LoadState

The ConcentratedChargeState object stores the propagating data of a concentrated charge in a step. One instance of this object is created internally by the ConcCharge object for each step. The instance is also deleted internally by the ConcCharge object. The ConcentratedChargeState object has no constructor or methods. The ConcentratedChargeState object is derived from the LoadState object.

Note

This object can be accessed by:

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

The corresponding analysis keywords are:

  • CECHARGE

Member Details:

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

A String specifying the name of the amplitude reference. The String is empty if the load has no amplitude reference.

amplitudeState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

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

magnitude : --is-rst--:py:class:`float` | :py:obj:`None` = None[source]

A Float specifying the load magnitude.

magnitudeState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the load magnitude. Possible values are UNSET, SET, UNCHANGED, and FREED.

status : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

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

  • NOT_YET_ACTIVE

  • CREATED

  • PROPAGATED

  • MODIFIED

  • DEACTIVATED

  • NO_LONGER_ACTIVE

  • TYPE_NOT_APPLICABLE

  • INSTANCE_NOT_APPLICABLE

  • BUILT_INTO_BASE_STATE

class ConcentratedConcentrationFluxState[source]

Bases: LoadState

The ConcentratedConcentrationFluxState object stores the propagating data of a concentrated concentration flux in a step. One instance of this object is created internally by the ConcConcFlux object for each step. The instance is also deleted internally by the ConcConcFlux object. The ConcentratedConcentrationFluxState object has no constructor or methods. The ConcentratedConcentrationFluxState object is derived from the LoadState object.

Note

This object can be accessed by:

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

The corresponding analysis keywords are:

  • CFLUX

Member Details:

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

A String specifying the name of the amplitude reference. The String is empty if the load has no amplitude reference.

amplitudeState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

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

magnitude : --is-rst--:py:class:`float` | :py:obj:`None` = None[source]

A Float specifying the load magnitude.

magnitudeState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the load magnitude. Possible values are UNSET, SET, UNCHANGED, and FREED.

status : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

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

  • NOT_YET_ACTIVE

  • CREATED

  • PROPAGATED

  • MODIFIED

  • DEACTIVATED

  • NO_LONGER_ACTIVE

  • TYPE_NOT_APPLICABLE

  • INSTANCE_NOT_APPLICABLE

  • BUILT_INTO_BASE_STATE

class ConcentratedForce(
name,
createStepName,
region,
distributionType=UNIFORM,
field='',
cf1=None,
cf2=None,
cf3=None,
amplitude=UNSET,
follower=0,
localCsys=None,
)[source]

Bases: Load

The ConcentratedForce object defines a concentrated force. The ConcentratedForce object is derived from the Load object.

Note

This object can be accessed by:

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

Member Details:

distributionType : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'UNIFORM'[source]

A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

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

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

follower : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]

A Boolean specifying whether the direction of the force rotates with the rotation at each node of the region. You should provide the follower argument only if it is valid for the specified step. The default value is OFF.

localCsys : --is-rst--:py:class:`int` | :py:obj:`None` = None[source]

None or a DatumCsys object specifying the local coordinate system of the load’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. When this member is queried, it returns an Int. The default value is None.

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

A String specifying the load 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 load is applied.

setValues(
distributionType=UNIFORM,
field='',
cf1=None,
cf2=None,
cf3=None,
amplitude=UNSET,
follower=0,
localCsys=None,
)[source]

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

Parameters:
distributionType=UNIFORM

A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

field=''

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

cf1=None

A Float or a Complex specifying the concentrated force component in the 1-direction. Although cf1, cf2, and cf3 are optional arguments, at least one of them must be nonzero.

cf2=None

A Float or a Complex specifying the concentrated force component in the 2-direction.

cf3=None

A Float or a Complex specifying the concentrated force component in the 3-direction.

amplitude=UNSET

A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

follower=0

A Boolean specifying whether the direction of the force rotates with the rotation at each node of the region. You should provide the follower argument only if it is valid for the specified step. The default value is OFF.

localCsys=None

None or a DatumCsys object specifying the local coordinate system of the load’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. When this member is queried, it returns an Int. The default value is None.

setValuesInStep(
stepName,
cf1=Ellipsis,
cf2=Ellipsis,
cf3=Ellipsis,
amplitude='',
)[source]

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

Parameters:
stepName

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

cf1=Ellipsis

A Float, a Complex, or the SymbolicConstant UNCHANGED specifying the concentrated force component in the 1-direction. UNCHANGED should be used if the concentrated force component is propagated from the previous analysis step.

cf2=Ellipsis

A Float, a Complex, or the SymbolicConstant UNCHANGED specifying the concentrated force component in the 2-direction. UNCHANGED should be used if the concentrated force component is propagated from the previous analysis step.

cf3=Ellipsis

A Float, a Complex, or the SymbolicConstant UNCHANGED specifying the concentrated force component in the 3-direction. UNCHANGED should be used if the concentrated force component is propagated from the previous analysis step.

amplitude=''

A String or a SymbolicConstant specifying the name of the amplitude reference. Possible values for the SymbolicConstant are UNCHANGED and FREED. UNCHANGED should be used if the amplitude is propagated from the previous analysis step. FREED should be used if the load is changed to have no amplitude reference. You should provide the amplitude argument only if it is valid for the specified step.

class ConcentratedForceState[source]

Bases: LoadState

The ConcentratedForceState object stores the propagating data for a concentrated force in a step. One instance of this object is created internally by the ConcentratedForce object for each step. The instance is also deleted internally by the ConcentratedForce object. The ConcentratedForceState object has no constructor or methods. The ConcentratedForceState object is derived from the LoadState object.

Note

This object can be accessed by:

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

The corresponding analysis keywords are:

  • CLOAD

Member Details:

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

A String specifying the name of the amplitude reference. The String is empty if the load has no amplitude reference. - NOT_YET_ACTIVE - CREATED - PROPAGATED - MODIFIED - DEACTIVATED - NO_LONGER_ACTIVE - TYPE_NOT_APPLICABLE - INSTANCE_NOT_APPLICABLE - BUILT_INTO_BASE_STATE

amplitudeState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

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

cf1 : --is-rst--:py:class:`float` | :py:obj:`None` = None[source]

A Float or a Complex specifying the concentrated force component in the 1-direction. Although cf1, cf2, and cf3 are optional arguments, at least one of them must be nonzero.

cf1State : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the concentrated force component in the 1-direction. Possible values are UNSET, SET, UNCHANGED, and MODIFIED.

cf2 : --is-rst--:py:class:`float` | :py:obj:`None` = None[source]

A Float or a Complex specifying the concentrated force component in the 2-direction.

cf2State : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the concentrated force component in the 2-direction. Possible values are UNSET, SET, UNCHANGED, and MODIFIED.

cf3 : --is-rst--:py:class:`float` | :py:obj:`None` = None[source]

A Float or a Complex specifying the concentrated force component in the 3-direction.

cf3State : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the concentrated force component in the 3-direction. Possible values are UNSET, SET, UNCHANGED, and MODIFIED.

status : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

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

class ConcentratedHeatFlux(
name,
createStepName,
region,
magnitude,
distributionType=UNIFORM,
field='',
amplitude=UNSET,
dof=11,
)[source]

Bases: Load

The ConcentratedHeatFlux object stores the data for a concentrated heat flux load. The ConcentratedHeatFlux object is derived from the Load object.

Note

This object can be accessed by:

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

Member Details:

distributionType : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'UNIFORM'[source]

A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

dof : --is-rst--:py:class:`int` = 11[source]

An Int specifying the degree of freedom of the node, to which the concentrated heat flux should be applied. The default value is 11.

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

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

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

A String specifying the load 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 load is applied.

setValues(
distributionType=UNIFORM,
field='',
amplitude=UNSET,
dof=11,
)[source]

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

Parameters:
distributionType=UNIFORM

A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

field=''

A String specifying the name of the AnalyticalField object associated with this load. The field argument applies only when distributionType = 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 load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

dof=11

An Int specifying the degree of freedom of the node, to which the concentrated heat flux should be applied. The default value is 11.

setValuesInStep(stepName, magnitude=None, amplitude='')[source]

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

Parameters:
stepName

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

magnitude=None

A Float specifying the load magnitude.

amplitude=''

A String or a SymbolicConstant specifying the name of the amplitude reference. Possible values for the SymbolicConstant are UNCHANGED and FREED. UNCHANGED should be used if the amplitude is propagated from the previous static analysis step. FREED should be used if the load is changed to have no amplitude reference. You should provide the amplitude argument only if it is valid for the specified step.

class ConcentratedHeatFluxState[source]

Bases: LoadState

The ConcentratedHeatFluxState object stores the propagating data of a concentrated heat flux load in a step. One instance of this object is created internally by the ConcentratedHeatFlux object for each step. The instance is also deleted internally by the ConcentratedHeatFlux object. The ConcentratedHeatFluxState object has no constructor or methods. The ConcentratedHeatFluxState object is derived from the LoadState object.

Note

This object can be accessed by:

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

The corresponding analysis keywords are:

  • CFLUX

Member Details:

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

A String specifying the name of the amplitude reference. The String is empty if the load has no amplitude reference.

amplitudeState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

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

magnitude : --is-rst--:py:class:`float` | :py:obj:`None` = None[source]

A Float specifying the load magnitude.

magnitudeState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the load magnitude. Possible values are UNSET, SET, UNCHANGED, and FREED.

status : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

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

  • NOT_YET_ACTIVE

  • CREATED

  • PROPAGATED

  • MODIFIED

  • DEACTIVATED

  • NO_LONGER_ACTIVE

  • TYPE_NOT_APPLICABLE

  • INSTANCE_NOT_APPLICABLE

  • BUILT_INTO_BASE_STATE

class ConcentratedPoreFluidState[source]

Bases: LoadState

The ConcentratedPoreFluidState object stores the propagating data of a concentrated pore fluid flow load in a step. One instance of this object is created internally by the ConcPoreFluid object for each step. The instance is also deleted internally by the ConcPoreFluid object. The ConcentratedPoreFluidState object has no constructor or methods. The ConcentratedPoreFluidState object is derived from the LoadState object.

Note

This object can be accessed by:

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

The corresponding analysis keywords are:

  • CLOAD

Member Details:

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

A String specifying the name of the amplitude reference. The String is empty if the load has no amplitude reference.

amplitudeState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

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

magnitude : --is-rst--:py:class:`float` | :py:obj:`None` = None[source]

A Float specifying the load magnitude.

magnitudeState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the load magnitude. Possible values are UNSET, SET, UNCHANGED, and FREED.

status : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

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

  • NOT_YET_ACTIVE

  • CREATED

  • PROPAGATED

  • MODIFIED

  • DEACTIVATED

  • NO_LONGER_ACTIVE

  • TYPE_NOT_APPLICABLE

  • INSTANCE_NOT_APPLICABLE

  • BUILT_INTO_BASE_STATE

class ConnectorForce(
name,
createStepName,
region='',
fastenerName='',
fastenerSetName='',
f1=None,
f2=None,
f3=None,
amplitude=UNSET,
)[source]

Bases: Load

The ConnectorForce object defines a connector force. The ConnectorForce object is derived from the Load object.

Note

This object can be accessed by:

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

Member Details:

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

A String specifying the name of the assembled fastener to which the load will be applied. This argument is not valid when region is specified. When this argument is specified, fastenerSetName must also be specified. The default value is an empty string.

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

A String specifying the assembled fastener template model set to which the load will be applied. This argument is not valid when region is specified. When this argument is specified, fastenerName must also be specified. The default value is an empty string.

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

A String specifying the load 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 load is applied.

setValues(
region='',
fastenerName='',
fastenerSetName='',
f1=None,
f2=None,
f3=None,
amplitude=UNSET,
)[source]

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

Parameters:
region=''

The wire region to which the load is applied. This argument is not valid when fastenerName and fastenerSetName are specified.

fastenerName=''

A String specifying the name of the assembled fastener to which the load will be applied. This argument is not valid when region is specified. When this argument is specified, fastenerSetName must also be specified. The default value is an empty string.

fastenerSetName=''

A String specifying the assembled fastener template model set to which the load will be applied. This argument is not valid when region is specified. When this argument is specified, fastenerName must also be specified. The default value is an empty string.

f1=None

A Float or a Complex specifying the connector force component in the connector’s local 1-direction. Note: Although f1, f2, and f3 are optional arguments, at least one of them must be nonzero.

f2=None

A Float or a Complex specifying the connector force component in the connector’s local 2-direction.

f3=None

A Float or a Complex specifying the connector force component in the connector’s local 3-direction.

amplitude=UNSET

A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

setValuesInStep(
stepName,
f1=Ellipsis,
f2=Ellipsis,
f3=Ellipsis,
amplitude='',
)[source]

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

Parameters:
stepName

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

f1=Ellipsis

A Float, a Complex, or the SymbolicConstant UNCHANGED specifying the connector force component in the connector’s local 1-direction. UNCHANGED should be used if the connector force component is propagated from the previous analysis step.

f2=Ellipsis

A Float, a Complex, or the SymbolicConstant UNCHANGED specifying the connector force component in the connector’s local 2-direction. UNCHANGED should be used if the connector force component is propagated from the previous analysis step.

f3=Ellipsis

A Float, a Complex, or the SymbolicConstant UNCHANGED specifying the connector force component in the connector’s local 3-direction. UNCHANGED should be used if the connector force component is propagated from the previous analysis step.

amplitude=''

A String or a SymbolicConstant specifying the name of the amplitude reference. Possible values for the SymbolicConstant are UNCHANGED and FREED. UNCHANGED should be used if the amplitude is propagated from the previous analysis step. FREED should be used if the load is changed to have no amplitude reference. You should provide the amplitude argument only if it is valid for the specified step.

class ConnectorForceState[source]

Bases: LoadState

The ConnectorForceState object stores the propagating data for a connector force in a step. One instance of this object is created internally by the ConnectorForce object for each step. The instance is also deleted internally by the ConnectorForce object. The ConnectorForceState object has no constructor or methods. The ConnectorForceState object is derived from the LoadState object.

Note

This object can be accessed by:

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

The corresponding analysis keywords are:

  • CONNECTOR LOAD

Member Details:

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

A String specifying the name of the amplitude reference. The String is empty if the load has no amplitude reference.

amplitudeState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

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

f1 : --is-rst--:py:class:`float` | :py:obj:`None` = None[source]

A Float or a Complex specifying the connector force component in the connector’s local 1-direction.

f1State : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the connector force component in the connector’s local 1-direction. Possible values are UNSET, SET, UNCHANGED, and MODIFIED.

f2 : --is-rst--:py:class:`float` | :py:obj:`None` = None[source]

A Float or a Complex specifying the connector force component in the connector’s local 2-direction.

f2State : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the connector force component in the connector’s local 2-direction. Possible values are UNSET, SET, UNCHANGED, and MODIFIED.

f3 : --is-rst--:py:class:`float` | :py:obj:`None` = None[source]

A Float or a Complex specifying the connector force component in the connector’s local 3-direction.

f3State : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the connector force component in the connector’s local 3-direction. Possible values are UNSET, SET, UNCHANGED, and MODIFIED.

status : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

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

  • NOT_YET_ACTIVE

  • CREATED

  • PROPAGATED

  • MODIFIED

  • DEACTIVATED

  • NO_LONGER_ACTIVE

  • TYPE_NOT_APPLICABLE

  • INSTANCE_NOT_APPLICABLE

  • BUILT_INTO_BASE_STATE

class ConnectorMoment(
name,
createStepName,
region='',
fastenerName='',
fastenerSetName='',
m1=None,
m2=None,
m3=None,
amplitude=UNSET,
)[source]

Bases: Load

The ConnectorMoment object stores the data for a connector moment. The ConnectorMoment object is derived from the Load object.

Note

This object can be accessed by:

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

Member Details:

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

A String specifying the name of the assembled fastener to which the load will be applied. This argument is not valid when region is specified. When this argument is specified, fastenerSetName must also be specified. The default value is an empty string.

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

A String specifying the assembled fastener template model set to which the load will be applied. This argument is not valid when region is specified. When this argument is specified, fastenerName must also be specified. The default value is an empty string.

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

A String specifying the load 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 load is applied.

setValues(
region='',
fastenerName='',
fastenerSetName='',
m1=None,
m2=None,
m3=None,
amplitude=UNSET,
)[source]

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

Parameters:
region=''

The wire region to which the load is applied. This argument is not valid when fastenerName and fastenerSetName are specified.

fastenerName=''

A String specifying the name of the assembled fastener to which the load will be applied. This argument is not valid when region is specified. When this argument is specified, fastenerSetName must also be specified. The default value is an empty string.

fastenerSetName=''

A String specifying the assembled fastener template model set to which the load will be applied. This argument is not valid when region is specified. When this argument is specified, fastenerName must also be specified. The default value is an empty string.

m1=None

A Float or a Complex specifying the moment component in the connector’s local 4-direction.

m2=None

A Float or a Complex specifying the moment component in the connector’s local 5-direction.

m3=None

A Float or a Complex specifying the moment component in the connector’s local 6-direction.

amplitude=UNSET

A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

setValuesInStep(
stepName,
m1=Ellipsis,
m2=Ellipsis,
m3=Ellipsis,
amplitude='',
)[source]

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

Parameters:
stepName

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

m1=Ellipsis

A Float, a Complex, or a SymbolicConstant specifying the moment component in the connector’s local 4-direction. Possible values for the SymbolicConstant are UNCHANGED and FREED. UNCHANGED should be used if the load component is propagated from the previous static analysis step. Use FREED to remove a previously defined load component.

m2=Ellipsis

A Float, a Complex, or a SymbolicConstant specifying the moment component in the connector’s local 5-direction. Possible values for the SymbolicConstant are UNCHANGED and FREED. UNCHANGED should be used if the load component is propagated from the previous static analysis step. Use FREED to remove a previously defined load component.

m3=Ellipsis

A Float, a Complex, or a SymbolicConstant specifying the moment component in the connector’s local 6-direction. Possible values for the SymbolicConstant are UNCHANGED and FREED. UNCHANGED should be used if the load component is propagated from the previous static analysis step. Use FREED to remove a previously defined load component.

amplitude=''

A String or a SymbolicConstant specifying the name of the amplitude reference. Possible values for the SymbolicConstant are UNCHANGED and FREED. UNCHANGED should be used if the amplitude is propagated from the previous static analysis step. FREED should be used if the load is changed to have no amplitude reference. You should provide the amplitude argument only if it is valid for the specified step.

class ConnectorMomentState[source]

Bases: LoadState

The ConnectorMomentState object stores the propagating data for a connector moment in a step. One instance of this object is created internally by the ConnectorMoment object for each step. The instance is also deleted internally by the ConnectorMoment object. The ConnectorMomentState object has no constructor or methods. The ConnectorMomentState object is derived from the LoadState object.

Note

This object can be accessed by:

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

The corresponding analysis keywords are:

  • CONNECTOR LOAD

Member Details:

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

A String specifying the name of the amplitude reference. The String is empty if the load has no amplitude reference.

amplitudeState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

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

m1 : --is-rst--:py:class:`float` | :py:obj:`None` = None[source]

A Float or a Complex specifying the connector moment component in the connector’s local 4-direction. Although m1, m2, and m3 are optional arguments, at least one of them must be nonzero.

m1State : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the load component in the connector’s local 4-direction. Possible values are UNSET, SET, UNCHANGED, and FREED.

m2 : --is-rst--:py:class:`float` | :py:obj:`None` = None[source]

A Float or a Complex specifying the connector moment component in the connector’s local 5direction.

m2State : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the load component in the connector’s local 5-direction. Possible values are UNSET, SET, UNCHANGED, and FREED.

m3 : --is-rst--:py:class:`float` | :py:obj:`None` = None[source]

A Float or a Complex specifying the connector moment component in the connector’s local 6-direction.

m3State : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the load component in the connector’s local 6-direction. Possible values are UNSET, SET, UNCHANGED, and FREED.

status : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

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

  • NOT_YET_ACTIVE

  • CREATED

  • PROPAGATED

  • MODIFIED

  • DEACTIVATED

  • NO_LONGER_ACTIVE

  • TYPE_NOT_APPLICABLE

  • INSTANCE_NOT_APPLICABLE

  • BUILT_INTO_BASE_STATE

class CoriolisForce(
name,
createStepName,
region,
magnitude,
point1,
point2,
amplitude=UNSET,
distributionType=UNIFORM,
field='',
)[source]

Bases: Load

The CoriolisForce object stores the data for a coriolis force. The CoriolisForce object is derived from the Load object.

Note

This object can be accessed by:

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

Member Details:

distributionType : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'UNIFORM'[source]

A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

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

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

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

A String specifying the load repository key.

point1 : --is-rst--:py:class:`float` | :py:obj:`None` = None[source]

A tuple of Floats specifying the first point on the axis of rotation for the load.

point2 : --is-rst--:py:class:`float` | :py:obj:`None` = None[source]

A tuple of Floats specifying the second point on the axis of rotation for the load.

region : --is-rst--:py:class:`~abaqus.Region.Region.Region` = <abaqus.Region.Region.Region object>[source]

A Region object specifying the region to which the load is applied.

setValues(amplitude=UNSET, distributionType=UNIFORM, field='')[source]

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

Parameters:
amplitude=UNSET

A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

distributionType=UNIFORM

A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

field=''

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

setValuesInStep(stepName, magnitude=None, amplitude='')[source]

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

Parameters:
stepName

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

magnitude=None

A Float specifying the load magnitude.

amplitude=''

A String or a SymbolicConstant specifying the name of the amplitude reference. Possible values for the SymbolicConstant are UNCHANGED and FREED. UNCHANGED should be used if the amplitude is propagated from the previous static analysis step. FREED should be used if the load is changed to have no amplitude reference. You should provide the amplitude argument only if it is valid for the specified step.

class CoriolisForceState[source]

Bases: LoadState

The CoriolisForceState object stores the propagating data of a coriolis force in a step. One instance of this object is created internally by the CoriolisForce object for each step. The instance is also deleted internally by the CoriolisForce object. The CoriolisForceState object has no constructor or methods. The CoriolisForceState object is derived from the LoadState object.

Note

This object can be accessed by:

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

The corresponding analysis keywords are:

  • DLOAD

Member Details:

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

A String specifying the name of the amplitude reference. The String is empty if the load has no amplitude reference.

amplitudeState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

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

magnitude : --is-rst--:py:class:`float` | :py:obj:`None` = None[source]

A Float specifying the load magnitude.

magnitudeState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the load magnitude. Possible values are UNSET, SET, UNCHANGED, and FREED.

status : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

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

  • NOT_YET_ACTIVE

  • CREATED

  • PROPAGATED

  • MODIFIED

  • DEACTIVATED

  • NO_LONGER_ACTIVE

  • TYPE_NOT_APPLICABLE

  • INSTANCE_NOT_APPLICABLE

  • BUILT_INTO_BASE_STATE

class Gravity(
name,
createStepName,
distributionType=UNIFORM,
field='',
region=None,
comp1=None,
comp2=None,
comp3=None,
amplitude=UNSET,
)[source]

Bases: Load

The Gravity object stores the data of a gravity load. The Gravity object is derived from the Load object.

Note

This object can be accessed by:

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

Member Details:

distributionType : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'UNIFORM'[source]

A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

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

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

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

A String specifying the load 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 load is applied.

setValues(
distributionType=UNIFORM,
field='',
region=None,
comp1=None,
comp2=None,
comp3=None,
amplitude=UNSET,
)[source]

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

Parameters:
distributionType=UNIFORM

A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

field=''

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

region=None

A Region object specifying the region to which the load is applied.

comp1=None

A Float or a Complex specifying the component of the load in the 1-direction. Note: Although comp1, comp2, and comp3 are optional arguments, at least one of them must be nonzero.

comp2=None

A Float or a Complex specifying the component of the load in the 2-direction.

comp3=None

A Float or a Complex specifying the component of the load in the 3-direction.

amplitude=UNSET

A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

setValuesInStep(
stepName,
comp1=Ellipsis,
comp2=Ellipsis,
comp3=Ellipsis,
amplitude='',
)[source]

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

Parameters:
stepName

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

comp1=Ellipsis

A Float, a Complex, or a SymbolicConstant specifying the load component in the 1-direction. Possible values for the SymbolicConstant are UNCHANGED and FREED. UNCHANGED should be used if the load component is propagated from the previous static analysis step. Use FREED to remove a previously defined load component.

comp2=Ellipsis

A Float, a Complex, or a SymbolicConstant specifying the load component in the 2-direction. For details see comp1.

comp3=Ellipsis

A Float, a Complex, or a SymbolicConstant specifying the load component in the 3-direction. For details see comp1.

amplitude=''

A String or a SymbolicConstant specifying the name of the amplitude reference. Possible values for the SymbolicConstant are UNCHANGED and FREED. UNCHANGED should be used if the amplitude is propagated from the previous static analysis step. FREED should be used if the load is changed to have no amplitude reference. You should provide the amplitude argument only if it is valid for the specified step.

class GravityState[source]

Bases: LoadState

The GravityState object stores the propagating data for a gravity load in a step. One instance of this object is created internally by the Gravity object for each step. The instance is also deleted internally by the Gravity object. The GravityState object has no constructor or methods. The GravityState object is derived from the LoadState object.

Note

This object can be accessed by:

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

The corresponding analysis keywords are:

  • DLOAD

Member Details:

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

A String specifying the name of the amplitude reference. The String is empty if the load has no amplitude reference.

amplitudeState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

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

comp1 : --is-rst--:py:class:`float` | :py:obj:`None` = None[source]

A Float or a Complex specifying the load component in the 1-direction.

comp1State : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the load component in the 1-direction. Possible values are UNSET, SET, UNCHANGED, and FREED.

comp2 : --is-rst--:py:class:`float` | :py:obj:`None` = None[source]

A Float or a Complex specifying the load component in the 2-direction.

comp2State : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the load component in the 2-direction. Possible values are UNSET, SET, UNCHANGED, and FREED.

comp3 : --is-rst--:py:class:`float` | :py:obj:`None` = None[source]

A Float or a Complex specifying the load component in the 3-direction.

comp3State : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the load component in the 3-direction. Possible values are UNSET, SET, UNCHANGED, and FREED.

status : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

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

  • NOT_YET_ACTIVE

  • CREATED

  • PROPAGATED

  • MODIFIED

  • DEACTIVATED

  • NO_LONGER_ACTIVE

  • TYPE_NOT_APPLICABLE

  • INSTANCE_NOT_APPLICABLE

  • BUILT_INTO_BASE_STATE

class HydrostaticFluidFlowState[source]

Bases: LoadState

The HydrostaticFluidFlowState object stores the propagating data for a concentrated HydrostaticFluidFlow object in a step. One instance of this object is created internally by the HydrostaticFluidFlow object for each step. The instance is also deleted internally by the HydrostaticFluidFlow object. The HydrostaticFluidFlowState object has no constructor or methods. The HydrostaticFluidFlowState object is derived from the LoadState object.

Note

This object can be accessed by:

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

The corresponding analysis keywords are:

  • FLUID FLUX

Member Details:

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

A String specifying the name of the amplitude reference. The String is empty if the load has no amplitude reference.

amplitudeState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

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

magnitude : --is-rst--:py:class:`float` | :py:obj:`None` = None[source]

A Float specifying the load magnitude.

magnitudeState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the load magnitude. Possible values are UNSET, SET, UNCHANGED, and FREED.

status : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

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

  • NOT_YET_ACTIVE

  • CREATED

  • PROPAGATED

  • MODIFIED

  • DEACTIVATED

  • NO_LONGER_ACTIVE

  • TYPE_NOT_APPLICABLE

  • INSTANCE_NOT_APPLICABLE

  • BUILT_INTO_BASE_STATE

class InertiaRelief(
name,
createStepName,
u1=0,
u2=0,
u3=0,
ur1=0,
ur2=0,
ur3=0,
referencePoint=(),
localCoordinates=None,
)[source]

Bases: Load

The InertiaRelief object defines an inertia relief load. The InertiaRelief object is derived from the Load object.

Note

This object can be accessed by:

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

Member Details:

localCoordinates : --is-rst--:py:class:`int` | :py:obj:`None` = None[source]

None or a DatumCsys object specifying the local coordinate system of the rigid body degrees of freedom for the inertia relief load. If localCoordinates = None, the free directions are defined in the global coordinate system. When this member is queried, it returns an Int. The default value is None.

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

A String specifying the load 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 load is applied.

setValues(
u1=0,
u2=0,
u3=0,
ur1=0,
ur2=0,
ur3=0,
referencePoint=(),
localCoordinates=None,
)[source]

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

Parameters:
u1=0

A Boolean specifying the 1-direction as a free direction. Note: Although u1, u2, u3, ur1, ur2, and ur3 are optional arguments, at least one of them must be specified. Further, any specified set of free directions cannot include only two rotational degrees of freedom.

u2=0

A Boolean specifying the 2-direction as a free direction.

u3=0

A Boolean specifying the 3-direction as a free direction.

ur1=0

A Boolean specifying the rotation about the 1-direction as a free direction.

ur2=0

A Boolean specifying the rotation about the 2-direction as a free direction.

ur3=0

A Boolean specifying the rotation about the 3-direction as a free direction.

referencePoint=()

A sequence of Floats specifying the X, Y and Z coordinates of a fixed rotation point or a point on the rotation axis or a point on the symmetry line, about which rotations are defined. Such a point must be specified only for certain combinations of free directions.

localCoordinates=None

None or a DatumCsys object specifying the local coordinate system of the rigid body degrees of freedom for the inertia relief load. If localCoordinates = None, the free directions are defined in the global coordinate system. When this member is queried, it returns an Int. The default value is None.

setValuesInStep(
stepName,
u1=0,
u2=0,
u3=0,
ur1=0,
ur2=0,
ur3=0,
referencePoint=(),
fixed=0,
)[source]

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

Parameters:
stepName

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

u1=0

A Boolean specifying the 1-direction as a free direction.

u2=0

A Boolean specifying the 2-direction as a free direction.

u3=0

A Boolean specifying the 3-direction as a free direction.

ur1=0

A Boolean specifying the rotation about the 1-direction as a free direction.

ur2=0

A Boolean specifying the rotation about the 2-direction as a free direction.

ur3=0

A Boolean specifying the rotation about the 3-direction as a free direction.

referencePoint=()

A sequence of Floats specifying the point about which rotations are defined. The point can be specified only for certain combinations of free directions. The referencePoint argument can be one of the following:

  • The X, Y and Z coordinates of a fixed rotation point.

  • A point on the rotation axis.

  • A point on the symmetry line.

fixed=0

A Boolean specifying whether the inertia relief loading should remain fixed at the current loading at the start of the step. The default value is OFF.

class InertiaReliefState[source]

Bases: LoadState

The InertiaReliefState object stores the propagating data for an inertia relief load in a step. One instance of this object is created internally by the InertiaRelief object for each step. The instance is also deleted internally by the InertiaRelief object. The InertiaReliefState object has no constructor or methods. The InertiaReliefState object is derived from the LoadState object.

Note

This object can be accessed by:

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

The corresponding analysis keywords are:

  • INERTIA RELIEF

Member Details:

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

A String specifying the name of the amplitude reference. The String is empty if the load has no amplitude reference.

amplitudeState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

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

fixed : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]

A Boolean specifying whether the inertia relief loading should remain fixed at the current loading at the start of the step. The default value is OFF.

fixedState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the Boolean that identifies whether the inertia relief load should remain fixed at current level at the start of the step. Possible values are UNSET, SET, UNCHANGED, and MODIFIED.

referencePoint : --is-rst--:py:class:`float` | :py:obj:`None` = None[source]

A tuple of Floats specifying the point about which rotations are defined. The point can be specified only for certain combinations of free directions. The referencePoint argument can be one of the following: - The X, Y and Z coordinates of a fixed rotation point. - A point on the rotation axis. - A point on the symmetry line.

referencePointState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the reference point of the inertia relief load. Possible values are UNSET, SET, UNCHANGED, and MODIFIED.

status : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

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

  • NOT_YET_ACTIVE

  • CREATED

  • PROPAGATED

  • MODIFIED

  • DEACTIVATED

  • NO_LONGER_ACTIVE

  • TYPE_NOT_APPLICABLE

  • INSTANCE_NOT_APPLICABLE

  • BUILT_INTO_BASE_STATE

u1 : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]

A Boolean specifying the 1-direction as a free direction.

u1State : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the Boolean that identifies the local 1-direction as a free direction. Possible values are UNSET, SET, UNCHANGED, and MODIFIED.

u2 : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]

A Boolean specifying the 2-direction as a free direction.

u2State : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the Boolean that identifies the local 2-direction as a free direction. Possible values are UNSET, SET, UNCHANGED, and MODIFIED.

u3 : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]

A Boolean specifying the 3-direction as a free direction.

u3State : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the Boolean that identifies the local the 3-direction as a free direction. Possible values are UNSET, SET, UNCHANGED, and MODIFIED.

ur1 : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]

A Boolean specifying the rotation about the 1-direction as a free direction.

ur1State : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the Boolean that identifies rotation about the local 1-direction as a free direction. Possible values are UNSET, SET, UNCHANGED, and MODIFIED.

ur2 : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]

A Boolean specifying the rotation about the 2-direction as a free direction.

ur2State : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the Boolean that identifies the rotation about the local the 2-direction as a free direction. Possible values are UNSET, SET, UNCHANGED, and MODIFIED.

ur3 : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]

A Boolean specifying the rotation about the 3-direction as a free direction.

ur3State : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the Boolean that identifies the rotation about the local the 3-direction as a free direction. Possible values are UNSET, SET, UNCHANGED, and MODIFIED.

class InwardVolAccel(
name,
createStepName,
region,
magnitude,
distributionType=UNIFORM,
field='',
amplitude=UNSET,
)[source]

Bases: Load

The InwardVolAccel object stores the data for an inward volume acceleration acoustic load. The InwardVolAccel object is derived from the Load object.

Note

This object can be accessed by:

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

Member Details:

distributionType : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'UNIFORM'[source]

A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

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

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

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

A String specifying the load 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 load is applied.

setValues(distributionType=UNIFORM, field='', amplitude=UNSET)[source]

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

Parameters:
distributionType=UNIFORM

A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

field=''

A String specifying the name of the AnalyticalField object associated with this load. The field argument applies only when distributionType = 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 load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

setValuesInStep(stepName, magnitude=None, amplitude='')[source]

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

Parameters:
stepName

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

magnitude=None

A Float specifying the load magnitude.

amplitude=''

A String or a SymbolicConstant specifying the name of the amplitude reference. Possible values for the SymbolicConstant are UNCHANGED and FREED. UNCHANGED should be used if the amplitude is propagated from the previous static analysis step. FREED should be used if the load is changed to have no amplitude reference. You should provide the amplitude argument only if it is valid for the specified step.

class InwardVolAccelState[source]

Bases: LoadState

The InwardVolAccelState object stores the propagating data of an inward volume acceleration acoustic load in a step. One instance of this object is created internally by the InwardVolAccel object for each step. The instance is also deleted internally by the InwardVolAccel object. The InwardVolAccelState object has no constructor or methods. The InwardVolAccelState object is derived from the LoadState object.

Note

This object can be accessed by:

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

The corresponding analysis keywords are:

  • CLOAD

Member Details:

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

A String specifying the name of the amplitude reference. The String is empty if the load has no amplitude reference.

amplitudeState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

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

magnitude : --is-rst--:py:class:`float` | :py:obj:`None` = None[source]

A Float specifying the load magnitude.

magnitudeState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the load magnitude. Possible values are UNSET, SET, UNCHANGED, and FREED.

status : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

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

  • NOT_YET_ACTIVE

  • CREATED

  • PROPAGATED

  • MODIFIED

  • DEACTIVATED

  • NO_LONGER_ACTIVE

  • TYPE_NOT_APPLICABLE

  • INSTANCE_NOT_APPLICABLE

  • BUILT_INTO_BASE_STATE

class LineLoad(
name,
createStepName,
region,
distributionType=UNIFORM,
field='',
comp1=None,
comp2=None,
comp3=None,
amplitude=UNSET,
system=GLOBAL,
)[source]

Bases: Load

The LineLoad object stores the data of an applied line load. The LineLoad object is derived from the Load object.

Note

This object can be accessed by:

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

Member Details:

distributionType : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'UNIFORM'[source]

A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM, USER_DEFINED, and FIELD. The default value is UNIFORM.

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

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

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

A String specifying the load 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 load is applied.

setValues(
distributionType=UNIFORM,
field='',
comp1=None,
comp2=None,
comp3=None,
amplitude=UNSET,
system=GLOBAL,
)[source]

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

Parameters:
distributionType=UNIFORM

A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM, USER_DEFINED, and FIELD. The default value is UNIFORM.

field=''

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

comp1=None

A Float or a Complex specifying the component of the load in the global or the beam local 1-direction. Note: Although comp1, comp2, and comp3 are optional arguments, at least one of them must be nonzero unless distributionType = USER_DEFINED.

comp2=None

A Float or a Complex specifying the component of the load in the global or the beam local 2-direction.

comp3=None

A Float or a Complex specifying the component of the load in the global 3-direction.

amplitude=UNSET

A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

system=GLOBAL

A SymbolicConstant specifying whether the load is applied in a global or the beam local frame of reference. Possible values are GLOBAL and LOCAL. The default value is GLOBAL.

setValuesInStep(
stepName,
comp1=Ellipsis,
comp2=Ellipsis,
comp3=Ellipsis,
amplitude='',
)[source]

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

Parameters:
stepName

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

comp1=Ellipsis

A Float, a Complex, or a SymbolicConstant specifying the load component in the global or the beam local 1-direction. Possible values for the SymbolicConstant are UNCHANGED and FREED. UNCHANGED should be used if the load component is propagated from the previous static analysis step. Use FREED to remove a previously defined load component.

comp2=Ellipsis

A Float, a Complex, or a SymbolicConstant specifying the load component in the global or the beam local 2-direction. For details see comp1.

comp3=Ellipsis

A Float, a Complex, or a SymbolicConstant specifying the load component in the global 3-direction. For details see comp1.

amplitude=''

A String or a SymbolicConstant specifying the name of the amplitude reference. Possible values for the SymbolicConstant are UNCHANGED and FREED. UNCHANGED should be used if the amplitude is propagated from the previous static analysis step. FREED should be used if the load is changed to have no amplitude reference. You should provide the amplitude argument only if it is valid for the specified step.

system : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'GLOBAL'[source]

A SymbolicConstant specifying whether the load is applied in a global or the beam local frame of reference. Possible values are GLOBAL and LOCAL. The default value is GLOBAL.

class LineLoadState[source]

Bases: LoadState

The LineLoadState object stores the propagating data of a line load in a step. One instance of this object is created internally by the LineLoad object for each step. The instance is also deleted internally by the LineLoad object. The LineLoadState object has no constructor or methods. The LineLoadState object is derived from the LoadState object.

Note

This object can be accessed by:

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

The corresponding analysis keywords are:

  • DLOAD

Member Details:

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

A String specifying the name of the amplitude reference. The String is empty if the load has no amplitude reference.

amplitudeState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

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

comp1 : --is-rst--:py:class:`float` | :py:obj:`None` = None[source]

A Float or a Complex specifying the load component in the global or the beam local 1-direction.

comp1State : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the load component in the global or the beam local 1-direction. Possible values are UNSET, SET, UNCHANGED, and FREED.

comp2 : --is-rst--:py:class:`float` | :py:obj:`None` = None[source]

A Float or a Complex specifying the load component in the global or the beam local 2-direction.

comp2State : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the load component in the global or the beam local 2-direction. Possible values are UNSET, SET, UNCHANGED, and FREED.

comp3 : --is-rst--:py:class:`float` | :py:obj:`None` = None[source]

A Float or a Complex specifying the load component in the global 3-direction.

comp3State : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the load component in the global 3-direction. Possible values are UNSET, SET, UNCHANGED, and FREED.

status : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

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

  • NOT_YET_ACTIVE

  • CREATED

  • PROPAGATED

  • MODIFIED

  • DEACTIVATED

  • NO_LONGER_ACTIVE

  • TYPE_NOT_APPLICABLE

  • INSTANCE_NOT_APPLICABLE

  • BUILT_INTO_BASE_STATE

class LoadCase(name, boundaryConditions=(), loads=(), includeActiveBaseStateBC=1)[source]

Bases: object

The LoadCase object is used to define the loads and constraints comprising a particular loading condition and the linear response of a structure subjected to that loading condition.

Note

This object can be accessed by:

import step
mdb.models[name].steps[name].loadCases[name]

Member Details:

resume()[source]

This method resumes the load case that was previously suppressed.

setValues(boundaryConditions=(), loads=(), includeActiveBaseStateBC=1)[source]

This method modifies the LoadCase object.

Parameters:
boundaryConditions=()

A sequence of (String, Float) sequences specifying the name of a BoundaryCondition followed by a nonzero Float scaling factor. The default value is an empty sequence.

loads=()

A sequence of (String, Float) sequences specifying the name of a Load followed by a nonzero Float specifying a scale factor. The default value is an empty sequence.

includeActiveBaseStateBC=1

A Boolean specifying whether to include all active boundary conditions propagated or modified from the base state. The default value is ON.

suppress()[source]

This method suppresses the load case.

suppressed : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]

A Boolean specifying whether the load case is suppressed or not. The default value is OFF.

class Moment(
name,
createStepName,
region,
cm1=None,
cm2=None,
cm3=None,
amplitude=UNSET,
follower=0,
localCsys=None,
distributionType=UNIFORM,
field='',
)[source]

Bases: Load

The Moment object stores the data for a moment. The Moment object is derived from the Load object.

Note

This object can be accessed by:

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

Member Details:

distributionType : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'UNIFORM'[source]

A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

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

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

follower : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]

A Boolean specifying whether the direction of the force rotates with the rotation of the node. You should provide the follower argument only if it is valid for the specified step. The default value is OFF.

localCsys : --is-rst--:py:class:`int` | :py:obj:`None` = None[source]

None or a DatumCsys object specifying the ID of the Datum coordinate system used as the local coordinate system of the load. If localCsys = None, the load is defined in the global coordinate system. When this member is queried, it returns an Int. The default value is None.

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

A String specifying the load 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 load is applied.

setValues(
cm1=None,
cm2=None,
cm3=None,
amplitude=UNSET,
follower=0,
localCsys=None,
distributionType=UNIFORM,
field='',
)[source]

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

Parameters:
cm1=None

A Float or a Complex specifying the load component in the 4-direction. Note: Although comp1, comp2, and comp3 are optional arguments, at least one of them must be nonzero.

cm2=None

A Float or a Complex specifying the load component in the 5- direction.

cm3=None

A Float or a Complex specifying the load component in the 6-direction.

amplitude=UNSET

A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

follower=0

A Boolean specifying whether the direction of the force rotates with the rotation of the node. You should provide the follower argument only if it is valid for the specified step. The default value is OFF.

localCsys=None

None or a DatumCsys object specifying the ID of the Datum coordinate system used as the local coordinate system of the load. If localCsys = None, the load is defined in the global coordinate system. When this member is queried, it returns an Int. The default value is None.

distributionType=UNIFORM

A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

field=''

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

setValuesInStep(
stepName,
comp1=Ellipsis,
comp2=Ellipsis,
comp3=Ellipsis,
amplitude='',
)[source]

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

Parameters:
stepName

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

comp1=Ellipsis

A Float, a Complex, or a SymbolicConstant specifying the load component in the 4-direction. Possible values for the SymbolicConstant are UNCHANGED and FREED. UNCHANGED should be used if the load component is propagated from the previous static analysis step. Use FREED to remove a previously defined load component.

comp2=Ellipsis

A Float, a Complex, or a SymbolicConstant specifying the load component in the 5-direction. For details see comp1.

comp3=Ellipsis

A Float, a Complex, or a SymbolicConstant specifying the load component in the 6-direction. For details see comp1.

amplitude=''

A String or a SymbolicConstant specifying the name of the amplitude reference. Possible values for the SymbolicConstant are UNCHANGED and FREED. UNCHANGED should be used if the amplitude is propagated from the previous static analysis step. FREED should be used if the load is changed to have no amplitude reference. You should provide the amplitude argument only if it is valid for the specified step.

class PEGLoad(
name,
createStepName,
region,
distributionType=UNIFORM,
field='',
comp1=None,
comp2=None,
comp3=None,
amplitude=UNSET,
)[source]

Bases: Load

The PEGLoad object stores the data for a PEG load. The PEGLoad object is derived from the Load object.

Note

This object can be accessed by:

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

Member Details:

distributionType : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'UNIFORM'[source]

A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

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

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

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

A String specifying the load 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 load is applied.

setValues(
distributionType=UNIFORM,
field='',
comp1=None,
comp2=None,
comp3=None,
amplitude=UNSET,
)[source]

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

Parameters:
distributionType=UNIFORM

A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

field=''

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

comp1=None

A Float or a Complex specifying the load component at dof 1 of reference node 1. Note: Although comp1, comp2, and comp3 are optional arguments, at least one of them must be nonzero.

comp2=None

A Float or a Complex specifying the load component at dof 1 of reference node 2.

comp3=None

A Float or a Complex specifying the load component at dof 2 of reference node 2.

amplitude=UNSET

A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

setValuesInStep(
stepName,
comp1=Ellipsis,
comp2=Ellipsis,
comp3=Ellipsis,
amplitude='',
)[source]

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

Parameters:
stepName

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

comp1=Ellipsis

A Float, a Complex, or a SymbolicConstant specifying the load component at dof 1 of reference node 1. Possible values for the SymbolicConstant are UNCHANGED and FREED. UNCHANGED should be used if the load component is propagated from the previous static analysis step. Use FREED to remove a previously defined load component.

comp2=Ellipsis

A Float, a Complex, or a SymbolicConstant specifying the load component at dof 1 of reference node 2. For details see comp1.

comp3=Ellipsis

A Float, a Complex, or a SymbolicConstant specifying the load component at dof 2 of reference node 2. For details see comp1.

amplitude=''

A String or a SymbolicConstant specifying the name of the amplitude reference. Possible values for the SymbolicConstant are UNCHANGED and FREED. UNCHANGED should be used if the amplitude is propagated from the previous static analysis step. FREED should be used if the load is changed to have no amplitude reference. You should provide the amplitude argument only if it is valid for the specified step.

class PipePressure(
name,
createStepName,
region,
magnitude,
diameter,
hZero,
hReference,
field='',
amplitude=UNSET,
distributionType=UNIFORM,
side=INTERNAL,
)[source]

Bases: Load

The PipePressure object stores the data for a pressure applied to pipe or elbow elements. The PipePressure object is derived from the Load object.

Note

This object can be accessed by:

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

Member Details:

diameter : --is-rst--:py:class:`float` | :py:obj:`None` = None[source]

A Float specifying the effective inner or outer diameter.

distributionType : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'UNIFORM'[source]

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

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

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

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

A String specifying the load 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 load is applied.

setValues(field='', amplitude=UNSET, distributionType=UNIFORM, side=INTERNAL)[source]

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

Parameters:
field=''

A String specifying the name of the AnalyticalField object associated with this load. The field argument applies only when distributionType = 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 load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

distributionType=UNIFORM

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

side=INTERNAL

A SymbolicConstant specifying whether the pressure is applied internally or externally. Possible values are INTERNAL and EXTERNAL. The default value is INTERNAL.

setValuesInStep(
stepName,
magnitude=None,
hZero=None,
hReference=None,
amplitude='',
)[source]

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

Parameters:
stepName

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

magnitude=None

A Float specifying the pressure magnitude.

hZero=None

A Float specifying the height of the zero pressure level when distributionType = HYDROSTATIC.

hReference=None

A Float specifying the height of the reference pressure level when distributionType = HYDROSTATIC.

amplitude=''

A String or a SymbolicConstant specifying the name of the amplitude reference. Possible values for the SymbolicConstant are UNCHANGED and FREED. UNCHANGED should be used if the amplitude is propagated from the previous static analysis step. FREED should be used if the load has no amplitude reference. You should provide the amplitude argument only if it is valid for the specified step.

side : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'INTERNAL'[source]

A SymbolicConstant specifying whether the pressure is applied internally or externally. Possible values are INTERNAL and EXTERNAL. The default value is INTERNAL.

class Pressure(
name,
createStepName,
region,
magnitude=0.0,
hZero=0.0,
hReference=0.0,
field='',
refPoint='',
distributionType=UNIFORM,
amplitude=UNSET,
)[source]

Bases: Load

The Pressure object defines a pressure load. The Pressure object is derived from the Load object.

Note

This object can be accessed by:

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

Member Details:

distributionType : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'UNIFORM'[source]

A SymbolicConstant specifying how the pressure is distributed spatially. Possible values are UNIFORM, USER_DEFINED, FIELD, HYDROSTATIC, STAGNATION, VISCOUS, TOTAL_FORCE, and DISCRETE_FIELD. The default value is UNIFORM.

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

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

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

A String specifying the load 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 load is applied.

setValues(field='', refPoint='', distributionType=UNIFORM, amplitude=UNSET)[source]

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

Parameters:
field=''

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

refPoint=''

A Region specifying the reference point from which the relative velocity is determined when distributionType = STAGNATION or VISCOUS.

distributionType=UNIFORM

A SymbolicConstant specifying how the pressure is distributed spatially. Possible values are UNIFORM, USER_DEFINED, FIELD, HYDROSTATIC, STAGNATION, VISCOUS, TOTAL_FORCE, and DISCRETE_FIELD. The default value is UNIFORM.

amplitude=UNSET

A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

setValuesInStep(
stepName,
magnitude=None,
hZero=None,
hReference=None,
amplitude='',
)[source]

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

Parameters:
stepName

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

magnitude=None

A Float or a Complex specifying the pressure magnitude.

hZero=None

A Float specifying the height of the zero pressure level when distributionType = HYDROSTATIC.

hReference=None

A Float specifying the height of the reference pressure level when distributionType = HYDROSTATIC.

amplitude=''

A String or a SymbolicConstant specifying the name of the amplitude reference. Possible values for the SymbolicConstant are UNCHANGED and FREED. UNCHANGED should be used if the amplitude is propagated from the previous analysis step. FREED should be used if the load has no amplitude reference. You should provide the amplitude argument only if it is valid for the specified step.

class RotationalBodyForce(
name,
createStepName,
region,
magnitude,
point1,
point2,
distributionType=UNIFORM,
field='',
centrifugal=0,
rotaryAcceleration=0,
amplitude=UNSET,
)[source]

Bases: Load

The RotationalBodyForce object stores the data for a rotational body force. The RotationalBodyForce object is derived from the Load object.

Note

This object can be accessed by:

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

Member Details:

centrifugal : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]

A Boolean specifying whether or not the effect of the load is centrifugal. The default value is OFF. Note: At least one of centrifugal or rotaryAcceleration must be specified and only one must have the value ON.

distributionType : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'UNIFORM'[source]

A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

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

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

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

A String specifying the load repository key.

point1 : --is-rst--:py:class:`float` | :py:obj:`None` = None[source]

A tuple of Floats specifying the first point on the axis of rotation for the load.

point2 : --is-rst--:py:class:`float` | :py:obj:`None` = None[source]

A tuple of Floats specifying the second point on the axis of rotation for the load.

region : --is-rst--:py:class:`~abaqus.Region.Region.Region` = <abaqus.Region.Region.Region object>[source]

A Region object specifying the region to which the load is applied.

rotaryAcceleration : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]

A Boolean specifying whether or not the effect of the load is rotary acceleration. The default value is OFF. Note: At least one of centrifugal or rotaryAcceleration must be specified and only one must have the value ON.

setValues(
distributionType=UNIFORM,
field='',
centrifugal=0,
rotaryAcceleration=0,
amplitude=UNSET,
)[source]

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

Parameters:
distributionType=UNIFORM

A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

field=''

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

centrifugal=0

A Boolean specifying whether or not the effect of the load is centrifugal. The default value is OFF. Note: At least one of centrifugal or rotaryAcceleration must be specified and only one must have the value ON.

rotaryAcceleration=0

A Boolean specifying whether or not the effect of the load is rotary acceleration. The default value is OFF. Note: At least one of centrifugal or rotaryAcceleration must be specified and only one must have the value ON.

amplitude=UNSET

A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

setValuesInStep(stepName, magnitude=None, amplitude='')[source]

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

Parameters:
stepName

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

magnitude=None

A Float specifying the load magnitude.

amplitude=''

A String or a SymbolicConstant specifying the name of the amplitude reference. Possible values for the SymbolicConstant are UNCHANGED and FREED. UNCHANGED should be used if the amplitude is propagated from the previous static analysis step. FREED should be used if the load is changed to have no amplitude reference. You should provide the amplitude argument only if it is valid for the specified step.

class ShellEdgeLoad(
name,
createStepName,
region,
magnitude,
distributionType=UNIFORM,
field='',
amplitude=UNSET,
angle=0,
axis=AXIS_1,
localCsys=GENERAL,
userCsys=GENERAL,
directionVector=(),
follower=1,
resultant=0,
traction=NORMAL,
)[source]

Bases: Load

The ShellEdgeLoad object defines shell edge loads on a region. The ShellEdgeLoad object is derived from the Load object.

Note

This object can be accessed by:

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

Member Details:

distributionType : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'UNIFORM'[source]

A SymbolicConstant specifying how the shell edge load is distributed spatially. Possible values are UNIFORM, USER_DEFINED, and FIELD. The default value is UNIFORM.

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

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

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

A String specifying the load 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 load is applied.

setValues(
distributionType=UNIFORM,
field='',
amplitude=UNSET,
angle=0,
axis=AXIS_1,
localCsys=GENERAL,
userCsys=GENERAL,
directionVector=(),
follower=1,
resultant=0,
traction=NORMAL,
)[source]

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

Parameters:
distributionType=UNIFORM

A SymbolicConstant specifying how the shell edge load is distributed spatially. Possible values are UNIFORM, USER_DEFINED, and FIELD. The default value is UNIFORM.

field=''

A String specifying the name of the AnalyticalField object associated with this load. The field argument applies only when distributionType = 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 load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

angle=0

A Float specifying an additional rotation of directionVector about an axis. The default value is 0.This parameter is available only if traction is GENERAL.

axis=AXIS_1

A SymbolicConstant specifying the axis about which to apply an additional rotation of directionVector. Possible values are AXIS_1, AXIS_2, AXIS_3. The default value is AXIS_1.This parameter is available only if traction is GENERAL.

localCsys=GENERAL

A DatumCsys object specifying the local coordinate system of the load’s degrees of freedom. The default value is None, indicating that the degrees of freedom are defined in the global coordinate system or by the userCsys parameter if defined. This parameter is available only if traction is GENERAL. When this member is queried, it returns an Int.

userCsys=GENERAL

A String specifying a CSYS defined by a user-subroutine. The default value is None, indicating that the degrees of freedom are defined in the global coordinate system or by the localCsys parameter if defined. This parameter is available only if traction is GENERAL.

directionVector=()

A tuple of two points specifying the direction of the load. Each point is specified as a point region or a tuple of coordinates. If traction is SHEAR, then directionVector will be projected onto the region surface. This parameter is available only if traction is GENERAL.

follower=1

A Boolean specifying whether the direction of the force changes with rotation. The default value is ON. This parameter may be modified only if traction is GENERAL. You should provide the follower argument only if it is valid for the specified step.

resultant=0

A Boolean specifying whether to maintain a constant resultant force by defining traction per unit undeformed area. If resultant is OFF, traction is defined per unit deformed area. The default value is OFF. You should provide the resultant argument only if it is valid for the specified step.

traction=NORMAL

A SymbolicConstant specifying how to apply surface traction. Possible values are NORMAL, TRANSVERSE, SHEAR, MOMENT and GENERAL. The default value is NORMAL.

setValuesInStep(stepName, magnitude=Ellipsis, amplitude='')[source]

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

Parameters:
stepName

A String specifying the name of the step in which the surface pore fluid flow is modified.

magnitude=Ellipsis

A Float, a Complex, or the SymbolicConstant UNCHANGED specifying the load magnitude. UNCHANGED should be used if the magnitude is propagated from the previous analysis step.

amplitude=''

A String or a SymbolicConstant specifying the name of the amplitude reference. Possible values for the SymbolicConstant are UNCHANGED and FREED. UNCHANGED should be used if the amplitude is propagated from the previous analysis step. FREED should be used if the load has no amplitude reference. You should provide the amplitude argument only if it is valid for the specified step.

class SubmodelSB(
name,
createStepName,
region,
globalStep,
globalDrivingRegion='',
absoluteExteriorTolerance=None,
exteriorTolerance=0,
globalIncrement=0,
)[source]

Bases: Load

The SubmodelSB object stores the data for a submodel surface based load. The SubmodelSB object is derived from the Load object.

Note

This object can be accessed by:

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

Member Details:

absoluteExteriorTolerance : --is-rst--:py:class:`float` | :py:obj:`None` = None[source]

None or a Float specifying the absolute value by which a driven node of the submodel can lie outside the region of the elements of the global model. The default value is None.

exteriorTolerance : --is-rst--:py:class:`float` = 0[source]

None or a Float specifying the fraction of the average element size in the global model by which a driven node of the submodel can lie outside the region of the elements of the global model. The default value is 0.05.

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

A String specifying the element set in the global model that will be searched for elements whose responses will be used to drive the submodel. An empty string indicates that the entire global model will be searched. The default value is an empty string.

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

A String specifying the load 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 load is applied.

setValues(
globalDrivingRegion='',
absoluteExteriorTolerance=None,
exteriorTolerance=0,
globalIncrement=0,
)[source]

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

Parameters:
globalDrivingRegion=''

A String specifying the element set in the global model that will be searched for elements whose responses will be used to drive the submodel. An empty string indicates that the entire global model will be searched. The default value is an empty string.

absoluteExteriorTolerance=None

None or a Float specifying the absolute value by which a driven node of the submodel can lie outside the region of the elements of the global model. The default value is None.

exteriorTolerance=0

None or a Float specifying the fraction of the average element size in the global model by which a driven node of the submodel can lie outside the region of the elements of the global model. The default value is 0.05.

globalIncrement=0

An Int specifying the increment number in the global model step from which the solution will be used to specify the values of the driven variables. If globalIncrement = 0, the solution from the last increment will be used. The globalIncrement argument is applicable only for linear perturbation steps. The default value is 0.

setValuesInStep(stepName, fixed=1, globalStep='', globalIncrement=0)[source]

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

Parameters:
stepName

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

fixed=1

A Boolean specifying whether the load should remain fixed at the current values at the start of the step. The default value is ON.

globalStep=''

A String specifying the step in the global model from which Abaqus reads the values of the variables that will drive the submodel analysis. The String indicates the position of the step in the sequence of analysis steps. For example, globalStep = ‘1’ indicates the first step. The globalStep argument is applicable only if fixed = OFF.

globalIncrement=0

An Int specifying the increment number in the global model step at which the solution will be used to specify the values of the driven variables. If globalIncrement = 0, the solution from the last increment will be used. The globalIncrement argument is applicable only for linear perturbation steps and if fixed = OFF. The default value is 0.

class SubstructureLoad(name, createStepName, region, loadCaseNames, magnitude, amplitude=UNSET)[source]

Bases: Load

The SubstructureLoad object defines a substructure load. The SubstructureLoad object is derived from the Load object.

Note

This object can be accessed by:

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

Member Details:

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

A String specifying the load 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 load is applied.

setValues(amplitude=UNSET)[source]

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

Parameters:
amplitude=UNSET

A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

setValuesInStep(stepName, loadCaseNames='', magnitude=None, amplitude='')[source]

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

Parameters:
stepName

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

loadCaseNames=''

A list of names of the load cases that should be activated by this substructure load.

magnitude=None

A Float specifying the multiplier for the load case magnitude.

amplitude=''

A String or a SymbolicConstant specifying the name of the amplitude reference. Possible values for the SymbolicConstant are UNCHANGED and FREED. UNCHANGED should be used if the amplitude is propagated from the previous analysis step. FREED should be used if the load has no amplitude reference. You should provide the amplitude argument only if it is valid for the specified step.

class SurfaceCharge(
name,
createStepName,
region,
magnitude,
distributionType=UNIFORM,
field='',
amplitude=UNSET,
)[source]

Bases: Load

The SurfaceCharge object stores the data for a surface charge. The SurfaceCharge object is derived from the Load object.

Note

This object can be accessed by:

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

Member Details:

distributionType : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'UNIFORM'[source]

A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

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

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

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

A String specifying the load 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 load is applied.

setValues(distributionType=UNIFORM, field='', amplitude=UNSET)[source]

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

Parameters:
distributionType=UNIFORM

A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

field=''

A String specifying the name of the AnalyticalField object associated with this load. The field argument applies only when distributionType = 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 load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

setValuesInStep(stepName, magnitude=None, amplitude='')[source]

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

Parameters:
stepName

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

magnitude=None

A Float specifying the load magnitude.

amplitude=''

A String or a SymbolicConstant specifying the name of the amplitude reference. Possible values for the SymbolicConstant are UNCHANGED and FREED. UNCHANGED should be used if the amplitude is propagated from the previous static analysis step. FREED should be used if the load is changed to have no amplitude reference. You should provide the amplitude argument only if it is valid for the specified step.

class SurfaceConcentrationFlux(
name,
createStepName,
region,
magnitude,
field='',
distributionType=UNIFORM,
amplitude=UNSET,
)[source]

Bases: Load

The SurfaceConcentrationFlux object defines surface concentration flux from a region or into a region. The SurfaceConcentrationFlux object is derived from the Load object.

Note

This object can be accessed by:

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

Member Details:

distributionType : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'UNIFORM'[source]

A SymbolicConstant specifying how the surface concentration flux is distributed spatially. Possible values are UNIFORM, USER_DEFINED, and FIELD. The default value is UNIFORM.

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

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

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

A String specifying the load 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 load is applied.

setValues(field='', distributionType=UNIFORM, amplitude=UNSET)[source]

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

Parameters:
field=''

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

distributionType=UNIFORM

A SymbolicConstant specifying how the surface concentration flux is distributed spatially. Possible values are UNIFORM, USER_DEFINED, and FIELD. The default value is UNIFORM.

amplitude=UNSET

A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

setValuesInStep(stepName, magnitude=None, amplitude='')[source]

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

Parameters:
stepName

A String specifying the name of the step in which the surface concentration flux is modified.

magnitude=None

A Float specifying the surface concentration flux magnitude.

amplitude=''

A String or a SymbolicConstant specifying the name of the amplitude reference. Possible values for the SymbolicConstant are UNCHANGED and FREED. UNCHANGED should be used if the amplitude is propagated from the previous analysis step. FREED should be used if the load has no amplitude reference. You should provide the amplitude argument only if it is valid for the specified step.

class SurfaceCurrent(
name,
createStepName,
region,
magnitude,
distributionType=UNIFORM,
field='',
amplitude=UNSET,
)[source]

Bases: Load

The SurfaceCurrent object stores the data for a surface current. The SurfaceCurrent object is derived from the Load object.

Note

This object can be accessed by:

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

Member Details:

distributionType : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'UNIFORM'[source]

A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

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

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

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

A String specifying the load 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 load is applied.

setValues(distributionType=UNIFORM, field='', amplitude=UNSET)[source]

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

Parameters:
distributionType=UNIFORM

A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and FIELD. The default value is UNIFORM.

field=''

A String specifying the name of the AnalyticalField object associated with this load. The field argument applies only when distributionType = 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 load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

setValuesInStep(stepName, magnitude=None, amplitude='')[source]

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

Parameters:
stepName

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

magnitude=None

A Float specifying the load magnitude.

amplitude=''

A String or a SymbolicConstant specifying the name of the amplitude reference. Possible values for the SymbolicConstant are UNCHANGED and FREED. UNCHANGED should be used if the amplitude is propagated from the previous static analysis step. FREED should be used if the load is changed to have no amplitude reference. You should provide the amplitude argument only if it is valid for the specified step.

class SurfaceCurrentDensity(
name,
createStepName,
region,
comp1,
comp2,
comp3,
distributionType=UNIFORM,
amplitude=UNSET,
)[source]

Bases: Load

The SurfaceCurrentDensity object stores the data for a surface current. The SurfaceCurrentDensity object is derived from the Load object.

Note

This object can be accessed by:

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

Member Details:

distributionType : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'UNIFORM'[source]

A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and USER_DEFINED. The default value is UNIFORM.

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

A String specifying the load 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 load is applied.

setValues(distributionType=UNIFORM, amplitude=UNSET)[source]

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

Parameters:
distributionType=UNIFORM

A SymbolicConstant specifying how the load is distributed spatially. Possible values are UNIFORM and USER_DEFINED. The default value is UNIFORM.

amplitude=UNSET

A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

setValuesInStep(
stepName,
comp1='',
comp2='',
comp3='',
amplitude='',
)[source]

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

Parameters:
stepName

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

comp1=''

A Complex specifying the first component of the load.

comp2=''

A Complex specifying the second component of the load.

comp3=''

A Complex specifying the third component of the load.

amplitude=''

A String or a SymbolicConstant specifying the name of the amplitude reference. Possible values for the SymbolicConstant are UNCHANGED and FREED. UNCHANGED should be used if the amplitude is propagated from the previous static analysis step. FREED should be used if the load is changed to have no amplitude reference. You should provide the amplitude argument only if it is valid for the specified step.

class SurfaceHeatFlux(
name,
createStepName,
region,
magnitude,
field='',
distributionType=UNIFORM,
amplitude=UNSET,
)[source]

Bases: Load

The SurfaceHeatFlux object defines surface heat flux from a region or into a region. The SurfaceHeatFlux object is derived from the Load object.

Note

This object can be accessed by:

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

Member Details:

distributionType : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'UNIFORM'[source]

A SymbolicConstant specifying how the surface heat flux is distributed spatially. Possible values are UNIFORM, USER_DEFINED, and FIELD. The default value is UNIFORM.

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

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

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

A String specifying the load 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 load is applied.

setValues(field='', distributionType=UNIFORM, amplitude=UNSET)[source]

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

Parameters:
field=''

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

distributionType=UNIFORM

A SymbolicConstant specifying how the surface heat flux is distributed spatially. Possible values are UNIFORM, USER_DEFINED, and FIELD. The default value is UNIFORM.

amplitude=UNSET

A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

setValuesInStep(stepName, magnitude=None, amplitude='')[source]

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

Parameters:
stepName

A String specifying the name of the step in which the surface heat flux is modified.

magnitude=None

A Float specifying the surface heat flux magnitude.

amplitude=''

A String or a SymbolicConstant specifying the name of the amplitude reference. Possible values for the SymbolicConstant are UNCHANGED and FREED. UNCHANGED should be used if the amplitude is propagated from the previous analysis step. FREED should be used if the load has no amplitude reference. You should provide the amplitude argument only if it is valid for the specified step.

class SurfacePoreFluid(
name,
createStepName,
region,
magnitude,
field='',
distributionType=UNIFORM,
amplitude=UNSET,
)[source]

Bases: Load

The SurfacePoreFluid object defines surface pore fluid flow from a region or into a region. The SurfacePoreFluid object is derived from the Load object.

Note

This object can be accessed by:

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

Member Details:

distributionType : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'UNIFORM'[source]

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

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

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

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

A String specifying the load 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 load is applied.

setValues(field='', distributionType=UNIFORM, amplitude=UNSET)[source]

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

Parameters:
field=''

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

distributionType=UNIFORM

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

amplitude=UNSET

A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

setValuesInStep(stepName, magnitude=None, amplitude='')[source]

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

Parameters:
stepName

A String specifying the name of the step in which the surface pore fluid flow is modified.

magnitude=None

A Float specifying the surface pore fluid flow magnitude.

amplitude=''

A String or a SymbolicConstant specifying the name of the amplitude reference. Possible values for the SymbolicConstant are UNCHANGED and FREED. UNCHANGED should be used if the amplitude is propagated from the previous analysis step. FREED should be used if the load has no amplitude reference. You should provide the amplitude argument only if it is valid for the specified step.

class SurfaceTraction(
name,
createStepName,
region,
magnitude,
distributionType=UNIFORM,
field='',
amplitude=UNSET,
angle=0,
axis=AXIS_1,
localCsys=None,
userCsys='',
directionVector=(),
follower=1,
resultant=0,
traction=SHEAR,
)[source]

Bases: Load

The SurfaceTraction object defines surface traction on a region. The SurfaceTraction object is derived from the Load object.

Note

This object can be accessed by:

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

Member Details:

angle : --is-rst--:py:class:`float` = 0[source]

A Float specifying an additional rotation of directionVector about an axis. The default value is 0.0.

axis : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'AXIS_1'[source]

A SymbolicConstant specifying the axis about which to apply an additional rotation of directionVector. Possible values are AXIS_1, AXIS_2, and AXIS_3. The default value is AXIS_1.

directionVector : --is-rst--:py:class:`tuple` = ()[source]

A VertexArray object of length 2 specifying the direction of the load. Instead of through a ConstrainedSketchVertex, each point may be specified through a tuple of coordinates. If traction is SHEAR, then directionVector will be projected onto the region surface. This parameter is available only if traction is GENERAL or SHEAR.

distributionType : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'UNIFORM'[source]

A SymbolicConstant specifying how the surface traction is distributed spatially. Possible values are UNIFORM, USER_DEFINED, and FIELD. The default value is UNIFORM.

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

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

follower : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 1[source]

A Boolean specifying whether the direction of the force changes with rotation. The default value is ON.This parameter may be modified only if traction is GENERAL. You should provide the follower argument only if it is valid for the specified step.

localCsys : --is-rst--:py:class:`int` | :py:obj:`None` = None[source]

None or a DatumCsys object specifying the local coordinate system of the load’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system or by the userCsys parameter if defined. When this member is queried, it returns an Int. The default value is None.

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

A String specifying the load 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 load is applied.

resultant : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]

A Boolean specifying whether the to maintain a constant resultant force by defining traction per unit undeformed area. If resultant is OFF, traction is defined per unit deformed area. The default value is OFF.You should provide the resultant argument only if it is valid for the specified step.

setValues(
distributionType=UNIFORM,
field='',
amplitude=UNSET,
angle=0,
axis=AXIS_1,
localCsys=None,
userCsys='',
directionVector=(),
follower=1,
resultant=0,
traction=SHEAR,
)[source]

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

Parameters:
distributionType=UNIFORM

A SymbolicConstant specifying how the surface traction is distributed spatially. Possible values are UNIFORM, USER_DEFINED, and FIELD. The default value is UNIFORM.

field=''

A String specifying the name of the AnalyticalField object associated with this load. The field argument applies only when distributionType = 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 load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

angle=0

A Float specifying an additional rotation of directionVector about an axis. The default value is 0.0.

axis=AXIS_1

A SymbolicConstant specifying the axis about which to apply an additional rotation of directionVector. Possible values are AXIS_1, AXIS_2, and AXIS_3. The default value is AXIS_1.

localCsys=None

None or a DatumCsys object specifying the local coordinate system of the load’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system or by the userCsys parameter if defined. When this member is queried, it returns an Int. The default value is None.

userCsys=''

A String specifying a CSYS defined by a user-subroutine. If userCsys = None, the degrees of freedom are defined in the global coordinate system or by the localCsys parameter if defined. The default value is “None”.

directionVector=()

A VertexArray object of length 2 specifying the direction of the load. Instead of through a ConstrainedSketchVertex, each point may be specified through a tuple of coordinates. If traction is SHEAR, then directionVector will be projected onto the region surface. This parameter is available only if traction is GENERAL or SHEAR.

follower=1

A Boolean specifying whether the direction of the force changes with rotation. The default value is ON.This parameter may be modified only if traction is GENERAL. You should provide the follower argument only if it is valid for the specified step.

resultant=0

A Boolean specifying whether the to maintain a constant resultant force by defining traction per unit undeformed area. If resultant is OFF, traction is defined per unit deformed area. The default value is OFF.You should provide the resultant argument only if it is valid for the specified step.

traction=SHEAR

A SymbolicConstant specifying how to apply surface traction. Possible values are SHEAR and GENERAL. The default value is SHEAR.

setValuesInStep(stepName, magnitude=Ellipsis, amplitude='')[source]

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

Parameters:
stepName

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

magnitude=Ellipsis

A Float, a Complex, or the SymbolicConstant UNCHANGED specifying the load magnitude. UNCHANGED should be used if the magnitude is propagated from the previous analysis step.

amplitude=''

A String or a SymbolicConstant specifying the name of the amplitude reference. Possible values for the SymbolicConstant are UNCHANGED and FREED. UNCHANGED should be used if the amplitude is propagated from the previous analysis step. FREED should be used if the load has no amplitude reference. You should provide the amplitude argument only if it is valid for the specified step.

traction : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'SHEAR'[source]

A SymbolicConstant specifying how to apply surface traction. Possible values are SHEAR and GENERAL. The default value is SHEAR.

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

A String specifying a CSYS defined by a user-subroutine. If userCsys = None, the degrees of freedom are defined in the global coordinate system or by the localCsys parameter if defined. The default value is “None”.

class LoadStep[source]

Bases: StepBase

Member Details:

LoadCase(name, boundaryConditions=(), loads=(), includeActiveBaseStateBC=1)[source]

This method creates a load case in a step.

Note

This function can be accessed by:

mdb.models[name].steps[name].LoadCase
Parameters:
name

A String specifying the name of the object.

boundaryConditions=()

A sequence of (String, Float) sequences specifying the name of a BoundaryCondition followed by a nonzero Float scaling factor. The default value is an empty sequence.

loads=()

A sequence of (String, Float) sequences specifying the name of a Load followed by a nonzero Float specifying a scale factor. The default value is an empty sequence.

includeActiveBaseStateBC=1

A Boolean specifying whether to include all active boundary conditions propagated or modified from the base state. The default value is ON.

Returns:

A LoadCase object.

Return type:

LoadCase

Raises:

RangeError

class MomentState[source]

Bases: LoadState

The MomentState object stores the propagating data for a moment in a step. One instance of this object is created internally by the Moment object for each step. The instance is also deleted internally by the Moment object. The MomentState object has no constructor or methods. The MomentState object is derived from the LoadState object.

Note

This object can be accessed by:

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

The corresponding analysis keywords are:

  • CLOAD

Member Details:

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

A String specifying the name of the amplitude reference. The String is empty if the load has no amplitude reference.

amplitudeState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

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

cm1 : --is-rst--:py:class:`float` | :py:obj:`None` = None[source]

A Float or a Complex specifying the load component in the 4-direction.

cm1State : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the load component in the 4-direction. Possible values are UNSET, SET, UNCHANGED, and FREED.

cm2 : --is-rst--:py:class:`float` | :py:obj:`None` = None[source]

A Float or a Complex specifying the load component in the 5-direction.

cm2State : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the load component in the 5-direction. Possible values are UNSET, SET, UNCHANGED, and FREED.

cm3 : --is-rst--:py:class:`float` | :py:obj:`None` = None[source]

A Float or a Complex specifying the load component in the 6-direction.

cm3State : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the load component in the 6-direction. Possible values are UNSET, SET, UNCHANGED, and FREED.

status : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

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

  • NOT_YET_ACTIVE

  • CREATED

  • PROPAGATED

  • MODIFIED

  • DEACTIVATED

  • NO_LONGER_ACTIVE

  • TYPE_NOT_APPLICABLE

  • INSTANCE_NOT_APPLICABLE

  • BUILT_INTO_BASE_STATE

class PEGLoadState[source]

Bases: LoadState

The PEGLoadState object stores the propagating data for a concentrated force in a step. One instance of this object is created internally by the PEGLoad object for each step. The instance is also deleted internally by the PEGLoad object. The PEGLoadState object has no constructor or methods. The PEGLoadState object is derived from the LoadState object.

Note

This object can be accessed by:

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

The corresponding analysis keywords are:

  • CLOAD

Member Details:

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

A String specifying the name of the amplitude reference. The String is empty if the load has no amplitude reference.

amplitudeState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

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

comp1 : --is-rst--:py:class:`float` | :py:obj:`None` = None[source]

A Float or a Complex specifying the load component at dof 1 of reference node 1.

comp1State : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the load component at dof 1 of reference node 1. Possible values are UNSET, SET, UNCHANGED, and FREED.

comp2 : --is-rst--:py:class:`float` | :py:obj:`None` = None[source]

A Float or a Complex specifying the load component at dof 1 of reference node 2.

comp2State : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the load component at dof 1 of reference node 2. Possible values are UNSET, SET, UNCHANGED, and FREED.

comp3 : --is-rst--:py:class:`float` | :py:obj:`None` = None[source]

A Float or a Complex specifying the load component at dof 2 of reference node 2.

comp3State : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the load component at dof 2 of reference node 2. Possible values are UNSET, SET, UNCHANGED, and FREED.

status : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

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

  • NOT_YET_ACTIVE

  • CREATED

  • PROPAGATED

  • MODIFIED

  • DEACTIVATED

  • NO_LONGER_ACTIVE

  • TYPE_NOT_APPLICABLE

  • INSTANCE_NOT_APPLICABLE

  • BUILT_INTO_BASE_STATE

class PipePressureState[source]

Bases: LoadState

The PipePressureState object stores the propagating data for a pipe pressure in a step. One instance of this object is created internally by the PipePressure object for each step. The instance is also deleted internally by the PipePressure object. The PipePressureState object has no constructor or methods. The PipePressureState object is derived from the LoadState object.

Note

This object can be accessed by:

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

The corresponding analysis keywords are:

  • DSLOAD

  • DLOAD

Member Details:

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

A String specifying the name of the amplitude reference. The String is empty if the load has no amplitude reference.

amplitudeState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

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

hReference : --is-rst--:py:class:`float` | :py:obj:`None` = None[source]

A Float specifying the height of the reference pressure level when the pipe pressure distributionType = HYDROSTATIC.

hReferenceState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

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

hZero : --is-rst--:py:class:`float` | :py:obj:`None` = None[source]

A Float specifying the height of the zero pressure level when the pipe pressure distributionType = HYDROSTATIC.

hZeroState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

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

magnitude : --is-rst--:py:class:`float` | :py:obj:`None` = None[source]

A Float or a Complex specifying the load magnitude.

magnitudeState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the load magnitude. Possible values are UNSET, SET, UNCHANGED, and FREED.

status : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

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

  • NOT_YET_ACTIVE

  • CREATED

  • PROPAGATED

  • MODIFIED

  • DEACTIVATED

  • NO_LONGER_ACTIVE

  • TYPE_NOT_APPLICABLE

  • INSTANCE_NOT_APPLICABLE

  • BUILT_INTO_BASE_STATE

class PressureState[source]

Bases: LoadState

The PressureState object stores the propagating data for a pressure in a step. One instance of this object is created internally by the Pressure object for each step. The instance is also deleted internally by the Pressure object. The PressureState object has no constructor or methods. The PressureState object is derived from the LoadState object.

Note

This object can be accessed by:

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

The corresponding analysis keywords are:

  • DSLOAD

  • DLOAD

Member Details:

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

A String specifying the name of the amplitude reference. The String is empty if the load has no amplitude reference.

amplitudeState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

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

hReference : --is-rst--:py:class:`float` | :py:obj:`None` = None[source]

A Float specifying the height of the reference pressure level when the pressure distributionType = HYDROSTATIC.

hReferenceState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

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

hZero : --is-rst--:py:class:`float` | :py:obj:`None` = None[source]

A Float specifying the height of the zero pressure level when the pressure distributionType = HYDROSTATIC.

hZeroState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

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

magnitude : --is-rst--:py:class:`float` | :py:obj:`None` = None[source]

A Float or a Complex specifying the pressure magnitude.

magnitudeState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the pressure magnitude. Possible values are UNSET, SET, UNCHANGED, and MODIFIED.

status : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

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

  • NOT_YET_ACTIVE

  • CREATED

  • PROPAGATED

  • MODIFIED

  • DEACTIVATED

  • NO_LONGER_ACTIVE

  • TYPE_NOT_APPLICABLE

  • INSTANCE_NOT_APPLICABLE

  • BUILT_INTO_BASE_STATE

class RotationalBodyForceState[source]

Bases: LoadState

The RotationalBodyForceState object stores the propagating data of a rotational body force in a step. One instance of this object is created internally by the RotationalBodyForce object for each step. The instance is also deleted internally by the RotationalBodyForce object. The RotationalBodyForceState object has no constructor or methods. The RotationalBodyForceState object is derived from the LoadState object.

Note

This object can be accessed by:

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

The corresponding analysis keywords are:

  • DLOAD

Member Details:

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

A String specifying the name of the amplitude reference. The String is empty if the load has no amplitude reference.

amplitudeState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

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

magnitude : --is-rst--:py:class:`float` | :py:obj:`None` = None[source]

A Float specifying the load magnitude.

magnitudeState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the load magnitude. Possible values are UNSET, SET, UNCHANGED, and FREED.

status : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

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

  • NOT_YET_ACTIVE

  • CREATED

  • PROPAGATED

  • MODIFIED

  • DEACTIVATED

  • NO_LONGER_ACTIVE

  • TYPE_NOT_APPLICABLE

  • INSTANCE_NOT_APPLICABLE

  • BUILT_INTO_BASE_STATE

class ShellEdgeLoadState[source]

Bases: LoadState

The ShellEdgeLoadState object stores the propagating data for a ShellEdgeLoad object in a step. One instance of this object is created internally by the ShellEdgeLoad object for each step. The instance is also deleted internally by the ShellEdgeLoad object. The ShellEdgeLoadState object has no constructor or methods. The ShellEdgeLoadState object is derived from the LoadState object.

Note

This object can be accessed by:

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

The corresponding analysis keywords are:

  • DSLOAD

  • DLOAD

Member Details:

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

A String specifying the name of the amplitude reference. The String is empty if the load has no amplitude reference.

amplitudeState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

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

magnitude : --is-rst--:py:class:`float` | :py:obj:`None` = None[source]

A Float or a Complex specifying the load magnitude.

magnitudeState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the load magnitude. Possible values are UNSET, SET, UNCHANGED, and MODIFIED.

status : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

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

  • NOT_YET_ACTIVE

  • CREATED

  • PROPAGATED

  • MODIFIED

  • DEACTIVATED

  • NO_LONGER_ACTIVE

  • TYPE_NOT_APPLICABLE

  • INSTANCE_NOT_APPLICABLE

  • BUILT_INTO_BASE_STATE

class SubmodelSBState[source]

Bases: LoadState

The SubmodelSBState object stores the propagating data for a Submodel load in a step. One instance of this object is created internally by the SubmodelSB object for each step. The instance is also deleted internally by the SubmodelSB object. The SubmodelSBState object has no constructor or methods. The SubmodelSBState object is derived from the LoadState object.

Note

This object can be accessed by:

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

The corresponding analysis keywords are:

  • SUBMODEL

  • DSLOAD

Member Details:

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

A String specifying the name of the amplitude reference. The String is empty if the load has no amplitude reference.

amplitudeState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

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

globalIncrement : --is-rst--:py:class:`int` | :py:obj:`None` = None[source]

An Int specifying the increment number in the global model step at which the solution will be used to specify the values of the driven variables. This argument is applicable only for linear perturbation steps.

globalIncrementState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the globalIncrement member. Possible values are SET and UNCHANGED.

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

A String specifying the step in the global model from which Abaqus reads the values of the variables that will drive the submodel analysis. The String indicates the position of the step in the sequence of analysis steps. For example, globalStep = ‘1’ indicates the first step.

globalStepState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the globalStep member. Possible values are SET and UNCHANGED.

status : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

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

  • NOT_YET_ACTIVE

  • CREATED

  • PROPAGATED

  • MODIFIED

  • DEACTIVATED

  • NO_LONGER_ACTIVE

  • TYPE_NOT_APPLICABLE

  • INSTANCE_NOT_APPLICABLE

  • BUILT_INTO_BASE_STATE

class SubstructureLoadState[source]

Bases: LoadState

The SubstructureLoadState object stores the propagating data for a substructure load in a step. One instance of this object is created internally by the SubstructureLoad object for each step. The instance is also deleted internally by the SubstructureLoad object. The SubstructureLoadState object has no constructor or methods. The SubstructureLoadState object is derived from the LoadState object.

Note

This object can be accessed by:

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

The corresponding analysis keywords are:

  • SLOAD

Member Details:

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

A String specifying the name of the amplitude reference. The String is empty if the load has no amplitude reference.

amplitudeState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

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

loadCaseNames : --is-rst--:py:class:`tuple` = ()[source]

A tuple of strings specifying the names of the load cases to be activated.

magnitude : --is-rst--:py:class:`float` | :py:obj:`None` = None[source]

A Float or a Complex specifying the load magnitude.

magnitudeState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the load magnitude. Possible values are UNSET, SET, UNCHANGED, and MODIFIED.

status : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

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

  • NOT_YET_ACTIVE

  • CREATED

  • PROPAGATED

  • MODIFIED

  • DEACTIVATED

  • NO_LONGER_ACTIVE

  • TYPE_NOT_APPLICABLE

  • INSTANCE_NOT_APPLICABLE

  • BUILT_INTO_BASE_STATE

class SurfaceChargeState[source]

Bases: LoadState

The SurfaceChargeState object stores the propagating data of a surface charge in a step. One instance of this object is created internally by the SurfaceCharge object for each step. The instance is also deleted internally by the SurfaceCharge object. The SurfaceChargeState object has no constructor or methods. The SurfaceChargeState object is derived from the LoadState object.

Note

This object can be accessed by:

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

The corresponding analysis keywords are:

  • DSECHARGE

Member Details:

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

A String specifying the name of the amplitude reference. The String is empty if the load has no amplitude reference.

amplitudeState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

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

magnitude : --is-rst--:py:class:`float` | :py:obj:`None` = None[source]

A Float specifying the load magnitude.

magnitudeState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the load magnitude. Possible values are UNSET, SET, UNCHANGED, and FREED.

status : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

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

  • NOT_YET_ACTIVE

  • CREATED

  • PROPAGATED

  • MODIFIED

  • DEACTIVATED

  • NO_LONGER_ACTIVE

  • TYPE_NOT_APPLICABLE

  • INSTANCE_NOT_APPLICABLE

  • BUILT_INTO_BASE_STATE

class SurfaceConcentrationFluxState[source]

Bases: LoadState

The SurfaceConcentrationFluxState object stores the propagating data for a SurfaceConcentrationFlux object in a step. One instance of this object is created internally by the SurfaceConcentrationFlux object for each step. The instance is also deleted internally by the SurfaceConcentrationFlux object. The SurfaceConcentrationFluxState object has no constructor or methods. The SurfaceConcentrationFluxState object is derived from the LoadState object.

Note

This object can be accessed by:

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

The corresponding analysis keywords are:

  • DSFLUX

Member Details:

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

A String specifying the name of the amplitude reference. The String is empty if the load has no amplitude reference.

amplitudeState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

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

magnitude : --is-rst--:py:class:`float` | :py:obj:`None` = None[source]

A Float specifying the surface concentration flux magnitude.

magnitudeState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the surface concentration flux magnitude. Possible values are UNSET, SET, UNCHANGED, and MODIFIED.

status : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

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

  • NOT_YET_ACTIVE

  • CREATED

  • PROPAGATED

  • MODIFIED

  • DEACTIVATED

  • NO_LONGER_ACTIVE

  • TYPE_NOT_APPLICABLE

  • INSTANCE_NOT_APPLICABLE

  • BUILT_INTO_BASE_STATE

class SurfaceCurrentState[source]

Bases: LoadState

The SurfaceCurrentState object stores the propagating data of a surface current in a step. One instance of this object is created internally by the SurfaceCurrent object for each step. The instance is also deleted internally by the SurfaceCurrent object. The SurfaceCurrentState object has no constructor or methods. The SurfaceCurrentState object is derived from the LoadState object.

Note

This object can be accessed by:

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

The corresponding analysis keywords are:

  • DSECURRENT

Member Details:

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

A String specifying the name of the amplitude reference. The String is empty if the load has no amplitude reference.

amplitudeState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

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

magnitude : --is-rst--:py:class:`float` | :py:obj:`None` = None[source]

A Float specifying the load magnitude.

magnitudeState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the load magnitude. Possible values are UNSET, SET, UNCHANGED, and FREED.

status : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

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

  • NOT_YET_ACTIVE

  • CREATED

  • PROPAGATED

  • MODIFIED

  • DEACTIVATED

  • NO_LONGER_ACTIVE

  • TYPE_NOT_APPLICABLE

  • INSTANCE_NOT_APPLICABLE

  • BUILT_INTO_BASE_STATE

class SurfaceHeatFluxState[source]

Bases: LoadState

The SurfaceHeatFluxState object stores the propagating data for a surface SurfaceHeatFlux object in a step. One instance of this object is created internally by the SurfaceHeatFlux object for each step. The instance is also deleted internally by the SurfaceHeatFlux object. The SurfaceHeatFluxState object has no constructor or methods. The SurfaceHeatFluxState object is derived from the LoadState object.

Note

This object can be accessed by:

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

The corresponding analysis keywords are:

  • DSFLUX

Member Details:

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

A String specifying the name of the amplitude reference. The String is empty if the load has no amplitude reference.

amplitudeState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

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

magnitude : --is-rst--:py:class:`float` | :py:obj:`None` = None[source]

A Float specifying the surface heat flux magnitude.

magnitudeState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the surface heat flux magnitude. Possible values are UNSET, SET, UNCHANGED, and MODIFIED.

status : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

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

  • NOT_YET_ACTIVE

  • CREATED

  • PROPAGATED

  • MODIFIED

  • DEACTIVATED

  • NO_LONGER_ACTIVE

  • TYPE_NOT_APPLICABLE

  • INSTANCE_NOT_APPLICABLE

  • BUILT_INTO_BASE_STATE

class SurfacePoreFluidState[source]

Bases: LoadState

The SurfacePoreFluidState object stores the propagating data for a SurfacePoreFluid object in a step. One instance of this object is created internally by the SurfacePoreFluid object for each step. The instance is also deleted internally by the SurfacePoreFluid object. The SurfacePoreFluidState object has no constructor or methods. The SurfacePoreFluidState object is derived from the LoadState object.

Note

This object can be accessed by:

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

The corresponding analysis keywords are:

  • DSFLOW

Member Details:

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

A String specifying the name of the amplitude reference. The String is empty if the load has no amplitude reference.

amplitudeState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

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

magnitude : --is-rst--:py:class:`float` | :py:obj:`None` = None[source]

A Float specifying the surface pore fluid flow magnitude.

magnitudeState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the surface pore fluid flow magnitude. Possible values are UNSET, SET, UNCHANGED, and MODIFIED.

status : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

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

  • NOT_YET_ACTIVE

  • CREATED

  • PROPAGATED

  • MODIFIED

  • DEACTIVATED

  • NO_LONGER_ACTIVE

  • TYPE_NOT_APPLICABLE

  • INSTANCE_NOT_APPLICABLE

  • BUILT_INTO_BASE_STATE

class SurfaceTractionState[source]

Bases: LoadState

The SurfaceTractionState object stores the propagating data for a SurfaceTraction object in a step. One instance of this object is created internally by the SurfaceTraction object for each step. The instance is also deleted internally by the SurfaceTraction object. The SurfaceTractionState object has no constructor or methods. The SurfaceTractionState object is derived from the LoadState object.

Note

This object can be accessed by:

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

The corresponding analysis keywords are:

  • DSLOAD

  • DLOAD

Member Details:

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

A String specifying the name of the amplitude reference. The String is empty if the load has no amplitude reference.

amplitudeState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

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

magnitude : --is-rst--:py:class:`float` | :py:obj:`None` = None[source]

A Float or a Complex specifying the load magnitude.

magnitudeState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the load magnitude. Possible values are UNSET, SET, UNCHANGED, and MODIFIED.

status : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

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

  • NOT_YET_ACTIVE

  • CREATED

  • PROPAGATED

  • MODIFIED

  • DEACTIVATED

  • NO_LONGER_ACTIVE

  • TYPE_NOT_APPLICABLE

  • INSTANCE_NOT_APPLICABLE

  • BUILT_INTO_BASE_STATE