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=1, copyConnectors=1, copyInteractions=1)[source]๏ƒ

Bases: ModelBase

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

Note

This object can be accessed by:

mdb.models[name]

This method creates a Model object.

Note

This function can be accessed by:

mdb.Model
Parameters:
  • name (str) โ€“ A String specifying the repository key.

  • description (str, default: '') โ€“ A String specifying the purpose and contents of the Model object. The default value is an empty string.

  • stefanBoltzmann (Optional[float], default: None) โ€“ None or a Float specifying the Stefan-Boltzmann constant. The default value is None.

  • absoluteZero (Optional[float], default: None) โ€“ None or a Float specifying the absolute zero constant. The default value is None.

  • waveFormulation (Literal[SCATTERED, NOT_SET, TOTAL], default: NOT_SET) โ€“ A SymbolicConstant specifying the type of incident wave formulation to be used in acoustic problems. Possible values are NOT_SET, SCATTERED, and TOTAL. The default value is NOT_SET.

  • modelType (Literal[STANDARD_EXPLICIT, ELECTROMAGNETIC], default: STANDARD_EXPLICIT) โ€“ A SymbolicConstant specifying the analysis model type. Possible values are STANDARD_EXPLICIT and ELECTROMAGNETIC. The default is STANDARD_EXPLICIT.

  • universalGas (Optional[float], default: None) โ€“ None or a Float specifying the universal gas constant. The default value is None.

  • copyConstraints (Union[AbaqusBoolean, bool], default: 1) โ€“ A boolean specifying whether to copy the constraints created in the model to the model that instances this model. The default value is ON.

  • copyConnectors (Union[AbaqusBoolean, bool], default: 1) โ€“ A boolean specifying whether to copy the connectors created in the model to the model that instances this model. The default value is ON.

  • copyInteractions (Union[AbaqusBoolean, bool], default: 1) โ€“ A boolean specifying whether to copy the interactions created in the model to the model that instances this model. The default value is ON.

Returns:

A Model object.

Return type:

Model

Public Data Attributes:

Inherited from ModelBase

name

A String specifying the repository key.

stefanBoltzmann

None or a Float specifying the Stefan-Boltzmann constant.

absoluteZero

None or a Float specifying the absolute zero constant.

waveFormulation

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

universalGas

None or a Float specifying the universal gas constant.

noPartsInputFile

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

endRestartStep

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

shellToSolid

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

lastChangedCount

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

description

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

restartJob

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

restartStep

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

globalJob

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

copyConstraints

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

copyConnectors

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

copyInteractions

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

keywordBlock

A KeywordBlock object.

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.

restartIncrement

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

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.


Member Details:

AdaptiveMeshConstraint(name, category, region, localCsys=None)[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.

Note

This function can be accessed by:

mdb.models[name].AdaptiveMeshConstraint
Parameters:
  • name (str) โ€“ A String specifying the adaptive mesh constraint repository key.

  • category (Literal[THERMAL, MECHANICAL]) โ€“ 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)[source]๏ƒ

This method creates an AdaptiveMeshControl object.

Note

This function can be accessed by:

mdb.models[name].AdaptiveMeshConstraint
Parameters:
  • name (str) โ€“ A String specifying the name of the object.

  • remapping (Literal[SECOND_ORDER_ADVECTION, FIRST_ORDER_ADVECTION], 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 (Literal[GEOMETRY_ENHANCED, STANDARD], 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 (Literal[GRADED, UNIFORM], 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 (Literal[HALF_INDEX_SHIFT, ELEMENT_CENTER_PROJECTION], 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 (Literal[PREVIOUS, CURRENT], 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)[source]๏ƒ

This method creates a DisplacementAdaptiveMeshConstraint object.

Note

This function can be accessed by:

mdb.models[name].AdaptiveMeshConstraint
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[Literal[SET, UNSET], 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[Literal[SET, UNSET], 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[Literal[SET, UNSET], 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[Literal[SET, UNSET], 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[Literal[SET, UNSET], 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[Literal[SET, UNSET], 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 (Literal[USER_DEFINED, INDEPENDENT, FOLLOW], 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[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:

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=0, specifyMaxSize=1, coarseningFactor=abaqusConstants.DEFAULT_LIMIT, refinementFactor=abaqusConstants.DEFAULT_LIMIT, elementCountLimit=None)[source]๏ƒ

This method creates a RemeshingRule object.

Note

This function can be accessed by:

mdb.models[name].AdaptiveMeshConstraint
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 (Literal[MODEL], 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 (Literal[MINIMUM_MAXIMUM, DEFAULT, UNIFORM_ERROR], 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 (Literal[LAST_INCREMENT, ALL_INCREMENTS], 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: 0) โ€“ 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: 1) โ€“ 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 (Literal[NOT_ALLOWED, DEFAULT_LIMIT], 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 (Literal[NOT_ALLOWED, DEFAULT_LIMIT], 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)[source]๏ƒ

This method creates a VelocityAdaptiveMeshConstraint object.

Note

This function can be accessed by:

mdb.models[name].AdaptiveMeshConstraint
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[Literal[SET, UNSET], 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[Literal[SET, UNSET], 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[Literal[SET, UNSET], 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[Literal[SET, UNSET], 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[Literal[SET, UNSET], 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[Literal[SET, UNSET], 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[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.

  • motionType (Literal[USER_DEFINED, INDEPENDENT, FOLLOW], 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)[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 (Odb) โ€“ An Odb object containing error output field results.

Returns:

An AdaptivityIteration object.

Return type:

AdaptivityIteration

Create adaptivity mesh state features๏ƒ

class AdaptivityStep[source]๏ƒ

Bases: StepBase

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]

Public Data Attributes:

Inherited from StepBase

name

A String specifying the repository key.

perturbation

A Boolean specifying whether the step has a perturbation procedure type.

nonmechanical

A Boolean specifying whether the step has a mechanical procedure type.

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.

explicit

A SymbolicConstant specifying whether the step has an explicit procedure type (procedureType = ANNEAL, DYNAMIC_EXPLICIT, or DYNAMIC_TEMP_DISPLACEMENT).

procedureType

A SymbolicConstant specifying the Abaqus procedure.

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.


Member Details:

AdaptiveMeshConstraintState(amplitudeState=None, status=None, amplitude='')[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.

Note

This function can be accessed by:

mdb.models[name].steps[name].AdaptiveMeshConstraintState
Parameters:
  • amplitudeState (Optional[Literal[UNSET, SET, FREED, UNCHANGED, MODIFIED]], default: None) โ€“

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

    • UNSET

    • SET

    • UNCHANGED

    • FREED

    • MODIFIED

  • status (Optional[Literal[NOT_YET_ACTIVE, PROPAGATED_FROM_BASE_STATE, DEACTIVATED_FROM_BASE_STATE, DEACTIVATED, MODIFIED_FROM_BASE_STATE, PROPAGATED, NO_LONGER_ACTIVE, CREATED, INSTANCE_NOT_APPLICABLE, BUILT_INTO_MODES, TYPE_NOT_APPLICABLE, MODIFIED]], 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)[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.

Note

This function can be accessed by:

mdb.models[name].steps[name].AdaptiveMeshDomain
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='')[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.

Note

This function can be accessed by:

mdb.models[name].steps[name].DisplacementAdaptiveMeshConstraintState
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[Literal[UNSET, SET, FREED, UNCHANGED, MODIFIED]], 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[Literal[UNSET, SET, FREED, UNCHANGED, MODIFIED]], 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[Literal[UNSET, SET, FREED, UNCHANGED, MODIFIED]], 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[Literal[UNSET, SET, FREED, UNCHANGED, MODIFIED]], 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[Literal[UNSET, SET, FREED, UNCHANGED, MODIFIED]], 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[Literal[UNSET, SET, FREED, UNCHANGED, MODIFIED]], 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[Literal[UNSET, SET, FREED, UNCHANGED, MODIFIED]], default: None) โ€“ A SymbolicConstant specifying the propagation state of the amplitude reference. Possible values are UNSET, SET, UNCHANGED, FREED, and MODIFIED.

  • status (Optional[Literal[NOT_YET_ACTIVE, PROPAGATED_FROM_BASE_STATE, DEACTIVATED_FROM_BASE_STATE, DEACTIVATED, MODIFIED_FROM_BASE_STATE, PROPAGATED, NO_LONGER_ACTIVE, CREATED, INSTANCE_NOT_APPLICABLE, BUILT_INTO_MODES, TYPE_NOT_APPLICABLE, MODIFIED]], 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='')[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.

Note

This function can be accessed by:

mdb.models[name].steps[name].VelocityAdaptiveMeshConstraintState
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[Literal[UNSET, SET, FREED, UNCHANGED, MODIFIED]], 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[Literal[UNSET, SET, FREED, UNCHANGED, MODIFIED]], 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[Literal[UNSET, SET, FREED, UNCHANGED, MODIFIED]], 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[Literal[UNSET, SET, FREED, UNCHANGED, MODIFIED]], 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[Literal[UNSET, SET, FREED, UNCHANGED, MODIFIED]], 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[Literal[UNSET, SET, FREED, UNCHANGED, MODIFIED]], 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[Literal[UNSET, SET, FREED, UNCHANGED, MODIFIED]], default: None) โ€“ A SymbolicConstant specifying the propagation state of the amplitude reference. Possible values are UNSET, SET, UNCHANGED, FREED, and MODIFIED.

  • status (Optional[Literal[NOT_YET_ACTIVE, PROPAGATED_FROM_BASE_STATE, DEACTIVATED_FROM_BASE_STATE, DEACTIVATED, MODIFIED_FROM_BASE_STATE, PROPAGATED, NO_LONGER_ACTIVE, CREATED, INSTANCE_NOT_APPLICABLE, BUILT_INTO_MODES, TYPE_NOT_APPLICABLE, MODIFIED]], 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)[source]๏ƒ

Bases: object

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]

This method creates an AdaptivityIteration object.

Note

This function can be accessed by:

mdb.adaptivityProcesses[name].AdaptivityIteration
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

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.

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.

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.


Member Details:

ErrorIndicatorResult(name, results)[source]๏ƒ

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
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=())[source]๏ƒ

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
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[source]๏ƒ

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

jobName: str[source]๏ƒ

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

modelName: str[source]๏ƒ

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

odbPath: str[source]๏ƒ

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

remeshingErrors: int[source]๏ƒ

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] = {}[source]๏ƒ

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

Other Classes๏ƒ

class AdaptiveMeshConstraint(name, category, region, localCsys=None)[source]๏ƒ

Bases: object

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]

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
Parameters:
  • name (str) โ€“ A String specifying the adaptive mesh constraint repository key.

  • category (Literal[THERMAL, MECHANICAL]) โ€“ 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.

Member Details:

category: SymbolicConstant[source]๏ƒ

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

deactivate(stepName)[source]๏ƒ

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

Parameters:

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

Raises:

TextError โ€“

delete(indices)[source]๏ƒ

This method allows you to delete existing adaptive mesh constraints.

Parameters:

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

localCsys: Optional[DatumCsys] = <abaqus.Datum.DatumCsys.DatumCsys object>[source]๏ƒ

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)[source]๏ƒ

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

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 = ''[source]๏ƒ

A String specifying the adaptive mesh constraint repository key.

region: Region = <abaqus.Region.Region.Region object>[source]๏ƒ

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

reset(stepName)[source]๏ƒ

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

Parameters:

stepName (str) โ€“ 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.

class AdaptiveMeshConstraintState(amplitudeState=None, status=None, amplitude='')[source]๏ƒ

Bases: object

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]

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
Parameters:
  • amplitudeState (Optional[Literal[UNSET, SET, FREED, UNCHANGED, MODIFIED]], default: None) โ€“ A SymbolicConstant specifying the propagation state of the amplitude reference. Possible values are UNSET, SET, UNCHANGED, FREED, and MODIFIED.

  • status (Optional[Literal[NOT_YET_ACTIVE, PROPAGATED_FROM_BASE_STATE, DEACTIVATED_FROM_BASE_STATE, DEACTIVATED, MODIFIED_FROM_BASE_STATE, PROPAGATED, NO_LONGER_ACTIVE, CREATED, INSTANCE_NOT_APPLICABLE, BUILT_INTO_MODES, TYPE_NOT_APPLICABLE, MODIFIED]], 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.

Member Details:

amplitude: str = ''[source]๏ƒ

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

amplitudeState: SymbolicConstant[source]๏ƒ

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

status: SymbolicConstant[source]๏ƒ

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

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)[source]๏ƒ

Bases: object

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]

This method creates an AdaptiveMeshControl object.

Note

This function can be accessed by:

mdb.models[name].AdaptiveMeshControl
Parameters:
  • name (str) โ€“ A String specifying the name of the object.

  • remapping (Literal[SECOND_ORDER_ADVECTION, FIRST_ORDER_ADVECTION], 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 (Literal[GEOMETRY_ENHANCED, STANDARD], 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 (Literal[GRADED, UNIFORM], 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 (Literal[HALF_INDEX_SHIFT, ELEMENT_CENTER_PROJECTION], 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 (Literal[PREVIOUS, CURRENT], 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.

Returns:

An AdaptiveMeshControl object.

Return type:

AdaptiveMeshControl

Raises:

RangeError โ€“

Member Details:

curvatureRefinement: float = 1[source]๏ƒ

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[source]๏ƒ

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

initialFeatureAngle: float = 30[source]๏ƒ

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[source]๏ƒ

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

meshConstraintAngle: float = 60[source]๏ƒ

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'[source]๏ƒ

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'[source]๏ƒ

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[source]๏ƒ

A String specifying the name of the object.

originalConfigurationProjectionWeight: float = 1[source]๏ƒ

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

remapping: SymbolicConstant = 'SECOND_ORDER_ADVECTION'[source]๏ƒ

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)[source]๏ƒ

This method modifies the AdaptiveMeshControl object.

Parameters:
  • remapping (Literal[SECOND_ORDER_ADVECTION, FIRST_ORDER_ADVECTION], 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 (Literal[GEOMETRY_ENHANCED, STANDARD], 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 (Literal[GRADED, UNIFORM], 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 (Literal[HALF_INDEX_SHIFT, ELEMENT_CENTER_PROJECTION], 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 (Literal[PREVIOUS, CURRENT], 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'[source]๏ƒ

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'[source]๏ƒ

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

standardVolumetricSmoothingWeight: float = 0[source]๏ƒ

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

transitionFeatureAngle: float = 30[source]๏ƒ

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[source]๏ƒ

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

class AdaptiveMeshDomain(region, controls='', frequency=10, initialMeshSweeps=5, meshSweeps=1)[source]๏ƒ

Bases: object

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]

This method creates an AdaptiveMeshDomain object.

Note

This function can be accessed by:

mdb.models[name].steps[name].AdaptiveMeshDomain
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

Raises:

RangeError โ€“

Member Details:

controls: str = ''[source]๏ƒ

A String specifying the name of an AdaptiveMeshControl object.

frequency: int = 10[source]๏ƒ

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

initialMeshSweeps: int = 5[source]๏ƒ

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[source]๏ƒ

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

region: Region[source]๏ƒ

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

setValues(*args, **kwargs)[source]๏ƒ

This method modifies the AdaptiveMeshDomain object.

Raises:

RangeError โ€“

class ErrorIndicatorResult[source]๏ƒ

Bases: object

Member Details:

class RuleResult(name, indicatorResults, numElems, minSizeElemCount, satisfiedVars=())[source]๏ƒ

Bases: object

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]

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].iterations[i].RuleResult
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 โ€“

Member Details:

indicatorResults: dict[str, ErrorIndicatorResult][source]๏ƒ

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[source]๏ƒ

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

name: str[source]๏ƒ

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

numElems: int[source]๏ƒ

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

satisfiedVars: tuple = ()[source]๏ƒ

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

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)[source]๏ƒ

Bases: AdaptiveMeshConstraint

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]

This method creates a DisplacementAdaptiveMeshConstraint object.

Note

This function can be accessed by:

mdb.models[name].DisplacementAdaptiveMeshConstraint
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[Literal[SET, UNSET], 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[Literal[SET, UNSET], 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[Literal[SET, UNSET], 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[Literal[SET, UNSET], 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[Literal[SET, UNSET], 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[Literal[SET, UNSET], 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 (Literal[USER_DEFINED, INDEPENDENT, FOLLOW], 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[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:

A DisplacementAdaptiveMeshConstraint object.

Return type:

DisplacementAdaptiveMeshConstraint

Member Details:

category: SymbolicConstant[source]๏ƒ

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

localCsys: Optional[DatumCsys] = <abaqus.Datum.DatumCsys.DatumCsys object>[source]๏ƒ

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 = ''[source]๏ƒ

A String specifying the adaptive mesh constraint repository key.

region: Region = <abaqus.Region.Region.Region object>[source]๏ƒ

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)[source]๏ƒ

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

Parameters:
  • u1 (Union[Literal[SET, UNSET], 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[Literal[SET, UNSET], 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[Literal[SET, UNSET], 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[Literal[SET, UNSET], 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[Literal[SET, UNSET], 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[Literal[SET, UNSET], 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 (Literal[USER_DEFINED, INDEPENDENT, FOLLOW], 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='')[source]๏ƒ

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

Parameters:
  • stepName (str) โ€“ A String specifying the name of the step in which the adaptive mesh constraint is modified.

  • u1 (Union[Literal[SET, FREED, UNCHANGED], 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[Literal[SET, FREED, UNCHANGED], 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[Literal[SET, FREED, UNCHANGED], 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[Literal[SET, FREED, UNCHANGED], 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[Literal[SET, FREED, UNCHANGED], 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[Literal[SET, FREED, UNCHANGED], 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.

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=0, specifyMaxSize=1, coarseningFactor=abaqusConstants.DEFAULT_LIMIT, refinementFactor=abaqusConstants.DEFAULT_LIMIT, elementCountLimit=None)[source]๏ƒ

Bases: object

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]

This method creates a RemeshingRule object.

Note

This function can be accessed by:

mdb.models[name].RemeshingRule
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 (Literal[MODEL], 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 (Literal[MINIMUM_MAXIMUM, DEFAULT, UNIFORM_ERROR], 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 (Literal[LAST_INCREMENT, ALL_INCREMENTS], 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: 0) โ€“ 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: 1) โ€“ 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 (Literal[NOT_ALLOWED, DEFAULT_LIMIT], 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 (Literal[NOT_ALLOWED, DEFAULT_LIMIT], 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

Raises:

AbaqusException โ€“

Member Details:

coarseningFactor: SymbolicConstant = 'DEFAULT_LIMIT'[source]๏ƒ

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 = ''[source]๏ƒ

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

elementCountLimit: Optional[int] = None[source]๏ƒ

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[source]๏ƒ

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[source]๏ƒ

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

maxSolutionErrorTarget: float = 0[source]๏ƒ

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[source]๏ƒ

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[source]๏ƒ

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

minSolutionErrorTarget: float = 0[source]๏ƒ

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[source]๏ƒ

A String specifying the name of the object.

outputFrequency: SymbolicConstant = 'LAST_INCREMENT'[source]๏ƒ

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'[source]๏ƒ

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'[source]๏ƒ

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()[source]๏ƒ

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=0, specifyMaxSize=1, coarseningFactor=abaqusConstants.DEFAULT_LIMIT, refinementFactor=abaqusConstants.DEFAULT_LIMIT, elementCountLimit=None)[source]๏ƒ

This method modifies the RemeshingRule object.

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

  • region (Literal[MODEL], 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 (Literal[MINIMUM_MAXIMUM, DEFAULT, UNIFORM_ERROR], 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 (Literal[LAST_INCREMENT, ALL_INCREMENTS], 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: 0) โ€“ 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: 1) โ€“ 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 (Literal[NOT_ALLOWED, DEFAULT_LIMIT], 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 (Literal[NOT_ALLOWED, DEFAULT_LIMIT], 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'[source]๏ƒ

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] = 1[source]๏ƒ

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] = 0[source]๏ƒ

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[source]๏ƒ

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

suppress()[source]๏ƒ

This method suppresses the remeshing rule.

Abaqus will not remesh regions where the rules are suppressed.

suppressed: Union[AbaqusBoolean, bool] = 0[source]๏ƒ

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[source]๏ƒ

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

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)[source]๏ƒ

Bases: AdaptiveMeshConstraint

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]

This method creates a VelocityAdaptiveMeshConstraint object.

Note

This function can be accessed by:

mdb.models[name].VelocityAdaptiveMeshConstraint
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[float, Literal[SET, UNSET]], 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[float, Literal[SET, UNSET]], 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[float, Literal[SET, UNSET]], 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[float, Literal[SET, UNSET]], 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[float, Literal[SET, UNSET]], 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[float, Literal[SET, UNSET]], 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 (Union[str, Literal[UNSET]], 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[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.

  • motionType (Literal[INDEPENDENT, FOLLOW, USER_DEFINED], 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

Member Details:

category: Literal[MECHANICAL, THERMAL][source]๏ƒ

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

localCsys: Optional[DatumCsys] = <abaqus.Datum.DatumCsys.DatumCsys object>[source]๏ƒ

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 = ''[source]๏ƒ

A String specifying the adaptive mesh constraint repository key.

region: Region = <abaqus.Region.Region.Region object>[source]๏ƒ

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)[source]๏ƒ

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

Parameters:
  • v1 (Union[float, Literal[SET, UNSET]], 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[float, Literal[SET, UNSET]], 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[float, Literal[SET, UNSET]], 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[float, Literal[SET, UNSET]], 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[float, Literal[SET, UNSET]], 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[float, Literal[SET, UNSET]], 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 (Union[str, Literal[UNSET]], 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[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.

  • motionType (Literal[INDEPENDENT, FOLLOW, USER_DEFINED], 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=abaqusConstants.UNSET, v2=abaqusConstants.UNSET, v3=abaqusConstants.UNSET, vr1=abaqusConstants.UNSET, vr2=abaqusConstants.UNSET, vr3=abaqusConstants.UNSET, amplitude=abaqusConstants.UNCHANGED)[source]๏ƒ

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

Parameters:
  • stepName (str) โ€“ A String specifying the name of the step in which the adaptive mesh constraint is modified.

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

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

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

  • vr1 (Union[float, Literal[SET, UNSET]], default: UNSET) โ€“ 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[float, Literal[SET, UNSET]], default: UNSET) โ€“ 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[float, Literal[SET, UNSET]], default: UNSET) โ€“ A Float or a SymbolicConstant specifying the rotational velocity component about the 3-direction. Possible values for the SymbolicConstant are SET and FREED.

  • amplitude (Union[str, Literal[UNCHANGED, FREED]], default: UNCHANGED) โ€“ 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.

class AdaptivityProcess(name, job, maxIterations=3, jobPrefix='')[source]๏ƒ

Bases: object

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]

This method creates an AdaptivityProcess object.

Note

This function can be accessed by:

mdb.AdaptivityProcess
Parameters:
  • name (str) โ€“ A String specifying the name of 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.

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

Returns:

An AdaptivityProcess object.

Return type:

AdaptivityProcess

Raises:

AbaqusException โ€“

Member Details:

AdaptivityIteration(iteration, jobName, modelName, odbPath, remeshingErrors)[source]๏ƒ

This method creates an AdaptivityIteration object.

Note

This function can be accessed by:

mdb.AdaptivityProcess
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] = {}[source]๏ƒ

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

job: ModelJob[source]๏ƒ

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

jobPrefix: str = ''[source]๏ƒ

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[source]๏ƒ

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[source]๏ƒ

A String specifying the name of the Adaptivity Process.

setValues(maxIterations=3, jobPrefix='')[source]๏ƒ

This method modifies the AdaptivityProcess object.

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: SymbolicConstant[source]๏ƒ

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

submit(waitForCompletion=0, datacheckJob=False, continueJob=False)[source]๏ƒ

This method begins the process of analysis and adaptive remeshing.

Parameters:
  • waitForCompletion (Union[AbaqusBoolean, bool], default: 0) โ€“ 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.

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='')[source]๏ƒ

Bases: AdaptiveMeshConstraintState

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

This function can be accessed by:

mdb.models[name].steps[name].DisplacementAdaptiveMeshConstraintState
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[Literal[UNSET, SET, FREED, UNCHANGED, MODIFIED]], 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[Literal[UNSET, SET, FREED, UNCHANGED, MODIFIED]], 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[Literal[UNSET, SET, FREED, UNCHANGED, MODIFIED]], 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[Literal[UNSET, SET, FREED, UNCHANGED, MODIFIED]], 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[Literal[UNSET, SET, FREED, UNCHANGED, MODIFIED]], 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[Literal[UNSET, SET, FREED, UNCHANGED, MODIFIED]], 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[Literal[UNSET, SET, FREED, UNCHANGED, MODIFIED]], default: None) โ€“ A SymbolicConstant specifying the propagation state of the amplitude reference. Possible values are UNSET, SET, UNCHANGED, FREED, and MODIFIED.

  • status (Optional[Literal[NOT_YET_ACTIVE, PROPAGATED_FROM_BASE_STATE, DEACTIVATED_FROM_BASE_STATE, DEACTIVATED, MODIFIED_FROM_BASE_STATE, PROPAGATED, NO_LONGER_ACTIVE, CREATED, INSTANCE_NOT_APPLICABLE, BUILT_INTO_MODES, TYPE_NOT_APPLICABLE, MODIFIED]], 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.

Member Details:

amplitude: str = ''[source]๏ƒ

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

amplitudeState: SymbolicConstant[source]๏ƒ

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

status: SymbolicConstant[source]๏ƒ

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[source]๏ƒ

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

u1State: SymbolicConstant[source]๏ƒ

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

u2: Optional[float] = None[source]๏ƒ

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

u2State: SymbolicConstant[source]๏ƒ

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

u3: Optional[float] = None[source]๏ƒ

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

u3State: SymbolicConstant[source]๏ƒ

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

ur1: Optional[float] = None[source]๏ƒ

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

ur1State: SymbolicConstant[source]๏ƒ

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

ur2: Optional[float] = None[source]๏ƒ

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

ur2State: SymbolicConstant[source]๏ƒ

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

ur3: Optional[float] = None[source]๏ƒ

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

ur3State: SymbolicConstant[source]๏ƒ

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

class 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='')[source]๏ƒ

Bases: AdaptiveMeshConstraintState

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

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
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[Literal[UNSET, SET, FREED, UNCHANGED, MODIFIED]], 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[Literal[UNSET, SET, FREED, UNCHANGED, MODIFIED]], 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[Literal[UNSET, SET, FREED, UNCHANGED, MODIFIED]], 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[Literal[UNSET, SET, FREED, UNCHANGED, MODIFIED]], 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[Literal[UNSET, SET, FREED, UNCHANGED, MODIFIED]], 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[Literal[UNSET, SET, FREED, UNCHANGED, MODIFIED]], 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[Literal[UNSET, SET, FREED, UNCHANGED, MODIFIED]], default: None) โ€“ A SymbolicConstant specifying the propagation state of the amplitude reference. Possible values are UNSET, SET, UNCHANGED, FREED, and MODIFIED.

  • status (Optional[Literal[NOT_YET_ACTIVE, PROPAGATED_FROM_BASE_STATE, DEACTIVATED_FROM_BASE_STATE, DEACTIVATED, MODIFIED_FROM_BASE_STATE, PROPAGATED, NO_LONGER_ACTIVE, CREATED, INSTANCE_NOT_APPLICABLE, BUILT_INTO_MODES, TYPE_NOT_APPLICABLE, MODIFIED]], 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.

Member Details:

amplitude: str = ''[source]๏ƒ

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

amplitudeState: SymbolicConstant[source]๏ƒ

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

status: SymbolicConstant[source]๏ƒ

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[source]๏ƒ

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

v1State: SymbolicConstant[source]๏ƒ

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

v2: Optional[float] = None[source]๏ƒ

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

v2State: SymbolicConstant[source]๏ƒ

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

v3: Optional[float] = None[source]๏ƒ

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

v3State: SymbolicConstant[source]๏ƒ

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

vr1: Optional[float] = None[source]๏ƒ

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

vr1State: SymbolicConstant[source]๏ƒ

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

vr2: Optional[float] = None[source]๏ƒ

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

vr2State: SymbolicConstant[source]๏ƒ

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

vr3: Optional[float] = None[source]๏ƒ

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

vr3State: SymbolicConstant[source]๏ƒ

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