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: str, description: str = '', stefanBoltzmann: float | None = None, absoluteZero: float | None = None, waveFormulation: SymbolicConstantType = 'NOT_SET', modelType: SymbolicConstantType = 'STANDARD_EXPLICIT', universalGas: float | None = None, copyConstraints: BooleanType = 1, copyConnectors: BooleanType = 1, copyInteractions: BooleanType = 1)[source]#

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

Notes

This object can be accessed by:

mdb.models[name]

Methods

`AdaptiveMeshConstraint`([name, category, ...])	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.
`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: str = '', category: ~abaqusConstants.SymbolicConstantType | None = None, region: ~abaqus.Region.Region.Region = <abaqus.Region.Region.Region object>, localCsys: ~abaqus.Datum.DatumCsys.DatumCsys | None = None) → AdaptiveMeshConstraint[source]#

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.

Parameters:

name: A String specifying the adaptive mesh constraint repository key.
category: A SymbolicConstant specifying the category of the adaptive mesh constraint. Possible values are MECHANICAL and THERMAL.
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. If *localCsys*=None, the degrees of freedom are defined in the global coordinate system. The default value is None.

Notes

This function can be accessed by:

mdb.models[name].AdaptiveMeshConstraint

AdaptiveMeshControl(name: str, remapping: SymbolicConstantType = 'SECOND_ORDER_ADVECTION', smoothingAlgorithm: SymbolicConstantType = 'GEOMETRY_ENHANCED', smoothingPriority: SymbolicConstantType = 'UNIFORM', initialFeatureAngle: float = 30, transitionFeatureAngle: float = 30, momentumAdvection: SymbolicConstantType = 'ELEMENT_CENTER_PROJECTION', meshingPredictor: SymbolicConstantType = 'CURRENT', curvatureRefinement: float = 1, volumetricSmoothingWeight: float = 1, laplacianSmoothingWeight: float = 0, equipotentialSmoothingWeight: float = 0, meshConstraintAngle: float = 60, originalConfigurationProjectionWeight: float = 1, standardVolumetricSmoothingWeight: float = 0) → AdaptiveMeshControl[source]#

This method creates an AdaptiveMeshControl object.

Parameters:

name: A String specifying the name of the object.
remapping: A SymbolicConstant specifying the remapping algorithm. Possible values are FIRST_ORDER_ADVECTION and SECOND_ORDER_ADVECTION. The default value is SECOND_ORDER_ADVECTION.
smoothingAlgorithm: A SymbolicConstant specifying the type of smoothing algorithm to use. Possible values are STANDARD and GEOMETRY_ENHANCED. The default value is GEOMETRY_ENHANCED.
smoothingPriority: A SymbolicConstant specifying the type of smoothing to perform. Possible values are UNIFORM and GRADED. The default value is UNIFORM.
initialFeatureAngle: A Float specifying the initial geometric feature angle, θI, in degrees. Possible values are 0° ≤θI≤ 180°. The default value is 30.0.
transitionFeatureAngle: A Float specifying the transitional feature angle, θT, in degrees. Possible values are 0° ≤θT≤ 180°. The default value is 30.0.
momentumAdvection: 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: A SymbolicConstant specifying the nodal starting location to use for remeshing. Possible values are CURRENT and PREVIOUS. The default value is CURRENT.
curvatureRefinement: A Float specifying the solution dependence weight, αC. Possible values are 0.0 ≤αC≤ 1.0. The default value is 1.0.
volumetricSmoothingWeight: A Float specifying the weight used by Abaqus/Explicit for the volumetric smoothing method. The default value is 1.0.
laplacianSmoothingWeight: A Float specifying the weight for the Laplacian smoothing method. The default value is 0.0.
equipotentialSmoothingWeight: A Float specifying the weight for the equipotential smoothing method. The default value is 0.0.
meshConstraintAngle: A Float specifying the initial geometric feature angle, θC. Possible values are 0° ≤θC≤ 180°. The default value is 60.0.
originalConfigurationProjectionWeight: A Float specifying the weight for the original configuration projection method. The default value is 1.0.
standardVolumetricSmoothingWeight: A Float specifying the weight used by Abaqus/Standard for the volumetric smoothing method. The default value is 0.0.

Returns:

An AdaptiveMeshControl object

Notes

This function can be accessed by:

mdb.models[name].AdaptiveMeshConstraint

DisplacementAdaptiveMeshConstraint(name: str, createStepName: str, region: Region, u1: SymbolicConstantType | float = 'UNSET', u2: SymbolicConstantType | float = 'UNSET', u3: SymbolicConstantType | float = 'UNSET', ur1: SymbolicConstantType | float = 'UNSET', ur2: SymbolicConstantType | float = 'UNSET', ur3: SymbolicConstantType | float = 'UNSET', amplitude: str = 'UNSET', motionType: SymbolicConstantType = 'INDEPENDENT', localCsys: str | None = None) → DisplacementAdaptiveMeshConstraint[source]#

This method creates a DisplacementAdaptiveMeshConstraint object.

Parameters:

name: A String specifying the adaptive mesh constraint repository key.
createStepName: A String specifying the name of the step in which the adaptive mesh constraint is created.
region: A Region object specifying the region to which the adaptive mesh constraint is applied.
u1: 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: 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: 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: 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: 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: 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: 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: 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: 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

Notes

This function can be accessed by:

mdb.models[name].AdaptiveMeshConstraint

RemeshingRule(name: str, stepName: str, variables: tuple, description: str = '', region: SymbolicConstantType = 'MODEL', sizingMethod: SymbolicConstantType = 'DEFAULT', errorTarget: float = 0, maxSolutionErrorTarget: float = 0, minSolutionErrorTarget: float = 0, meshBias: int = 0, minElementSize: float = 0, maxElementSize: float = 0, outputFrequency: SymbolicConstantType = 'LAST_INCREMENT', specifyMinSize: BooleanType = 0, specifyMaxSize: BooleanType = 1, coarseningFactor: SymbolicConstantType = 'DEFAULT_LIMIT', refinementFactor: SymbolicConstantType = 'DEFAULT_LIMIT', elementCountLimit: int | None = None) → RemeshingRule[source]#

This method creates a RemeshingRule object.

Parameters:

name: A String specifying the name of the object.
stepName: A String specifying the name of the step in which resizing should occur for this rule.
variables: A sequence of Strings specifying the output request variables that Abaqus will use as error indicators.
description: A String specifying a descriptive string for this rule. The default value is an empty string.
region: 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: 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: 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: 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: 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: 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: A Float specifying the minimum size of any single element. The default value is 0.0.
maxElementSize: A Float specifying the maximum size of any single element. The default value is 0.0.
outputFrequency: 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: 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: 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: 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: 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: 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

Notes

This function can be accessed by:

mdb.models[name].AdaptiveMeshConstraint

VelocityAdaptiveMeshConstraint(name: str, createStepName: str, region: Region, v1: SymbolicConstantType | float = 'UNSET', v2: SymbolicConstantType | float = 'UNSET', v3: SymbolicConstantType | float = 'UNSET', vr1: SymbolicConstantType | float = 'UNSET', vr2: SymbolicConstantType | float = 'UNSET', vr3: SymbolicConstantType | float = 'UNSET', amplitude: str = 'UNSET', localCsys: str | None = None, motionType: SymbolicConstantType = 'INDEPENDENT') → VelocityAdaptiveMeshConstraint[source]#

This method creates a VelocityAdaptiveMeshConstraint object.

Parameters:

name: A String specifying the adaptive mesh constraint repository key.
createStepName: A String specifying the name of the step in which the adaptive mesh constraint is created.
region: A Region object specifying the region to which the adaptive mesh constraint is applied.
v1: 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: 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: 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: 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: 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: 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: 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: 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: 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

Notes

This function can be accessed by:

mdb.models[name].AdaptiveMeshConstraint

adaptiveRemesh(odb: Odb)[source]#

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

Parameters:

odb: An Odb object containing error output field results.

Returns:

An AdaptivityIteration object.

Create adaptivity mesh state features#

class AdaptivityStep[source]#

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.

Notes

This object can be accessed by:

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

Methods

`AdaptiveMeshConstraintState`([...])	The AdaptiveMeshConstraintState object is the abstract base type for other Arbitrary Lagrangian Eularian (ALE) style AdaptiveMeshConstraintState objects.
`AdaptiveMeshDomain`(region[, controls, ...])	The AdaptiveMeshDomain object defines the region and controls that govern an Arbitrary Lagrangian Eularian (ALE) style adaptive smoothing mesh domain.
`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.

AdaptiveMeshConstraintState(amplitudeState: SymbolicConstantType | None = None, status: SymbolicConstantType | None = None, amplitude: str = '') → AdaptiveMeshConstraintState[source]#

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.

Parameters:

amplitudeState: A SymbolicConstant specifying the propagation state of the amplitude reference. Possible values are UNSET, SET, UNCHANGED, FREED, and MODIFIED.
status: 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: A String specifying the name of the amplitude reference. The String is empty if the adaptive mesh constraint has no amplitude reference.

Notes

This function can be accessed by:

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

AdaptiveMeshDomain(region: Region, controls: str = '', frequency: int = 10, initialMeshSweeps: int = 5, meshSweeps: int = 1) → AdaptiveMeshDomain[source]#

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.

Parameters:

region: A Region object specifying the region to which the adaptive mesh domain is applied.
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. The default value is 10.
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. The default value is 5.
meshSweeps: 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

Notes

This function can be accessed by:

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

DisplacementAdaptiveMeshConstraintState(u1: float | None = None, u2: float | None = None, u3: float | None = None, ur1: float | None = None, ur2: float | None = None, ur3: float | None = None, u1State: SymbolicConstantType | None = None, u2State: SymbolicConstantType | None = None, u3State: SymbolicConstantType | None = None, ur1State: SymbolicConstantType | None = None, ur2State: SymbolicConstantType | None = None, ur3State: SymbolicConstantType | None = None, amplitudeState: SymbolicConstantType | None = None, status: SymbolicConstantType | None = None, amplitude: str = '') → DisplacementAdaptiveMeshConstraintState[source]#

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.

Parameters:

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. Possible values are UNSET, SET, UNCHANGED, FREED, and MODIFIED.
u2State: A SymbolicConstant specifying the propagation state of the displacement component in the 2-direction. Possible values are UNSET, SET, UNCHANGED, FREED, and MODIFIED.
u3State: A SymbolicConstant specifying the propagation state of the displacement component in the 3-direction. Possible values are UNSET, SET, UNCHANGED, FREED, and MODIFIED.
ur1State: 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: 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: 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: A SymbolicConstant specifying the propagation state of the amplitude reference. Possible values are UNSET, SET, UNCHANGED, FREED, and MODIFIED.
status: 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: A String specifying the name of the amplitude reference. The String is empty if the adaptive mesh constraint has no amplitude reference.

Notes

This function can be accessed by:

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

VelocityAdaptiveMeshConstraintState(v1: float | None = None, v2: float | None = None, v3: float | None = None, vr1: float | None = None, vr2: float | None = None, vr3: float | None = None, v1State: SymbolicConstantType | None = None, v2State: SymbolicConstantType | None = None, v3State: SymbolicConstantType | None = None, vr1State: SymbolicConstantType | None = None, vr2State: SymbolicConstantType | None = None, vr3State: SymbolicConstantType | None = None, amplitudeState: SymbolicConstantType | None = None, status: SymbolicConstantType | None = None, amplitude: str = '') → VelocityAdaptiveMeshConstraintState[source]#

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.

Parameters:

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. Possible values are UNSET, SET, UNCHANGED, FREED, and MODIFIED.
v2State: A SymbolicConstant specifying the propagation state of the velocity component in the 2-direction. Possible values are UNSET, SET, UNCHANGED, FREED, and MODIFIED.
v3State: A SymbolicConstant specifying the propagation state of the velocity component in the 3-direction. Possible values are UNSET, SET, UNCHANGED, FREED, and MODIFIED.
vr1State: 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: 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: 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: A SymbolicConstant specifying the propagation state of the amplitude reference. Possible values are UNSET, SET, UNCHANGED, FREED, and MODIFIED.
status: 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: A String specifying the name of the amplitude reference. The String is empty if the adaptive mesh constraint has no amplitude reference.

Notes

This function can be accessed by:

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

Create features for AdaptivityIteration#

class RuleResult(name: str, indicatorResults: dict[str, abaqus.Adaptivity.RuleResult.ErrorIndicatorResult], numElems: int, minSizeElemCount: int, satisfiedVars: tuple = ())[source]#

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

Notes

This object can be accessed by:

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

Object Features#

AdaptiveMeshConstraint#

class AdaptiveMeshConstraint(name: str = '', category: ~abaqusConstants.SymbolicConstantType | None = None, region: ~abaqus.Region.Region.Region = <abaqus.Region.Region.Region object>, localCsys: ~abaqus.Datum.DatumCsys.DatumCsys | None = None)[source]#

Notes

This object can be accessed by:

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

Attributes:

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: DatumCsys: 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.

Methods

`deactivate`(stepName)	This method deactivates the adaptive mesh constraint in the specified step and all subsequent steps.
`delete`(indices)	This method allows you to delete existing adaptive mesh constraints.
`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.

deactivate(stepName: str)[source]#

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

Parameters:

stepName: A String specifying the name of the step in which the adaptive mesh constraint is deactivated.

Raises:

TextError.

delete(indices: tuple)[source]#

This method allows you to delete existing adaptive mesh constraints.

Parameters:

indices: A sequence of Ints specifying the index of each adaptive mesh constraint to delete.

move(fromStepName: str, toStepName: str)[source]#

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

Parameters:

fromStepName: A String specifying the name of the step from which the adaptive mesh constraint state is moved.
toStepName: A String specifying the name of the step to which the adaptive mesh constraint state is moved.

Raises:

TextError.

reset(stepName: str)[source]#

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

Parameters:

stepName: A String specifying the name of the step in which the adaptive mesh constraint state is reset.

Raises:

TextError.

resume()[source]#: This method resumes the adaptive mesh constraint that was previously suppressed.

suppress()[source]#: This method suppresses the adaptive mesh constraint.

AdaptiveMeshConstraintState#

class AdaptiveMeshConstraintState(amplitudeState: SymbolicConstantType | None = None, status: SymbolicConstantType | None = None, amplitude: str = '')[source]#

Notes

This object can be accessed by:

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

Attributes:

amplitudeState: SymbolicConstant

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

status: SymbolicConstant

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

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

AdaptiveMeshControl#

class AdaptiveMeshControl(name: str, remapping: SymbolicConstantType = 'SECOND_ORDER_ADVECTION', smoothingAlgorithm: SymbolicConstantType = 'GEOMETRY_ENHANCED', smoothingPriority: SymbolicConstantType = 'UNIFORM', initialFeatureAngle: float = 30, transitionFeatureAngle: float = 30, momentumAdvection: SymbolicConstantType = 'ELEMENT_CENTER_PROJECTION', meshingPredictor: SymbolicConstantType = 'CURRENT', curvatureRefinement: float = 1, volumetricSmoothingWeight: float = 1, laplacianSmoothingWeight: float = 0, equipotentialSmoothingWeight: float = 0, meshConstraintAngle: float = 60, originalConfigurationProjectionWeight: float = 1, standardVolumetricSmoothingWeight: float = 0)[source]#

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.

Notes

This object can be accessed by:

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

Methods

setValues([remapping, smoothingAlgorithm, ...])

This method modifies the AdaptiveMeshControl object.

setValues(remapping: SymbolicConstantType = 'SECOND_ORDER_ADVECTION', smoothingAlgorithm: SymbolicConstantType = 'GEOMETRY_ENHANCED', smoothingPriority: SymbolicConstantType = 'UNIFORM', initialFeatureAngle: float = 30, transitionFeatureAngle: float = 30, momentumAdvection: SymbolicConstantType = 'ELEMENT_CENTER_PROJECTION', meshingPredictor: SymbolicConstantType = 'CURRENT', curvatureRefinement: float = 1, volumetricSmoothingWeight: float = 1, laplacianSmoothingWeight: float = 0, equipotentialSmoothingWeight: float = 0, meshConstraintAngle: float = 60, originalConfigurationProjectionWeight: float = 1, standardVolumetricSmoothingWeight: float = 0)[source]#

This method modifies the AdaptiveMeshControl object.

Parameters:

remapping: A SymbolicConstant specifying the remapping algorithm. Possible values are FIRST_ORDER_ADVECTION and SECOND_ORDER_ADVECTION. The default value is SECOND_ORDER_ADVECTION.
smoothingAlgorithm: A SymbolicConstant specifying the type of smoothing algorithm to use. Possible values are STANDARD and GEOMETRY_ENHANCED. The default value is GEOMETRY_ENHANCED.
smoothingPriority: A SymbolicConstant specifying the type of smoothing to perform. Possible values are UNIFORM and GRADED. The default value is UNIFORM.
initialFeatureAngle: A Float specifying the initial geometric feature angle, θI, in degrees. Possible values are 0° ≤θI≤ 180°. The default value is 30.0.
transitionFeatureAngle: A Float specifying the transitional feature angle, θT, in degrees. Possible values are 0° ≤θT≤ 180°. The default value is 30.0.
momentumAdvection: 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: A SymbolicConstant specifying the nodal starting location to use for remeshing. Possible values are CURRENT and PREVIOUS. The default value is CURRENT.
curvatureRefinement: A Float specifying the solution dependence weight, αC. Possible values are 0.0 ≤αC≤ 1.0. The default value is 1.0.
volumetricSmoothingWeight: A Float specifying the weight used by Abaqus/Explicit for the volumetric smoothing method. The default value is 1.0.
laplacianSmoothingWeight: A Float specifying the weight for the Laplacian smoothing method. The default value is 0.0.
equipotentialSmoothingWeight: A Float specifying the weight for the equipotential smoothing method. The default value is 0.0.
meshConstraintAngle: A Float specifying the initial geometric feature angle, θC. Possible values are 0° ≤θC≤ 180°. The default value is 60.0.
originalConfigurationProjectionWeight: A Float specifying the weight for the original configuration projection method. The default value is 1.0.
standardVolumetricSmoothingWeight: A Float specifying the weight used by Abaqus/Standard for the volumetric smoothing method. The default value is 0.0.

Raises:

RangeError

AdaptiveMeshDomain#

class AdaptiveMeshDomain(region: Region, controls: str = '', frequency: int = 10, initialMeshSweeps: int = 5, meshSweeps: int = 1)[source]#

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

Notes

This object can be accessed by:

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

Methods

setValues()

This method modifies the AdaptiveMeshDomain object.

setValues()[source]#

This method modifies the AdaptiveMeshDomain object.

Raises:

RangeError

AdaptivityIteration#

class AdaptivityIteration(iteration: int, jobName: str, modelName: str, odbPath: str, remeshingErrors: int)[source]#

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

Notes

This object can be accessed by:

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

Attributes:

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.

Methods

`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: str, results: str) → ErrorIndicatorResult[source]#

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

Parameters:

name: A String specifying the name of the error indicator variable to which these results correspond.
results: 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.

Raises:

AbaqusException.

Notes

This function can be accessed by:

mdb.adaptivityProcesses[name].AdaptivityIteration

RuleResult(name: str, indicatorResults: dict[str, abaqus.Adaptivity.AdaptivityIteration.AdaptivityIteration.ErrorIndicatorResult], numElems: int, minSizeElemCount: int, satisfiedVars: tuple = ()) → RuleResult[source]#

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

Parameters:

name: A String specifying the name of the Remeshing Rule to which these results correspond.
indicatorResults: A repository of ErrorIndicatorResult objects specifying the calculated results from the sizing function corresponding to the error indicator variables for the Remeshing Rule.
numElems: An Int specifying the number of elements before remeshing in the region of the Remeshing Rule.
minSizeElemCount: An Int specifying the number of elements that were constrained to the minimum element size by the Remeshing Rule.
satisfiedVars: A sequence of Strings specifying the error indicator variables that have satisfied the Remeshing Rule.

Returns:

A RuleResult object.

Raises:

AbaqusException.

Notes

This function can be accessed by:

mdb.adaptivityProcesses[name].AdaptivityIteration

AdaptivityProcess#

class AdaptivityProcess(name: str, job: ModelJob, maxIterations: int = 3, jobPrefix: str = '')[source]#

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

Notes

This object can be accessed by:

import job
mdb.adaptivityProcesses[name]

Attributes:

status: SymbolicConstant: A SymbolicConstant specifying the status of the adaptivity process. Possible values are SUBMITTED, RUNNING, ABORTED, TERMINATED, and COMPLETED.
iterations: dict[int, AdaptivityIteration]: A repository of AdaptivityIteration.:py:class:~abaqus.Adaptivity.AdaptivityIteration.AdaptivityIteration` objects specifying the AdaptivityIteration.:py:class:~abaqus.Adaptivity.AdaptivityIteration.AdaptivityIteration` objects received during running the adaptivity process.

Methods

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

AdaptivityIteration(iteration: int, jobName: str, modelName: str, odbPath: str, remeshingErrors: int) → AdaptivityIteration[source]#

This method creates an AdaptivityIteration object.

Parameters:

iteration: An Int specifying the sequence number for this iteration in the adaptivity process.
jobName: A String specifying the name of the job that was run for this iteration.
modelName: A String specifying the name of the model that was analyzed and remeshed in this iteration.
odbPath: A String specifying the path to the ODB file that was created for this iteration.
remeshingErrors: 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.

Notes

This function can be accessed by:

mdb.AdaptivityProcess

setValues(maxIterations: int = 3, jobPrefix: str = '')[source]#

This method modifies the AdaptivityProcess object.

Parameters:

maxIterations: 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: 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.

submit(waitForCompletion: BooleanType = 0, datacheckJob: BooleanType = False, continueJob: BooleanType = False)[source]#

This method begins the process of analysis and adaptive remeshing.

Parameters:

waitForCompletion: A Boolean specifying whether to interrupt the execution of a script until the end of the adaptive remeshing process is reached.
datacheckJob: 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: 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: str, createStepName: str, region: Region, u1: SymbolicConstantType | float = 'UNSET', u2: SymbolicConstantType | float = 'UNSET', u3: SymbolicConstantType | float = 'UNSET', ur1: SymbolicConstantType | float = 'UNSET', ur2: SymbolicConstantType | float = 'UNSET', ur3: SymbolicConstantType | float = 'UNSET', amplitude: str = 'UNSET', motionType: SymbolicConstantType = 'INDEPENDENT', localCsys: str | None = None)[source]#

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

Notes

This object can be accessed by:

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

Attributes:

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: str: 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.

Methods

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

setValues(u1: SymbolicConstantType | float = 'UNSET', u2: SymbolicConstantType | float = 'UNSET', u3: SymbolicConstantType | float = 'UNSET', ur1: SymbolicConstantType | float = 'UNSET', ur2: SymbolicConstantType | float = 'UNSET', ur3: SymbolicConstantType | float = 'UNSET', amplitude: str = 'UNSET', motionType: SymbolicConstantType = 'INDEPENDENT', localCsys: str | None = None)[source]#

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

Parameters:

u1: 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: 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: 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: 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: 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: 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: 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: 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: 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.

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

Parameters:

stepName: A String specifying the name of the step in which the adaptive mesh constraint is modified.
u1: A Float or a SymbolicConstant specifying the displacement component in the 1-direction. Possible values for the SymbolicConstant are SET, UNCHANGED, and FREED.
u2: A Float or a SymbolicConstant specifying the displacement component in the 2-direction. Possible values for the SymbolicConstant are SET, UNCHANGED, and FREED.
u3: A Float or a SymbolicConstant specifying the displacement component in the 3-direction. Possible values for the SymbolicConstant are SET, UNCHANGED, and FREED.
ur1: 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: 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: 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: 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#

Notes

This object can be accessed by:

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

The corresponding analysis keywords are:

ADAPTIVE MESH CONSTRAINT

Attributes:

u1: float: A Float or a Complex specifying the displacement component in the 1-direction.
u2: float: A Float or a Complex specifying the displacement component in the 2-direction.
u3: float: A Float or a Complex specifying the displacement component in the 3-direction.
ur1: float: A Float or a Complex specifying the rotational displacement component about the 1-direction.
ur2: float: A Float or a Complex specifying the rotational displacement component about the 2-direction.
ur3: float: A Float or a Complex specifying the rotational displacement component about the 3-direction.
u1State: SymbolicConstant: A SymbolicConstant specifying the propagation state of the displacement component in the 1-direction. Possible values are UNSET, SET, UNCHANGED, FREED, and MODIFIED.
u2State: SymbolicConstant: A SymbolicConstant specifying the propagation state of the displacement component in the 2-direction. Possible values are UNSET, SET, UNCHANGED, FREED, and MODIFIED.
u3State: SymbolicConstant: A SymbolicConstant specifying the propagation state of the displacement component in the 3-direction. Possible values are UNSET, SET, UNCHANGED, FREED, and MODIFIED.
ur1State: SymbolicConstant: 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: SymbolicConstant: 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: SymbolicConstant: 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: SymbolicConstant: A SymbolicConstant specifying the propagation state of the amplitude reference. Possible values are UNSET, SET, UNCHANGED, FREED, and MODIFIED.
status: SymbolicConstant: 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: A String specifying the name of the amplitude reference. The String is empty if the adaptive mesh constraint has no amplitude reference.

ErrorIndicatorResult#

class ErrorIndicatorResult(name: str, results: str)[source]#

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

Notes

This object can be accessed by:

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

RemeshingRule#

class RemeshingRule(name: str, stepName: str, variables: tuple, description: str = '', region: SymbolicConstantType = 'MODEL', sizingMethod: SymbolicConstantType = 'DEFAULT', errorTarget: float = 0, maxSolutionErrorTarget: float = 0, minSolutionErrorTarget: float = 0, meshBias: int = 0, minElementSize: float = 0, maxElementSize: float = 0, outputFrequency: SymbolicConstantType = 'LAST_INCREMENT', specifyMinSize: BooleanType = 0, specifyMaxSize: BooleanType = 1, coarseningFactor: SymbolicConstantType = 'DEFAULT_LIMIT', refinementFactor: SymbolicConstantType = 'DEFAULT_LIMIT', elementCountLimit: int | None = None)[source]#

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

Notes

This object can be accessed by:

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

Attributes:

suppressed: Boolean: 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.

Methods

`resume`()	This method resumes the remeshing rule that was previously suppressed.
`setValues`([description, region, ...])	This method modifies the RemeshingRule object.
`suppress`()	This method suppresses the remeshing rule.

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

setValues(description: str = '', region: SymbolicConstantType = 'MODEL', sizingMethod: SymbolicConstantType = 'DEFAULT', errorTarget: float = 0, maxSolutionErrorTarget: float = 0, minSolutionErrorTarget: float = 0, meshBias: int = 0, minElementSize: float = 0, maxElementSize: float = 0, outputFrequency: SymbolicConstantType = 'LAST_INCREMENT', specifyMinSize: BooleanType = 0, specifyMaxSize: BooleanType = 1, coarseningFactor: SymbolicConstantType = 'DEFAULT_LIMIT', refinementFactor: SymbolicConstantType = 'DEFAULT_LIMIT', elementCountLimit: int | None = None)[source]#

This method modifies the RemeshingRule object.

Parameters:

description: A String specifying a descriptive string for this rule. The default value is an empty string.
region: 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: 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: 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: 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: 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: 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: A Float specifying the minimum size of any single element. The default value is 0.0.
maxElementSize: A Float specifying the maximum size of any single element. The default value is 0.0.
outputFrequency: 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: 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: 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: 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: 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: 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.

suppress()[source]#: This method suppresses the remeshing rule. Abaqus will not remesh regions where the rules are suppressed.

RuleResult#

class RuleResult(name: str, indicatorResults: dict[str, abaqus.Adaptivity.RuleResult.ErrorIndicatorResult], numElems: int, minSizeElemCount: int, satisfiedVars: tuple = ())[source]#

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

Notes

This object can be accessed by:

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

VelocityAdaptiveMeshConstraint#

class VelocityAdaptiveMeshConstraint(name: str, createStepName: str, region: Region, v1: SymbolicConstantType | float = 'UNSET', v2: SymbolicConstantType | float = 'UNSET', v3: SymbolicConstantType | float = 'UNSET', vr1: SymbolicConstantType | float = 'UNSET', vr2: SymbolicConstantType | float = 'UNSET', vr3: SymbolicConstantType | float = 'UNSET', amplitude: str = 'UNSET', localCsys: str | None = None, motionType: SymbolicConstantType = 'INDEPENDENT')[source]#

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.

Notes

This object can be accessed by:

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

Attributes:

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: str: 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.

Methods

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

setValues(v1: SymbolicConstantType | float = 'UNSET', v2: SymbolicConstantType | float = 'UNSET', v3: SymbolicConstantType | float = 'UNSET', vr1: SymbolicConstantType | float = 'UNSET', vr2: SymbolicConstantType | float = 'UNSET', vr3: SymbolicConstantType | float = 'UNSET', amplitude: str = 'UNSET', localCsys: str | None = None, motionType: SymbolicConstantType = 'INDEPENDENT')[source]#

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

Parameters:

v1: 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: 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: 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: 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: 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: 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: 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: 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: 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.

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

Parameters:

stepName: A String specifying the name of the step in which the adaptive mesh constraint is modified.
v1: A Float or a SymbolicConstant specifying the velocity component in the 1-direction. Possible values for the SymbolicConstant are SET and FREED.
v2: A Float or a SymbolicConstant specifying the velocity component in the 2-direction. Possible values for the SymbolicConstant are SET and FREED.
v3: A Float or a SymbolicConstant specifying the velocity component in the 3-direction. Possible values for the SymbolicConstant are SET and FREED.
vr1: A Float or a SymbolicConstant specifying the rotational velocity component about the 1-direction. Possible values for the SymbolicConstant are SET and FREED.
vr2: A Float or a SymbolicConstant specifying the rotational velocity component about the 2-direction. Possible values for the SymbolicConstant are SET and FREED.
vr3: A Float or a SymbolicConstant specifying the rotational velocity component about the 3-direction. Possible values for the SymbolicConstant are SET and FREED.
amplitude: A String or a SymbolicConstant specifying the name of the amplitude reference. Possible values for the SymbolicConstant are UNCHANGED and FREED. UNCHANGED should be used if the amplitude is propagated from the previous analysis step. FREED should be used if the 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#

Notes

This object can be accessed by:

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

The corresponding analysis keywords are:

ADAPTIVE MESH CONSTRAINT

Attributes:

v1: float: A Float specifying the velocity component in the 1-direction.
v2: float: A Float specifying the velocity component in the 2-direction.
v3: float: A Float specifying the velocity component in the 3-direction.
vr1: float: A Float specifying the rotational velocity component about the 1-direction.
vr2: float: A Float specifying the rotational velocity component about the 2-direction.
vr3: float: A Float specifying the rotational velocity component about the 3-direction.
v1State: SymbolicConstant: A SymbolicConstant specifying the propagation state of the velocity component in the 1-direction. Possible values are UNSET, SET, UNCHANGED, FREED, and MODIFIED.
v2State: SymbolicConstant: A SymbolicConstant specifying the propagation state of the velocity component in the 2-direction. Possible values are UNSET, SET, UNCHANGED, FREED, and MODIFIED.
v3State: SymbolicConstant: A SymbolicConstant specifying the propagation state of the velocity component in the 3-direction. Possible values are UNSET, SET, UNCHANGED, FREED, and MODIFIED.
vr1State: SymbolicConstant: 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: SymbolicConstant: 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: SymbolicConstant: 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: SymbolicConstant: A SymbolicConstant specifying the propagation state of the amplitude reference. Possible values are UNSET, SET, UNCHANGED, FREED, and MODIFIED.
status: SymbolicConstant: 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: A String specifying the name of the amplitude reference. The String is empty if the adaptive mesh constraint has no amplitude reference.