Boundary Condition

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

Create boundary conditions

class BoundaryConditionModel(
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:

AccelerationBaseMotionBC(name, ...[, ...])

This method creates a AccelerationBaseMotionBC object.

AccelerationBC(name, createStepName, region)

This method creates an AccelerationBC object.

AcousticPressureBC(name, createStepName, region)

This method creates a AcousticPressureBC object.

ConcentrationBC(name, createStepName, region)

This method creates a ConcentrationBC object.

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

This method creates an ConnAccelerationBC object on a wire region.

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

This method creates a ConnDisplacementBC object on a wire region.

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

This method creates a ConnVelocityBC object on a wire region.

DisplacementBaseMotionBC(name, ...[, ...])

This method creates a DisplacementBaseMotionBC object.

DisplacementBC(name, createStepName, region)

This method creates a DisplacementBC object.

ElectricPotentialBC(name, createStepName, region)

This method creates an ElectricPotentialBC object.

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

This method creates a EulerianBC object.

EulerianMotionBC(name, createStepName, ...)

This method creates an EulerianMotionBC object.

FluidCavityPressureBC(name, createStepName, ...)

This method creates a FluidCavityPressureBC object.

MagneticVectorPotentialBC(name, ...[, ...])

This method creates a MagneticVectorPotentialBC object.

MaterialFlowBC(name, createStepName, region)

This method creates a MaterialFlowBC object.

PorePressureBC(name, createStepName, region)

This method creates a PorePressureBC object.

RetainedNodalDofsBC(name, createStepName, region)

This method creates a RetainedNodalDofsBC object.

SecondaryBaseBC(name, createStepName, ...)

This method creates a SecondaryBaseBC object.

SubmodelBC(name, createStepName, region, ...)

This method creates a SubmodelBC object.

TemperatureBC(name, createStepName, region)

This method creates a TemperatureBC object.

VelocityBaseMotionBC(name, createStepName, dof)

This method creates a VelocityBaseMotionBC object.

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

This method creates a VelocityBC object.

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

This method creates an encastre TypeBC object.

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

This method creates a pinned TypeBC object.

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

This method creates a TypeBC object that specifies symmetry about the X axis.

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

This method creates a TypeBC object that specifies symmetry about the Y axis.

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

This method creates a TypeBC object that specifies symmetry about the Z axis.

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

This method creates a TypeBC object that specifies antisymmetry about the X axis.

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

This method creates a TypeBC object that specifies antisymmetry about the Y axis.

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

This method creates a TypeBC object that specifies antisymmetry about the Z axis.

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:

AccelerationBC(
name,
createStepName,
region,
fieldName='',
a1=UNSET,
a2=UNSET,
a3=UNSET,
ar1=UNSET,
ar2=UNSET,
ar3=UNSET,
amplitude=UNSET,
localCsys=None,
distributionType=UNIFORM,
)[source]

This method creates an AccelerationBC object.

Note

This function can be accessed by:

mdb.models[name].AccelerationBC
Parameters:
name

A String specifying the boundary condition repository key.

createStepName

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

region

A Region object specifying the region to which the boundary condition is applied.

fieldName=''

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

a1=UNSET

A Float or a SymbolicConstant specifying the acceleration component in the 1-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET. Note: Although a1, a2, a3, ar1, ar2, and ar3 are optional arguments, at least one of them must be specified.

a2=UNSET

A Float or a SymbolicConstant specifying the acceleration component in the 2-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

a3=UNSET

A Float or a SymbolicConstant specifying the acceleration component in the 3-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

ar1=UNSET

A Float or a SymbolicConstant specifying the rotational acceleration component about the 1-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

ar2=UNSET

A Float or a SymbolicConstant specifying the rotational acceleration component about the 2-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

ar3=UNSET

A Float or a SymbolicConstant specifying the rotational acceleration component about the 3-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

amplitude=UNSET

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

localCsys=None

None or a DatumCsys object specifying the local coordinate system of the boundary condition’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

distributionType=UNIFORM

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

Returns:

bc – An AccelerationBC object.

Return type:

AccelerationBC

AccelerationBaseMotionBC(
name,
createStepName,
dof,
amplitudeScaleFactor=1,
centerOfRotation=(),
correlation=None,
secondaryBase='',
useComplex=0,
amplitude=UNSET,
)[source]

This method creates a AccelerationBaseMotionBC object.

Note

This function can be accessed by:

mdb.models[name].AccelerationBaseMotionBC
Parameters:
name

A String specifying the boundary condition repository key.

createStepName

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

dof

A SymbolicConstant specifying the constrained degree-of-freedom. Possible values for the SymbolicConstant are U1, U2, U3, UR1, UR2, UR3. The default value is U1.

amplitudeScaleFactor=1

A Float specifying the scale factor for the amplitude curve. The default value is 1.0.

centerOfRotation=()

A ModelDot object specifying a tuple containing one center of rotation. The default value is the global origin. This argument applies only when dof = UR1, UR2, or UR3.

correlation=None

A Correlation object.

secondaryBase=''

A String specifying the name of the SecondaryBaseBC object associated with this boundary condition. The default value is an empty string.

useComplex=0

A Boolean specifying whether to define the imaginary (out-of-plane) portion of the base motion record given by amplitude definition. The default value is OFF.

amplitude=UNSET

A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the boundary condition 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:

bc – An AccelerationBaseMotionBC object.

Return type:

AccelerationBaseMotionBC

AcousticPressureBC(
name,
createStepName,
region,
fieldName='',
magnitude=0,
distributionType=UNIFORM,
amplitude=UNSET,
fixed=0,
)[source]

This method creates a AcousticPressureBC object.

Note

This function can be accessed by:

mdb.models[name].AcousticPressureBC
Parameters:
name

A String specifying the boundary condition repository key.

createStepName

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

region

A Region object specifying the region to which the boundary condition is applied.

fieldName=''

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

magnitude=0

A Float specifying the acoustic pressure magnitude. The default value is 0. The magnitude argument is optional if distributionType = USER_DEFINED.

distributionType=UNIFORM

A SymbolicConstant specifying how the boundary condition 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 boundary condition has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

fixed=0

A Boolean specifying whether the boundary condition should remain fixed at the current values at the start of the step. The default value is OFF.

Returns:

bc – An AcousticPressureBC object.

Return type:

AcousticPressureBC

ConcentrationBC(
name,
createStepName,
region,
fieldName='',
magnitude=0,
distributionType=UNIFORM,
amplitude=UNSET,
fixed=0,
)[source]

This method creates a ConcentrationBC object.

Note

This function can be accessed by:

mdb.models[name].ConcentrationBC
Parameters:
name

A String specifying the boundary condition repository key.

createStepName

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

region

A Region object specifying the region to which the boundary condition is applied.

fieldName=''

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

magnitude=0

A Float specifying the concentration magnitude. The default value is 0. The magnitude argument is optional if distributionType = USER_DEFINED.

distributionType=UNIFORM

A SymbolicConstant specifying how the boundary condition 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 boundary condition has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

fixed=0

A Boolean specifying whether the boundary condition should remain fixed at the current values at the start of the step. The default value is OFF.

Returns:

bc – A ConcentrationBC object.

Return type:

ConcentrationBC

ConnAccelerationBC(
name,
createStepName,
region='',
fastenerName='',
fastenerSetName='',
a1=UNSET,
a2=UNSET,
a3=UNSET,
ar1=UNSET,
ar2=UNSET,
ar3=UNSET,
amplitude=UNSET,
distributionType=UNIFORM,
)[source]

This method creates an ConnAccelerationBC object on a wire region. Alternatively, the boundary condition 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].ConnAccelerationBC
Parameters:
name

A String specifying the boundary condition repository key.

createStepName

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

region=''

The wire region to which the boundary condition 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 boundary condition 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 boundary condition 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.

a1=UNSET

A Float or a SymbolicConstant specifying the acceleration component in the connector’s local 1-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET. Note: Although a1, a2, a3, ar1, ar2, and ar3 are optional arguments, at least one of them must be specified.

a2=UNSET

A Float or a SymbolicConstant specifying the acceleration component in the connector’s local 2-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

a3=UNSET

A Float or a SymbolicConstant specifying the acceleration component in the connector’s local 3-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

ar1=UNSET

A Float or a SymbolicConstant specifying the rotational acceleration component in the connector’s local 4-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

ar2=UNSET

A Float or a SymbolicConstant specifying the rotational acceleration component in the connector’s local 5-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

ar3=UNSET

A Float or a SymbolicConstant specifying the rotational acceleration component in the connector’s local 6-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

amplitude=UNSET

A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the boundary condition 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 boundary condition is distributed spatially. Possible values are UNIFORM and USER_DEFINED. The default value is UNIFORM.

Returns:

bc – A ConnAccelerationBC object.

Return type:

ConnAccelerationBC

ConnDisplacementBC(
name,
createStepName,
region='',
fastenerName='',
fastenerSetName='',
u1=UNSET,
u2=UNSET,
u3=UNSET,
ur1=UNSET,
ur2=UNSET,
ur3=UNSET,
fixed=0,
amplitude=UNSET,
distributionType=UNIFORM,
buckleCase=NOT_APPLICABLE,
)[source]

This method creates a ConnDisplacementBC object on a wire region. Alternatively, the boundary condition 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].ConnDisplacementBC
Parameters:
name

A String specifying the boundary condition repository key.

createStepName

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

region=''

The wire region to which the boundary condition 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 boundary condition 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 boundary condition 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.

u1=UNSET

A Float, a Complex, or a SymbolicConstant specifying the displacement component in the connector’s local 1-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET. Note: Although u1, u2, u3, ur1, ur2, and ur3 are optional arguments, at least one of them must be specified.

u2=UNSET

A Float, a Complex, or a SymbolicConstant specifying the displacement component in the connector’s local 2-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

u3=UNSET

A Float, a Complex, or a SymbolicConstant specifying the displacement component in the connector’s local 3-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

ur1=UNSET

A Float, a Complex, or a SymbolicConstant specifying the rotational component in the connector’s local 4-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

ur2=UNSET

A Float, a Complex, or a SymbolicConstant specifying the rotational component in the connector’s local 5-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

ur3=UNSET

A Float, a Complex, or a SymbolicConstant specifying the rotational component in the connector’s local 6-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

fixed=0

A Boolean specifying whether the boundary condition should remain fixed at the current values at the start of the step. The default value is OFF.

amplitude=UNSET

A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the boundary condition 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 boundary condition is distributed spatially. Possible values are UNIFORM and USER_DEFINED. The default value is UNIFORM.

buckleCase=NOT_APPLICABLE

A SymbolicConstant specifying how the boundary condition is defined in a BUCKLE analysis. Possible values are NOT_APPLICABLE, STRESS_PERTURBATION, BUCKLING_MODES, and PERTURBATION_AND_BUCKLING. The default value is NOT_APPLICABLE.

Returns:

bc – A ConnDisplacementBC object.

Return type:

ConnDisplacementBC

ConnVelocityBC(
name,
createStepName,
region='',
fastenerName='',
fastenerSetName='',
v1=UNSET,
v2=UNSET,
v3=UNSET,
vr1=UNSET,
vr2=UNSET,
vr3=UNSET,
amplitude=UNSET,
distributionType=UNIFORM,
)[source]

This method creates a ConnVelocityBC object on a wire region. Alternatively, the boundary condition 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].ConnVelocityBC
Parameters:
name

A String specifying the boundary condition repository key.

createStepName

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

region=''

The wire region to which the boundary condition 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 boundary condition 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 boundary condition 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.

v1=UNSET

A Float or a SymbolicConstant specifying the velocity component in the connector’s local 1-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET. Note: Although v1, v2, v3, vr1, vr2, and vr3 are optional arguments, at least one of them must be specified.

v2=UNSET

A Float or a SymbolicConstant specifying the velocity component in the connector’s local 2-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

v3=UNSET

A Float or a SymbolicConstant specifying the velocity component in the connector’s local 3-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

vr1=UNSET

A Float or a SymbolicConstant specifying the rotational velocity component in the connector’s local 4-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

vr2=UNSET

A Float or a SymbolicConstant specifying the rotational velocity component in the connector’s local 5-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

vr3=UNSET

A Float or a SymbolicConstant specifying the rotational velocity component in the connector’s local 6-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

amplitude=UNSET

A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the boundary condition 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 boundary condition is distributed spatially. Possible values are UNIFORM and USER_DEFINED. The default value is UNIFORM.

Returns:

bc – A ConnVelocityBC object.

Return type:

ConnVelocityBC

DisplacementBC(
name,
createStepName,
region,
fieldName='',
u1=UNSET,
u2=UNSET,
u3=UNSET,
ur1=UNSET,
ur2=UNSET,
ur3=UNSET,
fixed=0,
amplitude=UNSET,
distributionType=UNIFORM,
localCsys=None,
buckleCase=NOT_APPLICABLE,
)[source]

This method creates a DisplacementBC object.

Note

This function can be accessed by:

mdb.models[name].DisplacementBC
Parameters:
name

A String specifying the boundary condition repository key.

createStepName

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

region

A Region object specifying the region to which the boundary condition is applied.

fieldName=''

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

u1=UNSET

A Float, a Complex, or a SymbolicConstant specifying the displacement component in the 1-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET. Note: Although u1, u2, u3, ur1, ur2, and ur3 are optional arguments, at least one of them must be specified.

u2=UNSET

A Float, a Complex, or a SymbolicConstant specifying the displacement component in the 2-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

u3=UNSET

A Float, a Complex, or a SymbolicConstant specifying the displacement component in the 3-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

ur1=UNSET

A Float, a Complex, or a SymbolicConstant specifying the rotational displacement component about the 1-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

ur2=UNSET

A Float, a Complex, or a SymbolicConstant specifying the rotational displacement component about the 2-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

ur3=UNSET

A Float, a Complex, or a SymbolicConstant specifying the rotational displacement component about the 3-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

fixed=0

A Boolean specifying whether the boundary condition should remain fixed at the current values at the start of the step. The default value is OFF.

amplitude=UNSET

A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the boundary condition 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 boundary condition is distributed spatially. Possible values are UNIFORM, USER_DEFINED, FIELD, and DISCRETE_FIELD. The default value is UNIFORM.

localCsys=None

None or a DatumCsys object specifying the local coordinate system of the boundary condition’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

buckleCase=NOT_APPLICABLE

A SymbolicConstant specifying how the boundary condition is defined in a BUCKLE analysis. Possible values are NOT_APPLICABLE, STRESS_PERTURBATION, BUCKLING_MODES, and PERTURBATION_AND_BUCKLING. The default value is NOT_APPLICABLE.

Returns:

bc – A DisplacementBC object

Return type:

DisplacementBC

DisplacementBaseMotionBC(
name,
createStepName,
dof,
amplitudeScaleFactor=1,
centerOfRotation=(),
correlation=None,
secondaryBase='',
useComplex=0,
amplitude=UNSET,
)[source]

This method creates a DisplacementBaseMotionBC object.

Note

This function can be accessed by:

mdb.models[name].DisplacementBaseMotionBC
Parameters:
name

A String specifying the boundary condition repository key.

createStepName

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

dof

A SymbolicConstant specifying the constrained degree-of-freedom. Possible values for the SymbolicConstant are U1, U2, U3, UR1, UR2, UR3. The default value is U1.

amplitudeScaleFactor=1

A Float specifying the scale factor for the amplitude curve. The default value is 1.0.

centerOfRotation=()

A ModelDot object specifying a tuple containing one center of rotation. The default value is the global origin. This argument applies only when dof = UR1, UR2, or UR3.

correlation=None

A Correlation object.

secondaryBase=''

A String specifying the name of the SecondaryBaseBC object associated with this boundary condition. The default value is an empty string.

useComplex=0

A Boolean specifying whether to define the imaginary (out-of-plane) portion of the base motion record given by amplitude definition. The default value is OFF.

amplitude=UNSET

A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the boundary condition 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:

bc – A DisplacementBaseMotionBC object.

Return type:

DisplacementBaseMotionBC

ElectricPotentialBC(
name,
createStepName,
region,
fieldName='',
magnitude=0,
distributionType=UNIFORM,
amplitude=UNSET,
fixed=0,
)[source]

This method creates an ElectricPotentialBC object.

Note

This function can be accessed by:

mdb.models[name].ElectricPotentialBC
Parameters:
name

A String specifying the boundary condition repository key.

createStepName

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

region

A Region object specifying the region to which the boundary condition is applied.

fieldName=''

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

magnitude=0

A Float specifying the electrical potential magnitude. The default value is 0. The magnitude argument is optional if distributionType = USER_DEFINED.

distributionType=UNIFORM

A SymbolicConstant specifying how the boundary condition 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 boundary condition has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

fixed=0

A Boolean specifying whether the boundary condition should remain fixed at the current values at the start of the step. The default value is OFF.

Returns:

bc – An ElectricPotentialBC object.

Return type:

ElectricPotentialBC

EncastreBC(
name,
createStepName,
region,
buckleCase=NOT_APPLICABLE,
localCsys=None,
)[source]

This method creates an encastre TypeBC object.

Note

This function can be accessed by:

mdb.models[name].EncastreBC
Parameters:
name

A String specifying the boundary condition repository key.

createStepName

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

region

A Region object specifying the region to which the boundary condition is applied.

buckleCase=NOT_APPLICABLE

A SymbolicConstant specifying how the boundary condition is defined in a BUCKLE analysis. Possible values are NOT_APPLICABLE, STRESS_PERTURBATION, BUCKLING_MODES, and PERTURBATION_AND_BUCKLING. The default value is NOT_APPLICABLE.

localCsys=None

None or a DatumCsys object specifying the local coordinate system of the boundary condition’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

Returns:

A TypeBC object.

Return type:

TypeBC

EulerianBC(
name,
createStepName,
region,
definition=INFLOW,
inflowType=FREE,
outflowType=ZERO_PRESSURE,
)[source]

This method creates a EulerianBC object.

Note

This function can be accessed by:

mdb.models[name].EulerianBC
Parameters:
name

A String specifying the boundary condition repository key.

createStepName

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

region

A Region object specifying the region to which the boundary condition is applied.

definition=INFLOW

A SymbolicConstant specifying the flow conditions to be defined. Possible values are INFLOW, OUTFLOW, and BOTH. The default value is INFLOW.

inflowType=FREE

A SymbolicConstant specifying the control of material flow into the Eulerian domain. Possible values are FREE, NONE, and VOID. The default value is FREE.

outflowType=ZERO_PRESSURE

A SymbolicConstant specifying the control of flow of material out of the Eulerian domain. Possible values are ZERO_PRESSURE, FREE, NON_REFLECTING, and EQUILIBRIUM. The default value is ZERO_PRESSURE.

Returns:

bc – An EulerianBC object.

Return type:

EulerianBC

EulerianMotionBC(
name,
createStepName,
instanceName,
followRegion=1,
region=None,
materialName='',
ctrPosition1=FREE,
posPosition1=FREE,
negPosition1=FREE,
expansionRatio1=None,
contractRatio1=0,
ctrPosition2=FREE,
posPosition2=FREE,
negPosition2=FREE,
expansionRatio2=None,
contractRatio2=0,
ctrPosition3=FREE,
posPosition3=FREE,
negPosition3=FREE,
expansionRatio3=None,
contractRatio3=0,
allowContraction=1,
aspectLimit=10,
vmaxFactor=1,
volThreshold=0,
bufferSize=2,
)[source]

This method creates an EulerianMotionBC object.

Note

This function can be accessed by:

mdb.models[name].EulerianMotionBC
Parameters:
name

A String specifying the boundary condition repository key.

createStepName

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

instanceName

A String specifying the name of the Eulerian part instance.

followRegion=1

A Boolean specifying whether the mesh will follow a regular surface region or an Eulerian surface. The default value is ON.

region=None

A Region object specifying the region to which the boundary condition is applied.

materialName=''

A String specifying the name of the Eulerian surface to follow. This argument applies only when followRegion = False.

ctrPosition1=FREE

A SymbolicConstant specifying the 1-direction translational constraint on the center of the Eulerian mesh. Possible values are FREE and FIXED. The default value is FREE.

posPosition1=FREE

A SymbolicConstant specifying the translational constraint on the positive (maximum) bounds of the mesh in the 1 direction. Possible values are FREE and FIXED. The default value is FREE.

negPosition1=FREE

A SymbolicConstant specifying the translational constraint on the negative (minimum) bounds of the mesh in the 1 direction. Possible values are FREE and FIXED. The default value is FREE.

expansionRatio1=None

None or a Float specifying the upper bounds on the allowable scaling of the mesh in the 1 direction. If expansionRatio1 = None, then there is no upper limit. The default value is None.

contractRatio1=0

A Float specifying the lower bounds on the allowable scaling of the mesh in the 1 direction. The default value is 0.0.

ctrPosition2=FREE

A SymbolicConstant specifying the 2-direction translational constraint on the center of the Eulerian mesh. Possible values are FREE and FIXED. The default value is FREE.

posPosition2=FREE

A SymbolicConstant specifying the translational constraint on the positive (maximum) bounds of the mesh in the 2 direction. Possible values are FREE and FIXED. The default value is FREE.

negPosition2=FREE

A SymbolicConstant specifying the translational constraint on the negative (minimum) bounds of the mesh in the 2 direction. Possible values are FREE and FIXED. The default value is FREE.

expansionRatio2=None

None or a Float specifying the upper bounds on the allowable scaling of the mesh in the 2 direction. If expansionRatio2 = None, then there is no upper limit. The default value is None.

contractRatio2=0

A Float specifying the lower bounds on the allowable scaling of the mesh in the 2 direction. The default value is 0.0.

ctrPosition3=FREE

A SymbolicConstant specifying the 3-direction translational constraint on the center of the Eulerian mesh. Possible values are FREE and FIXED. The default value is FREE.

posPosition3=FREE

A SymbolicConstant specifying the translational constraint on the positive (maximum) bounds of the mesh in the 3 direction. Possible values are FREE and FIXED. The default value is FREE.

negPosition3=FREE

A SymbolicConstant specifying the translational constraint on the negative (minimum) bounds of the mesh in the 3 direction. Possible values are FREE and FIXED. The default value is FREE.

expansionRatio3=None

None or a Float specifying the upper bounds on the allowable scaling of the mesh in the 3 direction. If expansionRatio3 = None, then there is no upper limit. The default value is None.

contractRatio3=0

A Float specifying the lower bounds on the allowable scaling of the mesh in the 3 direction. The default value is 0.0.

allowContraction=1

A Boolean specifying whether the mesh is allowed to contract . The default value is ON.

aspectLimit=10

A Float specifying the maximum change in allowed aspect ratio (for any of the three mesh aspects, 1-2, 2-3, 3-1). The default value is 10.0.

vmaxFactor=1

A Float specifying the multiplier for the mesh nodal velocity limit. The default value is 1.01.

volThreshold=0

A Float specifying the lower bounds on the volume fraction when determining which nodes to include in the surface bounding box calculation for an Eulerian material surface. This argument applies only when followRegion = False. The default value is 0.5.

bufferSize=2

None or a Float specifying the buffer between the surface box and the Eulerian section mesh bounding box. The default value is 2.0.

Returns:

bc – An EulerianMotionBC object.

Return type:

EulerianMotionBC

FluidCavityPressureBC(
name,
createStepName,
fluidCavity,
magnitude=0,
amplitude=UNSET,
fixed=0,
)[source]

This method creates a FluidCavityPressureBC object.

Note

This function can be accessed by:

mdb.models[name].FluidCavityPressureBC
Parameters:
name

A String specifying the boundary condition repository key.

createStepName

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

fluidCavity

A String specifying the name of a Fluid Cavity Interaction.

magnitude=0

A Float specifying the fluid cavity pressure magnitude. The default value is 0.

amplitude=UNSET

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

fixed=0

A Boolean specifying whether the boundary condition should remain fixed at the current values at the start of the step. The default value is OFF.

Returns:

bc – A FluidCavityPressureBC object.

Return type:

FluidCavityPressureBC

MagneticVectorPotentialBC(
name,
createStepName,
region,
component1=None,
component2=UNSET,
component3=UNSET,
amplitude=UNSET,
distributionType=UNIFORM,
localCsys=None,
)[source]

This method creates a MagneticVectorPotentialBC object.

Note

This function can be accessed by:

mdb.models[name].MagneticVectorPotentialBC
Parameters:
name

A String specifying the boundary condition repository key.

createStepName

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

region

A Region object specifying the region to which the boundary condition is applied.

component1=None

A Complex, or a SymbolicConstant specifying the magnetic vector potential component in the 1-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET

component2=UNSET

A Complex, or a SymbolicConstant specifying the magnetic vector potential component in the 2-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

component3=UNSET

A Complex, or a SymbolicConstant specifying the magnetic vector potential component in the 3-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

amplitude=UNSET

A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the boundary condition 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 boundary condition is distributed spatially. Possible values are UNIFORM and USER_DEFINED. The default value is UNIFORM.

localCsys=None

None or a DatumCsys object specifying the local coordinate system of the boundary condition’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

Returns:

bc – A MagneticVectorPotentialBC object.

Return type:

MagneticVectorPotentialBC

MaterialFlowBC(
name,
createStepName,
region,
fieldName='',
magnitude=0,
distributionType=UNIFORM,
amplitude=UNSET,
fixed=0,
)[source]

This method creates a MaterialFlowBC object.

Note

This function can be accessed by:

mdb.models[name].MaterialFlowBC
Parameters:
name

A String specifying the boundary condition repository key.

createStepName

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

region

A Region object specifying the region to which the boundary condition is applied.

fieldName=''

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

magnitude=0

A Float specifying the material flow magnitude. The default value is 0. The magnitude argument is optional if distributionType = USER_DEFINED.

distributionType=UNIFORM

A SymbolicConstant specifying how the boundary condition 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 boundary condition has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

fixed=0

A Boolean specifying whether the boundary condition should remain fixed at the current values at the start of the step. The default value is OFF.

Returns:

bc – A MaterialFlowBC object.

Return type:

MaterialFlowBC

PinnedBC(
name,
createStepName,
region,
buckleCase=NOT_APPLICABLE,
localCsys=None,
)[source]

This method creates a pinned TypeBC object.

Note

This function can be accessed by:

mdb.models[name].PinnedBC
Parameters:
name

A String specifying the boundary condition repository key.

createStepName

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

region

A Region object specifying the region to which the boundary condition is applied.

buckleCase=NOT_APPLICABLE

A SymbolicConstant specifying how the boundary condition is defined in a BUCKLE analysis. Possible values are NOT_APPLICABLE, STRESS_PERTURBATION, BUCKLING_MODES, and PERTURBATION_AND_BUCKLING. The default value is NOT_APPLICABLE.

localCsys=None

None or a DatumCsys object specifying the local coordinate system of the boundary condition’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

Returns:

A TypeBC object.

Return type:

TypeBC

PorePressureBC(
name,
createStepName,
region,
fieldName='',
magnitude=0,
distributionType=UNIFORM,
amplitude=UNSET,
fixed=0,
)[source]

This method creates a PorePressureBC object.

Note

This function can be accessed by:

mdb.models[name].PorePressureBC
Parameters:
name

A String specifying the boundary condition repository key.

createStepName

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

region

A Region object specifying the region to which the boundary condition is applied.

fieldName=''

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

magnitude=0

A Float specifying the pore pressure magnitude. The default value is 0. The magnitude argument is optional if distributionType = USER_DEFINED.

distributionType=UNIFORM

A SymbolicConstant specifying how the boundary condition 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 boundary condition has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

fixed=0

A Boolean specifying whether the boundary condition should remain fixed at the current values at the start of the step. The default value is OFF.

Returns:

bc – A PorePressureBC object.

Return type:

PorePressureBC

RetainedNodalDofsBC(
name,
createStepName,
region,
u1=0,
u2=0,
u3=0,
ur1=0,
ur2=0,
ur3=0,
)[source]

This method creates a RetainedNodalDofsBC object.

Note

This function can be accessed by:

mdb.models[name].RetainedNodalDofsBC
Parameters:
name

A String specifying the boundary condition repository key.

createStepName

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

region

A Region object specifying the region to which the boundary condition is applied.

u1=0

A Boolean specifying whether to retain the degree of freedom in the 1-direction. The default value is OFF indicating that the degree of freedom is not retained.

u2=0

A Boolean specifying whether to retain the degree of freedom in the 2-direction. The default value is OFF indicating that the degree of freedom is not retained.

u3=0

A Boolean specifying whether to retain the degree of freedom in the 3-direction. The default value is OFF indicating that the degree of freedom is not retained.

ur1=0

A Boolean specifying whether to retain the rotational degree of freedom about the 1-direction. The default value is OFF indicating that the degree of freedom is not retained.

ur2=0

A Boolean specifying whether to retain the rotational degree of freedom about the 2-direction. The default value is OFF indicating that the degree of freedom is not retained.

ur3=0

A Boolean specifying whether to retain the rotational degree of freedom about the 3-direction. The default value is OFF indicating that the degree of freedom is not retained.

Returns:

bc – A RetainedNodalDofsBC object.

Return type:

RetainedNodalDofsBC

SecondaryBaseBC(name, createStepName, regions, dofs)[source]

This method creates a SecondaryBaseBC object.

Note

This function can be accessed by:

mdb.models[name].SecondaryBaseBC
Parameters:
name

A String specifying the boundary condition repository key.

createStepName

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

regions

A RegionArray object specifying the region to which the boundary condition is applied. Note that the usual region is ignored. The default value is MODEL.

dofs

A sequence of sequences of Ints specifying the constrained degrees-of-freedom.

Returns:

bc – A SecondaryBaseBC object.

Return type:

SecondaryBaseBC

SubmodelBC(
name,
createStepName,
region,
dof,
globalStep,
timeScale,
shellThickness,
globalDrivingRegion='',
absoluteExteriorTolerance=None,
exteriorTolerance=0,
localCsys=None,
globalIncrement=0,
centerZoneSize=None,
intersectionOnly=0,
)[source]

This method creates a SubmodelBC object.

Note

This function can be accessed by:

mdb.models[name].SubmodelBC
Parameters:
name

A String specifying the boundary condition repository key.

createStepName

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

region

A Region object specifying the region to which the boundary condition is applied.

dof

A sequence of Ints specifying the degrees of freedom to which the boundary condition 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.

timeScale

A Boolean specifying whether to scale the time variable for the driven nodes’ amplitude functions to match the submodel analysis step time. The default value is OFF.

shellThickness

A Float specifying the thickness of the shell in the global model. This argument is required for shell-to-solid submodeling and is not applicable to other submodels. The default value is 0.0.

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.

localCsys=None

None or a DatumCsys object specifying the local coordinate system of the boundary condition’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

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.

centerZoneSize=None

A Float specifying the thickness of the center zone size around the shell midsurface. The default value is None.

intersectionOnly=0

A Boolean specifying whether to ignore driven nodes that lie outside the region of elements of the global model after accounting for the exterior search tolerance. The default value is OFF.

Added in version 2021: The intersectionOnly argument was added.

Returns:

bc – A SubmodelBC object.

Return type:

SubmodelBC

TemperatureBC(
name,
createStepName,
region,
fieldName='',
magnitude=0,
dof=(),
amplitude=UNSET,
distributionType=UNIFORM,
fixed=0,
)[source]

This method creates a TemperatureBC object.

Note

This function can be accessed by:

mdb.models[name].TemperatureBC
Parameters:
name

A String specifying the boundary condition repository key.

createStepName

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

region

A Region object specifying the region to which the boundary condition is applied.

fieldName=''

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

magnitude=0

A Float specifying the temperature magnitude. The default value is 0.

dof=()

A sequence of Ints specifying the degrees of freedom to which the boundary condition is applied. The default value is (11,).

amplitude=UNSET

A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the boundary condition 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 boundary condition is distributed spatially. Possible values are UNIFORM, USER_DEFINED, and FIELD. The default value is UNIFORM.

fixed=0

A Boolean specifying whether the boundary condition should remain fixed at the current values at the start of the step. The default value is OFF.

Returns:

bc – A TemperatureBC object.

Return type:

TemperatureBC

VelocityBC(
name,
createStepName,
region,
fieldName='',
v1=UNSET,
v2=UNSET,
v3=UNSET,
vr1=UNSET,
vr2=UNSET,
vr3=UNSET,
amplitude=UNSET,
localCsys=None,
distributionType=UNIFORM,
)[source]

This method creates a VelocityBC object.

Note

This function can be accessed by:

mdb.models[name].VelocityBC
Parameters:
name

A String specifying the boundary condition repository key.

createStepName

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

region

A Region object specifying the region to which the boundary condition is applied.

fieldName=''

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

v1=UNSET

A Float or a SymbolicConstant specifying the velocity component in the 1-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET. Note: Although v1, v2, v3, vr1, vr2, and vr3 are optional arguments, at least one of them must be specified.

v2=UNSET

A Float or a SymbolicConstant specifying the velocity component in the 2-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

v3=UNSET

A Float or a SymbolicConstant specifying the velocity component in the 3-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

vr1=UNSET

A Float or a SymbolicConstant specifying the rotational velocity component about the 1-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

vr2=UNSET

A Float or a SymbolicConstant specifying the rotational velocity component about the 2-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

vr3=UNSET

A Float or a SymbolicConstant specifying the rotational velocity component about the 3-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

amplitude=UNSET

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

localCsys=None

None or a DatumCsys object specifying the local coordinate system of the boundary condition’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

distributionType=UNIFORM

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

Returns:

bc – A VelocityBC object.

Return type:

VelocityBC

VelocityBaseMotionBC(
name,
createStepName,
dof,
amplitudeScaleFactor=1,
centerOfRotation=(),
correlation=None,
secondaryBase='',
useComplex=0,
amplitude=UNSET,
)[source]

This method creates a VelocityBaseMotionBC object.

Note

This function can be accessed by:

mdb.models[name].VelocityBaseMotionBC
Parameters:
name

A String specifying the boundary condition repository key.

createStepName

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

dof

A SymbolicConstant specifying the constrained degree-of-freedom. Possible values for the SymbolicConstant are U1, U2, U3, UR1, UR2, UR3. The default value is U1.

amplitudeScaleFactor=1

A Float specifying the scale factor for the amplitude curve. The default value is 1.0.

centerOfRotation=()

A ModelDot object specifying a tuple containing one center of rotation. The default value is the global origin. This argument applies only when dof = UR1, UR2, or UR3.

correlation=None

A Correlation object.

secondaryBase=''

A String specifying the name of the SecondaryBaseBC object associated with this boundary condition. The default value is an empty string.

useComplex=0

A Boolean specifying whether to define the imaginary (out-of-plane) portion of the base motion record given by amplitude definition. The default value is OFF.

amplitude=UNSET

A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the boundary condition 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:

bc – A VelocityBaseMotionBC object.

Return type:

VelocityBaseMotionBC

XasymmBC(
name,
createStepName,
region,
buckleCase=NOT_APPLICABLE,
localCsys=None,
)[source]

This method creates a TypeBC object that specifies antisymmetry about the X axis.

Note

This function can be accessed by:

mdb.models[name].EncastreBC
Parameters:
name

A String specifying the boundary condition repository key.

createStepName

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

region

A Region object specifying the region to which the boundary condition is applied.

buckleCase=NOT_APPLICABLE

A SymbolicConstant specifying how the boundary condition is defined in a BUCKLE analysis. Possible values are NOT_APPLICABLE, STRESS_PERTURBATION, BUCKLING_MODES, and PERTURBATION_AND_BUCKLING. The default value is NOT_APPLICABLE.

localCsys=None

None or a DatumCsys object specifying the local coordinate system of the boundary condition’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

Returns:

A TypeBC object.

Return type:

TypeBC

XsymmBC(
name,
createStepName,
region,
buckleCase=NOT_APPLICABLE,
localCsys=None,
)[source]

This method creates a TypeBC object that specifies symmetry about the X axis.

Note

This function can be accessed by:

mdb.models[name].EncastreBC
Parameters:
name

A String specifying the boundary condition repository key.

createStepName

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

region

A Region object specifying the region to which the boundary condition is applied.

buckleCase=NOT_APPLICABLE

A SymbolicConstant specifying how the boundary condition is defined in a BUCKLE analysis. Possible values are NOT_APPLICABLE, STRESS_PERTURBATION, BUCKLING_MODES, and PERTURBATION_AND_BUCKLING. The default value is NOT_APPLICABLE.

localCsys=None

None or a DatumCsys object specifying the local coordinate system of the boundary condition’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

Returns:

A TypeBC object.

Return type:

TypeBC

YasymmBC(
name,
createStepName,
region,
buckleCase=NOT_APPLICABLE,
localCsys=None,
)[source]

This method creates a TypeBC object that specifies antisymmetry about the Y axis.

Note

This function can be accessed by:

mdb.models[name].YasymmBC
Parameters:
name

A String specifying the boundary condition repository key.

createStepName

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

region

A Region object specifying the region to which the boundary condition is applied.

buckleCase=NOT_APPLICABLE

A SymbolicConstant specifying how the boundary condition is defined in a BUCKLE analysis. Possible values are NOT_APPLICABLE, STRESS_PERTURBATION, BUCKLING_MODES, and PERTURBATION_AND_BUCKLING. The default value is NOT_APPLICABLE.

localCsys=None

None or a DatumCsys object specifying the local coordinate system of the boundary condition’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

Returns:

A TypeBC object.

Return type:

TypeBC

YsymmBC(
name,
createStepName,
region,
buckleCase=NOT_APPLICABLE,
localCsys=None,
)[source]

This method creates a TypeBC object that specifies symmetry about the Y axis.

Note

This function can be accessed by:

mdb.models[name].YsymmBC
Parameters:
name

A String specifying the boundary condition repository key.

createStepName

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

region

A Region object specifying the region to which the boundary condition is applied.

buckleCase=NOT_APPLICABLE

A SymbolicConstant specifying how the boundary condition is defined in a BUCKLE analysis. Possible values are NOT_APPLICABLE, STRESS_PERTURBATION, BUCKLING_MODES, and PERTURBATION_AND_BUCKLING. The default value is NOT_APPLICABLE.

localCsys=None

None or a DatumCsys object specifying the local coordinate system of the boundary condition’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

Returns:

A TypeBC object.

Return type:

TypeBC

ZasymmBC(
name,
createStepName,
region,
buckleCase=NOT_APPLICABLE,
localCsys=None,
)[source]

This method creates a TypeBC object that specifies antisymmetry about the Z axis.

Note

This function can be accessed by:

mdb.models[name].ZasymmBC
Parameters:
name

A String specifying the boundary condition repository key.

createStepName

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

region

A Region object specifying the region to which the boundary condition is applied.

buckleCase=NOT_APPLICABLE

A SymbolicConstant specifying how the boundary condition is defined in a BUCKLE analysis. Possible values are NOT_APPLICABLE, STRESS_PERTURBATION, BUCKLING_MODES, and PERTURBATION_AND_BUCKLING. The default value is NOT_APPLICABLE.

localCsys=None

None or a DatumCsys object specifying the local coordinate system of the boundary condition’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

Returns:

A TypeBC object.

Return type:

TypeBC

ZsymmBC(
name,
createStepName,
region,
buckleCase=NOT_APPLICABLE,
localCsys=None,
)[source]

This method creates a TypeBC object that specifies symmetry about the Z axis.

Note

This function can be accessed by:

mdb.models[name].EncastreBC
Parameters:
name

A String specifying the boundary condition repository key.

createStepName

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

region

A Region object specifying the region to which the boundary condition is applied.

buckleCase=NOT_APPLICABLE

A SymbolicConstant specifying how the boundary condition is defined in a BUCKLE analysis. Possible values are NOT_APPLICABLE, STRESS_PERTURBATION, BUCKLING_MODES, and PERTURBATION_AND_BUCKLING. The default value is NOT_APPLICABLE.

localCsys=None

None or a DatumCsys object specifying the local coordinate system of the boundary condition’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

Returns:

A TypeBC object.

Return type:

TypeBC

Other Classes

class AccelerationBC(
name,
createStepName,
region,
fieldName='',
a1=UNSET,
a2=UNSET,
a3=UNSET,
ar1=UNSET,
ar2=UNSET,
ar3=UNSET,
amplitude=UNSET,
localCsys=None,
distributionType=UNIFORM,
)[source]

Bases: BoundaryCondition

The AccelerationBC object stores the data for an acceleration boundary condition. The AccelerationBC object is derived from the BoundaryCondition object.

Note

This object can be accessed by:

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

Member Details:

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

A SymbolicConstant specifying the category of the boundary condition. Possible values are MECHANICAL and THERMAL.

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

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

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

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

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

None or a DatumCsys object specifying the local coordinate system of the boundary condition’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

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

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

setValues(
fieldName='',
a1=UNSET,
a2=UNSET,
a3=UNSET,
ar1=UNSET,
ar2=UNSET,
ar3=UNSET,
amplitude=UNSET,
localCsys=None,
distributionType=UNIFORM,
)[source]

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

Parameters:
fieldName=''

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

a1=UNSET

A Float or a SymbolicConstant specifying the acceleration component in the 1-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET. Note: Although a1, a2, a3, ar1, ar2, and ar3 are optional arguments, at least one of them must be specified.

a2=UNSET

A Float or a SymbolicConstant specifying the acceleration component in the 2-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

a3=UNSET

A Float or a SymbolicConstant specifying the acceleration component in the 3-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

ar1=UNSET

A Float or a SymbolicConstant specifying the rotational acceleration component about the 1-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

ar2=UNSET

A Float or a SymbolicConstant specifying the rotational acceleration component about the 2-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

ar3=UNSET

A Float or a SymbolicConstant specifying the rotational acceleration component about the 3-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

amplitude=UNSET

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

localCsys=None

None or a DatumCsys object specifying the local coordinate system of the boundary condition’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

distributionType=UNIFORM

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

setValuesInStep(
stepName,
a1=SET,
a2=SET,
a3=SET,
ar1=SET,
ar2=SET,
ar3=SET,
amplitude='',
)[source]

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

Parameters:
stepName

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

a1=SET

A Float or a SymbolicConstant specifying the acceleration component in the 1-direction. Possible values for the SymbolicConstant are SET, UNCHANGED, and FREED.

a2=SET

A Float or a SymbolicConstant specifying the acceleration component in the 2-direction. Possible values for the SymbolicConstant are SET, UNCHANGED, and FREED.

a3=SET

A Float or a SymbolicConstant specifying the acceleration component in the 3-direction. Possible values for the SymbolicConstant are SET, UNCHANGED, and FREED.

ar1=SET

A Float or a SymbolicConstant specifying the rotational acceleration component about the 1-direction. Possible values for the SymbolicConstant are SET, UNCHANGED, and FREED.

ar2=SET

A Float or a SymbolicConstant specifying the rotational acceleration component about the 2-direction. Possible values for the SymbolicConstant are SET, UNCHANGED, and FREED.

ar3=SET

A Float or a SymbolicConstant specifying the rotational acceleration component about the 3-direction. Possible values for the SymbolicConstant are SET, UNCHANGED, and FREED.

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 boundary condition is changed to have no amplitude reference. You should provide the amplitude argument only if it is valid for the specified step.

class BoundaryCondition[source]

Bases: object

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

Note

This object can be accessed by:

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

Member Details:

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

A SymbolicConstant specifying the category of the boundary condition. Possible values are MECHANICAL and THERMAL.

deactivate(stepName)[source]

This method deactivates the boundary condition in the specified step and all subsequent steps.

Parameters:
stepName

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

delete(indices)[source]

This method allows you to delete existing boundary conditions.

Parameters:
indices

A sequence of Ints specifying the index of each boundary condition to delete.

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

None or a DatumCsys object specifying the local coordinate system of the boundary condition’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

move(fromStepName, toStepName)[source]

This method moves the boundary condition state from one step to a different step.

Parameters:
fromStepName

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

toStepName

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

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

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

reset(stepName)[source]

This method resets the boundary condition state of the specified step to the state of the previous analysis step.

Parameters:
stepName

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

resume()[source]

This method resumes the boundary condition that was previously suppressed.

setValues(*args, **kwargs)[source]
setValuesInStep(*args, **kwargs)[source]
suppress()[source]

This method suppresses the boundary condition.

class AccelerationBCState[source]

Bases: BoundaryConditionState

The AccelerationBCState object stores the propagating data of an acceleration boundary condition in a step. One instance of this object is created internally by the AccelerationBC object for each step. The instance is also deleted internally by the AccelerationBC object. The AccelerationBCState object has no constructor or methods. The AccelerationBCState object is derived from the BoundaryConditionState object.

Note

This object can be accessed by:

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

The corresponding analysis keywords are:

  • BOUNDARY

Member Details:

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

A Float specifying the acceleration component in the 1-direction.

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

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

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

A Float specifying the acceleration component in the 2-direction.

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

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

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

A Float specifying the acceleration component in the 3-direction.

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

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

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

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

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

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

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

A Float specifying the rotational acceleration component about the 1-direction.

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

A SymbolicConstant specifying the propagation state of the rotational acceleration component about the 1-direction. Possible values are UNSET, SET, UNCHANGED, FREED, and MODIFIED.

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

A Float specifying the rotational acceleration component about the 2-direction.

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

A SymbolicConstant specifying the propagation state of the rotational acceleration component about the 2-direction. Possible values are UNSET, SET, UNCHANGED, FREED, and MODIFIED.

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

A Float specifying the rotational acceleration component about the 3-direction.

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

A SymbolicConstant specifying the propagation state of the rotational acceleration component about the 3-direction. Possible values are UNSET, SET, UNCHANGED, FREED, and MODIFIED.

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

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

  • NOT_YET_ACTIVE

  • CREATED

  • PROPAGATED

  • MODIFIED

  • DEACTIVATED

  • NO_LONGER_ACTIVE

  • TYPE_NOT_APPLICABLE

  • INSTANCE_NOT_APPLICABLE

  • PROPAGATED_FROM_BASE_STATE

  • MODIFIED_FROM_BASE_STATE

  • DEACTIVATED_FROM_BASE_STATE

  • BUILT_INTO_MODES

class BoundaryConditionState[source]

Bases: object

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

Note

This object can be accessed by:

import load
mdb.models[name].steps[name].boundaryConditionStates[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 boundary condition has no amplitude reference.

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

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

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

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

  • NOT_YET_ACTIVE

  • CREATED

  • PROPAGATED

  • MODIFIED

  • DEACTIVATED

  • NO_LONGER_ACTIVE

  • TYPE_NOT_APPLICABLE

  • INSTANCE_NOT_APPLICABLE

  • PROPAGATED_FROM_BASE_STATE

  • MODIFIED_FROM_BASE_STATE

  • DEACTIVATED_FROM_BASE_STATE

  • BUILT_INTO_MODES

class AccelerationBaseMotionBC(
name,
createStepName,
dof,
amplitudeScaleFactor=1,
centerOfRotation=(),
correlation=None,
secondaryBase='',
useComplex=0,
amplitude=UNSET,
)[source]

Bases: BoundaryCondition

The AccelerationBaseMotionBC object stores the data for an acceleration base motion boundary condition. The AccelerationBaseMotionBC object is derived from the BoundaryCondition object.

Note

This object can be accessed by:

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

Member Details:

amplitudeScaleFactor : --is-rst--:py:class:`float` = 1[source]

A Float specifying the scale factor for the amplitude curve. The default value is 1.0.

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

A SymbolicConstant specifying the category of the boundary condition. Possible values are MECHANICAL and THERMAL.

centerOfRotation : --is-rst--:py:class:`tuple` = ()[source]

A ModelDot object specifying a tuple containing one center of rotation. The default value is the global origin. This argument applies only when dof = UR1, UR2, or UR3.

correlation : --is-rst--:py:class:`~abaqus.Amplitude.Correlation.Correlation` = <abaqus.Amplitude.Correlation.Correlation object>[source]

A Correlation object.

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

None or a DatumCsys object specifying the local coordinate system of the boundary condition’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

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

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

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

A String specifying the name of the SecondaryBaseBC object associated with this boundary condition. The default value is an empty string.

setValues(
amplitudeScaleFactor=1,
centerOfRotation=(),
correlation=None,
secondaryBase='',
useComplex=0,
amplitude=UNSET,
)[source]

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

Parameters:
amplitudeScaleFactor=1

A Float specifying the scale factor for the amplitude curve. The default value is 1.0.

centerOfRotation=()

A ModelDot object specifying a tuple containing one center of rotation. The default value is the global origin. This argument applies only when dof = UR1, UR2, or UR3.

correlation=None

A Correlation object.

secondaryBase=''

A String specifying the name of the SecondaryBaseBC object associated with this boundary condition. The default value is an empty string.

useComplex=0

A Boolean specifying whether to define the imaginary (out-of-plane) portion of the base motion record given by amplitude definition. The default value is OFF.

amplitude=UNSET

A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the boundary condition 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, amplitude='')[source]

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

Parameters:
stepName

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

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 boundary condition is changed to have no amplitude reference. You should provide the amplitude argument only if it is valid for the specified step.

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

A Boolean specifying whether to define the imaginary (out-of-plane) portion of the base motion record given by amplitude definition. The default value is OFF.

class AccelerationBaseMotionBCState[source]

Bases: BoundaryConditionState

The AccelerationBaseMotionBCState object stores the propagating data for a velocity base motion boundary condition in a step. One instance of this object is created internally by the AccelerationBaseMotionBC object for each step. The instance is also deleted internally by the AccelerationBaseMotionBC object. The AccelerationBaseMotionBCState object has no constructor or methods. The AccelerationBaseMotionBCState object is derived from the BoundaryConditionState object.

Note

This object can be accessed by:

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

The corresponding analysis keywords are:

  • BASE MOTION

Member Details:

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

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

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

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

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

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

  • NOT_YET_ACTIVE

  • CREATED

  • PROPAGATED

  • MODIFIED

  • DEACTIVATED

  • NO_LONGER_ACTIVE

  • TYPE_NOT_APPLICABLE

  • INSTANCE_NOT_APPLICABLE

  • PROPAGATED_FROM_BASE_STATE

  • MODIFIED_FROM_BASE_STATE

  • DEACTIVATED_FROM_BASE_STATE

  • BUILT_INTO_MODES

class AcousticPressureBC(
name,
createStepName,
region,
fieldName='',
magnitude=0,
distributionType=UNIFORM,
amplitude=UNSET,
fixed=0,
)[source]

Bases: BoundaryCondition

The AcousticPressureBC object stores the data for an acoustic pressure boundary condition. The AcousticPressureBC object is derived from the BoundaryCondition object.

Note

This object can be accessed by:

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

Member Details:

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

A SymbolicConstant specifying the category of the boundary condition. Possible values are MECHANICAL and THERMAL.

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

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

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

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

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

None or a DatumCsys object specifying the local coordinate system of the boundary condition’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

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

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

setValues(
fieldName='',
magnitude=0,
distributionType=UNIFORM,
amplitude=UNSET,
fixed=0,
)[source]

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

Parameters:
fieldName=''

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

magnitude=0

A Float specifying the acoustic pressure magnitude. The default value is 0. The magnitude argument is optional if distributionType = USER_DEFINED.

distributionType=UNIFORM

A SymbolicConstant specifying how the boundary condition 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 boundary condition has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

fixed=0

A Boolean specifying whether the boundary condition should remain fixed at the current values at the start of the step. The default value is OFF.

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

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

Parameters:
stepName

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

magnitude=UNCHANGED

A Float or the SymbolicConstant FREED specifying the acoustic pressure 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 boundary condition is changed to have no amplitude reference. You should provide the amplitude argument only if it is valid for the specified step.

class AcousticPressureBCState[source]

Bases: BoundaryConditionState

The AcousticPressureBCState object stores the propagating data for an acoustic pressure boundary condition in a step. One instance of this object is created internally by the AcousticPressureBC object for each step. The instance is also deleted internally by the AcousticPressureBC object. The AcousticPressureBCState object has no constructor or methods. The AcousticPressureBCState object is derived from the BoundaryConditionState object.

Note

This object can be accessed by:

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

The corresponding analysis keywords are:

  • 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 boundary condition has no amplitude reference.

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

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

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

A Float specifying the acoustic pressure magnitude.

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

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

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

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

  • NOT_YET_ACTIVE

  • CREATED

  • PROPAGATED

  • MODIFIED

  • DEACTIVATED

  • NO_LONGER_ACTIVE

  • TYPE_NOT_APPLICABLE

  • INSTANCE_NOT_APPLICABLE

  • PROPAGATED_FROM_BASE_STATE

  • MODIFIED_FROM_BASE_STATE

  • DEACTIVATED_FROM_BASE_STATE

  • BUILT_INTO_MODES

class ConcentrationBC(
name,
createStepName,
region,
fieldName='',
magnitude=0,
distributionType=UNIFORM,
amplitude=UNSET,
fixed=0,
)[source]

Bases: BoundaryCondition

The ConcentrationBC object stores the data for a concentration boundary condition. The ConcentrationBC object is derived from the BoundaryCondition object.

Note

This object can be accessed by:

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

Member Details:

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

A SymbolicConstant specifying the category of the boundary condition. Possible values are MECHANICAL and THERMAL.

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

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

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

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

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

None or a DatumCsys object specifying the local coordinate system of the boundary condition’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

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

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

setValues(
fieldName='',
magnitude=0,
distributionType=UNIFORM,
amplitude=UNSET,
fixed=0,
)[source]

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

Parameters:
fieldName=''

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

magnitude=0

A Float specifying the concentration magnitude. The default value is 0. The magnitude argument is optional if distributionType = USER_DEFINED.

distributionType=UNIFORM

A SymbolicConstant specifying how the boundary condition 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 boundary condition has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

fixed=0

A Boolean specifying whether the boundary condition should remain fixed at the current values at the start of the step. The default value is OFF.

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

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

Parameters:
stepName

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

magnitude=UNCHANGED

A Float or the SymbolicConstant FREED specifying the concentration 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 boundary condition is changed to have no amplitude reference. You should provide the amplitude argument only if it is valid for the specified step.

class ConcentrationBCState[source]

Bases: BoundaryConditionState

The ConcentrationBCState object stores the propagating data for a concentration boundary condition in a step. One instance of this object is created internally by the ConcentrationBC object for each step. The instance is also deleted internally by the ConcentrationBC object. The ConcentrationBCState object has no constructor or methods. The ConcentrationBCState object is derived from the BoundaryConditionState object.

Note

This object can be accessed by:

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

The corresponding analysis keywords are:

  • 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 boundary condition has no amplitude reference.

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

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

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

A Float specifying the concentration magnitude.

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

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

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

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

  • NOT_YET_ACTIVE

  • CREATED

  • PROPAGATED

  • MODIFIED

  • DEACTIVATED

  • NO_LONGER_ACTIVE

  • TYPE_NOT_APPLICABLE

  • INSTANCE_NOT_APPLICABLE

  • PROPAGATED_FROM_BASE_STATE

  • MODIFIED_FROM_BASE_STATE

  • DEACTIVATED_FROM_BASE_STATE

  • BUILT_INTO_MODES

class ConnAccelerationBC(
name,
createStepName,
region='',
fastenerName='',
fastenerSetName='',
a1=UNSET,
a2=UNSET,
a3=UNSET,
ar1=UNSET,
ar2=UNSET,
ar3=UNSET,
amplitude=UNSET,
distributionType=UNIFORM,
)[source]

Bases: BoundaryCondition

The ConnAccelerationBC object stores the data for a connector acceleration boundary condition. The ConnAccelerationBC object is derived from the BoundaryCondition object.

Note

This object can be accessed by:

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

Member Details:

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

A SymbolicConstant specifying the category of the boundary condition. Possible values are MECHANICAL and THERMAL.

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

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

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

A String specifying the name of the assembled fastener to which the boundary condition 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 boundary condition 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.

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

None or a DatumCsys object specifying the local coordinate system of the boundary condition’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

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

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

setValues(
region='',
fastenerName='',
fastenerSetName='',
a1=UNSET,
a2=UNSET,
a3=UNSET,
ar1=UNSET,
ar2=UNSET,
ar3=UNSET,
amplitude=UNSET,
distributionType=UNIFORM,
)[source]

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

Parameters:
region=''

The wire region to which the boundary condition 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 boundary condition 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 boundary condition 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.

a1=UNSET

A Float or a SymbolicConstant specifying the acceleration component in the connector’s local 1-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET. Note: Although a1, a2, a3, ar1, ar2, and ar3 are optional arguments, at least one of them must be specified.

a2=UNSET

A Float or a SymbolicConstant specifying the acceleration component in the connector’s local 2-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

a3=UNSET

A Float or a SymbolicConstant specifying the acceleration component in the connector’s local 3-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

ar1=UNSET

A Float or a SymbolicConstant specifying the rotational acceleration component in the connector’s local 4-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

ar2=UNSET

A Float or a SymbolicConstant specifying the rotational acceleration component in the connector’s local 5-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

ar3=UNSET

A Float or a SymbolicConstant specifying the rotational acceleration component in the connector’s local 6-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

amplitude=UNSET

A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the boundary condition 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 boundary condition is distributed spatially. Possible values are UNIFORM and USER_DEFINED. The default value is UNIFORM.

setValuesInStep(
stepName,
a1=SET,
a2=SET,
a3=SET,
ar1=SET,
ar2=SET,
ar3=SET,
amplitude='',
)[source]

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

Parameters:
stepName

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

a1=SET

A Float or a SymbolicConstant specifying the connector acceleration component in the connector’s local 1-direction. Possible values for the SymbolicConstant are SET, UNCHANGED, and FREED.

a2=SET

A Float or a SymbolicConstant specifying the connector acceleration component in the connector’s local 2-direction. Possible values for the SymbolicConstant are SET, UNCHANGED, and FREED.

a3=SET

A Float or a SymbolicConstant specifying the connector acceleration component in the connector’s local 3-direction. Possible values for the SymbolicConstant are SET, UNCHANGED, and FREED.

ar1=SET

A Float or a SymbolicConstant specifying the connector acceleration component in the connector’s local 4-direction. Possible values for the SymbolicConstant are SET, UNCHANGED, and FREED.

ar2=SET

A Float or a SymbolicConstant specifying the connector acceleration component in the connector’s local 5-direction. Possible values for the SymbolicConstant are SET, UNCHANGED, and FREED.

ar3=SET

A Float or a SymbolicConstant specifying the connector acceleration component in the connector’s local 6-direction. Possible values for the SymbolicConstant are SET, UNCHANGED, and FREED.

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 boundary condition is changed to have no amplitude reference. You should provide the amplitude argument only if it is valid for the specified step.

class ConnAccelerationBCState[source]

Bases: BoundaryConditionState

The ConnAccelerationBCState object stores the propagating data of a connector acceleration boundary condition in a step. One instance of this object is created internally by the ConnAccelerationBC object for each step. The instance is also deleted internally by the ConnAccelerationBC object. The ConnAccelerationBCState object has no constructor or methods. The ConnAccelerationBCState object is derived from the BoundaryConditionState object.

Note

This object can be accessed by:

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

The corresponding analysis keywords are:

  • CONNECTOR MOTION

Member Details:

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

A Float specifying the connector acceleration component in the connector’s local 1-direction.

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

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

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

A Float specifying the connector acceleration component in the connector’s local 2-direction.

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

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

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

A Float specifying the connector acceleration component in the connector’s local 3-direction.

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

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

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

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

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

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

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

A Float specifying the connector acceleration component in the connector’s local 4-direction.

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

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

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

A Float specifying the connector acceleration component in the connector’s local 5-direction.

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

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

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

A Float specifying the connector acceleration component in the connector’s local 6-direction.

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

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

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

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

  • NOT_YET_ACTIVE

  • CREATED

  • PROPAGATED

  • MODIFIED

  • DEACTIVATED

  • NO_LONGER_ACTIVE

  • TYPE_NOT_APPLICABLE

  • INSTANCE_NOT_APPLICABLE

  • PROPAGATED_FROM_BASE_STATE

  • MODIFIED_FROM_BASE_STATE

  • DEACTIVATED_FROM_BASE_STATE

  • BUILT_INTO_MODES

class ConnDisplacementBC(
name,
createStepName,
region='',
fastenerName='',
fastenerSetName='',
u1=UNSET,
u2=UNSET,
u3=UNSET,
ur1=UNSET,
ur2=UNSET,
ur3=UNSET,
fixed=0,
amplitude=UNSET,
distributionType=UNIFORM,
buckleCase=NOT_APPLICABLE,
)[source]

Bases: BoundaryCondition

The ConnDisplacementBC object stores the data for a connector displacement/rotation boundary condition. The ConnDisplacementBC object is derived from the BoundaryCondition object.

Note

This object can be accessed by:

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

Member Details:

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

A SymbolicConstant specifying how the boundary condition is defined in a BUCKLE analysis. Possible values are NOT_APPLICABLE, STRESS_PERTURBATION, BUCKLING_MODES, and PERTURBATION_AND_BUCKLING. The default value is NOT_APPLICABLE.

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

A SymbolicConstant specifying the category of the boundary condition. Possible values are MECHANICAL and THERMAL.

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

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

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

A String specifying the name of the assembled fastener to which the boundary condition 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 boundary condition 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.

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

A Boolean specifying whether the boundary condition should remain fixed at the current values at the start of the step. The default value is OFF.

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

None or a DatumCsys object specifying the local coordinate system of the boundary condition’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

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

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

setValues(
region='',
fastenerName='',
fastenerSetName='',
u1=UNSET,
u2=UNSET,
u3=UNSET,
ur1=UNSET,
ur2=UNSET,
ur3=UNSET,
fixed=0,
amplitude=UNSET,
distributionType=UNIFORM,
buckleCase=NOT_APPLICABLE,
)[source]

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

Parameters:
region=''

The wire region to which the boundary condition 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 boundary condition 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 boundary condition 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.

u1=UNSET

A Float, a Complex, or a SymbolicConstant specifying the displacement component in the connector’s local 1-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET. Note: Although u1, u2, u3, ur1, ur2, and ur3 are optional arguments, at least one of them must be specified.

u2=UNSET

A Float, a Complex, or a SymbolicConstant specifying the displacement component in the connector’s local 2-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

u3=UNSET

A Float, a Complex, or a SymbolicConstant specifying the displacement component in the connector’s local 3-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

ur1=UNSET

A Float, a Complex, or a SymbolicConstant specifying the rotational component in the connector’s local 4-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

ur2=UNSET

A Float, a Complex, or a SymbolicConstant specifying the rotational component in the connector’s local 5-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

ur3=UNSET

A Float, a Complex, or a SymbolicConstant specifying the rotational component in the connector’s local 6-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

fixed=0

A Boolean specifying whether the boundary condition should remain fixed at the current values at the start of the step. The default value is OFF.

amplitude=UNSET

A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the boundary condition 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 boundary condition is distributed spatially. Possible values are UNIFORM and USER_DEFINED. The default value is UNIFORM.

buckleCase=NOT_APPLICABLE

A SymbolicConstant specifying how the boundary condition is defined in a BUCKLE analysis. Possible values are NOT_APPLICABLE, STRESS_PERTURBATION, BUCKLING_MODES, and PERTURBATION_AND_BUCKLING. The default value is NOT_APPLICABLE.

setValuesInStep(
stepName,
u1=SET,
u2=SET,
u3=SET,
ur1=SET,
ur2=SET,
ur3=SET,
amplitude='',
buckleCase=NOT_APPLICABLE,
)[source]

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

Parameters:
stepName

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

u1=SET

A Float, a Complex, or a SymbolicConstant specifying the displacement component in the connector’s local 1-direction. Possible values for the SymbolicConstant are SET, UNCHANGED, and FREED.

u2=SET

A Float, a Complex, or a SymbolicConstant specifying the displacement component in the connector’s local 2-direction. Possible values for the SymbolicConstant are SET, UNCHANGED, and FREED.

u3=SET

A Float, a Complex, or a SymbolicConstant specifying the displacement component in the connector’s local 3-direction. Possible values for the SymbolicConstant are SET, UNCHANGED, and FREED.

ur1=SET

A Float, a Complex, or a SymbolicConstant specifying the rotational component in the connector’s local 4-direction. Possible values for the SymbolicConstant are SET, UNCHANGED, and FREED.

ur2=SET

A Float, a Complex, or a SymbolicConstant specifying the rotational component in the connector’s local 5-direction. Possible values for the SymbolicConstant are SET, UNCHANGED, and FREED.

ur3=SET

A Float, a Complex, or a SymbolicConstant specifying the rotational component in the connector’s local 6-direction. Possible values for the SymbolicConstant are SET, UNCHANGED, and FREED.

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 boundary condition is changed to have no amplitude reference. You should provide the amplitude argument only if it is valid for the specified step.

buckleCase=NOT_APPLICABLE

A SymbolicConstant specifying how the boundary condition is defined in a BUCKLE analysis. Possible values are NOT_APPLICABLE, STRESS_PERTURBATION, BUCKLING_MODES, and PERTURBATION_AND_BUCKLING. The default value is NOT_APPLICABLE.

class ConnDisplacementBCState[source]

Bases: BoundaryConditionState

The ConnDisplacementBCState object stores the propagating data for a connector displacement/rotation boundary condition in a step. One instance of this object is created internally by the ConnDisplacementBC object for each step. The instance is also deleted internally by the ConnDisplacementBC object. The ConnDisplacementBCState object has no constructor or methods. The ConnDisplacementBCState object is derived from the BoundaryConditionState object.

Note

This object can be accessed by:

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

The corresponding analysis keywords are:

  • CONNECTOR MOTION

Member Details:

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

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

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

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

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

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

  • NOT_YET_ACTIVE

  • CREATED

  • PROPAGATED

  • MODIFIED

  • DEACTIVATED

  • NO_LONGER_ACTIVE

  • TYPE_NOT_APPLICABLE

  • INSTANCE_NOT_APPLICABLE

  • PROPAGATED_FROM_BASE_STATE

  • MODIFIED_FROM_BASE_STATE

  • DEACTIVATED_FROM_BASE_STATE

  • BUILT_INTO_MODES

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

class ConnVelocityBC(
name,
createStepName,
region='',
fastenerName='',
fastenerSetName='',
v1=UNSET,
v2=UNSET,
v3=UNSET,
vr1=UNSET,
vr2=UNSET,
vr3=UNSET,
amplitude=UNSET,
distributionType=UNIFORM,
)[source]

Bases: BoundaryCondition

The ConnVelocityBC object stores the data for a connector velocity boundary condition. The ConnVelocityBC object is derived from the BoundaryCondition object.

Note

This object can be accessed by:

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

Member Details:

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

A SymbolicConstant specifying the category of the boundary condition. Possible values are MECHANICAL and THERMAL.

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

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

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

A String specifying the name of the assembled fastener to which the boundary condition 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 boundary condition 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.

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

None or a DatumCsys object specifying the local coordinate system of the boundary condition’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

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

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

setValues(
region='',
fastenerName='',
fastenerSetName='',
v1=UNSET,
v2=UNSET,
v3=UNSET,
vr1=UNSET,
vr2=UNSET,
vr3=UNSET,
amplitude=UNSET,
distributionType=UNIFORM,
)[source]

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

Parameters:
region=''

The wire region to which the boundary condition 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 boundary condition 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 boundary condition 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.

v1=UNSET

A Float or a SymbolicConstant specifying the velocity component in the connector’s local 1-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET. Note: Although v1, v2, v3, vr1, vr2, and vr3 are optional arguments, at least one of them must be specified.

v2=UNSET

A Float or a SymbolicConstant specifying the velocity component in the connector’s local 2-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

v3=UNSET

A Float or a SymbolicConstant specifying the velocity component in the connector’s local 3-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

vr1=UNSET

A Float or a SymbolicConstant specifying the rotational velocity component in the connector’s local 4-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

vr2=UNSET

A Float or a SymbolicConstant specifying the rotational velocity component in the connector’s local 5-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

vr3=UNSET

A Float or a SymbolicConstant specifying the rotational velocity component in the connector’s local 6-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

amplitude=UNSET

A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the boundary condition 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 boundary condition is distributed spatially. Possible values are UNIFORM and USER_DEFINED. The default value is UNIFORM.

setValuesInStep(
stepName,
v1=SET,
v2=SET,
v3=SET,
vr1=SET,
vr2=SET,
vr3=SET,
amplitude='',
)[source]

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

Parameters:
stepName

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

v1=SET

A Float or a SymbolicConstant specifying the velocity component in the connector’s local 1-direction. Possible values for the SymbolicConstant are SET and FREED.

v2=SET

A Float or a SymbolicConstant specifying the velocity component in the connector’s local 2-direction. Possible values for the SymbolicConstant are SET and FREED.

v3=SET

A Float or a SymbolicConstant specifying the velocity component in the connector’s local 3-direction. Possible values for the SymbolicConstant are SET and FREED.

vr1=SET

A Float or a SymbolicConstant specifying the rotational velocity component in the connector’s local 4-direction. Possible values for the SymbolicConstant are SET and FREED.

vr2=SET

A Float or a SymbolicConstant specifying the rotational velocity component in the connector’s local 5-direction. Possible values for the SymbolicConstant are SET and FREED.

vr3=SET

A Float or a SymbolicConstant specifying the rotational velocity component in the connector’s local 6-direction. Possible values for the SymbolicConstant are SET and FREED.

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 boundary condition is changed to have no amplitude reference. You should provide the amplitude argument only if it is valid for the specified step.

class ConnVelocityBCState[source]

Bases: BoundaryConditionState

The ConnVelocityBCState object stores the propagating data for a velocity boundary condition in a step. One instance of this object is created internally by the ConnVelocityBC object for each step. The instance is also deleted internally by the ConnVelocityBC object. The ConnVelocityBCState object has no constructor or methods. The ConnVelocityBCState object is derived from the BoundaryConditionState object.

Note

This object can be accessed by:

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

The corresponding analysis keywords are:

  • CONNECTOR MOTION

Member Details:

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

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

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

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

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

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

  • NOT_YET_ACTIVE

  • CREATED

  • PROPAGATED

  • MODIFIED

  • DEACTIVATED

  • NO_LONGER_ACTIVE

  • TYPE_NOT_APPLICABLE

  • INSTANCE_NOT_APPLICABLE

  • PROPAGATED_FROM_BASE_STATE

  • MODIFIED_FROM_BASE_STATE

  • DEACTIVATED_FROM_BASE_STATE

  • BUILT_INTO_MODES

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

A Float specifying the velocity component in the connector’s local 1-direction.

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

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

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

A Float specifying the velocity component in the connector’s local 2-direction.

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

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

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

A Float specifying the velocity component in the connector’s local 3-direction.

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

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

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

A Float specifying the rotational velocity component in the connector’s local 4-direction.

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

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

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

A Float specifying the rotational velocity component in the connector’s local 5-direction.

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

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

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

A Float specifying the rotational velocity component in the connector’s local 6-direction.

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

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

class DisplacementBC(
name,
createStepName,
region,
fieldName='',
u1=UNSET,
u2=UNSET,
u3=UNSET,
ur1=UNSET,
ur2=UNSET,
ur3=UNSET,
fixed=0,
amplitude=UNSET,
distributionType=UNIFORM,
localCsys=None,
buckleCase=NOT_APPLICABLE,
)[source]

Bases: BoundaryCondition

The DisplacementBC object stores the data for a displacement/rotation boundary condition. The DisplacementBC object is derived from the BoundaryCondition object.

Note

This object can be accessed by:

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

Member Details:

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

A SymbolicConstant specifying how the boundary condition is defined in a BUCKLE analysis. Possible values are NOT_APPLICABLE, STRESS_PERTURBATION, BUCKLING_MODES, and PERTURBATION_AND_BUCKLING. The default value is NOT_APPLICABLE.

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

A SymbolicConstant specifying the category of the boundary condition. Possible values are MECHANICAL and THERMAL.

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

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

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

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

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

A Boolean specifying whether the boundary condition should remain fixed at the current values at the start of the step. The default value is OFF.

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

None or a DatumCsys object specifying the local coordinate system of the boundary condition’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

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

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

setValues(
fieldName='',
u1=UNSET,
u2=UNSET,
u3=UNSET,
ur1=UNSET,
ur2=UNSET,
ur3=UNSET,
fixed=0,
amplitude=UNSET,
distributionType=UNIFORM,
localCsys=None,
buckleCase=NOT_APPLICABLE,
)[source]

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

Parameters:
fieldName=''

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

u1=UNSET

A Float, a Complex, or a SymbolicConstant specifying the displacement component in the 1-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET. Note: Although u1, u2, u3, ur1, ur2, and ur3 are optional arguments, at least one of them must be specified.

u2=UNSET

A Float, a Complex, or a SymbolicConstant specifying the displacement component in the 2-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

u3=UNSET

A Float, a Complex, or a SymbolicConstant specifying the displacement component in the 3-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

ur1=UNSET

A Float, a Complex, or a SymbolicConstant specifying the rotational displacement component about the 1-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

ur2=UNSET

A Float, a Complex, or a SymbolicConstant specifying the rotational displacement component about the 2-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

ur3=UNSET

A Float, a Complex, or a SymbolicConstant specifying the rotational displacement component about the 3-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

fixed=0

A Boolean specifying whether the boundary condition should remain fixed at the current values at the start of the step. The default value is OFF.

amplitude=UNSET

A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the boundary condition 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 boundary condition is distributed spatially. Possible values are UNIFORM, USER_DEFINED, FIELD, and DISCRETE_FIELD. The default value is UNIFORM.

localCsys=None

None or a DatumCsys object specifying the local coordinate system of the boundary condition’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

buckleCase=NOT_APPLICABLE

A SymbolicConstant specifying how the boundary condition is defined in a BUCKLE analysis. Possible values are NOT_APPLICABLE, STRESS_PERTURBATION, BUCKLING_MODES, and PERTURBATION_AND_BUCKLING. The default value is NOT_APPLICABLE.

setValuesInStep(
stepName,
u1=SET,
u2=SET,
u3=SET,
ur1=SET,
ur2=SET,
ur3=SET,
amplitude='',
buckleCase=NOT_APPLICABLE,
)[source]

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

Parameters:
stepName

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

u1=SET

A Float, a Complex, or a SymbolicConstant specifying the displacement component in the 1-direction. Possible values for the SymbolicConstant are SET, UNCHANGED, and FREED.

u2=SET

A Float, a Complex, or a SymbolicConstant specifying the displacement component in the 2-direction. Possible values for the SymbolicConstant are SET, UNCHANGED, and FREED.

u3=SET

A Float, a Complex, or a SymbolicConstant specifying the displacement component in the 3-direction. Possible values for the SymbolicConstant are SET, UNCHANGED, and FREED.

ur1=SET

A Float, a Complex, or a SymbolicConstant specifying the rotational displacement component about the 1-direction. Possible values for the SymbolicConstant are SET, UNCHANGED, and FREED.

ur2=SET

A Float, a Complex, or a SymbolicConstant specifying the rotational displacement component about the 2-direction. Possible values for the SymbolicConstant are SET, UNCHANGED, and FREED.

ur3=SET

A Float, a Complex, or a SymbolicConstant specifying the rotational displacement component about the 3-direction. Possible values for the SymbolicConstant are SET, UNCHANGED, and FREED.

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 boundary condition is changed to have no amplitude reference. You should provide the amplitude argument only if it is valid for the specified step.

buckleCase=NOT_APPLICABLE

A SymbolicConstant specifying how the boundary condition is defined in a BUCKLE analysis. Possible values are NOT_APPLICABLE, STRESS_PERTURBATION, BUCKLING_MODES, and PERTURBATION_AND_BUCKLING. The default value is NOT_APPLICABLE.

class DisplacementBCState[source]

Bases: BoundaryConditionState

The DisplacementBCState object stores the propagating data for a displacement/rotation boundary condition in a step. One instance of this object is created internally by the DisplacementBC object for each step. The instance is also deleted internally by the DisplacementBC object. The DisplacementBCState object has no constructor or methods. The DisplacementBCState object is derived from the BoundaryConditionState object.

Note

This object can be accessed by:

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

The corresponding analysis keywords are:

  • 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 boundary condition has no amplitude reference.

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

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

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

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

  • NOT_YET_ACTIVE

  • CREATED

  • PROPAGATED

  • MODIFIED

  • DEACTIVATED

  • NO_LONGER_ACTIVE

  • TYPE_NOT_APPLICABLE

  • INSTANCE_NOT_APPLICABLE

  • PROPAGATED_FROM_BASE_STATE

  • MODIFIED_FROM_BASE_STATE

  • DEACTIVATED_FROM_BASE_STATE

  • BUILT_INTO_MODES

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

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

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

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

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

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

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

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

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

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

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

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

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

A Float or a Complex specifying the rotational displacement component about the 1-direction.

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

A SymbolicConstant specifying the propagation state of the rotational displacement component about the 1-direction. Possible values are UNSET, SET, UNCHANGED, FREED, and MODIFIED.

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

A Float or a Complex specifying the rotational displacement component about the 2-direction.

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

A SymbolicConstant specifying the propagation state of the rotational displacement component about the 2-direction. Possible values are UNSET, SET, UNCHANGED, FREED, and MODIFIED.

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

A Float or a Complex specifying the rotational displacement component about the 3-direction.

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

A SymbolicConstant specifying the propagation state of the rotational displacement component about the 3-direction. Possible values are UNSET, SET, UNCHANGED, FREED, and MODIFIED.

class DisplacementBaseMotionBC(
name,
createStepName,
dof,
amplitudeScaleFactor=1,
centerOfRotation=(),
correlation=None,
secondaryBase='',
useComplex=0,
amplitude=UNSET,
)[source]

Bases: BoundaryCondition

The DisplacementBaseMotionBC object stores the data for a displacement base motion boundary condition. The DisplacementBaseMotionBC object is derived from the BoundaryCondition object.

Note

This object can be accessed by:

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

Member Details:

amplitudeScaleFactor : --is-rst--:py:class:`float` = 1[source]

A Float specifying the scale factor for the amplitude curve. The default value is 1.0.

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

A SymbolicConstant specifying the category of the boundary condition. Possible values are MECHANICAL and THERMAL.

centerOfRotation : --is-rst--:py:class:`tuple` = ()[source]

A ModelDot object specifying a tuple containing one center of rotation. The default value is the global origin. This argument applies only when dof = UR1, UR2, or UR3.

correlation : --is-rst--:py:class:`~abaqus.Amplitude.Correlation.Correlation` = <abaqus.Amplitude.Correlation.Correlation object>[source]

A Correlation object.

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

None or a DatumCsys object specifying the local coordinate system of the boundary condition’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

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

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

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

A String specifying the name of the SecondaryBaseBC object associated with this boundary condition. The default value is an empty string.

setValues(
amplitudeScaleFactor=1,
centerOfRotation=(),
correlation=None,
secondaryBase='',
useComplex=0,
amplitude=UNSET,
)[source]

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

Parameters:
amplitudeScaleFactor=1

A Float specifying the scale factor for the amplitude curve. The default value is 1.0.

centerOfRotation=()

A ModelDot object specifying a tuple containing one center of rotation. The default value is the global origin. This argument applies only when dof = UR1, UR2, or UR3.

correlation=None

A Correlation object.

secondaryBase=''

A String specifying the name of the SecondaryBaseBC object associated with this boundary condition. The default value is an empty string.

useComplex=0

A Boolean specifying whether to define the imaginary (out-of-plane) portion of the base motion record given by amplitude definition. The default value is OFF.

amplitude=UNSET

A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the boundary condition 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, amplitude='')[source]

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

Parameters:
stepName

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

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 boundary condition is changed to have no amplitude reference. You should provide the amplitude argument only if it is valid for the specified step.

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

A Boolean specifying whether to define the imaginary (out-of-plane) portion of the base motion record given by amplitude definition. The default value is OFF.

class DisplacementBaseMotionBCState[source]

Bases: BoundaryConditionState

The DisplacementBaseMotionBCState object stores the propagating data for a velocity base motion boundary condition in a step. One instance of this object is created internally by the DisplacementBaseMotionBC object for each step. The instance is also deleted internally by the DisplacementBaseMotionBC object. The DisplacementBaseMotionBCState object has no constructor or methods. The DisplacementBaseMotionBCState object is derived from the BoundaryConditionState object.

Note

This object can be accessed by:

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

The corresponding analysis keywords are:

  • BASE MOTION

Member Details:

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

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

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

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

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

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

  • NOT_YET_ACTIVE

  • CREATED

  • PROPAGATED

  • MODIFIED

  • DEACTIVATED

  • NO_LONGER_ACTIVE

  • TYPE_NOT_APPLICABLE

  • INSTANCE_NOT_APPLICABLE

  • PROPAGATED_FROM_BASE_STATE

  • MODIFIED_FROM_BASE_STATE

  • DEACTIVATED_FROM_BASE_STATE

  • BUILT_INTO_MODES

class ElectricPotentialBC(
name,
createStepName,
region,
fieldName='',
magnitude=0,
distributionType=UNIFORM,
amplitude=UNSET,
fixed=0,
)[source]

Bases: BoundaryCondition

The ElectricPotentialBC object stores the data for an electrical potential boundary condition. The ElectricPotentialBC object is derived from the BoundaryCondition object.

Note

This object can be accessed by:

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

Member Details:

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

A SymbolicConstant specifying the category of the boundary condition. Possible values are MECHANICAL and THERMAL.

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

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

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

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

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

None or a DatumCsys object specifying the local coordinate system of the boundary condition’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

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

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

setValues(
fieldName='',
magnitude=0,
distributionType=UNIFORM,
amplitude=UNSET,
fixed=0,
)[source]

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

Parameters:
fieldName=''

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

magnitude=0

A Float specifying the electrical potential magnitude. The default value is 0. The magnitude argument is optional if distributionType = USER_DEFINED.

distributionType=UNIFORM

A SymbolicConstant specifying how the boundary condition 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 boundary condition has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

fixed=0

A Boolean specifying whether the boundary condition should remain fixed at the current values at the start of the step. The default value is OFF.

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

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

Parameters:
stepName

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

magnitude=UNCHANGED

A Float or the SymbolicConstant FREED specifying the electrical potential 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 boundary condition is changed to have no amplitude reference. You should provide the amplitude argument only if it is valid for the specified step.

class ElectricPotentialBCState[source]

Bases: BoundaryConditionState

The ElectricPotentialBCState object stores the propagating data for a electrical potential boundary condition in a step. One instance of this object is created internally by the ElectricPotentialBC object for each step. The instance is also deleted internally by the ElectricPotentialBC object. The ElectricPotentialBCState object has no constructor or methods. The ElectricPotentialBCState object is derived from the BoundaryConditionState object.

Note

This object can be accessed by:

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

The corresponding analysis keywords are:

  • 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 boundary condition has no amplitude reference.

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

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

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

A Float specifying the electrical potential magnitude.

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

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

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

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

  • NOT_YET_ACTIVE

  • CREATED

  • PROPAGATED

  • MODIFIED

  • DEACTIVATED

  • NO_LONGER_ACTIVE

  • TYPE_NOT_APPLICABLE

  • INSTANCE_NOT_APPLICABLE

  • PROPAGATED_FROM_BASE_STATE

  • MODIFIED_FROM_BASE_STATE

  • DEACTIVATED_FROM_BASE_STATE

  • BUILT_INTO_MODES

class EulerianBC(
name,
createStepName,
region,
definition=INFLOW,
inflowType=FREE,
outflowType=ZERO_PRESSURE,
)[source]

Bases: BoundaryCondition

The EulerianBC object stores the data for an Eulerian boundary condition. The EulerianBC object is derived from the BoundaryCondition object.

Note

This object can be accessed by:

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

Member Details:

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

A SymbolicConstant specifying the category of the boundary condition. Possible values are MECHANICAL and THERMAL.

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

A SymbolicConstant specifying the flow conditions to be defined. Possible values are INFLOW, OUTFLOW, and BOTH. The default value is INFLOW.

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

A SymbolicConstant specifying the control of material flow into the Eulerian domain. Possible values are FREE, NONE, and VOID. The default value is FREE.

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

None or a DatumCsys object specifying the local coordinate system of the boundary condition’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

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

A String specifying the boundary condition repository key.

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

A SymbolicConstant specifying the control of flow of material out of the Eulerian domain. Possible values are ZERO_PRESSURE, FREE, NON_REFLECTING, and EQUILIBRIUM. The default value is ZERO_PRESSURE.

region : --is-rst--:py:class:`~abaqus.Region.Region.Region` = <abaqus.Region.Region.Region object>[source]

A Region object specifying the region to which the boundary condition is applied.

setValues(
region,
definition=INFLOW,
inflowType=FREE,
outflowType=ZERO_PRESSURE,
)[source]

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

Parameters:
region

A Region object specifying the region to which the boundary condition is applied.

definition=INFLOW

A SymbolicConstant specifying the material flow conditions to be defined. Possible values are INFLOW, OUTFLOW, and BOTH. The default value is INFLOW.

inflowType=FREE

A SymbolicConstant specifying the control of material flow into the Eulerian domain. Possible values are FREE, NONE, and VOID. The default value is FREE.

outflowType=ZERO_PRESSURE

A SymbolicConstant specifying the control of material flow out of the Eulerian domain. Possible values are ZERO_PRESSURE, FREE, NON_REFLECTING, and EQUILIBRIUM. The default value is ZERO_PRESSURE.

setValuesInStep(
stepName,
definition=INFLOW,
inflowType=FREE,
outflowType=ZERO_PRESSURE,
)[source]

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

Parameters:
stepName

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

definition=INFLOW

A SymbolicConstant specifying the material flow conditions to be defined. Possible values are INFLOW, OUTFLOW, and BOTH. The default value is INFLOW.

inflowType=FREE

A SymbolicConstant specifying the control of material flow into the Eulerian domain. Possible values are FREE, NONE, and VOID. The default value is FREE.

outflowType=ZERO_PRESSURE

A SymbolicConstant specifying the control of material flow out of the Eulerian domain. Possible values are ZERO_PRESSURE, FREE, NON_REFLECTING, and EQUILIBRIUM. The default value is ZERO_PRESSURE.

class EulerianBCState[source]

Bases: BoundaryConditionState

The EulerianBCState object stores the propagating data for an Eulerian boundary condition in a step. One instance of this object is created internally by the EulerianBC object for each step. The instance is also deleted internally by the EulerianBC object. The EulerianBCState object has no constructor or methods. The EulerianBCState object is derived from the BoundaryConditionState object.

Note

This object can be accessed by:

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

The corresponding analysis keywords are:

  • EULERIAN 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 boundary condition has no amplitude reference.

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

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

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

A SymbolicConstant specifying the material flow conditions to be defined. Possible values are INFLOW, OUTFLOW, and BOTH. The default value is INFLOW.

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

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

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

A SymbolicConstant specifying the material flow conditions to be defined. Possible values are FREE, NONE, and VOID. The default value is FREE.

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

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

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

A SymbolicConstant specifying the material flow conditions to be defined. Possible values are ZERO_PRESSURE, FREE, NON_REFLECTING, and EQUILIBRIUM. The default value is ZERO_PRESSURE.

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

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

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

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

  • NOT_YET_ACTIVE

  • CREATED

  • PROPAGATED

  • MODIFIED

  • DEACTIVATED

  • NO_LONGER_ACTIVE

  • TYPE_NOT_APPLICABLE

  • INSTANCE_NOT_APPLICABLE

  • PROPAGATED_FROM_BASE_STATE

  • MODIFIED_FROM_BASE_STATE

  • DEACTIVATED_FROM_BASE_STATE

  • BUILT_INTO_MODES

class EulerianMotionBC(
name,
createStepName,
instanceName,
followRegion=1,
region=None,
materialName='',
ctrPosition1=FREE,
posPosition1=FREE,
negPosition1=FREE,
expansionRatio1=None,
contractRatio1=0,
ctrPosition2=FREE,
posPosition2=FREE,
negPosition2=FREE,
expansionRatio2=None,
contractRatio2=0,
ctrPosition3=FREE,
posPosition3=FREE,
negPosition3=FREE,
expansionRatio3=None,
contractRatio3=0,
allowContraction=1,
aspectLimit=10,
vmaxFactor=1,
volThreshold=0,
bufferSize=2,
)[source]

Bases: BoundaryCondition

The EulerianMotionBC object stores the data for an Eulerian mesh motion boundary condition. The EulerianMotionBC object is derived from the BoundaryCondition object.

Note

This object can be accessed by:

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

Member Details:

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

A Boolean specifying whether the mesh is allowed to contract . The default value is ON.

aspectLimit : --is-rst--:py:class:`float` = 10[source]

A Float specifying the maximum change in allowed aspect ratio (for any of the three mesh aspects, 1-2, 2-3, 3-1). The default value is 10.0.

bufferSize : --is-rst--:py:class:`float` = 2[source]

None or a Float specifying the buffer between the surface box and the Eulerian section mesh bounding box. The default value is 2.0.

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

A SymbolicConstant specifying the category of the boundary condition. Possible values are MECHANICAL and THERMAL.

contractRatio1 : --is-rst--:py:class:`float` = 0[source]

A Float specifying the lower bounds on the allowable scaling of the mesh in the 1 direction. The default value is 0.0.

contractRatio2 : --is-rst--:py:class:`float` = 0[source]

A Float specifying the lower bounds on the allowable scaling of the mesh in the 2 direction. The default value is 0.0.

contractRatio3 : --is-rst--:py:class:`float` = 0[source]

A Float specifying the lower bounds on the allowable scaling of the mesh in the 3 direction. The default value is 0.0.

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

A SymbolicConstant specifying the 1-direction translational constraint on the center of the Eulerian mesh. Possible values are FREE and FIXED. The default value is FREE.

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

A SymbolicConstant specifying the 2-direction translational constraint on the center of the Eulerian mesh. Possible values are FREE and FIXED. The default value is FREE.

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

A SymbolicConstant specifying the 3-direction translational constraint on the center of the Eulerian mesh. Possible values are FREE and FIXED. The default value is FREE.

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

None or a Float specifying the upper bounds on the allowable scaling of the mesh in the 1 direction. If expansionRatio1 = None, then there is no upper limit. The default value is None.

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

None or a Float specifying the upper bounds on the allowable scaling of the mesh in the 2 direction. If expansionRatio2 = None, then there is no upper limit. The default value is None.

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

None or a Float specifying the upper bounds on the allowable scaling of the mesh in the 3 direction. If expansionRatio3 = None, then there is no upper limit. The default value is None.

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

A Boolean specifying whether the mesh will follow a regular surface region or an Eulerian surface. The default value is ON.

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

A String specifying the name of the Eulerian part instance.

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

None or a DatumCsys object specifying the local coordinate system of the boundary condition’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

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

A String specifying the name of the Eulerian surface to follow. This argument applies only when followRegion = False.

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

A String specifying the boundary condition repository key.

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

A SymbolicConstant specifying the translational constraint on the negative (minimum) bounds of the mesh in the 1 direction. Possible values are FREE and FIXED. The default value is FREE.

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

A SymbolicConstant specifying the translational constraint on the negative (minimum) bounds of the mesh in the 2 direction. Possible values are FREE and FIXED. The default value is FREE.

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

A SymbolicConstant specifying the translational constraint on the negative (minimum) bounds of the mesh in the 3 direction. Possible values are FREE and FIXED. The default value is FREE.

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

A SymbolicConstant specifying the translational constraint on the positive (maximum) bounds of the mesh in the 1 direction. Possible values are FREE and FIXED. The default value is FREE.

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

A SymbolicConstant specifying the translational constraint on the positive (maximum) bounds of the mesh in the 2 direction. Possible values are FREE and FIXED. The default value is FREE.

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

A SymbolicConstant specifying the translational constraint on the positive (maximum) bounds of the mesh in the 3 direction. Possible values are FREE and FIXED. The default value is FREE.

region : --is-rst--:py:class:`~abaqus.Region.Region.Region` = <abaqus.Region.Region.Region object>[source]

A Region object specifying the region to which the boundary condition is applied.

setValues(
instanceName,
followRegion=1,
region=None,
materialName='',
ctrPosition1=FREE,
posPosition1=FREE,
negPosition1=FREE,
expansionRatio1=None,
contractRatio1=0,
ctrPosition2=FREE,
posPosition2=FREE,
negPosition2=FREE,
expansionRatio2=None,
contractRatio2=0,
ctrPosition3=FREE,
posPosition3=FREE,
negPosition3=FREE,
expansionRatio3=None,
contractRatio3=0,
allowContraction=1,
aspectLimit=10,
vmaxFactor=1,
volThreshold=0,
bufferSize=2,
)[source]

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

Parameters:
instanceName

A String specifying the name of the Eulerian part instance.

followRegion=1

A Boolean specifying whether the mesh will follow a regular surface region or an Eulerian surface. The default value is ON.

region=None

A Region object specifying the region to which the boundary condition is applied.

materialName=''

A String specifying the name of the Eulerian surface to follow. This argument applies only when followRegion = False.

ctrPosition1=FREE

A SymbolicConstant specifying the 1-direction translational constraint on the center of the Eulerian mesh. Possible values are FREE and FIXED. The default value is FREE.

posPosition1=FREE

A SymbolicConstant specifying the translational constraint on the positive (maximum) bounds of the mesh in the 1 direction. Possible values are FREE and FIXED. The default value is FREE.

negPosition1=FREE

A SymbolicConstant specifying the translational constraint on the negative (minimum) bounds of the mesh in the 1 direction. Possible values are FREE and FIXED. The default value is FREE.

expansionRatio1=None

None or a Float specifying the upper bounds on the allowable scaling of the mesh in the 1 direction. If expansionRatio1 = None, then there is no upper limit. The default value is None.

contractRatio1=0

A Float specifying the lower bounds on the allowable scaling of the mesh in the 1 direction. The default value is 0.0.

ctrPosition2=FREE

A SymbolicConstant specifying the 2-direction translational constraint on the center of the Eulerian mesh. Possible values are FREE and FIXED. The default value is FREE.

posPosition2=FREE

A SymbolicConstant specifying the translational constraint on the positive (maximum) bounds of the mesh in the 2 direction. Possible values are FREE and FIXED. The default value is FREE.

negPosition2=FREE

A SymbolicConstant specifying the translational constraint on the negative (minimum) bounds of the mesh in the 2 direction. Possible values are FREE and FIXED. The default value is FREE.

expansionRatio2=None

None or a Float specifying the upper bounds on the allowable scaling of the mesh in the 2 direction. If expansionRatio2 = None, then there is no upper limit. The default value is None.

contractRatio2=0

A Float specifying the lower bounds on the allowable scaling of the mesh in the 2 direction. The default value is 0.0.

ctrPosition3=FREE

A SymbolicConstant specifying the 3-direction translational constraint on the center of the Eulerian mesh. Possible values are FREE and FIXED. The default value is FREE.

posPosition3=FREE

A SymbolicConstant specifying the translational constraint on the positive (maximum) bounds of the mesh in the 3 direction. Possible values are FREE and FIXED. The default value is FREE.

negPosition3=FREE

A SymbolicConstant specifying the translational constraint on the negative (minimum) bounds of the mesh in the 3 direction. Possible values are FREE and FIXED. The default value is FREE.

expansionRatio3=None

None or a Float specifying the upper bounds on the allowable scaling of the mesh in the 3 direction. If expansionRatio3 = None, then there is no upper limit. The default value is None.

contractRatio3=0

A Float specifying the lower bounds on the allowable scaling of the mesh in the 3 direction. The default value is 0.0.

allowContraction=1

A Boolean specifying whether the mesh is allowed to contract . The default value is ON.

aspectLimit=10

A Float specifying the maximum change in allowed aspect ratio (for any of the three mesh aspects, 1-2, 2-3, 3-1). The default value is 10.0.

vmaxFactor=1

A Float specifying the multiplier for the mesh nodal velocity limit. The default value is 1.01.

volThreshold=0

A Float specifying the lower bounds on the volume fraction when determining which nodes to include in the surface bounding box calculation for an Eulerian material surface. This argument applies only when followRegion = False. The default value is 0.5.

bufferSize=2

None or a Float specifying the buffer between the surface box and the Eulerian section mesh bounding box. The default value is 2.0.

setValuesInStep(
stepName,
ctrPosition1=FREE,
posPosition1=FREE,
negPosition1=FREE,
expansionRatio1=None,
contractRatio1=0,
ctrPosition2=FREE,
posPosition2=FREE,
negPosition2=FREE,
expansionRatio2=None,
contractRatio2=0,
ctrPosition3=FREE,
posPosition3=FREE,
negPosition3=FREE,
expansionRatio3=None,
contractRatio3=0,
allowContraction=1,
aspectLimit=10,
vmaxFactor=1,
volThreshold=0,
bufferSize=2,
)[source]

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

Parameters:
stepName

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

ctrPosition1=FREE

A SymbolicConstant specifying the 1-direction translational constraint on the center of the Eulerian mesh. Possible values are FREE and FIXED. The default value is FREE.

posPosition1=FREE

A SymbolicConstant specifying the translational constraint on the positive (maximum) bounds of the mesh in the 1 direction. Possible values are FREE and FIXED. The default value is FREE.

negPosition1=FREE

A SymbolicConstant specifying the translational constraint on the negative (minimum) bounds of the mesh in the 1 direction. Possible values are FREE and FIXED. The default value is FREE.

expansionRatio1=None

None or a Float specifying the upper bounds on the allowable scaling of the mesh in the 1 direction. If expansionRatio1 = None, then there is no upper limit. The default value is None.

contractRatio1=0

A Float specifying the lower bounds on the allowable scaling of the mesh in the 1 direction. The default value is 0.0.

ctrPosition2=FREE

A SymbolicConstant specifying the 2-direction translational constraint on the center of the Eulerian mesh. Possible values are FREE and FIXED. The default value is FREE.

posPosition2=FREE

A SymbolicConstant specifying the translational constraint on the positive (maximum) bounds of the mesh in the 2 direction. Possible values are FREE and FIXED. The default value is FREE.

negPosition2=FREE

A SymbolicConstant specifying the translational constraint on the negative (minimum) bounds of the mesh in the 2 direction. Possible values are FREE and FIXED. The default value is FREE.

expansionRatio2=None

None or a Float specifying the upper bounds on the allowable scaling of the mesh in the 2 direction. If expansionRatio2 = None, then there is no upper limit. The default value is None.

contractRatio2=0

A Float specifying the lower bounds on the allowable scaling of the mesh in the 2 direction. The default value is 0.0.

ctrPosition3=FREE

A SymbolicConstant specifying the 3-direction translational constraint on the center of the Eulerian mesh. Possible values are FREE and FIXED. The default value is FREE.

posPosition3=FREE

A SymbolicConstant specifying the translational constraint on the positive (maximum) bounds of the mesh in the 3 direction. Possible values are FREE and FIXED. The default value is FREE.

negPosition3=FREE

A SymbolicConstant specifying the translational constraint on the negative (minimum) bounds of the mesh in the 3 direction. Possible values are FREE and FIXED. The default value is FREE.

expansionRatio3=None

None or a Float specifying the upper bounds on the allowable scaling of the mesh in the 3 direction. If expansionRatio3 = None, then there is no upper limit. The default value is None.

contractRatio3=0

A Float specifying the lower bounds on the allowable scaling of the mesh in the 3 direction. The default value is 0.0.

allowContraction=1

A Boolean specifying whether the mesh is allowed to contract . The default value is ON.

aspectLimit=10

A Float specifying the maximum change in allowed aspect ratio (for any of the three mesh aspects, 1-2, 2-3, 3-1). The default value is 10.0.

vmaxFactor=1

A Float specifying the multiplier for the mesh nodal velocity limit. The default value is 1.01.

volThreshold=0

A Float specifying the lower bounds on the volume fraction when determining which nodes to include in the surface bounding box calculation for an Eulerian material surface. This argument applies only when followRegion = False. The default value is 0.5.

bufferSize=2

None or a Float specifying the buffer between the surface box and the Eulerian section mesh bounding box. The default value is 2.0.

vmaxFactor : --is-rst--:py:class:`float` = 1[source]

A Float specifying the multiplier for the mesh nodal velocity limit. The default value is 1.01.

volThreshold : --is-rst--:py:class:`float` = 0[source]

A Float specifying the lower bounds on the volume fraction when determining which nodes to include in the surface bounding box calculation for an Eulerian material surface. This argument applies only when followRegion = False. The default value is 0.5.

class EulerianMotionBCState[source]

Bases: BoundaryConditionState

The EulerianMotionBCState object stores the propagating data for an Eulerian mesh motion boundary condition in a step. One instance of this object is created internally by the EulerianMotionBC object for each step. The instance is also deleted internally by the EulerianMotionBC object. The EulerianMotionBCState object has no constructor or methods. The EulerianMotionBCState object is derived from the BoundaryConditionState object.

Note

This object can be accessed by:

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

The corresponding analysis keywords are:

  • EULERIAN MESH MOTION

Member Details:

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

A Boolean specifying whether the mesh is allowed to contract . The default value is ON.

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

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

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

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

aspectLimit : --is-rst--:py:class:`float` = 10[source]

A Float specifying the maximum change in allowed aspect ratio (for any of the three mesh aspects, 1-2, 2-3, 3-1). The default value is 10.0.

bufferSize : --is-rst--:py:class:`float` = 2[source]

None or a Float specifying the buffer between the surface box and the Eulerian section mesh bounding box. The default value is 2.0.

contractRatio1 : --is-rst--:py:class:`float` = 0[source]

A Float specifying the lower bounds on the allowable scaling of the mesh in the 1 direction. The default value is 0.0.

contractRatio2 : --is-rst--:py:class:`float` = 0[source]

A Float specifying the lower bounds on the allowable scaling of the mesh in the 2 direction. The default value is 0.0.

contractRatio3 : --is-rst--:py:class:`float` = 0[source]

A Float specifying the lower bounds on the allowable scaling of the mesh in the 3 direction. The default value is 0.0.

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

A SymbolicConstant specifying the 1-direction translational constraint on the center of the Eulerian mesh. Possible values are FREE and FIXED. The default value is FREE.

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

A SymbolicConstant specifying the 2-direction translational constraint on the center of the Eulerian mesh. Possible values are FREE and FIXED. The default value is FREE.

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

A SymbolicConstant specifying the 3-direction translational constraint on the center of the Eulerian mesh. Possible values are FREE and FIXED. The default value is FREE.

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

None or a Float specifying the upper bounds on the allowable scaling of the mesh in the 1 direction. If expansionRatio1 = None, then there is no upper limit. The default value is None.

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

None or a Float specifying the upper bounds on the allowable scaling of the mesh in the 2 direction. If expansionRatio2 = None, then there is no upper limit. The default value is None.

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

None or a Float specifying the upper bounds on the allowable scaling of the mesh in the 3 direction. If expansionRatio3 = None, then there is no upper limit. The default value is None.

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

A SymbolicConstant specifying the translational constraint on the negative (minimum) bounds of the mesh in the 1 direction. Possible values are FREE and FIXED. The default value is FREE.

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

A SymbolicConstant specifying the translational constraint on the negative (minimum) bounds of the mesh in the 2 direction. Possible values are FREE and FIXED. The default value is FREE.

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

A SymbolicConstant specifying the translational constraint on the negative (minimum) bounds of the mesh in the 3 direction. Possible values are FREE and FIXED. The default value is FREE.

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

A SymbolicConstant specifying the translational constraint on the positive (maximum) bounds of the mesh in the 1 direction. Possible values are FREE and FIXED. The default value is FREE.

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

A SymbolicConstant specifying the translational constraint on the positive (maximum) bounds of the mesh in the 2 direction. Possible values are FREE and FIXED. The default value is FREE.

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

A SymbolicConstant specifying the translational constraint on the positive (maximum) bounds of the mesh in the 3 direction. Possible values are FREE and FIXED. The default value is FREE.

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

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

  • NOT_YET_ACTIVE

  • CREATED

  • PROPAGATED

  • MODIFIED

  • DEACTIVATED

  • NO_LONGER_ACTIVE

  • TYPE_NOT_APPLICABLE

  • INSTANCE_NOT_APPLICABLE

  • PROPAGATED_FROM_BASE_STATE

  • MODIFIED_FROM_BASE_STATE

  • DEACTIVATED_FROM_BASE_STATE

  • BUILT_INTO_MODES

vmaxFactor : --is-rst--:py:class:`float` = 1[source]

A Float specifying the multiplier for the mesh nodal velocity limit. The default value is 1.01.

volThreshold : --is-rst--:py:class:`float` = 0[source]

A Float specifying the lower bounds on the volume fraction when determining which nodes to include in the surface bounding box calculation for an Eulerian material surface. This argument applies only when followRegion = False. The default value is 0.5.

class FluidCavityPressureBC(
name,
createStepName,
fluidCavity,
magnitude=0,
amplitude=UNSET,
fixed=0,
)[source]

Bases: BoundaryCondition

The FluidCavityPressureBC object stores the data for a fluid cavity pressure boundary condition. The FluidCavityPressureBC object is derived from the BoundaryCondition object.

Note

This object can be accessed by:

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

Member Details:

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

A SymbolicConstant specifying the category of the boundary condition. Possible values are MECHANICAL and THERMAL.

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

A String specifying the name of a Fluid Cavity Interaction.

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

None or a DatumCsys object specifying the local coordinate system of the boundary condition’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

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

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

setValues(magnitude=0, amplitude=UNSET, fixed=0)[source]

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

Parameters:
magnitude=0

A Float specifying the fluid cavity pressure magnitude. The default value is 0.

amplitude=UNSET

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

fixed=0

A Boolean specifying whether the boundary condition should remain fixed at the current values at the start of the step. The default value is OFF.

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

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

Parameters:
stepName

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

magnitude=UNCHANGED

A Float or the SymbolicConstant FREED specifying the fluid cavity pressure 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 boundary condition is changed to have no amplitude reference. You should provide the amplitude argument only if it is valid for the specified step.

class FluidCavityPressureBCState[source]

Bases: BoundaryConditionState

The FluidCavityPressureBCState object stores the propagating data for a fluid cavity pressure boundary condition in a step. One instance of this object is created internally by the FluidCavityPressureBC object for each step. The instance is also deleted internally by the FluidCavityPressureBC object. The FluidCavityPressureBCState object has no constructor or methods. The FluidCavityPressureBCState object is derived from the BoundaryConditionState object.

Note

This object can be accessed by:

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

The corresponding analysis keywords are:

  • 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 boundary condition has no amplitude reference.

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

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

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

A Float specifying the fluid cavity pressure magnitude.

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

A SymbolicConstant specifying the propagation state of the fluid cavity pressure magnitude. Possible values are UNSET, SET, UNCHANGED, FREED, and MODIFIED.

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

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

  • NOT_YET_ACTIVE

  • CREATED

  • PROPAGATED

  • MODIFIED

  • DEACTIVATED

  • NO_LONGER_ACTIVE

  • TYPE_NOT_APPLICABLE

  • INSTANCE_NOT_APPLICABLE

  • PROPAGATED_FROM_BASE_STATE

  • MODIFIED_FROM_BASE_STATE

  • DEACTIVATED_FROM_BASE_STATE

  • BUILT_INTO_MODES

class MagneticVectorPotentialBC(
name,
createStepName,
region,
component1=None,
component2=UNSET,
component3=UNSET,
amplitude=UNSET,
distributionType=UNIFORM,
localCsys=None,
)[source]

Bases: BoundaryCondition

The MagneticVectorPotentialBC object stores the data for a magnetic vector potential boundary condition. The MagneticVectorPotentialBC object is derived from the BoundaryCondition object.

Note

This object can be accessed by:

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

Member Details:

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

A SymbolicConstant specifying the category of the boundary condition. Possible values are MECHANICAL and THERMAL.

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

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

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

None or a DatumCsys object specifying the local coordinate system of the boundary condition’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

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

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

setValues(
component1=None,
component2=UNSET,
component3=UNSET,
amplitude=UNSET,
distributionType=UNIFORM,
localCsys=None,
)[source]

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

Parameters:
component1=None

A Complex, or a SymbolicConstant specifying the magnetic vector potential component in the 1-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET

component2=UNSET

A Complex, or a SymbolicConstant specifying the magnetic vector potential component in the 2-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

component3=UNSET

A Complex, or a SymbolicConstant specifying the magnetic vector potential component in the 3-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

amplitude=UNSET

A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the boundary condition 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 boundary condition is distributed spatially. Possible values are UNIFORM and USER_DEFINED. The default value is UNIFORM.

localCsys=None

None or a DatumCsys object specifying the local coordinate system of the boundary condition’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

setValuesInStep(
stepName,
component1=None,
component2=None,
component3=None,
amplitude='',
)[source]

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

Parameters:
stepName

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

component1=None

A Complex, or a SymbolicConstant specifying the magnetic vector potential component in the 1-direction. Possible values for the SymbolicConstant are SET and UNCHANGED.

component2=None

A Complex, or a SymbolicConstant specifying the magnetic vector potential component in the 2-direction. Possible values for the SymbolicConstant are SET and UNCHANGED.

component3=None

A Complex, or a SymbolicConstant specifying the magnetic vector potential component in the 3-direction. Possible values for the SymbolicConstant areSET and UNCHANGED.

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 boundary condition is changed to have no amplitude reference. You should provide the amplitude argument only if it is valid for the specified step.

class MaterialFlowBC(
name,
createStepName,
region,
fieldName='',
magnitude=0,
distributionType=UNIFORM,
amplitude=UNSET,
fixed=0,
)[source]

Bases: BoundaryCondition

The MaterialFlowBC object stores the data for a connector material flow boundary condition. The MaterialFlowBC object is derived from the BoundaryCondition object.

Note

This object can be accessed by:

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

Member Details:

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

A SymbolicConstant specifying the category of the boundary condition. Possible values are MECHANICAL and THERMAL.

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

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

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

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

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

None or a DatumCsys object specifying the local coordinate system of the boundary condition’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

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

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

setValues(
fieldName='',
magnitude=0,
distributionType=UNIFORM,
amplitude=UNSET,
fixed=0,
)[source]

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

Parameters:
fieldName=''

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

magnitude=0

A Float specifying the material flow magnitude. The default value is 0. The magnitude argument is optional if distributionType = USER_DEFINED.

distributionType=UNIFORM

A SymbolicConstant specifying how the boundary condition 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 boundary condition has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

fixed=0

A Boolean specifying whether the boundary condition should remain fixed at the current values at the start of the step. The default value is OFF.

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

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

Parameters:
stepName

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

magnitude=UNCHANGED

A Float or the SymbolicConstant FREED specifying the material 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 boundary condition is changed to have no amplitude reference. You should provide the amplitude argument only if it is valid for the specified step.

class MaterialFlowBCState[source]

Bases: BoundaryConditionState

The MaterialFlowBCState object stores the propagating data for a connector material flow boundary condition in a step. One instance of this object is created internally by the MaterialFlowBC object for each step. The instance is also deleted internally by the MaterialFlowBC object. The MaterialFlowBCState object has no constructor or methods. The MaterialFlowBCState object is derived from the BoundaryConditionState object.

Note

This object can be accessed by:

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

The corresponding analysis keywords are:

  • 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 boundary condition has no amplitude reference.

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

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

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

A Float specifying the material flow magnitude.

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

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

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

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

  • NOT_YET_ACTIVE

  • CREATED

  • PROPAGATED

  • MODIFIED

  • DEACTIVATED

  • NO_LONGER_ACTIVE

  • TYPE_NOT_APPLICABLE

  • INSTANCE_NOT_APPLICABLE

  • PROPAGATED_FROM_BASE_STATE

  • MODIFIED_FROM_BASE_STATE

  • DEACTIVATED_FROM_BASE_STATE

  • BUILT_INTO_MODES

class PorePressureBC(
name,
createStepName,
region,
fieldName='',
magnitude=0,
distributionType=UNIFORM,
amplitude=UNSET,
fixed=0,
)[source]

Bases: BoundaryCondition

The PorePressureBC object stores the data for a pore pressure boundary condition. The PorePressureBC object is derived from the BoundaryCondition object.

Note

This object can be accessed by:

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

Member Details:

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

A SymbolicConstant specifying the category of the boundary condition. Possible values are MECHANICAL and THERMAL.

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

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

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

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

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

None or a DatumCsys object specifying the local coordinate system of the boundary condition’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

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

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

setValues(
fieldName='',
magnitude=0,
distributionType=UNIFORM,
amplitude=UNSET,
fixed=0,
)[source]

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

Parameters:
fieldName=''

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

magnitude=0

A Float specifying the pore pressure magnitude. The default value is 0. The magnitude argument is optional if distributionType = USER_DEFINED.

distributionType=UNIFORM

A SymbolicConstant specifying how the boundary condition 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 boundary condition has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

fixed=0

A Boolean specifying whether the boundary condition should remain fixed at the current values at the start of the step. The default value is OFF.

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

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

Parameters:
stepName

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

magnitude=UNCHANGED

A Float or the SymbolicConstant FREED specifying the pore pressure 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 boundary condition is changed to have no amplitude reference. You should provide the amplitude argument only if it is valid for the specified step.

class PorePressureBCState[source]

Bases: BoundaryConditionState

The PorePressureBCState object stores the propagating data for a pore pressure boundary condition in a step. One instance of this object is created internally by the PorePressureBC object for each step. The instance is also deleted internally by the PorePressureBC object. The PorePressureBCState object has no constructor or methods. The PorePressureBCState object is derived from the BoundaryConditionState object.

Note

This object can be accessed by:

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

The corresponding analysis keywords are:

  • 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 boundary condition has no amplitude reference.

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

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

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

A Float specifying the pore pressure magnitude.

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

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

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

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

  • NOT_YET_ACTIVE

  • CREATED

  • PROPAGATED

  • MODIFIED

  • DEACTIVATED

  • NO_LONGER_ACTIVE

  • TYPE_NOT_APPLICABLE

  • INSTANCE_NOT_APPLICABLE

  • PROPAGATED_FROM_BASE_STATE

  • MODIFIED_FROM_BASE_STATE

  • DEACTIVATED_FROM_BASE_STATE

  • BUILT_INTO_MODES

class RetainedNodalDofsBC(name, createStepName, region, u1=0, u2=0, u3=0, ur1=0, ur2=0, ur3=0)[source]

Bases: BoundaryCondition

The RetainedNodalDofsBC object stores the data for a retained nodal dofs boundary condition. The RetainedNodalDofsBC object is derived from the BoundaryCondition object.

Note

This object can be accessed by:

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

Member Details:

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

A SymbolicConstant specifying the category of the boundary condition. Possible values are MECHANICAL and THERMAL.

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

None or a DatumCsys object specifying the local coordinate system of the boundary condition’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

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

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

setValues(u1=0, u2=0, u3=0, ur1=0, ur2=0, ur3=0)[source]

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

Parameters:
u1=0

A Boolean specifying whether to retain the degree of freedom in the 1-direction. The default value is OFF indicating that the degree of freedom is not retained.

u2=0

A Boolean specifying whether to retain the degree of freedom in the 2-direction. The default value is OFF indicating that the degree of freedom is not retained.

u3=0

A Boolean specifying whether to retain the degree of freedom in the 3-direction. The default value is OFF indicating that the degree of freedom is not retained.

ur1=0

A Boolean specifying whether to retain the rotational degree of freedom about the 1-direction. The default value is OFF indicating that the degree of freedom is not retained.

ur2=0

A Boolean specifying whether to retain the rotational degree of freedom about the 2-direction. The default value is OFF indicating that the degree of freedom is not retained.

ur3=0

A Boolean specifying whether to retain the rotational degree of freedom about the 3-direction. The default value is OFF indicating that the degree of freedom is not retained.

setValuesInStep(stepName, u1=0, u2=0, u3=0, ur1=0, ur2=0, ur3=0)[source]

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

Parameters:
stepName

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

u1=0

A Boolean specifying whether to retain the degree of freedom in the 1-direction.

u2=0

A Boolean specifying whether to retain the degree of freedom in the 2-direction.

u3=0

A Boolean specifying whether to retain the degree of freedom in the 3-direction.

ur1=0

A Boolean specifying whether to retain the rotational degree of freedom about the 1-direction.

ur2=0

A Boolean specifying whether to retain the rotational degree of freedom about the 2-direction.

ur3=0

A Boolean specifying whether to retain the rotational degree of freedom about the 3-direction.

class SecondaryBaseBC(name, createStepName, regions, dofs)[source]

Bases: BoundaryCondition

The SecondaryBaseBC object stores the data for a secondary base boundary condition. The SecondaryBaseBC object is derived from the BoundaryCondition object.

Note

This object can be accessed by:

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

Member Details:

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

A SymbolicConstant specifying the category of the boundary condition. Possible values are MECHANICAL and THERMAL.

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

A tuple of tuples of Ints specifying the constrained degrees-of-freedom.

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

None or a DatumCsys object specifying the local coordinate system of the boundary condition’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

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

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

regions : --is-rst--:py:class:`~typing.List`\ \[:py:class:`~abaqus.Region.Region.Region`] = 'MODEL'[source]

A RegionArray object specifying the region to which the boundary condition is applied. Note that the usual region is ignored. The default value is MODEL.

setValues(*args, **kwargs)[source]

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

setValuesInStep(stepName)[source]

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

Parameters:
stepName

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

class SecondaryBaseBCState[source]

Bases: BoundaryConditionState

The SecondaryBaseBCState object stores the propagating data for a secondary base boundary condition in a step. One instance of this object is created internally by the SecondaryBaseBC object for each step. The instance is also deleted internally by the SecondaryBaseBC object. The SecondaryBaseBCState object has no constructor or methods. The SecondaryBaseBCState object is derived from the BoundaryConditionState object.

Note

This object can be accessed by:

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

The corresponding analysis keywords are:

  • 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 boundary condition has no amplitude reference.

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

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

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

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

  • NOT_YET_ACTIVE

  • CREATED

  • PROPAGATED

  • MODIFIED

  • DEACTIVATED

  • NO_LONGER_ACTIVE

  • TYPE_NOT_APPLICABLE

  • INSTANCE_NOT_APPLICABLE

  • PROPAGATED_FROM_BASE_STATE

  • MODIFIED_FROM_BASE_STATE

  • DEACTIVATED_FROM_BASE_STATE

  • BUILT_INTO_MODES

class SubmodelBC(
name,
createStepName,
region,
dof,
globalStep,
timeScale,
shellThickness,
globalDrivingRegion='',
absoluteExteriorTolerance=None,
exteriorTolerance=0,
localCsys=None,
globalIncrement=0,
centerZoneSize=None,
intersectionOnly=0,
)[source]

Bases: BoundaryCondition

The SubmodelBC object stores the data for a submodel boundary condition. The SubmodelBC object is derived from the BoundaryCondition object.

Note

This object can be accessed by:

import load
mdb.models[name].boundaryConditions[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.

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

A SymbolicConstant specifying the category of the boundary condition. Possible values are MECHANICAL and THERMAL.

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.

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

None or a DatumCsys object specifying the local coordinate system of the boundary condition’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

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

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

setValues(
globalDrivingRegion='',
absoluteExteriorTolerance=None,
exteriorTolerance=0,
localCsys=None,
globalIncrement=0,
centerZoneSize=None,
)[source]

This method modifies the data for an existing SubmodelBC 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.

localCsys=None

None or a DatumCsys object specifying the local coordinate system of the boundary condition’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

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.

centerZoneSize=None

A Float specifying the thickness of the center zone size around the shell midsurface. The default value is None.

setValuesInStep(
stepName,
fixed=1,
dof=(),
globalStep='',
globalIncrement=0,
centerZoneSize=None,
)[source]

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

Parameters:
stepName

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

fixed=1

A Boolean specifying whether the boundary condition should remain fixed at the current values at the start of the step. The default value is ON.

dof=()

A sequence of Ints specifying the degrees of freedom to which the boundary condition is applied. The dof argument is applicable only if fixed = OFF.

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.

centerZoneSize=None

A Float specifying the thickness of the center zone size around the shell midsurface. The default value is None.The centerZoneSize argument is applicable only if fixed = OFF.

shellThickness : --is-rst--:py:class:`float` = 0[source]

A Float specifying the thickness of the shell in the global model. This argument is required for shell-to-solid submodeling and is not applicable to other submodels. The default value is 0.0.

class SubmodelBCState[source]

Bases: BoundaryConditionState

The SubmodelBCState object stores the propagating data for a Submodel boundary condition in a step. One instance of this object is created internally by the SubmodelBC object for each step. The instance is also deleted internally by the SubmodelBC object. The SubmodelBCState object has no constructor or methods. The SubmodelBCState object is derived from the BoundaryConditionState object.

Note

This object can be accessed by:

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

The corresponding analysis keywords are:

  • SUBMODEL

  • 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 boundary condition has no amplitude reference.

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

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

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

None or a Float specifying the thickness of the center zone size around the shell midsurface. The default value is None.

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

A SymbolicConstant specifying the propagation state of the centerZoneSize member. Possible values are SET and UNCHANGED.

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

A tuple of Ints specifying the degrees of freedom to which the boundary condition is applied.

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

A SymbolicConstant specifying the propagation state of the dof member. Possible values are SET and UNCHANGED.

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.

scale : --is-rst--:py:class:`float` = 1[source]

None or a Float specifying a scaling value applied to the applied displacements at the interface. The default value is 1.0.

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

A SymbolicConstant specifying the propagation state of the scale 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 BoundaryConditionState object. Possible values are:

  • NOT_YET_ACTIVE

  • CREATED

  • PROPAGATED

  • MODIFIED

  • DEACTIVATED

  • NO_LONGER_ACTIVE

  • TYPE_NOT_APPLICABLE

  • INSTANCE_NOT_APPLICABLE

  • PROPAGATED_FROM_BASE_STATE

  • MODIFIED_FROM_BASE_STATE

  • DEACTIVATED_FROM_BASE_STATE

  • BUILT_INTO_MODES

class TemperatureBC(
name,
createStepName,
region,
fieldName='',
magnitude=0,
dof=(),
amplitude=UNSET,
distributionType=UNIFORM,
fixed=0,
)[source]

Bases: BoundaryCondition

The TemperatureBC object stores the data for a temperature boundary condition. The TemperatureBC object is derived from the BoundaryCondition object.

Note

This object can be accessed by:

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

Member Details:

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

A SymbolicConstant specifying the category of the boundary condition. Possible values are MECHANICAL and THERMAL.

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

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

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

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

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

None or a DatumCsys object specifying the local coordinate system of the boundary condition’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

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

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

setValues(
fieldName='',
magnitude=0,
dof=(),
amplitude=UNSET,
distributionType=UNIFORM,
fixed=0,
)[source]

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

Parameters:
fieldName=''

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

magnitude=0

A Float specifying the temperature magnitude. The default value is 0.

dof=()

A sequence of Ints specifying the degrees of freedom to which the boundary condition is applied. The default value is (11,).

amplitude=UNSET

A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the boundary condition 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 boundary condition is distributed spatially. Possible values are UNIFORM, USER_DEFINED, and FIELD. The default value is UNIFORM.

fixed=0

A Boolean specifying whether the boundary condition should remain fixed at the current values at the start of the step. The default value is OFF.

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

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

Parameters:
stepName

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

magnitude=UNCHANGED

A Float or the SymbolicConstant FREED specifying the temperature magnitude.

dof=()

A sequence of Ints specifying the degrees of freedom to which the boundary condition is applied.

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 boundary condition is changed to have no amplitude reference. You should provide the amplitude argument only if it is valid for the specified step.

class TemperatureBCState[source]

Bases: BoundaryConditionState

The TemperatureBCState object stores the propagating data for a temperature boundary condition in a step. One instance of this object is created internally by the TemperatureBC object for each step. The instance is also deleted internally by the TemperatureBC object. The TemperatureBCState object has no constructor or methods. The TemperatureBCState object is derived from the BoundaryConditionState object.

Note

This object can be accessed by:

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

The corresponding analysis keywords are:

  • 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 boundary condition has no amplitude reference.

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

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

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

A tuple of Ints specifying the degrees of freedom to which the boundary condition is applied.

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

A SymbolicConstant specifying the propagation state of the dof member. Possible values are SET and UNCHANGED.

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

A Float specifying the temperature magnitude.

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

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

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

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

  • NOT_YET_ACTIVE

  • CREATED

  • PROPAGATED

  • MODIFIED

  • DEACTIVATED

  • NO_LONGER_ACTIVE

  • TYPE_NOT_APPLICABLE

  • INSTANCE_NOT_APPLICABLE

  • PROPAGATED_FROM_BASE_STATE

  • MODIFIED_FROM_BASE_STATE

  • DEACTIVATED_FROM_BASE_STATE

  • BUILT_INTO_MODES

class TypeBC(name, createStepName, region, buckleCase=NOT_APPLICABLE, localCsys=None)[source]

Bases: BoundaryCondition

The TypeBC object stores the data for several types of predefined boundary conditions that are commonly used in stress/displacement analyses. The TypeBC object is derived from the BoundaryCondition object.

Note

This object can be accessed by:

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

Member Details:

static EncastreBC(name, createStepName, region, buckleCase=NOT_APPLICABLE, localCsys=None)[source]

This method creates an encastre TypeBC object.

Note

This function can be accessed by:

mdb.models[name].EncastreBC
Parameters:
name

A String specifying the boundary condition repository key.

createStepName

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

region

A Region object specifying the region to which the boundary condition is applied.

buckleCase=NOT_APPLICABLE

A SymbolicConstant specifying how the boundary condition is defined in a BUCKLE analysis. Possible values are NOT_APPLICABLE, STRESS_PERTURBATION, BUCKLING_MODES, and PERTURBATION_AND_BUCKLING. The default value is NOT_APPLICABLE.

localCsys=None

None or a DatumCsys object specifying the local coordinate system of the boundary condition’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

Returns:

A TypeBC object.

Return type:

TypeBC

static PinnedBC(name, createStepName, region, buckleCase=NOT_APPLICABLE, localCsys=None)[source]

This method creates a pinned TypeBC object.

Note

This function can be accessed by:

mdb.models[name].PinnedBC
Parameters:
name

A String specifying the boundary condition repository key.

createStepName

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

region

A Region object specifying the region to which the boundary condition is applied.

buckleCase=NOT_APPLICABLE

A SymbolicConstant specifying how the boundary condition is defined in a BUCKLE analysis. Possible values are NOT_APPLICABLE, STRESS_PERTURBATION, BUCKLING_MODES, and PERTURBATION_AND_BUCKLING. The default value is NOT_APPLICABLE.

localCsys=None

None or a DatumCsys object specifying the local coordinate system of the boundary condition’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

Returns:

A TypeBC object.

Return type:

TypeBC

static XasymmBC(name, createStepName, region, buckleCase=NOT_APPLICABLE, localCsys=None)[source]

This method creates a TypeBC object that specifies antisymmetry about the X axis.

Note

This function can be accessed by:

mdb.models[name].XasymmBC
Parameters:
name

A String specifying the boundary condition repository key.

createStepName

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

region

A Region object specifying the region to which the boundary condition is applied.

buckleCase=NOT_APPLICABLE

A SymbolicConstant specifying how the boundary condition is defined in a BUCKLE analysis. Possible values are NOT_APPLICABLE, STRESS_PERTURBATION, BUCKLING_MODES, and PERTURBATION_AND_BUCKLING. The default value is NOT_APPLICABLE.

localCsys=None

None or a DatumCsys object specifying the local coordinate system of the boundary condition’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

Returns:

A TypeBC object.

Return type:

TypeBC

static XsymmBC(name, createStepName, region, buckleCase=NOT_APPLICABLE, localCsys=None)[source]

This method creates a TypeBC object that specifies symmetry about the X axis.

Note

This function can be accessed by:

mdb.models[name].XsymmBC
Parameters:
name

A String specifying the boundary condition repository key.

createStepName

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

region

A Region object specifying the region to which the boundary condition is applied.

buckleCase=NOT_APPLICABLE

A SymbolicConstant specifying how the boundary condition is defined in a BUCKLE analysis. Possible values are NOT_APPLICABLE, STRESS_PERTURBATION, BUCKLING_MODES, and PERTURBATION_AND_BUCKLING. The default value is NOT_APPLICABLE.

localCsys=None

None or a DatumCsys object specifying the local coordinate system of the boundary condition’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

Returns:

A TypeBC object.

Return type:

TypeBC

static YasymmBC(name, createStepName, region, buckleCase=NOT_APPLICABLE, localCsys=None)[source]

This method creates a TypeBC object that specifies antisymmetry about the Y axis.

Note

This function can be accessed by:

mdb.models[name].YasymmBC
Parameters:
name

A String specifying the boundary condition repository key.

createStepName

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

region

A Region object specifying the region to which the boundary condition is applied.

buckleCase=NOT_APPLICABLE

A SymbolicConstant specifying how the boundary condition is defined in a BUCKLE analysis. Possible values are NOT_APPLICABLE, STRESS_PERTURBATION, BUCKLING_MODES, and PERTURBATION_AND_BUCKLING. The default value is NOT_APPLICABLE.

localCsys=None

None or a DatumCsys object specifying the local coordinate system of the boundary condition’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

Returns:

A TypeBC object.

Return type:

TypeBC

static YsymmBC(name, createStepName, region, buckleCase=NOT_APPLICABLE, localCsys=None)[source]

This method creates a TypeBC object that specifies symmetry about the Y axis.

Note

This function can be accessed by:

mdb.models[name].YsymmBC
Parameters:
name

A String specifying the boundary condition repository key.

createStepName

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

region

A Region object specifying the region to which the boundary condition is applied.

buckleCase=NOT_APPLICABLE

A SymbolicConstant specifying how the boundary condition is defined in a BUCKLE analysis. Possible values are NOT_APPLICABLE, STRESS_PERTURBATION, BUCKLING_MODES, and PERTURBATION_AND_BUCKLING. The default value is NOT_APPLICABLE.

localCsys=None

None or a DatumCsys object specifying the local coordinate system of the boundary condition’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

Returns:

A TypeBC object.

Return type:

TypeBC

static ZasymmBC(name, createStepName, region, buckleCase=NOT_APPLICABLE, localCsys=None)[source]

This method creates a TypeBC object that specifies antisymmetry about the Z axis.

Note

This function can be accessed by:

mdb.models[name].ZasymmBC
Parameters:
name

A String specifying the boundary condition repository key.

createStepName

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

region

A Region object specifying the region to which the boundary condition is applied.

buckleCase=NOT_APPLICABLE

A SymbolicConstant specifying how the boundary condition is defined in a BUCKLE analysis. Possible values are NOT_APPLICABLE, STRESS_PERTURBATION, BUCKLING_MODES, and PERTURBATION_AND_BUCKLING. The default value is NOT_APPLICABLE.

localCsys=None

None or a DatumCsys object specifying the local coordinate system of the boundary condition’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

Returns:

A TypeBC object.

Return type:

TypeBC

static ZsymmBC(name, createStepName, region, buckleCase=NOT_APPLICABLE, localCsys=None)[source]

This method creates a TypeBC object that specifies symmetry about the Z axis.

Note

This function can be accessed by:

mdb.models[name].ZsymmBC
Parameters:
name

A String specifying the boundary condition repository key.

createStepName

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

region

A Region object specifying the region to which the boundary condition is applied.

buckleCase=NOT_APPLICABLE

A SymbolicConstant specifying how the boundary condition is defined in a BUCKLE analysis. Possible values are NOT_APPLICABLE, STRESS_PERTURBATION, BUCKLING_MODES, and PERTURBATION_AND_BUCKLING. The default value is NOT_APPLICABLE.

localCsys=None

None or a DatumCsys object specifying the local coordinate system of the boundary condition’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

Returns:

A TypeBC object.

Return type:

TypeBC

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

A SymbolicConstant specifying how the boundary condition is defined in a BUCKLE analysis. Possible values are NOT_APPLICABLE, STRESS_PERTURBATION, BUCKLING_MODES, and PERTURBATION_AND_BUCKLING. The default value is NOT_APPLICABLE.

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

A SymbolicConstant specifying the category of the boundary condition. Possible values are MECHANICAL and THERMAL.

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

None or a DatumCsys object specifying the local coordinate system of the boundary condition’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

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

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

setValues(region, typeName=None, buckleCase=NOT_APPLICABLE, localCsys=None)[source]

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

Parameters:
region

A Region object specifying the region to which the boundary condition is applied.

typeName=None

A SymbolicConstant specifying the predefined boundary condition type. Possible values are XSYMM, YSYMM, ZSYMM, XASYMM, YASYMM, ZASYMM, PINNED, and ENCASTRE.

buckleCase=NOT_APPLICABLE

A SymbolicConstant specifying how the boundary condition is defined in a BUCKLE analysis. Possible values are NOT_APPLICABLE, STRESS_PERTURBATION, BUCKLING_MODES, and PERTURBATION_AND_BUCKLING. The default value is NOT_APPLICABLE.

localCsys=None

None or a DatumCsys object specifying the local coordinate system of the boundary condition’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

setValuesInStep(stepName, typeName=None)[source]

This method always returns a value error for a TypeBC; it is inherited from the BoundaryCondition object.

Parameters:
stepName

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

typeName=None

A SymbolicConstant specifying the predefined boundary condition type. Possible values are XSYMM, YSYMM, ZSYMM, XASYMM, YASYMM, ZASYMM, PINNED, and ENCASTRE.

Raises:

Value Error – A Symmetry/Antisymmetry/Encastre BC cannot be edited in a propagated step.

class VelocityBC(
name,
createStepName,
region,
fieldName='',
v1=UNSET,
v2=UNSET,
v3=UNSET,
vr1=UNSET,
vr2=UNSET,
vr3=UNSET,
amplitude=UNSET,
localCsys=None,
distributionType=UNIFORM,
)[source]

Bases: BoundaryCondition

The VelocityBC object stores the data for a velocity boundary condition. The VelocityBC object is derived from the BoundaryCondition object.

Note

This object can be accessed by:

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

Member Details:

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

A SymbolicConstant specifying the category of the boundary condition. Possible values are MECHANICAL and THERMAL.

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

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

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

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

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

None or a DatumCsys object specifying the local coordinate system of the boundary condition’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

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

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

setValues(
fieldName='',
v1=UNSET,
v2=UNSET,
v3=UNSET,
vr1=UNSET,
vr2=UNSET,
vr3=UNSET,
amplitude=UNSET,
localCsys=None,
distributionType=UNIFORM,
)[source]

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

Parameters:
fieldName=''

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

v1=UNSET

A Float or a SymbolicConstant specifying the velocity component in the 1-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET. Note: Although v1, v2, v3, vr1, vr2, and vr3 are optional arguments, at least one of them must be specified.

v2=UNSET

A Float or a SymbolicConstant specifying the velocity component in the 2-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

v3=UNSET

A Float or a SymbolicConstant specifying the velocity component in the 3-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

vr1=UNSET

A Float or a SymbolicConstant specifying the rotational velocity component about the 1-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

vr2=UNSET

A Float or a SymbolicConstant specifying the rotational velocity component about the 2-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

vr3=UNSET

A Float or a SymbolicConstant specifying the rotational velocity component about the 3-direction. Possible values for the SymbolicConstant are UNSET and SET. The default value is UNSET.

amplitude=UNSET

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

localCsys=None

None or a DatumCsys object specifying the local coordinate system of the boundary condition’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

distributionType=UNIFORM

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

setValuesInStep(
stepName,
v1=SET,
v2=SET,
v3=SET,
vr1=SET,
vr2=SET,
vr3=SET,
amplitude='',
)[source]

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

Parameters:
stepName

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

v1=SET

A Float or a SymbolicConstant specifying the velocity component in the 1-direction. Possible values for the SymbolicConstant are SET and FREED.

v2=SET

A Float or a SymbolicConstant specifying the velocity component in the 2-direction. Possible values for the SymbolicConstant are SET and FREED.

v3=SET

A Float or a SymbolicConstant specifying the velocity component in the 3-direction. Possible values for the SymbolicConstant are SET and FREED.

vr1=SET

A Float or a SymbolicConstant specifying the rotational velocity component about the 1-direction. Possible values for the SymbolicConstant are SET and FREED.

vr2=SET

A Float or a SymbolicConstant specifying the rotational velocity component about the 2-direction. Possible values for the SymbolicConstant are SET and FREED.

vr3=SET

A Float or a SymbolicConstant specifying the rotational velocity component about the 3-direction. Possible values for the SymbolicConstant are SET and FREED.

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 boundary condition is changed to have no amplitude reference. You should provide the amplitude argument only if it is valid for the specified step.

class VelocityBCState[source]

Bases: BoundaryConditionState

The VelocityBCState object stores the propagating data for a velocity boundary condition in a step. One instance of this object is created internally by the VelocityBC object for each step. The instance is also deleted internally by the VelocityBC object. The VelocityBCState object has no constructor or methods. The VelocityBCState object is derived from the BoundaryConditionState object.

Note

This object can be accessed by:

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

The corresponding analysis keywords are:

  • 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 boundary condition has no amplitude reference.

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

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

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

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

  • NOT_YET_ACTIVE

  • CREATED

  • PROPAGATED

  • MODIFIED

  • DEACTIVATED

  • NO_LONGER_ACTIVE

  • TYPE_NOT_APPLICABLE

  • INSTANCE_NOT_APPLICABLE

  • PROPAGATED_FROM_BASE_STATE

  • MODIFIED_FROM_BASE_STATE

  • DEACTIVATED_FROM_BASE_STATE

  • BUILT_INTO_MODES

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

A Float specifying the velocity component in the 1-direction.

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

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

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

A Float specifying the velocity component in the 2-direction.

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

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

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

A Float specifying the velocity component in the 3-direction.

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

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

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

A Float specifying the rotational velocity component about the 1-direction.

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

A SymbolicConstant specifying the propagation state of the rotational velocity component about the 1-direction. Possible values are UNSET, SET, UNCHANGED, FREED, and MODIFIED.

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

A Float specifying the rotational velocity component about the 2-direction.

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

A SymbolicConstant specifying the propagation state of the rotational velocity component about the 2-direction. Possible values are UNSET, SET, UNCHANGED, FREED, and MODIFIED.

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

A Float specifying the rotational velocity component about the 3-direction.

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

A SymbolicConstant specifying the propagation state of the rotational velocity component about the 3-direction. Possible values are UNSET, SET, UNCHANGED, FREED, and MODIFIED.

class VelocityBaseMotionBC(
name,
createStepName,
dof,
amplitudeScaleFactor=1,
centerOfRotation=(),
correlation=None,
secondaryBase='',
useComplex=0,
amplitude=UNSET,
)[source]

Bases: BoundaryCondition

The VelocityBaseMotionBC object stores the data for a velocity base motion boundary condition. The VelocityBaseMotionBC object is derived from the BoundaryCondition object.

Note

This object can be accessed by:

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

Member Details:

amplitudeScaleFactor : --is-rst--:py:class:`float` = 1[source]

A Float specifying the scale factor for the amplitude curve. The default value is 1.0.

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

A SymbolicConstant specifying the category of the boundary condition. Possible values are MECHANICAL and THERMAL.

centerOfRotation : --is-rst--:py:class:`tuple` = ()[source]

A ModelDot object specifying a tuple containing one center of rotation. The default value is the global origin. This argument applies only when dof = UR1, UR2, or UR3.

correlation : --is-rst--:py:class:`~abaqus.Amplitude.Correlation.Correlation` = <abaqus.Amplitude.Correlation.Correlation object>[source]

A Correlation object.

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

None or a DatumCsys object specifying the local coordinate system of the boundary condition’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

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

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

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

A String specifying the name of the SecondaryBaseBC object associated with this boundary condition. The default value is an empty string.

setValues(
amplitudeScaleFactor=1,
centerOfRotation=(),
correlation=None,
secondaryBase='',
useComplex=0,
amplitude=UNSET,
)[source]

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

Parameters:
amplitudeScaleFactor=1

A Float specifying the scale factor for the amplitude curve. The default value is 1.0.

centerOfRotation=()

A ModelDot object specifying a tuple containing one center of rotation. The default value is the global origin. This argument applies only when dof = UR1, UR2, or UR3.

correlation=None

A Correlation object.

secondaryBase=''

A String specifying the name of the SecondaryBaseBC object associated with this boundary condition. The default value is an empty string.

useComplex=0

A Boolean specifying whether to define the imaginary (out-of-plane) portion of the base motion record given by amplitude definition. The default value is OFF.

amplitude=UNSET

A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the boundary condition 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, amplitude='')[source]

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

Parameters:
stepName

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

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 boundary condition is changed to have no amplitude reference. You should provide the amplitude argument only if it is valid for the specified step.

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

A Boolean specifying whether to define the imaginary (out-of-plane) portion of the base motion record given by amplitude definition. The default value is OFF.

class VelocityBaseMotionBCState[source]

Bases: BoundaryConditionState

The VelocityBaseMotionBCState object stores the propagating data for a velocity base motion boundary condition in a step. One instance of this object is created internally by the VelocityBaseMotionBC object for each step. The instance is also deleted internally by the VelocityBaseMotionBC object. The VelocityBaseMotionBCState object has no constructor or methods. The VelocityBaseMotionBCState object is derived from the BoundaryConditionState object.

Note

This object can be accessed by:

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

The corresponding analysis keywords are:

  • BASE MOTION

Member Details:

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

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

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

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

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

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

  • NOT_YET_ACTIVE

  • CREATED

  • PROPAGATED

  • MODIFIED

  • DEACTIVATED

  • NO_LONGER_ACTIVE

  • TYPE_NOT_APPLICABLE

  • INSTANCE_NOT_APPLICABLE

  • PROPAGATED_FROM_BASE_STATE

  • MODIFIED_FROM_BASE_STATE

  • DEACTIVATED_FROM_BASE_STATE

  • BUILT_INTO_MODES

class TypeBCState[source]

Bases: BoundaryConditionState

The TypeBCState object stores the propagating data for a predefined boundary condition in a step. One instance of this object is created internally by the TypeBC object for each step. The instance is also deleted internally by the TypeBC object. The TypeBCState object has no constructor or methods. The TypeBCState object is derived from the BoundaryConditionState object.

Note

This object can be accessed by:

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

The corresponding analysis keywords are:

  • 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 boundary condition has no amplitude reference.

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

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

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

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

  • NOT_YET_ACTIVE

  • CREATED

  • PROPAGATED

  • MODIFIED

  • DEACTIVATED

  • NO_LONGER_ACTIVE

  • TYPE_NOT_APPLICABLE

  • INSTANCE_NOT_APPLICABLE

  • PROPAGATED_FROM_BASE_STATE

  • MODIFIED_FROM_BASE_STATE

  • DEACTIVATED_FROM_BASE_STATE

  • BUILT_INTO_MODES

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

A SymbolicConstant specifying the predefined boundary condition type. Possible values are XSYMM, YSYMM, ZSYMM, XASYMM, YASYMM, ZASYMM, PINNED, and ENCASTRE.

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

A SymbolicConstant specifying the propagation state of the predefined boundary condition type. The only possible value is UNCHANGED.