Adaptivity

The Adaptivity commands are used to define objects, perform analyses, and calculate new meshes for Arbitrary Lagrangian Eularian (ALE) adaptive smoothing (adaptive meshing) and varying topology adaptivity (adaptive remeshing).

Create adaptivity mesh control features

class AdaptivityModel(name, description='', stefanBoltzmann=None, absoluteZero=None, waveFormulation=abaqusConstants.NOT_SET, modelType=abaqusConstants.STANDARD_EXPLICIT, universalGas=None, copyConstraints=ON, copyConnectors=ON, copyInteractions=ON)

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

Note

This object can be accessed by:

mdb.models[name]

Note

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

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.
restartIncrement	An Int specifying the increment, interval, iteration or cycle where the restart analysis will start.
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.
rootAssembly	An Assembly 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.

Public Methods:

adaptiveRemesh(odb)	This method remeshes the model using the active remesh rules in the model and the error indicator results from a previous analysis.
AdaptiveMeshConstraint(name, category, region)	The AdaptiveMeshConstraint object is the abstract base type for other Arbitrary Lagrangian Eularian (ALE) style AdaptiveMeshConstraint objects.
AdaptiveMeshControl(name[, remapping, ...])	This method creates an AdaptiveMeshControl object.
DisplacementAdaptiveMeshConstraint(name, ...)	This method creates a DisplacementAdaptiveMeshConstraint object.
RemeshingRule(name, stepName, variables[, ...])	This method creates a RemeshingRule object.
VelocityAdaptiveMeshConstraint(name, ...[, ...])	This method creates a VelocityAdaptiveMeshConstraint object.

Inherited from ModelBase

__init__(name[, description, ...])	This method creates a Model object.
ModelFromInputFile(name, inputFileName)	This method creates a Model object by reading the keywords in an input file and creating the corresponding Abaqus/CAE objects.
ModelFromOdbFile(name, odbFileName)	This method creates a Model object by reading an output database and creating any corresponding Abaqus/CAE objects.
ModelFromNastranFile(modelName, inputFileName)	This method creates a Model object by reading the keywords in a Nastran bulk data file or Nastran input file and creating any corresponding Abaqus/CAE objects.
setValues([description, noPartsInputFile, ...])	This method modifies the Model object.

---

AdaptiveMeshConstraint(name, category, region, localCsys=None)

The AdaptiveMeshConstraint object is the abstract base type for other Arbitrary Lagrangian Eularian (ALE) style AdaptiveMeshConstraint objects. The AdaptiveMeshConstraint object has no explicit constructor. The methods and members of the AdaptiveMeshConstraint object are common to all objects derived from the AdaptiveMeshConstraint object.

Note

This function can be accessed by:

mdb.models[name].AdaptiveMeshConstraint

Note

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

Parameters:

• name (str) – A String specifying the adaptive mesh constraint repository key.

• category (SymbolicConstant) – A SymbolicConstant specifying the category of the adaptive mesh constraint. Possible values are MECHANICAL and THERMAL.

• region (Region) – A Region object specifying the region to which the adaptive mesh constraint is applied.

• localCsys (Optional[DatumCsys], default: None) – None or a DatumCsys object specifying the local coordinate system of the adaptive mesh constraint’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

Returns:

An AdaptiveMeshConstraint object

Return type:

AdaptiveMeshConstraint

AdaptiveMeshControl(name, remapping=abaqusConstants.SECOND_ORDER_ADVECTION, smoothingAlgorithm=abaqusConstants.GEOMETRY_ENHANCED, smoothingPriority=abaqusConstants.UNIFORM, initialFeatureAngle=30, transitionFeatureAngle=30, momentumAdvection=abaqusConstants.ELEMENT_CENTER_PROJECTION, meshingPredictor=abaqusConstants.CURRENT, curvatureRefinement=1, volumetricSmoothingWeight=1, laplacianSmoothingWeight=0, equipotentialSmoothingWeight=0, meshConstraintAngle=60, originalConfigurationProjectionWeight=1, standardVolumetricSmoothingWeight=0)

This method creates an AdaptiveMeshControl object.

Note

This function can be accessed by:

mdb.models[name].AdaptiveMeshConstraint

Note

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

Parameters:

• name (str) – A String specifying the name of the object.

• remapping (SymbolicConstant, default: SECOND_ORDER_ADVECTION) – A SymbolicConstant specifying the remapping algorithm. Possible values are FIRST_ORDER_ADVECTION and SECOND_ORDER_ADVECTION. The default value is SECOND_ORDER_ADVECTION.

• smoothingAlgorithm (SymbolicConstant, default: GEOMETRY_ENHANCED) – A SymbolicConstant specifying the type of smoothing algorithm to use. Possible values are STANDARD and GEOMETRY_ENHANCED. The default value is GEOMETRY_ENHANCED.

• smoothingPriority (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying the type of smoothing to perform. Possible values are UNIFORM and GRADED. The default value is UNIFORM.

• initialFeatureAngle (float, default: 30) – A Float specifying the initial geometric feature angle, θI, in degrees. Possible values are 0° ≤θI≤ 180°. The default value is 30.0.

• transitionFeatureAngle (float, default: 30) – A Float specifying the transitional feature angle, θT, in degrees. Possible values are 0° ≤θT≤ 180°. The default value is 30.0.

• momentumAdvection (SymbolicConstant, default: ELEMENT_CENTER_PROJECTION) – A SymbolicConstant specifying the type of momentum advection algorithm. Possible values are ELEMENT_CENTER_PROJECTION and HALF_INDEX_SHIFT. The default value is ELEMENT_CENTER_PROJECTION.

• meshingPredictor (SymbolicConstant, default: CURRENT) – A SymbolicConstant specifying the nodal starting location to use for remeshing. Possible values are CURRENT and PREVIOUS. The default value is CURRENT.

• curvatureRefinement (float, default: 1) – A Float specifying the solution dependence weight, αC. Possible values are 0.0 ≤αC≤ 1.0. The default value is 1.0.

• volumetricSmoothingWeight (float, default: 1) – A Float specifying the weight used by Abaqus/Explicit for the volumetric smoothing method. The default value is 1.0.

• laplacianSmoothingWeight (float, default: 0) – A Float specifying the weight for the Laplacian smoothing method. The default value is 0.0.

• equipotentialSmoothingWeight (float, default: 0) – A Float specifying the weight for the equipotential smoothing method. The default value is 0.0.

• meshConstraintAngle (float, default: 60) – A Float specifying the initial geometric feature angle, θC. Possible values are 0° ≤θC≤ 180°. The default value is 60.0.

• originalConfigurationProjectionWeight (float, default: 1) – A Float specifying the weight for the original configuration projection method. The default value is 1.0.

• standardVolumetricSmoothingWeight (float, default: 0) – A Float specifying the weight used by Abaqus/Standard for the volumetric smoothing method. The default value is 0.0.

Returns:

An AdaptiveMeshControl object

Return type:

AdaptiveMeshControl

DisplacementAdaptiveMeshConstraint(name, createStepName, region, u1=abaqusConstants.UNSET, u2=abaqusConstants.UNSET, u3=abaqusConstants.UNSET, ur1=abaqusConstants.UNSET, ur2=abaqusConstants.UNSET, ur3=abaqusConstants.UNSET, amplitude=abaqusConstants.UNSET, motionType=abaqusConstants.INDEPENDENT, localCsys=None)

This method creates a DisplacementAdaptiveMeshConstraint object.

Note

This function can be accessed by:

mdb.models[name].AdaptiveMeshConstraint

Note

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

Parameters:

• name (str) – A String specifying the adaptive mesh constraint repository key.

• createStepName (str) – A String specifying the name of the step in which the adaptive mesh constraint is created.

• region (Region) – A Region object specifying the region to which the adaptive mesh constraint is applied.

• u1 (Union[SymbolicConstant, float], default: UNSET) – A Float 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 (Union[SymbolicConstant, float], default: UNSET) – A Float 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 (Union[SymbolicConstant, float], default: UNSET) – A Float 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 (Union[SymbolicConstant, float], default: UNSET) – A Float 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 (Union[SymbolicConstant, float], default: UNSET) – A Float 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 (Union[SymbolicConstant, float], default: UNSET) – A Float 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.

• amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the adaptive mesh constraint has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

• motionType (SymbolicConstant, default: INDEPENDENT) – A SymbolicConstant specifying the mesh motion in relation to the underlying material. Possible values are INDEPENDENT, FOLLOW and USER_DEFINED. The default value is INDEPENDENT.

• localCsys (Optional[str], default: None) – None or a DatumCsys object specifying the local coordinate system of the adaptive mesh constraint’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 DisplacementAdaptiveMeshConstraint object

Return type:

DisplacementAdaptiveMeshConstraint

RemeshingRule(name, stepName, variables, description='', region=abaqusConstants.MODEL, sizingMethod=abaqusConstants.DEFAULT, errorTarget=0, maxSolutionErrorTarget=0, minSolutionErrorTarget=0, meshBias=0, minElementSize=0, maxElementSize=0, outputFrequency=abaqusConstants.LAST_INCREMENT, specifyMinSize=OFF, specifyMaxSize=ON, coarseningFactor=abaqusConstants.DEFAULT_LIMIT, refinementFactor=abaqusConstants.DEFAULT_LIMIT, elementCountLimit=None)

This method creates a RemeshingRule object.

Note

This function can be accessed by:

mdb.models[name].AdaptiveMeshConstraint

Note

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

Parameters:

• name (str) – A String specifying the name of the object.

• stepName (str) – A String specifying the name of the step in which resizing should occur for this rule.

• variables (tuple) – A sequence of Strings specifying the output request variables that Abaqus will use as error indicators.

• description (str, default: '') – A String specifying a descriptive string for this rule. The default value is an empty string.

• region (SymbolicConstant, default: MODEL) – The SymbolicConstant MODEL or a Region object specifying the region in which Abaqus will remesh and generate output. The SymbolicConstant MODEL represents the entire applicable model. The default value is MODEL.

• sizingMethod (SymbolicConstant, default: DEFAULT) – A SymbolicConstant specifying the method for calculating the new mesh sizes. The SymbolicConstant DEFAULT indicates that Abaqus will use the default calculation method for each individual variable. Possible values are DEFAULT, UNIFORM_ERROR, and MINIMUM_MAXIMUM. The default value is DEFAULT.

• errorTarget (float, default: 0) – A Float specifying the target error percentage for each variable in the region. A value of 0.0 indicates that Abaqus will use automated error target reduction for the region. You use the errorTarget argument when sizingMethod = UNIFORM_ERROR. The default value is 0.0.

• maxSolutionErrorTarget (float, default: 0) – A Float specifying the target error percentage at the location of the maximum solution value in the region. A value of 0.0 indicates that Abaqus will use automated error target reduction for the region. You use the maxSolutionErrorTarget argument when sizingMethod = MINIMUM_MAXIMUM. The default value is 0.0.

• minSolutionErrorTarget (float, default: 0) – A Float specifying the target error percentage at the location of the minimum solution value in the region. A value of 0.0 indicates that Abaqus will use automated error target reduction for the region. You use the minSolutionErrorTarget argument when sizingMethod = MINIMUM_MAXIMUM. The default value is 0.0.

• meshBias (int, default: 0) – An Int specifying an indication of how much Abaqus will bias the mesh toward the location of the maximum solution value in the region. The higher the value, the more the mesh will bias towards the location of the maximum solution value. You use the meshBias argument when sizingMethod = MINIMUM_MAXIMUM. The default value is 0.0.

• minElementSize (float, default: 0) – A Float specifying the minimum size of any single element. The default value is 0.0.

• maxElementSize (float, default: 0) – A Float specifying the maximum size of any single element. The default value is 0.0.

• outputFrequency (SymbolicConstant, default: LAST_INCREMENT) – A SymbolicConstant specifying the frequency with which the error indicators are saved to the output database file (.odb). Possible values are LAST_INCREMENT and ALL_INCREMENTS. The default value is LAST_INCREMENT.

• specifyMinSize (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying an indication of whether to use a user-supplied minimum element size or to calculate a characteristic minimum element size. The default value is OFF.

• specifyMaxSize (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying an indication of whether to use a user-supplied maximum element size or to calculate a characteristic maximum element size. The default value is ON.

• coarseningFactor (SymbolicConstant, default: DEFAULT_LIMIT) – A SymbolicConstant or an Int specifying an indication of the upper limit on the element growth from one remeshing iteration to the next. Possible values are DEFAULT_LIMIT and NOT_ALLOWED. The default value is DEFAULT_LIMIT.

• refinementFactor (SymbolicConstant, default: DEFAULT_LIMIT) – A SymbolicConstant or an Int specifying an indication of the upper limit on element shrinkage from one remeshing iteration to the next. Possible values are DEFAULT_LIMIT and NOT_ALLOWED. The default value is DEFAULT_LIMIT.

• elementCountLimit (Optional[int], default: None) – None or an Int specifying an approximate limit on the number of elements that will be created during remeshing. Use None to indicate there is not upper limit. The default value is None.

Returns:

A RemeshingRule object

Return type:

RemeshingRule

VelocityAdaptiveMeshConstraint(name, createStepName, region, v1=abaqusConstants.UNSET, v2=abaqusConstants.UNSET, v3=abaqusConstants.UNSET, vr1=abaqusConstants.UNSET, vr2=abaqusConstants.UNSET, vr3=abaqusConstants.UNSET, amplitude=abaqusConstants.UNSET, localCsys=None, motionType=abaqusConstants.INDEPENDENT)

This method creates a VelocityAdaptiveMeshConstraint object.

Note

This function can be accessed by:

mdb.models[name].AdaptiveMeshConstraint

Note

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

Parameters:

• name (str) – A String specifying the adaptive mesh constraint repository key.

• createStepName (str) – A String specifying the name of the step in which the adaptive mesh constraint is created.

• region (Region) – A Region object specifying the region to which the adaptive mesh constraint is applied.

• v1 (Union[SymbolicConstant, float], default: 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 (Union[SymbolicConstant, float], default: 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 (Union[SymbolicConstant, float], default: 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 (Union[SymbolicConstant, float], default: 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 (Union[SymbolicConstant, float], default: 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 (Union[SymbolicConstant, float], default: 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 (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the adaptive mesh constraint 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 (Optional[str], default: None) – None or a DatumCsys object specifying the local coordinate system of the adaptive mesh constraint’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

• motionType (SymbolicConstant, default: INDEPENDENT) – A SymbolicConstant specifying the mesh motion in relation to the underlying material. Possible values are INDEPENDENT, FOLLOW and USER_DEFINED. The default value is INDEPENDENT.

Returns:

A VelocityAdaptiveMeshConstraint object

Return type:

VelocityAdaptiveMeshConstraint

adaptiveRemesh(odb)

This method remeshes the model using the active remesh rules in the model and the error indicator results from a previous analysis.

Note

Check AdaptivityModel.adaptiveRemesh on help.3ds.com/0.1..

Parameters:

odb (Odb) – An Odb object containing error output field results.

Returns:

An AdaptivityIteration object.

Return type:

AdaptivityIteration

Create adaptivity mesh state features

class AdaptivityStep

The Step object stores the parameters that determine the context of the step. The Step object is the abstract base type for other Step objects. The Step object has no explicit constructor. The methods and members of the Step object are common to all objects derived from the Step.

Note

This object can be accessed by:

import step
mdb.models[name].steps[name]

Note

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

Public Data Attributes:

Inherited from StepBase

name	A String specifying the repository key.
explicit	A SymbolicConstant specifying whether the step has an explicit procedure type (procedureType = ANNEAL, DYNAMIC_EXPLICIT, or DYNAMIC_TEMP_DISPLACEMENT).
perturbation	A Boolean specifying whether the step has a perturbation procedure type.
nonmechanical	A Boolean specifying whether the step has a mechanical procedure type.
procedureType	A SymbolicConstant specifying the Abaqus procedure.
suppressed	A Boolean specifying whether the step is suppressed or not.
fieldOutputRequestState	A repository of FieldOutputRequestState objects.
historyOutputRequestState	A repository of HistoryOutputRequestState objects.
diagnosticPrint	A DiagnosticPrint object.
monitor	A Monitor object.
restart	A Restart object.
adaptiveMeshConstraintStates	A repository of AdaptiveMeshConstraintState objects.
adaptiveMeshDomains	A repository of AdaptiveMeshDomain objects.
control	A Control object.
solverControl	A SolverControl object.
boundaryConditionStates	A repository of BoundaryConditionState objects.
interactionStates	A repository of InteractionState objects.
loadStates	A repository of LoadState objects.
loadCases	A repository of LoadCase objects.
predefinedFieldStates	A repository of PredefinedFieldState objects.
activateElements	A repository of ActivateElements objects.

Public Methods:

AdaptiveMeshConstraintState([...])	The AdaptiveMeshConstraintState object is the abstract base type for other Arbitrary Lagrangian Eularian (ALE) style AdaptiveMeshConstraintState objects.
DisplacementAdaptiveMeshConstraintState([...])	The DisplacementAdaptiveMeshConstraintState object stores the propagating data for an Arbitrary Lagrangian Eularian (ALE) style displacement/rotation adaptive mesh constraint in a step.
VelocityAdaptiveMeshConstraintState([v1, ...])	The VelocityAdaptiveMeshConstraintState object stores the propagating data for an Arbitrary Lagrangian Eularian (ALE) style velocity adaptive mesh constraint in a step.
AdaptiveMeshDomain(region[, controls, ...])	The AdaptiveMeshDomain object defines the region and controls that govern an Arbitrary Lagrangian Eularian (ALE) style adaptive smoothing mesh domain.

Inherited from StepBase

resume()	This method resumes the step that was previously suppressed.
suppress()	This method suppresses the step.

---

AdaptiveMeshConstraintState(amplitudeState=None, status=None, amplitude='')

The AdaptiveMeshConstraintState object is the abstract base type for other Arbitrary Lagrangian Eularian (ALE) style AdaptiveMeshConstraintState objects. The AdaptiveMeshConstraintState object has no explicit constructor or methods. The members of the AdaptiveMeshConstraintState object are common to all objects derived from the AdaptiveMeshConstraintState object.

Note

This function can be accessed by:

mdb.models[name].steps[name].AdaptiveMeshConstraintState

Note

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

Parameters:

• amplitudeState (Optional[SymbolicConstant], default: None) –

  A SymbolicConstant specifying the propagation state of the amplitude reference. Possible values are

  • UNSET

  • SET

  • UNCHANGED

  • FREED

  • MODIFIED

• status (Optional[SymbolicConstant], default: None) –

  A SymbolicConstant specifying the propagation state of the AdaptiveMeshConstraintState 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

• amplitude (str, default: '') – A String specifying the name of the amplitude reference. The String is empty if the adaptive mesh constraint has no amplitude reference.

AdaptiveMeshDomain(region, controls='', frequency=10, initialMeshSweeps=5, meshSweeps=1)

The AdaptiveMeshDomain object defines the region and controls that govern an Arbitrary Lagrangian Eularian (ALE) style adaptive smoothing mesh domain.

This method creates an AdaptiveMeshDomain object.

Note

This function can be accessed by:

mdb.models[name].steps[name].AdaptiveMeshDomain

Note

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

Parameters:

• region (Region) – A Region object specifying the region to which the adaptive mesh domain is applied.

• controls (str, default: '') – A String specifying the name of an AdaptiveMeshControl object.

• frequency (int, default: 10) – An Int specifying the frequency in increments at which adaptive meshing will be performed. The default value is 10.

• initialMeshSweeps (int, default: 5) – An Int specifying the number of mesh sweeps to be performed at the beginning of the first step in which this adaptive mesh definition is active. The default value is 5.

• meshSweeps (int, default: 1) – An Int specifying the number of mesh sweeps to be performed in each adaptive mesh increment. The default value is 1.

Returns:

An AdaptiveMeshDomain object

Return type:

AdaptiveMeshDomain

DisplacementAdaptiveMeshConstraintState(u1=None, u2=None, u3=None, ur1=None, ur2=None, ur3=None, u1State=None, u2State=None, u3State=None, ur1State=None, ur2State=None, ur3State=None, amplitudeState=None, status=None, amplitude='')

The DisplacementAdaptiveMeshConstraintState object stores the propagating data for an Arbitrary Lagrangian Eularian (ALE) style displacement/rotation adaptive mesh constraint in a step. One instance of this object is created internally by the DisplacementAdaptiveMeshConstraint object for each step. The instance is also deleted internally by the DisplacementAdaptiveMeshConstraint object. The DisplacementAdaptiveMeshConstraintState object has no constructor or methods. The DisplacementAdaptiveMeshConstraintState object is derived from the AdaptiveMeshConstraintState object.

Note

This function can be accessed by:

mdb.models[name].steps[name].DisplacementAdaptiveMeshConstraintState

Note

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

Parameters:

• u1 (Optional[float], default: None) – A Float or a Complex specifying the displacement component in the 1-direction.

• u2 (Optional[float], default: None) – A Float or a Complex specifying the displacement component in the 2-direction.

• u3 (Optional[float], default: None) – A Float or a Complex specifying the displacement component in the 3-direction.

• ur1 (Optional[float], default: None) – A Float or a Complex specifying the rotational displacement component about the 1-direction.

• ur2 (Optional[float], default: None) – A Float or a Complex specifying the rotational displacement component about the 2-direction.

• ur3 (Optional[float], default: None) – A Float or a Complex specifying the rotational displacement component about the 3-direction.

• u1State (Optional[SymbolicConstant], default: None) – A SymbolicConstant specifying the propagation state of the displacement component in the 1-direction. Possible values are UNSET, SET, UNCHANGED, FREED, and MODIFIED.

• u2State (Optional[SymbolicConstant], default: None) – A SymbolicConstant specifying the propagation state of the displacement component in the 2-direction. Possible values are UNSET, SET, UNCHANGED, FREED, and MODIFIED.

• u3State (Optional[SymbolicConstant], default: None) – A SymbolicConstant specifying the propagation state of the displacement component in the 3-direction. Possible values are UNSET, SET, UNCHANGED, FREED, and MODIFIED.

• ur1State (Optional[SymbolicConstant], default: None) – A SymbolicConstant specifying the propagation state of the rotational displacement component about the 1-direction. Possible values are UNSET, SET, UNCHANGED, FREED, and MODIFIED.

• ur2State (Optional[SymbolicConstant], default: None) – A SymbolicConstant specifying the propagation state of the rotational displacement component about the 2-direction. Possible values are UNSET, SET, UNCHANGED, FREED, and MODIFIED.

• ur3State (Optional[SymbolicConstant], default: None) – A SymbolicConstant specifying the propagation state of the rotational displacement component about the 3-direction. Possible values are UNSET, SET, UNCHANGED, FREED, and MODIFIED.

• amplitudeState (Optional[SymbolicConstant], default: None) – A SymbolicConstant specifying the propagation state of the amplitude reference. Possible values are UNSET, SET, UNCHANGED, FREED, and MODIFIED.

• status (Optional[SymbolicConstant], default: None) –

  A SymbolicConstant specifying the propagation state of the AdaptiveMeshConstraintState 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

• amplitude (str, default: '') – A String specifying the name of the amplitude reference. The String is empty if the adaptive mesh constraint has no amplitude reference.

VelocityAdaptiveMeshConstraintState(v1=None, v2=None, v3=None, vr1=None, vr2=None, vr3=None, v1State=None, v2State=None, v3State=None, vr1State=None, vr2State=None, vr3State=None, amplitudeState=None, status=None, amplitude='')

The VelocityAdaptiveMeshConstraintState object stores the propagating data for an Arbitrary Lagrangian Eularian (ALE) style velocity adaptive mesh constraint in a step. One instance of this object is created internally by the VelocityAdaptiveMeshConstraint object for each step. The instance is also deleted internally by the VelocityAdaptiveMeshConstraint object. The VelocityAdaptiveMeshConstraintState object has no constructor or methods. The VelocityAdaptiveMeshConstraintState object is derived from the AdaptiveMeshConstraintState object.

Note

This function can be accessed by:

mdb.models[name].steps[name].VelocityAdaptiveMeshConstraintState

Note

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

Parameters:

• v1 (Optional[float], default: None) – A Float specifying the velocity component in the 1-direction.

• v2 (Optional[float], default: None) – A Float specifying the velocity component in the 2-direction.

• v3 (Optional[float], default: None) – A Float specifying the velocity component in the 3-direction.

• vr1 (Optional[float], default: None) – A Float specifying the rotational velocity component about the 1-direction.

• vr2 (Optional[float], default: None) – A Float specifying the rotational velocity component about the 2-direction.

• vr3 (Optional[float], default: None) – A Float specifying the rotational velocity component about the 3-direction.

• v1State (Optional[SymbolicConstant], default: None) – A SymbolicConstant specifying the propagation state of the velocity component in the 1-direction. Possible values are UNSET, SET, UNCHANGED, FREED, and MODIFIED.

• v2State (Optional[SymbolicConstant], default: None) – A SymbolicConstant specifying the propagation state of the velocity component in the 2-direction. Possible values are UNSET, SET, UNCHANGED, FREED, and MODIFIED.

• v3State (Optional[SymbolicConstant], default: None) – A SymbolicConstant specifying the propagation state of the velocity component in the 3-direction. Possible values are UNSET, SET, UNCHANGED, FREED, and MODIFIED.

• vr1State (Optional[SymbolicConstant], default: None) – A SymbolicConstant specifying the propagation state of the rotational velocity component about the 1-direction. Possible values are UNSET, SET, UNCHANGED, FREED, and MODIFIED.

• vr2State (Optional[SymbolicConstant], default: None) – A SymbolicConstant specifying the propagation state of the rotational velocity component about the 2-direction. Possible values are UNSET, SET, UNCHANGED, FREED, and MODIFIED.

• vr3State (Optional[SymbolicConstant], default: None) – A SymbolicConstant specifying the propagation state of the rotational velocity component about the 3-direction. Possible values are UNSET, SET, UNCHANGED, FREED, and MODIFIED.

• amplitudeState (Optional[SymbolicConstant], default: None) – A SymbolicConstant specifying the propagation state of the amplitude reference. Possible values are UNSET, SET, UNCHANGED, FREED, and MODIFIED.

• status (Optional[SymbolicConstant], default: None) –

  A SymbolicConstant specifying the propagation state of the AdaptiveMeshConstraintState 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

• amplitude (str, default: '') – A String specifying the name of the amplitude reference. The String is empty if the adaptive mesh constraint has no amplitude reference.

Create features for AdaptivityIteration

class AdaptivityIteration(iteration, jobName, modelName, odbPath, remeshingErrors)

The AdaptivityIteration object contains information about a given iteration of the varying topology adaptivity process (adaptive remeshing).

Note

This object can be accessed by:

import job
mdb.adaptivityProcesses[name].iterations[i]

Note

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

Public Data Attributes:

ruleResults

A repository of RuleResult objects specifying the calculated results from sizing functions corresponding to the RemeshingRule objects for this iteration of an adaptivity process.

Public Methods:

__init__(iteration, jobName, modelName, ...)	This method creates an AdaptivityIteration object.
ErrorIndicatorResult(name, results)	This method creates an ErrorIndicatorResult with data for an error indicator variable in a RemeshingRule for a given adaptivity iteration.
RuleResult(name, indicatorResults, numElems, ...)	This method creates a RuleResult with data for a RemeshingRule for a given adaptivity iteration.

---

ErrorIndicatorResult(name, results)

This method creates an ErrorIndicatorResult with data for an error indicator variable in a RemeshingRule for a given adaptivity iteration.

Note

This function can be accessed by:

mdb.adaptivityProcesses[name].AdaptivityIteration

Note

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

Parameters:

• name (str) – A String specifying the name of the error indicator variable to which these results correspond.

• results (str) – A String-to-Float Dictionary specifying the calculated results from the sizing function corresponding to the error indicator variable represented by this ErrorIndicatorResult.

Returns:

An ErrorIndicatorResult object.

Return type:

ErrorIndicatorResult

Raises:

AbaqusException –

RuleResult(name, indicatorResults, numElems, minSizeElemCount, satisfiedVars=())

This method creates a RuleResult with data for a RemeshingRule for a given adaptivity iteration.

Note

This function can be accessed by:

mdb.adaptivityProcesses[name].AdaptivityIteration

Note

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

Parameters:

• name (str) – A String specifying the name of the Remeshing Rule to which these results correspond.

• indicatorResults (Dict[str, ErrorIndicatorResult]) – A repository of ErrorIndicatorResult objects specifying the calculated results from the sizing function corresponding to the error indicator variables for the Remeshing Rule.

• numElems (int) – An Int specifying the number of elements before remeshing in the region of the Remeshing Rule.

• minSizeElemCount (int) – An Int specifying the number of elements that were constrained to the minimum element size by the Remeshing Rule.

• satisfiedVars (tuple, default: ()) – A sequence of Strings specifying the error indicator variables that have satisfied the Remeshing Rule.

Returns:

A RuleResult object.

Return type:

RuleResult

Raises:

AbaqusException –

iteration: int

An Int specifying the sequence number for this iteration in the adaptivity process.

jobName: str

A String specifying the name of the job that was run for this iteration.

modelName: str

A String specifying the name of the model that was analyzed and remeshed in this iteration.

odbPath: str

A String specifying the path to the ODB file that was created for this iteration.

remeshingErrors: int

An Int specifying the number of part instances which generated errors while remeshing the model in this iteration of the adaptivity process.

ruleResults: Dict[str, RuleResult] = {}

A repository of RuleResult objects specifying the calculated results from sizing functions corresponding to the RemeshingRule objects for this iteration of an adaptivity process.

Object Features

AdaptiveMeshConstraint

class AdaptiveMeshConstraint(name, category, region, localCsys=None)

The AdaptiveMeshConstraint object is the abstract base type for other Arbitrary Lagrangian Eularian (ALE) style AdaptiveMeshConstraint objects. The AdaptiveMeshConstraint object has no explicit constructor. The methods and members of the AdaptiveMeshConstraint object are common to all objects derived from the AdaptiveMeshConstraint object.

Note

This object can be accessed by:

import step
mdb.models[name].adaptiveMeshConstraints[name]

Note

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

Public Data Attributes:

name	A String specifying the adaptive mesh constraint repository key.
category	A SymbolicConstant specifying the category of the adaptive mesh constraint.
region	A Region object specifying the region to which the adaptive mesh constraint is applied.
localCsys	None or a DatumCsys object specifying the local coordinate system of the adaptive mesh constraint's degrees of freedom.

Public Methods:

__init__(name, category, region[, localCsys])	The AdaptiveMeshConstraint object is the abstract base type for other Arbitrary Lagrangian Eularian (ALE) style AdaptiveMeshConstraint objects.
deactivate(stepName)	This method deactivates the adaptive mesh constraint in the specified step and all subsequent steps.
move(fromStepName, toStepName)	This method moves the adaptive mesh constraint state from one step to a different step.
reset(stepName)	This method resets the adaptive mesh constraint state of the specified step to the state of the previous analysis step.
resume()	This method resumes the adaptive mesh constraint that was previously suppressed.
suppress()	This method suppresses the adaptive mesh constraint.
delete(indices)	This method allows you to delete existing adaptive mesh constraints.

---

category: Optional[SymbolicConstant] = None

A SymbolicConstant specifying the category of the adaptive mesh constraint. Possible values are MECHANICAL and THERMAL.

deactivate(stepName)

This method deactivates the adaptive mesh constraint in the specified step and all subsequent steps.

Note

Check AdaptiveMeshConstraint.deactivate on help.3ds.com/0.1..

Parameters:

stepName (str) – A String specifying the name of the step in which the adaptive mesh constraint is deactivated.

Raises:

TextError –

delete(indices)

This method allows you to delete existing adaptive mesh constraints.

Note

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

Parameters:

indices (tuple) – A sequence of Ints specifying the index of each adaptive mesh constraint to delete.

localCsys: Optional[DatumCsys] = None

None or a DatumCsys object specifying the local coordinate system of the adaptive mesh constraint’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)

This method moves the adaptive mesh constraint state from one step to a different step.

Note

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

Parameters:

• fromStepName (str) – A String specifying the name of the step from which the adaptive mesh constraint state is moved.

• toStepName (str) – A String specifying the name of the step to which the adaptive mesh constraint state is moved.

Raises:

TextError –

name: str = ''

A String specifying the adaptive mesh constraint repository key.

region: Region = <abaqus.Region.Region.Region object>

A Region object specifying the region to which the adaptive mesh constraint is applied.

reset(stepName)

This method resets the adaptive mesh constraint state of the specified step to the state of the previous analysis step.

Note

Check AdaptiveMeshConstraint.reset on help.3ds.com/0.1..

Parameters:

stepName (str) – A String specifying the name of the step in which the adaptive mesh constraint state is reset.

Raises:

TextError –

resume()

This method resumes the adaptive mesh constraint that was previously suppressed.

suppress()

This method suppresses the adaptive mesh constraint.

AdaptiveMeshConstraintState

class AdaptiveMeshConstraintState(amplitudeState=None, status=None, amplitude='')

The AdaptiveMeshConstraintState object is the abstract base type for other Arbitrary Lagrangian Eularian (ALE) style AdaptiveMeshConstraintState objects. The AdaptiveMeshConstraintState object has no explicit constructor or methods. The members of the AdaptiveMeshConstraintState object are common to all objects derived from the AdaptiveMeshConstraintState object.

Note

This object can be accessed by:

import step
mdb.models[name].steps[name].adaptiveMeshConstraintStates[name]

Note

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

Public Data Attributes:

amplitudeState	A SymbolicConstant specifying the propagation state of the amplitude reference.
status	A SymbolicConstant specifying the propagation state of the AdaptiveMeshConstraintState object.
amplitude	A String specifying the name of the amplitude reference.

Public Methods:

__init__([amplitudeState, status, amplitude])

The AdaptiveMeshConstraintState object is the abstract base type for other Arbitrary Lagrangian Eularian (ALE) style AdaptiveMeshConstraintState objects.

---

amplitude: str = ''

A String specifying the name of the amplitude reference. The String is empty if the adaptive mesh constraint has no amplitude reference.

amplitudeState: Optional[SymbolicConstant] = None

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

status: Optional[SymbolicConstant] = None

A SymbolicConstant specifying the propagation state of the AdaptiveMeshConstraintState 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

AdaptiveMeshControl

class AdaptiveMeshControl(name, remapping=abaqusConstants.SECOND_ORDER_ADVECTION, smoothingAlgorithm=abaqusConstants.GEOMETRY_ENHANCED, smoothingPriority=abaqusConstants.UNIFORM, initialFeatureAngle=30, transitionFeatureAngle=30, momentumAdvection=abaqusConstants.ELEMENT_CENTER_PROJECTION, meshingPredictor=abaqusConstants.CURRENT, curvatureRefinement=1, volumetricSmoothingWeight=1, laplacianSmoothingWeight=0, equipotentialSmoothingWeight=0, meshConstraintAngle=60, originalConfigurationProjectionWeight=1, standardVolumetricSmoothingWeight=0)

The AdaptiveMeshControl object is used to control various aspects of Arbitrary Lagrangian Eularian (ALE) style adaptive smoothing and advection algorithms applied to an ALE adaptive mesh domain.

Note

This object can be accessed by:

import step
mdb.models[name].adaptiveMeshControls[name]

Note

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

Public Data Attributes:

remapping	A SymbolicConstant specifying the remapping algorithm.
smoothingAlgorithm	A SymbolicConstant specifying the type of smoothing algorithm to use.
smoothingPriority	A SymbolicConstant specifying the type of smoothing to perform.
initialFeatureAngle	A Float specifying the initial geometric feature angle, \(\theta_I\), in degrees.
transitionFeatureAngle	A Float specifying the transitional feature angle, \(\theta_T\), in degrees.
momentumAdvection	A SymbolicConstant specifying the type of momentum advection algorithm.
meshingPredictor	A SymbolicConstant specifying the nodal starting location to use for remeshing.
curvatureRefinement	A Float specifying the solution dependence weight, \(\alpha_C\).
volumetricSmoothingWeight	A Float specifying the weight used by Abaqus/Explicit for the volumetric smoothing method.
laplacianSmoothingWeight	A Float specifying the weight for the Laplacian smoothing method.
equipotentialSmoothingWeight	A Float specifying the weight for the equipotential smoothing method.
meshConstraintAngle	A Float specifying the initial geometric feature angle, \(\theta_C\).
originalConfigurationProjectionWeight	A Float specifying the weight for the original configuration projection method.
standardVolumetricSmoothingWeight	A Float specifying the weight used by Abaqus/Standard for the volumetric smoothing method.

Public Methods:

__init__(name[, remapping, ...])	This method creates an AdaptiveMeshControl object.
setValues([remapping, smoothingAlgorithm, ...])	This method modifies the AdaptiveMeshControl object.

---

curvatureRefinement: float = 1

A Float specifying the solution dependence weight, \(\alpha_C\). Possible values are \(0.0\le\alpha_C\le 1.0\). The default value is 1.0.

equipotentialSmoothingWeight: float = 0

A Float specifying the weight for the equipotential smoothing method. The default value is 0.0.

initialFeatureAngle: float = 30

A Float specifying the initial geometric feature angle, \(\theta_I\), in degrees. Possible values are \(0^\circ\le\theta_I\le 180^\circ\). The default value is 30.0.

laplacianSmoothingWeight: float = 0

A Float specifying the weight for the Laplacian smoothing method. The default value is 0.0.

meshConstraintAngle: float = 60

A Float specifying the initial geometric feature angle, \(\theta_C\). Possible values are \(0^\circ\le\theta_C\le 180^\circ\). The default value is 60.0.

meshingPredictor: SymbolicConstant = CURRENT

A SymbolicConstant specifying the nodal starting location to use for remeshing. Possible values are CURRENT and PREVIOUS. The default value is CURRENT.

momentumAdvection: SymbolicConstant = ELEMENT_CENTER_PROJECTION

A SymbolicConstant specifying the type of momentum advection algorithm. Possible values are ELEMENT_CENTER_PROJECTION and HALF_INDEX_SHIFT. The default value is ELEMENT_CENTER_PROJECTION.

name: str

A String specifying the name of the object.

originalConfigurationProjectionWeight: float = 1

A Float specifying the weight for the original configuration projection method. The default value is 1.0.

remapping: SymbolicConstant = SECOND_ORDER_ADVECTION

A SymbolicConstant specifying the remapping algorithm. Possible values are FIRST_ORDER_ADVECTION and SECOND_ORDER_ADVECTION. The default value is SECOND_ORDER_ADVECTION.

setValues(remapping=abaqusConstants.SECOND_ORDER_ADVECTION, smoothingAlgorithm=abaqusConstants.GEOMETRY_ENHANCED, smoothingPriority=abaqusConstants.UNIFORM, initialFeatureAngle=30, transitionFeatureAngle=30, momentumAdvection=abaqusConstants.ELEMENT_CENTER_PROJECTION, meshingPredictor=abaqusConstants.CURRENT, curvatureRefinement=1, volumetricSmoothingWeight=1, laplacianSmoothingWeight=0, equipotentialSmoothingWeight=0, meshConstraintAngle=60, originalConfigurationProjectionWeight=1, standardVolumetricSmoothingWeight=0)

This method modifies the AdaptiveMeshControl object.

Note

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

Parameters:

• remapping (SymbolicConstant, default: SECOND_ORDER_ADVECTION) – A SymbolicConstant specifying the remapping algorithm. Possible values are FIRST_ORDER_ADVECTION and SECOND_ORDER_ADVECTION. The default value is SECOND_ORDER_ADVECTION.

• smoothingAlgorithm (SymbolicConstant, default: GEOMETRY_ENHANCED) – A SymbolicConstant specifying the type of smoothing algorithm to use. Possible values are STANDARD and GEOMETRY_ENHANCED. The default value is GEOMETRY_ENHANCED.

• smoothingPriority (SymbolicConstant, default: UNIFORM) – A SymbolicConstant specifying the type of smoothing to perform. Possible values are UNIFORM and GRADED. The default value is UNIFORM.

• initialFeatureAngle (float, default: 30) – A Float specifying the initial geometric feature angle, \(\theta_I\), in degrees. Possible values are \(0^\circ\le\theta_I\le 180^\circ\). The default value is 30.0.

• transitionFeatureAngle (float, default: 30) – A Float specifying the transitional feature angle, \(\theta_T\), in degrees. Possible values are \(0^\circ\le\theta_T\le 180^\circ\). The default value is 30.0.

• momentumAdvection (SymbolicConstant, default: ELEMENT_CENTER_PROJECTION) – A SymbolicConstant specifying the type of momentum advection algorithm. Possible values are ELEMENT_CENTER_PROJECTION and HALF_INDEX_SHIFT. The default value is ELEMENT_CENTER_PROJECTION.

• meshingPredictor (SymbolicConstant, default: CURRENT) – A SymbolicConstant specifying the nodal starting location to use for remeshing. Possible values are CURRENT and PREVIOUS. The default value is CURRENT.

• curvatureRefinement (float, default: 1) – A Float specifying the solution dependence weight, \(\alpha_C\). Possible values are \(0.0\le\alpha_C\le 1.0\). The default value is 1.0.

• volumetricSmoothingWeight (float, default: 1) – A Float specifying the weight used by Abaqus/Explicit for the volumetric smoothing method. The default value is 1.0.

• laplacianSmoothingWeight (float, default: 0) – A Float specifying the weight for the Laplacian smoothing method. The default value is 0.0.

• equipotentialSmoothingWeight (float, default: 0) – A Float specifying the weight for the equipotential smoothing method. The default value is 0.0.

• meshConstraintAngle (float, default: 60) – A Float specifying the initial geometric feature angle, \(\theta_c\). Possible values are \(0^\circ\le\theta_C\le 180^\circ\). The default value is 60.0.

• originalConfigurationProjectionWeight (float, default: 1) – A Float specifying the weight for the original configuration projection method. The default value is 1.0.

• standardVolumetricSmoothingWeight (float, default: 0) – A Float specifying the weight used by Abaqus/Standard for the volumetric smoothing method. The default value is 0.0.

Raises:

RangeError –

smoothingAlgorithm: SymbolicConstant = GEOMETRY_ENHANCED

A SymbolicConstant specifying the type of smoothing algorithm to use. Possible values are STANDARD and GEOMETRY_ENHANCED. The default value is GEOMETRY_ENHANCED.

smoothingPriority: SymbolicConstant = UNIFORM

A SymbolicConstant specifying the type of smoothing to perform. Possible values are UNIFORM and GRADED. The default value is UNIFORM.

standardVolumetricSmoothingWeight: float = 0

A Float specifying the weight used by Abaqus/Standard for the volumetric smoothing method. The default value is 0.0.

transitionFeatureAngle: float = 30

A Float specifying the transitional feature angle, \(\theta_T\), in degrees. Possible values are \(0^\circ\le\theta_T\le 180^\circ\). The default value is 30.0.

volumetricSmoothingWeight: float = 1

A Float specifying the weight used by Abaqus/Explicit for the volumetric smoothing method. The default value is 1.0.

AdaptiveMeshDomain

class AdaptiveMeshDomain(region, controls='', frequency=10, initialMeshSweeps=5, meshSweeps=1)

The AdaptiveMeshDomain object defines the region and controls that govern an Arbitrary Lagrangian Eularian (ALE) style adaptive smoothing mesh domain.

Note

This object can be accessed by:

import step
mdb.models[name].steps[name].adaptiveMeshDomains[name]

Note

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

Public Data Attributes:

controls	A String specifying the name of an AdaptiveMeshControl object.
frequency	An Int specifying the frequency in increments at which adaptive meshing will be performed.
initialMeshSweeps	An Int specifying the number of mesh sweeps to be performed at the beginning of the first step in which this adaptive mesh definition is active.
meshSweeps	An Int specifying the number of mesh sweeps to be performed in each adaptive mesh increment.

Public Methods:

__init__(region[, controls, frequency, ...])	This method creates an AdaptiveMeshDomain object.
setValues(*args, **kwargs)	This method modifies the AdaptiveMeshDomain object.

---

controls: str = ''

A String specifying the name of an AdaptiveMeshControl object.

frequency: int = 10

An Int specifying the frequency in increments at which adaptive meshing will be performed. The default value is 10.

initialMeshSweeps: int = 5

An Int specifying the number of mesh sweeps to be performed at the beginning of the first step in which this adaptive mesh definition is active. The default value is 5.

meshSweeps: int = 1

An Int specifying the number of mesh sweeps to be performed in each adaptive mesh increment. The default value is 1.

region: Region

A Region object specifying the region to which the adaptive mesh domain is applied.

setValues(*args, **kwargs)

This method modifies the AdaptiveMeshDomain object.

Raises:

RangeError –

AdaptivityProcess

class AdaptivityProcess(name, job, maxIterations=3, jobPrefix='')

The AdaptivityProcess object defines a series of jobs that will be submitted for analysis. Abaqus performs adaptive remeshing between each job.

Note

This object can be accessed by:

import job
mdb.adaptivityProcesses[name]

Note

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

Public Data Attributes:

status	A SymbolicConstant specifying the status of the adaptivity process.
iterations	A repository of AdaptivityIteration objects specifying the AdaptivityIteration objects received during running the adaptivity process.
maxIterations	An Int specifying the maximum number of analysis jobs that will be run by the Adaptivity Process.
jobPrefix	A String specifying the prefix to use for jobs created by the adaptivity process.

Public Methods:

__init__(name, job[, maxIterations, jobPrefix])	This method creates an AdaptivityProcess object.
submit([waitForCompletion, datacheckJob, ...])	This method begins the process of analysis and adaptive remeshing.
setValues([maxIterations, jobPrefix])	This method modifies the AdaptivityProcess object.
AdaptivityIteration(iteration, jobName, ...)	This method creates an AdaptivityIteration object.

---

AdaptivityIteration(iteration, jobName, modelName, odbPath, remeshingErrors)

This method creates an AdaptivityIteration object.

Note

This function can be accessed by:

mdb.AdaptivityProcess

Note

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

Parameters:

• iteration (int) – An Int specifying the sequence number for this iteration in the adaptivity process.

• jobName (str) – A String specifying the name of the job that was run for this iteration.

• modelName (str) – A String specifying the name of the model that was analyzed and remeshed in this iteration.

• odbPath (str) – A String specifying the path to the ODB file that was created for this iteration.

• remeshingErrors (int) – An Int specifying the number of part instances which generated errors while remeshing the model in this iteration of the adaptivity process.

Returns:

An AdaptivityIteration object.

Return type:

AdaptivityIteration

iterations: Dict[int, AdaptivityIteration] = {}

A repository of AdaptivityIteration objects specifying the AdaptivityIteration objects received during running the adaptivity process.

job: ModelJob

A ModelJob object specifying a job to be used as the prototype for all analysis jobs run by the adaptivity process.

jobPrefix: str = ''

A String specifying the prefix to use for jobs created by the adaptivity process. An empty string indicates that the name of the adaptivity process should be used. The default value is an empty string.

maxIterations: int = 3

An Int specifying the maximum number of analysis jobs that will be run by the Adaptivity Process. Abaqus performs adaptive remeshing between each analysis. The default value is 3.

name: str

A String specifying the name of the Adaptivity Process.

setValues(maxIterations=3, jobPrefix='')

This method modifies the AdaptivityProcess object.

Note

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

Parameters:

• maxIterations (int, default: 3) – An Int specifying the maximum number of analysis jobs that will be run by the Adaptivity Process. Abaqus performs adaptive remeshing between each analysis. The default value is 3.

• jobPrefix (str, default: '') – A String specifying the prefix to use for jobs created by the adaptivity process. An empty string indicates that the name of the adaptivity process should be used. The default value is an empty string.

status: Optional[SymbolicConstant] = None

A SymbolicConstant specifying the status of the adaptivity process. Possible values are SUBMITTED, RUNNING, ABORTED, TERMINATED, and COMPLETED.

submit(waitForCompletion=OFF, datacheckJob=False, continueJob=False)

This method begins the process of analysis and adaptive remeshing.

Note

Check AdaptivityProcess.submit on help.3ds.com/0.1..

Parameters:

• waitForCompletion (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to interrupt the execution of a script until the end of the adaptive remeshing process is reached.

• datacheckJob (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether to run the adaptivity as a datacheck analysis. The default value is False. The datacheckJob and continueJob arguments cannot both be True.

• continueJob (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether to run the adaptivity as a continuation analysis. The default value is False. The datacheckJob and continueJob arguments cannot both be True.

DisplacementAdaptiveMeshConstraint

class DisplacementAdaptiveMeshConstraint(name, createStepName, region, u1=abaqusConstants.UNSET, u2=abaqusConstants.UNSET, u3=abaqusConstants.UNSET, ur1=abaqusConstants.UNSET, ur2=abaqusConstants.UNSET, ur3=abaqusConstants.UNSET, amplitude=abaqusConstants.UNSET, motionType=abaqusConstants.INDEPENDENT, localCsys=None)

The AdaptivityProcess object defines a series of jobs that will be submitted for analysis. Abaqus performs adaptive remeshing between each job.

Note

This object can be accessed by:

import step
mdb.models[name].adaptiveMeshConstraints[name]

Note

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

Public Data Attributes:

name	A String specifying the adaptive mesh constraint repository key.
category	A SymbolicConstant specifying the category of the adaptive mesh constraint.
region	A Region object specifying the region to which the adaptive mesh constraint is applied.
localCsys	None or a DatumCsys object specifying the local coordinate system of the adaptive mesh constraint's degrees of freedom.

Inherited from AdaptiveMeshConstraint

name	A String specifying the adaptive mesh constraint repository key.
category	A SymbolicConstant specifying the category of the adaptive mesh constraint.
region	A Region object specifying the region to which the adaptive mesh constraint is applied.
localCsys	None or a DatumCsys object specifying the local coordinate system of the adaptive mesh constraint's degrees of freedom.

Public Methods:

__init__(name, createStepName, region[, u1, ...])	This method creates a DisplacementAdaptiveMeshConstraint object.
setValues([u1, u2, u3, ur1, ur2, ur3, ...])	This method modifies the data for an existing DisplacementAdaptiveMeshConstraint object in the step where it is created.
setValuesInStep(stepName[, u1, u2, u3, ur1, ...])	This method modifies the propagating data for an existing DisplacementAdaptiveMeshConstraint object in the specified step.

Inherited from AdaptiveMeshConstraint

__init__(name, createStepName, region[, u1, ...])	This method creates a DisplacementAdaptiveMeshConstraint object.
deactivate(stepName)	This method deactivates the adaptive mesh constraint in the specified step and all subsequent steps.
move(fromStepName, toStepName)	This method moves the adaptive mesh constraint state from one step to a different step.
reset(stepName)	This method resets the adaptive mesh constraint state of the specified step to the state of the previous analysis step.
resume()	This method resumes the adaptive mesh constraint that was previously suppressed.
suppress()	This method suppresses the adaptive mesh constraint.
delete(indices)	This method allows you to delete existing adaptive mesh constraints.

---

category: Optional[SymbolicConstant] = None

A SymbolicConstant specifying the category of the adaptive mesh constraint. Possible values are MECHANICAL and THERMAL.

localCsys: Optional[str] = None

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

name: str = ''

A String specifying the adaptive mesh constraint repository key.

region: Region = <abaqus.Region.Region.Region object>

A Region object specifying the region to which the adaptive mesh constraint is applied.

setValues(u1=abaqusConstants.UNSET, u2=abaqusConstants.UNSET, u3=abaqusConstants.UNSET, ur1=abaqusConstants.UNSET, ur2=abaqusConstants.UNSET, ur3=abaqusConstants.UNSET, amplitude=abaqusConstants.UNSET, motionType=abaqusConstants.INDEPENDENT, localCsys=None)

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

Note

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

Parameters:

• u1 (Union[SymbolicConstant, float], default: UNSET) – A Float 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 (Union[SymbolicConstant, float], default: UNSET) – A Float 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 (Union[SymbolicConstant, float], default: UNSET) – A Float 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 (Union[SymbolicConstant, float], default: UNSET) – A Float 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 (Union[SymbolicConstant, float], default: UNSET) – A Float 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 (Union[SymbolicConstant, float], default: UNSET) – A Float 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.

• amplitude (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the adaptive mesh constraint has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.

• motionType (SymbolicConstant, default: INDEPENDENT) – A SymbolicConstant specifying the mesh motion in relation to the underlying material. Possible values are INDEPENDENT, FOLLOW and USER_DEFINED. The default value is INDEPENDENT.

• localCsys (Optional[str], default: None) – None or a DatumCsys object specifying the local coordinate system of the adaptive mesh constraint’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, u1=None, u2=None, u3=None, ur1=None, ur2=None, ur3=None, amplitude='')

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

Note

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

Parameters:

• stepName (str) – A String specifying the name of the step in which the adaptive mesh constraint is modified.

• u1 (Union[SymbolicConstant, float, None], default: None) – A Float or a SymbolicConstant specifying the displacement component in the 1-direction. Possible values for the SymbolicConstant are SET, UNCHANGED, and FREED.

• u2 (Union[SymbolicConstant, float, None], default: None) – A Float or a SymbolicConstant specifying the displacement component in the 2-direction. Possible values for the SymbolicConstant are SET, UNCHANGED, and FREED.

• u3 (Union[SymbolicConstant, float, None], default: None) – A Float or a SymbolicConstant specifying the displacement component in the 3-direction. Possible values for the SymbolicConstant are SET, UNCHANGED, and FREED.

• ur1 (Union[SymbolicConstant, float, None], default: None) – A Float or a SymbolicConstant specifying the rotational displacement component about the 1-direction. Possible values for the SymbolicConstant are SET, UNCHANGED, and FREED.

• ur2 (Union[SymbolicConstant, float, None], default: None) – A Float or a SymbolicConstant specifying the rotational displacement component about the 2-direction. Possible values for the SymbolicConstant are SET, UNCHANGED, and FREED.

• ur3 (Union[SymbolicConstant, float, None], default: None) – A Float or a SymbolicConstant specifying the rotational displacement component about the 3-direction. Possible values for the SymbolicConstant are SET, UNCHANGED, and FREED.

• amplitude (str, default: '') – 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 adaptive mesh constraint is changed to have no amplitude reference. You should provide the amplitude argument only if it is valid for the specified step.

DisplacementAdaptiveMeshConstraintState

class DisplacementAdaptiveMeshConstraintState(u1=None, u2=None, u3=None, ur1=None, ur2=None, ur3=None, u1State=None, u2State=None, u3State=None, ur1State=None, ur2State=None, ur3State=None, amplitudeState=None, status=None, amplitude='')

The DisplacementAdaptiveMeshConstraintState object stores the propagating data for an Arbitrary Lagrangian Eularian (ALE) style displacement/rotation adaptive mesh constraint in a step. One instance of this object is created internally by the DisplacementAdaptiveMeshConstraint object for each step. The instance is also deleted internally by the DisplacementAdaptiveMeshConstraint object. The DisplacementAdaptiveMeshConstraintState object has no constructor or methods. The DisplacementAdaptiveMeshConstraintState object is derived from the AdaptiveMeshConstraintState object.

Note

This object can be accessed by:

import step
mdb.models[name].steps[name].adaptiveMeshConstraintStates[name]

The corresponding analysis keywords are:

• ADAPTIVE MESH CONSTRAINT

Note

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

Public Data Attributes:

u1	A Float or a Complex specifying the displacement component in the 1-direction.
u2	A Float or a Complex specifying the displacement component in the 2-direction.
u3	A Float or a Complex specifying the displacement component in the 3-direction.
ur1	A Float or a Complex specifying the rotational displacement component about the 1-direction.
ur2	A Float or a Complex specifying the rotational displacement component about the 2-direction.
ur3	A Float or a Complex specifying the rotational displacement component about the 3-direction.
u1State	A SymbolicConstant specifying the propagation state of the displacement component in the 1-direction.
u2State	A SymbolicConstant specifying the propagation state of the displacement component in the 2-direction.
u3State	A SymbolicConstant specifying the propagation state of the displacement component in the 3-direction.
ur1State	A SymbolicConstant specifying the propagation state of the rotational displacement component about the 1-direction.
ur2State	A SymbolicConstant specifying the propagation state of the rotational displacement component about the 2-direction.
ur3State	A SymbolicConstant specifying the propagation state of the rotational displacement component about the 3-direction.
amplitudeState	A SymbolicConstant specifying the propagation state of the amplitude reference.
status	A SymbolicConstant specifying the propagation state of the AdaptiveMeshConstraintState object.
amplitude	A String specifying the name of the amplitude reference.

Inherited from AdaptiveMeshConstraintState

amplitudeState	A SymbolicConstant specifying the propagation state of the amplitude reference.
status	A SymbolicConstant specifying the propagation state of the AdaptiveMeshConstraintState object.
amplitude	A String specifying the name of the amplitude reference.

Public Methods:

__init__([u1, u2, u3, ur1, ur2, ur3, ...])

Inherited from AdaptiveMeshConstraintState

__init__([u1, u2, u3, ur1, ur2, ur3, ...])

---

amplitude: str = ''

A String specifying the name of the amplitude reference. The String is empty if the adaptive mesh constraint has no amplitude reference.

amplitudeState: Optional[SymbolicConstant] = None

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

status: Optional[SymbolicConstant] = None

A SymbolicConstant specifying the propagation state of the AdaptiveMeshConstraintState 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: Optional[float] = None

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

u1State: Optional[SymbolicConstant] = None

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

u2: Optional[float] = None

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

u2State: Optional[SymbolicConstant] = None

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

u3: Optional[float] = None

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

u3State: Optional[SymbolicConstant] = None

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

ur1: Optional[float] = None

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

ur1State: Optional[SymbolicConstant] = None

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: Optional[float] = None

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

ur2State: Optional[SymbolicConstant] = None

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: Optional[float] = None

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

ur3State: Optional[SymbolicConstant] = None

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

ErrorIndicatorResult

class ErrorIndicatorResult(name, results)

The ErrorIndicatorResult object contains result information corresponding to an error indicator variable in a RemeshingRule object for an adaptivity iteration.

Note

This object can be accessed by:

import job
mdb.adaptivityProcesses[name].iterations[i].ruleResults[name].indicatorResults[name]

Note

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

Public Data Attributes:

Inherited from RuleResult

satisfiedVars

A sequence of Strings specifying the error indicator variables that have satisfied the Remeshing Rule.

Public Methods:

__init__(name, results)

This method creates an ErrorIndicatorResult with data for an error indicator variable in a RemeshingRule for a given adaptivity iteration.

Inherited from RuleResult

__init__(name, results)

This method creates an ErrorIndicatorResult with data for an error indicator variable in a RemeshingRule for a given adaptivity iteration.

---

name: str

A String specifying the name of the error indicator variable to which these results correspond.

results: str

A String-to-Float Dictionary specifying the calculated results from the sizing function corresponding to the error indicator variable represented by this ErrorIndicatorResult.

RemeshingRule

class RemeshingRule(name, stepName, variables, description='', region=abaqusConstants.MODEL, sizingMethod=abaqusConstants.DEFAULT, errorTarget=0, maxSolutionErrorTarget=0, minSolutionErrorTarget=0, meshBias=0, minElementSize=0, maxElementSize=0, outputFrequency=abaqusConstants.LAST_INCREMENT, specifyMinSize=OFF, specifyMaxSize=ON, coarseningFactor=abaqusConstants.DEFAULT_LIMIT, refinementFactor=abaqusConstants.DEFAULT_LIMIT, elementCountLimit=None)

The RemeshingRule object controls the adaptive remeshing resizing and the error indicators written to the output database for a specified region of the model.

Note

This object can be accessed by:

import mesh
mdb.models[name].remeshingRules[name]

Note

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

Public Data Attributes:

suppressed	A Boolean specifying whether the remeshing rule is suppressed.
description	A String specifying a descriptive string for this rule.
region	The SymbolicConstant MODEL or a Region object specifying the region in which Abaqus will remesh and generate output.
sizingMethod	A SymbolicConstant specifying the method for calculating the new mesh sizes.
errorTarget	A Float specifying the target error percentage for each variable in the region.
maxSolutionErrorTarget	A Float specifying the target error percentage at the location of the maximum solution value in the region.
minSolutionErrorTarget	A Float specifying the target error percentage at the location of the minimum solution value in the region.
meshBias	An Int specifying an indication of how much Abaqus will bias the mesh toward the location of the maximum solution value in the region.
minElementSize	A Float specifying the minimum size of any single element.
maxElementSize	A Float specifying the maximum size of any single element.
outputFrequency	A SymbolicConstant specifying the frequency with which the error indicators are saved to the output database file (.odb).
specifyMinSize	A Boolean specifying an indication of whether to use a user-supplied minimum element size or to calculate a characteristic minimum element size.
specifyMaxSize	A Boolean specifying an indication of whether to use a user-supplied maximum element size or to calculate a characteristic maximum element size.
coarseningFactor	A SymbolicConstant or an Int specifying an indication of the upper limit on the element growth from one remeshing iteration to the next.
refinementFactor	A SymbolicConstant or an Int specifying an indication of the upper limit on element shrinkage from one remeshing iteration to the next.
elementCountLimit	None or an Int specifying an approximate limit on the number of elements that will be created during remeshing.

Public Methods:

__init__(name, stepName, variables[, ...])	This method creates a RemeshingRule object.
resume()	This method resumes the remeshing rule that was previously suppressed.
suppress()	This method suppresses the remeshing rule.
setValues([description, region, ...])	This method modifies the RemeshingRule object.

---

coarseningFactor: SymbolicConstant = DEFAULT_LIMIT

A SymbolicConstant or an Int specifying an indication of the upper limit on the element growth from one remeshing iteration to the next. Possible values are DEFAULT_LIMIT and NOT_ALLOWED. The default value is DEFAULT_LIMIT.

description: str = ''

A String specifying a descriptive string for this rule. The default value is an empty string.

elementCountLimit: Optional[int] = None

None or an Int specifying an approximate limit on the number of elements that will be created during remeshing. Use None to indicate there is not upper limit. The default value is None.

errorTarget: float = 0

A Float specifying the target error percentage for each variable in the region. A value of 0.0 indicates that Abaqus will use automated error target reduction for the region. You use the errorTarget argument when sizingMethod = UNIFORM_ERROR. The default value is 0.0.

maxElementSize: float = 0

A Float specifying the maximum size of any single element. The default value is 0.0.

maxSolutionErrorTarget: float = 0

A Float specifying the target error percentage at the location of the maximum solution value in the region. A value of 0.0 indicates that Abaqus will use automated error target reduction for the region. You use the maxSolutionErrorTarget argument when sizingMethod = MINIMUM_MAXIMUM. The default value is 0.0.

meshBias: int = 0

An Int specifying an indication of how much Abaqus will bias the mesh toward the location of the maximum solution value in the region. The higher the value, the more the mesh will bias towards the location of the maximum solution value. You use the meshBias argument when sizingMethod = MINIMUM_MAXIMUM. The default value is 0.0.

minElementSize: float = 0

A Float specifying the minimum size of any single element. The default value is 0.0.

minSolutionErrorTarget: float = 0

A Float specifying the target error percentage at the location of the minimum solution value in the region. A value of 0.0 indicates that Abaqus will use automated error target reduction for the region. You use the minSolutionErrorTarget argument when sizingMethod = MINIMUM_MAXIMUM. The default value is 0.0.

name: str

A String specifying the name of the object.

outputFrequency: SymbolicConstant = LAST_INCREMENT

A SymbolicConstant specifying the frequency with which the error indicators are saved to the output database file (.odb). Possible values are LAST_INCREMENT and ALL_INCREMENTS. The default value is LAST_INCREMENT.

refinementFactor: SymbolicConstant = DEFAULT_LIMIT

A SymbolicConstant or an Int specifying an indication of the upper limit on element shrinkage from one remeshing iteration to the next. Possible values are DEFAULT_LIMIT and NOT_ALLOWED. The default value is DEFAULT_LIMIT.

region: SymbolicConstant = MODEL

The SymbolicConstant MODEL or a Region object specifying the region in which Abaqus will remesh and generate output. The SymbolicConstant MODEL represents the entire applicable model. The default value is MODEL.

resume()

This method resumes the remeshing rule that was previously suppressed.

setValues(description='', region=abaqusConstants.MODEL, sizingMethod=abaqusConstants.DEFAULT, errorTarget=0, maxSolutionErrorTarget=0, minSolutionErrorTarget=0, meshBias=0, minElementSize=0, maxElementSize=0, outputFrequency=abaqusConstants.LAST_INCREMENT, specifyMinSize=OFF, specifyMaxSize=ON, coarseningFactor=abaqusConstants.DEFAULT_LIMIT, refinementFactor=abaqusConstants.DEFAULT_LIMIT, elementCountLimit=None)

This method modifies the RemeshingRule object.

Note

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

Parameters:

• description (str, default: '') – A String specifying a descriptive string for this rule. The default value is an empty string.

• region (SymbolicConstant, default: MODEL) – The SymbolicConstant MODEL or a Region object specifying the region in which Abaqus will remesh and generate output. The SymbolicConstant MODEL represents the entire applicable model. The default value is MODEL.

• sizingMethod (SymbolicConstant, default: DEFAULT) – A SymbolicConstant specifying the method for calculating the new mesh sizes. The SymbolicConstant DEFAULT indicates that Abaqus will use the default calculation method for each individual variable. Possible values are DEFAULT, UNIFORM_ERROR, and MINIMUM_MAXIMUM. The default value is DEFAULT.

• errorTarget (float, default: 0) – A Float specifying the target error percentage for each variable in the region. A value of 0.0 indicates that Abaqus will use automated error target reduction for the region. You use the errorTarget argument when sizingMethod = UNIFORM_ERROR. The default value is 0.0.

• maxSolutionErrorTarget (float, default: 0) – A Float specifying the target error percentage at the location of the maximum solution value in the region. A value of 0.0 indicates that Abaqus will use automated error target reduction for the region. You use the maxSolutionErrorTarget argument when sizingMethod = MINIMUM_MAXIMUM. The default value is 0.0.

• minSolutionErrorTarget (float, default: 0) – A Float specifying the target error percentage at the location of the minimum solution value in the region. A value of 0.0 indicates that Abaqus will use automated error target reduction for the region. You use the minSolutionErrorTarget argument when sizingMethod = MINIMUM_MAXIMUM. The default value is 0.0.

• meshBias (int, default: 0) – An Int specifying an indication of how much Abaqus will bias the mesh toward the location of the maximum solution value in the region. The higher the value, the more the mesh will bias towards the location of the maximum solution value. You use the meshBias argument when sizingMethod = MINIMUM_MAXIMUM. The default value is 0.0.

• minElementSize (float, default: 0) – A Float specifying the minimum size of any single element. The default value is 0.0.

• maxElementSize (float, default: 0) – A Float specifying the maximum size of any single element. The default value is 0.0.

• outputFrequency (SymbolicConstant, default: LAST_INCREMENT) – A SymbolicConstant specifying the frequency with which the error indicators are saved to the output database file (.odb). Possible values are LAST_INCREMENT and ALL_INCREMENTS. The default value is LAST_INCREMENT.

• specifyMinSize (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying an indication of whether to use a user-supplied minimum element size or to calculate a characteristic minimum element size. The default value is OFF.

• specifyMaxSize (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying an indication of whether to use a user-supplied maximum element size or to calculate a characteristic maximum element size. The default value is ON.

• coarseningFactor (SymbolicConstant, default: DEFAULT_LIMIT) – A SymbolicConstant or an Int specifying an indication of the upper limit on the element growth from one remeshing iteration to the next. Possible values are DEFAULT_LIMIT and NOT_ALLOWED. The default value is DEFAULT_LIMIT.

• refinementFactor (SymbolicConstant, default: DEFAULT_LIMIT) – A SymbolicConstant or an Int specifying an indication of the upper limit on element shrinkage from one remeshing iteration to the next. Possible values are DEFAULT_LIMIT and NOT_ALLOWED. The default value is DEFAULT_LIMIT.

• elementCountLimit (Optional[int], default: None) – None or an Int specifying an approximate limit on the number of elements that will be created during remeshing. Use None to indicate there is not upper limit. The default value is None.

sizingMethod: SymbolicConstant = DEFAULT

A SymbolicConstant specifying the method for calculating the new mesh sizes. The SymbolicConstant DEFAULT indicates that Abaqus will use the default calculation method for each individual variable. Possible values are DEFAULT, UNIFORM_ERROR, and MINIMUM_MAXIMUM. The default value is DEFAULT.

specifyMaxSize: Union[AbaqusBoolean, bool] = ON

A Boolean specifying an indication of whether to use a user-supplied maximum element size or to calculate a characteristic maximum element size. The default value is ON.

specifyMinSize: Union[AbaqusBoolean, bool] = OFF

A Boolean specifying an indication of whether to use a user-supplied minimum element size or to calculate a characteristic minimum element size. The default value is OFF.

stepName: str

A String specifying the name of the step in which resizing should occur for this rule.

suppress()

This method suppresses the remeshing rule. Abaqus will not remesh regions where the rules are suppressed.

suppressed: Union[AbaqusBoolean, bool] = OFF

A Boolean specifying whether the remeshing rule is suppressed. Remeshing of the remeshing rule’s region will not occur if you suppress a rule. The default value is OFF.

variables: tuple

A sequence of Strings specifying the output request variables that Abaqus will use as error indicators.

RuleResult

class RuleResult(name, indicatorResults, numElems, minSizeElemCount, satisfiedVars=())

The RuleResult object contains result information corresponding to a RemeshingRule object for an adaptivity iteration.

Note

This object can be accessed by:

import job
mdb.adaptivityProcesses[name].iterations[i].ruleResults[name]

Note

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

Public Data Attributes:

satisfiedVars

A sequence of Strings specifying the error indicator variables that have satisfied the Remeshing Rule.

Public Methods:

__init__(name, indicatorResults, numElems, ...)

This method creates a RuleResult with data for a RemeshingRule for a given adaptivity iteration.

---

indicatorResults: Dict[str, ErrorIndicatorResult]

A repository of ErrorIndicatorResult objects specifying the calculated results from the sizing function corresponding to the error indicator variables for the Remeshing Rule.

minSizeElemCount: int

An Int specifying the number of elements that were constrained to the minimum element size by the Remeshing Rule.

name: str

A String specifying the name of the Remeshing Rule to which these results correspond.

numElems: int

An Int specifying the number of elements before remeshing in the region of the Remeshing Rule.

satisfiedVars: tuple = ()

A sequence of Strings specifying the error indicator variables that have satisfied the Remeshing Rule.

VelocityAdaptiveMeshConstraint

class VelocityAdaptiveMeshConstraint(name, createStepName, region, v1=abaqusConstants.UNSET, v2=abaqusConstants.UNSET, v3=abaqusConstants.UNSET, vr1=abaqusConstants.UNSET, vr2=abaqusConstants.UNSET, vr3=abaqusConstants.UNSET, amplitude=abaqusConstants.UNSET, localCsys=None, motionType=abaqusConstants.INDEPENDENT)

The VelocityAdaptiveMeshConstraint object stores the data for an Arbitrary Lagrangian Eularian (ALE) style velocity adaptive mesh constraint. The VelocityAdaptiveMeshConstraint object is derived from the AdaptiveMeshConstraint object.

Note

This object can be accessed by:

import step
mdb.models[name].adaptiveMeshConstraints[name]

Note

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

Public Data Attributes:

name	A String specifying the adaptive mesh constraint repository key.
category	A SymbolicConstant specifying the category of the adaptive mesh constraint.
region	A Region object specifying the region to which the adaptive mesh constraint is applied.
localCsys	None or a DatumCsys object specifying the local coordinate system of the adaptive mesh constraint's degrees of freedom.

Inherited from AdaptiveMeshConstraint

name	A String specifying the adaptive mesh constraint repository key.
category	A SymbolicConstant specifying the category of the adaptive mesh constraint.
region	A Region object specifying the region to which the adaptive mesh constraint is applied.
localCsys	None or a DatumCsys object specifying the local coordinate system of the adaptive mesh constraint's degrees of freedom.

Public Methods:

__init__(name, createStepName, region[, v1, ...])	This method creates a VelocityAdaptiveMeshConstraint object.
setValues([v1, v2, v3, vr1, vr2, vr3, ...])	This method modifies the data for an existing VelocityAdaptiveMeshConstraint object in the step where it is created.
setValuesInStep(stepName[, v1, v2, v3, vr1, ...])	This method modifies the propagating data for an existing VelocityAdaptiveMeshConstraint object in the specified step.

Inherited from AdaptiveMeshConstraint

__init__(name, createStepName, region[, v1, ...])	This method creates a VelocityAdaptiveMeshConstraint object.
deactivate(stepName)	This method deactivates the adaptive mesh constraint in the specified step and all subsequent steps.
move(fromStepName, toStepName)	This method moves the adaptive mesh constraint state from one step to a different step.
reset(stepName)	This method resets the adaptive mesh constraint state of the specified step to the state of the previous analysis step.
resume()	This method resumes the adaptive mesh constraint that was previously suppressed.
suppress()	This method suppresses the adaptive mesh constraint.
delete(indices)	This method allows you to delete existing adaptive mesh constraints.

---

category: Optional[SymbolicConstant] = None

A SymbolicConstant specifying the category of the adaptive mesh constraint. Possible values are MECHANICAL and THERMAL.

localCsys: Optional[str] = None

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

name: str = ''

A String specifying the adaptive mesh constraint repository key.

region: Region = <abaqus.Region.Region.Region object>

A Region object specifying the region to which the adaptive mesh constraint is applied.

setValues(v1=abaqusConstants.UNSET, v2=abaqusConstants.UNSET, v3=abaqusConstants.UNSET, vr1=abaqusConstants.UNSET, vr2=abaqusConstants.UNSET, vr3=abaqusConstants.UNSET, amplitude=abaqusConstants.UNSET, localCsys=None, motionType=abaqusConstants.INDEPENDENT)

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

Note

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

Parameters:

• v1 (Union[SymbolicConstant, float], default: 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 (Union[SymbolicConstant, float], default: 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 (Union[SymbolicConstant, float], default: 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 (Union[SymbolicConstant, float], default: 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 (Union[SymbolicConstant, float], default: 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 (Union[SymbolicConstant, float], default: 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 (str, default: UNSET) – A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the adaptive mesh constraint 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 (Optional[str], default: None) – None or a DatumCsys object specifying the local coordinate system of the adaptive mesh constraint’s degrees of freedom. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

• motionType (SymbolicConstant, default: INDEPENDENT) – A SymbolicConstant specifying the mesh motion in relation to the underlying material. Possible values are INDEPENDENT, FOLLOW and USER_DEFINED. The default value is INDEPENDENT.

setValuesInStep(stepName, v1=None, v2=None, v3=None, vr1=None, vr2=None, vr3=None, amplitude='')

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

Note

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

Parameters:

• stepName (str) – A String specifying the name of the step in which the adaptive mesh constraint is modified.

• v1 (Union[SymbolicConstant, float, None], default: None) – A Float or a SymbolicConstant specifying the velocity component in the 1-direction. Possible values for the SymbolicConstant are SET and FREED.

• v2 (Union[SymbolicConstant, float, None], default: None) – A Float or a SymbolicConstant specifying the velocity component in the 2-direction. Possible values for the SymbolicConstant are SET and FREED.

• v3 (Union[SymbolicConstant, float, None], default: None) – A Float or a SymbolicConstant specifying the velocity component in the 3-direction. Possible values for the SymbolicConstant are SET and FREED.

• vr1 (Union[SymbolicConstant, float, None], default: None) – A Float or a SymbolicConstant specifying the rotational velocity component about the 1-direction. Possible values for the SymbolicConstant are SET and FREED.

• vr2 (Union[SymbolicConstant, float, None], default: None) – A Float or a SymbolicConstant specifying the rotational velocity component about the 2-direction. Possible values for the SymbolicConstant are SET and FREED.

• vr3 (Union[SymbolicConstant, float, None], default: None) – A Float or a SymbolicConstant specifying the rotational velocity component about the 3-direction. Possible values for the SymbolicConstant are SET and FREED.

• amplitude (str, default: '') – 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 adaptive mesh constraint is changed to have no amplitude reference. You should provide the amplitude argument only if it is valid for the specified step.

VelocityAdaptiveMeshConstraintState

class VelocityAdaptiveMeshConstraintState(v1=None, v2=None, v3=None, vr1=None, vr2=None, vr3=None, v1State=None, v2State=None, v3State=None, vr1State=None, vr2State=None, vr3State=None, amplitudeState=None, status=None, amplitude='')

The VelocityAdaptiveMeshConstraintState object stores the propagating data for an Arbitrary Lagrangian Eularian (ALE) style velocity adaptive mesh constraint in a step. One instance of this object is created internally by the VelocityAdaptiveMeshConstraint object for each step. The instance is also deleted internally by the VelocityAdaptiveMeshConstraint object. The VelocityAdaptiveMeshConstraintState object has no constructor or methods. The VelocityAdaptiveMeshConstraintState object is derived from the AdaptiveMeshConstraintState object.

Note

This object can be accessed by:

import step
mdb.models[name].steps[name].adaptiveMeshConstraintStates[name]

The corresponding analysis keywords are:

• ADAPTIVE MESH CONSTRAINT

Note

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

Public Data Attributes:

v1	A Float specifying the velocity component in the 1-direction.
v2	A Float specifying the velocity component in the 2-direction.
v3	A Float specifying the velocity component in the 3-direction.
vr1	A Float specifying the rotational velocity component about the 1-direction.
vr2	A Float specifying the rotational velocity component about the 2-direction.
vr3	A Float specifying the rotational velocity component about the 3-direction.
v1State	A SymbolicConstant specifying the propagation state of the velocity component in the 1-direction.
v2State	A SymbolicConstant specifying the propagation state of the velocity component in the 2-direction.
v3State	A SymbolicConstant specifying the propagation state of the velocity component in the 3-direction.
vr1State	A SymbolicConstant specifying the propagation state of the rotational velocity component about the 1-direction.
vr2State	A SymbolicConstant specifying the propagation state of the rotational velocity component about the 2-direction.
vr3State	A SymbolicConstant specifying the propagation state of the rotational velocity component about the 3-direction.
amplitudeState	A SymbolicConstant specifying the propagation state of the amplitude reference.
status	A SymbolicConstant specifying the propagation state of the AdaptiveMeshConstraintState object.
amplitude	A String specifying the name of the amplitude reference.

Inherited from AdaptiveMeshConstraintState

amplitudeState	A SymbolicConstant specifying the propagation state of the amplitude reference.
status	A SymbolicConstant specifying the propagation state of the AdaptiveMeshConstraintState object.
amplitude	A String specifying the name of the amplitude reference.

Public Methods:

__init__([v1, v2, v3, vr1, vr2, vr3, ...])

The VelocityAdaptiveMeshConstraintState object stores the propagating data for an Arbitrary Lagrangian Eularian (ALE) style velocity adaptive mesh constraint in a step.

Inherited from AdaptiveMeshConstraintState

__init__([v1, v2, v3, vr1, vr2, vr3, ...])

The VelocityAdaptiveMeshConstraintState object stores the propagating data for an Arbitrary Lagrangian Eularian (ALE) style velocity adaptive mesh constraint in a step.

---

amplitude: str = ''

A String specifying the name of the amplitude reference. The String is empty if the adaptive mesh constraint has no amplitude reference.

amplitudeState: Optional[SymbolicConstant] = None

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

status: Optional[SymbolicConstant] = None

A SymbolicConstant specifying the propagation state of the AdaptiveMeshConstraintState 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: Optional[float] = None

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

v1State: Optional[SymbolicConstant] = None

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

v2: Optional[float] = None

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

v2State: Optional[SymbolicConstant] = None

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

v3: Optional[float] = None

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

v3State: Optional[SymbolicConstant] = None

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

vr1: Optional[float] = None

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

vr1State: Optional[SymbolicConstant] = None

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: Optional[float] = None

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

vr2State: Optional[SymbolicConstant] = None

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: Optional[float] = None

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

vr3State: Optional[SymbolicConstant] = None

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