Optimization

Optimization commands are used to perform topology, shape, or sizing optimization of your model given a set of objectives and a set of restrictions.

Create optimization tasks

class OptimizationTaskModel(
name,
description='',
stefanBoltzmann=None,
absoluteZero=None,
waveFormulation=NOT_SET,
modelType=STANDARD_EXPLICIT,
universalGas=None,
copyConstraints=1,
copyConnectors=1,
copyInteractions=1,
)[source]

Bases: ModelBase

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

Note

This object can be accessed by:

mdb.models[name]

Public Data Attributes:

Inherited from ModelBase

name

A String specifying the repository key.

stefanBoltzmann

None or a Float specifying the Stefan-Boltzmann constant.

absoluteZero

None or a Float specifying the absolute zero constant.

waveFormulation

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

universalGas

None or a Float specifying the universal gas constant.

noPartsInputFile

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

endRestartStep

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

shellToSolid

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

lastChangedCount

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

description

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

restartJob

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

restartStep

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

globalJob

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

copyConstraints

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

copyConnectors

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

copyInteractions

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

keywordBlock

A KeywordBlock object.

amplitudes

A repository of Amplitude objects.

profiles

A repository of Profile objects.

boundaryConditions

A repository of BoundaryCondition objects.

constraints

A repository of ConstrainedSketchConstraint objects.

analyticalFields

A repository of AnalyticalField objects.

discreteFields

A repository of DiscreteField objects.

predefinedFields

A repository of PredefinedField objects.

interactions

A repository of Interaction objects.

interactionProperties

A repository of InteractionProperty objects.

contactControls

A repository of ContactControl objects.

contactInitializations

A repository of ContactInitialization objects.

contactStabilizations

A repository of ContactStabilization objects.

linkedInstances

A tuple of tuples of Strings specifying the linked child PartInstance name in the current model to the corresponding parent PartInstance name in a different model.

linkedParts

A tuple of tuples of Strings specifying the linked child Part name in the current model to the corresponding parent Part name in a different model.

loads

A repository of Load objects.

materials

A repository of Material objects.

calibrations

A repository of Calibration objects.

sections

A repository of Section objects.

remeshingRules

A repository of RemeshingRule objects.

sketches

A repository of ConstrainedSketch objects.

parts

A repository of Part objects.

steps

A repository of Step objects.

featureOptions

A FeatureOptions object.

adaptiveMeshConstraints

A repository of AdaptiveMeshConstraint objects.

adaptiveMeshControls

A repository of AdaptiveMeshControl objects.

timePoints

A repository of TimePoint objects.

filters

A repository of Filter objects.

integratedOutputSections

A repository of IntegratedOutputSection objects.

fieldOutputRequests

A repository of FieldOutputRequest objects.

historyOutputRequests

A repository of HistoryOutputRequest objects.

optimizationTasks

A repository of OptimizationTask objects.

restartIncrement

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

rootAssembly

An Assembly object.

Public Methods:

BeadTask(name[, algorithm, ...])

This method creates a BeadTask object.

ShapeTask(name[, absoluteStepSizeControl, ...])

This method creates a ShapeTask object.

SizingTask(name[, ...])

This method creates a SizingTask object.

TopologyTask(name[, algorithm, ...])

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

BeadTask(
name,
algorithm=GENERAL_OPTIMIZATION,
areBCRegionsFrozen=0,
beadIter=1,
beadMaxMembraneStress=0,
beadMinStress=0,
beadPerturbation=0,
beadWidth=DEFAULT,
curveSmooth=5,
filterRadius=4,
filterRadiusBy=VALUE,
flipNormalDir=0,
frozenBoundaryConditionRegion=MODEL,
isSensCalcOnlyOnDesignNodes=0,
modeTrackingRegion=MODEL,
nodalMoveLimit=0,
nodeSmooth=DEFAULT,
nodeUpdateStrategy=CONSERVATIVE,
numTrackedModes=5,
updateShapeBasisVectors=EVERY_CYCLE,
)[source]

This method creates a BeadTask object.

Note

This function can be accessed by:

mdb.models[name].BeadTask
Parameters:
name

A String specifying the optimization task repository key.

algorithm=GENERAL_OPTIMIZATION

A SymbolicConstant specifying the optimization task algorithm. Possible values are GENERAL_OPTIMIZATION and CONDITION_BASED_OPTIMIZATION. The default value is GENERAL_OPTIMIZATION.

areBCRegionsFrozen=0

A Boolean specifying whether to exclude elements with boundary conditions from the optimization. The default value is OFF.

beadIter=1

An int specifying the step size of the optimization. The default value is 1.

beadMaxMembraneStress=0

A float specifying maximum membrane/bending stress. The default value is 0.1.

beadMinStress=0

A float specifying minimum stress. The default value is 0.001.

beadPerturbation=0

A Sets perturbation size for finite differences. The default value is 0.0001.

beadWidth=DEFAULT

A SymbolicConstant specifying the Optimization product default or a float specifying the bead width. The default value is DEFAULT.

curveSmooth=5

A float specifying relative value to the middle element edge length such that normals in this area do not cross each other. The default value is 5.

filterRadius=4

A float specifying the filter radius. The default value is 4.

filterRadiusBy=VALUE

A SymbolicConstant specifying the method used to define filter radius. Possible values are VALUE and REFERENCE. The default is VALUE.

flipNormalDir=0

A Boolean specifying whether the growth direction is along the normal direction of elements or opposite to the normal direction. The default value is OFF

frozenBoundaryConditionRegion=MODEL

When nodes with boundary conditions are excluded from the optimization (frozenBoundaryConditionRegions = ON). you can specify that this exclusion apply to nodes throughout the model or only to those nodes from a specific region. Set this parameter to the SymbolicConstant MODEL to apply the freeze to the entire model, or set this parameter to a Region object to specify an individual region over which nodes with boundary conditions should be frozen. The default value is MODEL.

isSensCalcOnlyOnDesignNodes=0

A Boolean specifying whether to calculate the sensitivities only on design nodes or the whole model. The default value is ON

modeTrackingRegion=MODEL

The SymbolicConstant MODEL or a Region object specifying the region to use for mode tracking. The default value is MODEL.

nodalMoveLimit=0

A Float specifying the maximum change in nodal displacement per design cycle. The default value is 0.1.

nodeSmooth=DEFAULT

A SymbolicConstant specifying the Optimization product default or a float specifying the node smooth. The default value is DEFAULT.

nodeUpdateStrategy=CONSERVATIVE

A SymbolicConstant specifying the strategy for how the nodal displacements are updated in the method of moving asymptotes. Possible values are NORMAL, CONSERVATIVE, and AGGRESSIVE. The default value is CONSERVATIVE.

numTrackedModes=5

An Int specifying the number of modes included in mode tracking. The default value is 5.

updateShapeBasisVectors=EVERY_CYCLE

A SymbolicConstant specifying whether to update shape basis vectors in the first design cycle or every design cycle. Possible values are EVERY_CYCLE and FIRST_CYCLE. The default value is EVERY_CYCLE.

Returns:

A BeadTask object.

Return type:

BeadTask

ShapeTask(
name,
absoluteStepSizeControl=MINIMUM,
activateDurability=1,
additionalDurabilityFiles='',
constrainedLaplacianConvergenceLevel=NORMAL,
curvatureSmoothingEdgeLength=5,
durabilityInputfile='',
durabilitySolver=FE_SAFE,
equalityConstraintTolerance=None,
featureRecognitionAngle=30,
filterExponent=1,
filterMaxRadius=None,
filterRadiusReduction=None,
firstCycleDeletedVolumeTechnique=0,
freezeBoundaryConditionRegions=0,
frozenBoundaryConditionRegion=MODEL,
geometricRestrictionEvaluationFrequency=LOW,
growthScaleFactor=1,
haltUponViolation=0,
layerReferenceRegion=None,
meshSmoothingRegionMethod=TASK_REGION_LAYERS,
meshSmoothingStrategy=CONSTRAINED_LAPLACIAN,
midsideInterpolation=POSITIONS,
numFreeNodeLayers=0,
numSmoothedElementLayers=None,
presumeFeasibleBCRegionAtStart=1,
quadMaxAngle=160,
quadMinAngle=20,
quadSkew=30,
quadTaper=0,
region=MODEL,
reportPoorQualityElements=0,
reportQualityViolation=0,
shrinkScaleFactor=1,
smoothingRegion=None,
targetMeshQuality=LOW,
tetAspectRatio=100,
tetMaxAspect=8,
tetMinAspect=0,
tetSkew=100,
triMaxAngle=140,
triMinAngle=20,
updateShapeBasisVectors=EVERY_CYCLE,
)[source]

This method creates a ShapeTask object.

Note

This function can be accessed by:

mdb.models[name].ShapeTask
Parameters:
name

A String specifying the optimization task repository key.

absoluteStepSizeControl=MINIMUM

A SymbolicConstant specifying whether to control the permitted absolute step size by the average optimization displacement or minimum optimization displacement. Possible values are MINIMUM and AVERAGE. The default value is MINIMUM.

activateDurability=1

A boolean specifying whether or not the durability approach of optimization is turned on. The default value is ON.

additionalDurabilityFiles=''

A String specifying the path of additional files pertaining to durability optimization. Only valid if the activateDurability argument is ON.

constrainedLaplacianConvergenceLevel=NORMAL

A SymbolicConstant specifying the constrained Laplacian convergence level. Possible values are NORMAL, CONSERVATIVE, and AGGRESSIVE. The default value is NORMAL.

curvatureSmoothingEdgeLength=5

A Float specifying the edge length for the movement vector. The default value is 5.0.

durabilityInputfile=''

A string specifying the path of the input file. Only valid if the activateDurability argument is ON and is a required argument in that case.

durabilitySolver=FE_SAFE

A String specifying the type of solver for durability optimization. Possible values are: FE_SAFE, FEMFAT, FLANS, MSC_FATIGUE, FE_FATIGUE, DESIGN_LIFE, CUSTOM, FEMSITE. The default value is FE_SAFE. Only valid if the activateDurability argument is ON.

equalityConstraintTolerance=None

A Float specifying the equality constraint tolerance. The default value is 10⁻³.

featureRecognitionAngle=30

A Float specifying the mesh smoothing feature recognition angle for edges and corners. The default value is 30.0.

filterExponent=1

A Float specifying the weight depending on the radius, used when filterMaxRadius is specified. The default value is 1.0.

filterMaxRadius=None

None or a Float specifying the maximum influence radius for equivalent stress. The default value is None.

filterRadiusReduction=None

None or a Float specifying the reduction of the radius depending on surface bending, used when filterMaxRadius is specified. The default value is None.

firstCycleDeletedVolumeTechnique=0

A SymbolicConstant specifying the method of specifying volume that can be removed immediately in the first design cycle. Possible values are OFF, PERCENTAGE, and ABSOLUTE. The default value is OFF.

freezeBoundaryConditionRegions=0

A Boolean specifying whether to exclude nodes with boundary conditions from the optimization. The default value is OFF.

frozenBoundaryConditionRegion=MODEL

The SymbolicConstant MODEL or a Region object specifying the region in which to freeze boundary condition regions, or the SymbolicConstant MODEL, used with freezeBoundaryConditionRegions. The default value is MODEL.

geometricRestrictionEvaluationFrequency=LOW

A SymbolicConstant specifying the frequency of evaluating geometric restrictions during mesh smoothing. Possible values are LOW, MEDIUM, and HIGH. The default value is LOW.

growthScaleFactor=1

A Float specifying the scale factor to apply to optimization displacements for nodes with growth. The default value is 1.0.

haltUponViolation=0

A Boolean specifying whether to halt the optimization if quality criteria are not satisified. The default value is OFF.

layerReferenceRegion=None

None or a Region object specifying the region specifying the first node layer for mesh smoothing, used when meshSmoothingRegionMethod is TASK_REGION_LAYERS. The default value is None.

meshSmoothingRegionMethod=TASK_REGION_LAYERS

A SymbolicConstant specifying the method used to determine the mesh smoothing region. The REGION value uses the smoothingRegion. The NUMBER_OF_LAYERS value uses the layerReferenceRegion. The TASK_REGION_LAYERS value will smooth six layers using the task region. Possible values are TASK_REGION_LAYERS, REGION, and NUMBER_OF_LAYERS. The default value is TASK_REGION_LAYERS.

meshSmoothingStrategy=CONSTRAINED_LAPLACIAN

A SymbolicConstant specifying the method smoothing strategy. Possible values are CONSTRAINED_LAPLACIAN and LOCAL_GRADIENT. The default value is CONSTRAINED_LAPLACIAN.

midsideInterpolation=POSITIONS

A SymbolicConstant specifying the approach used when treating midside node positions during optimization. POSITIONS indicates midside node positions are interpolated linearly by position. OPTIMIZATION_DISPLACEMENT indicates they are interpolated by optimization displacement of corner nodes. Possible values are POSITIONS and OPTIMIZATION_DISPLACEMENT. The default value is POSITIONS.

numFreeNodeLayers=0

The SymbolicConstant FIX_NONE or an Int specifying the number of node layers adjoining the task region to remain free during mesh smoothing. A value of 0 indicates that no layers are free and all layers are fixed. The default value is 0.

numSmoothedElementLayers=None

None or an Int specifying the number of layers for mesh smoothing when meshSmoothingRegionMethod is NUMBER_OF_LAYERS. The default value is None.

presumeFeasibleBCRegionAtStart=1

A Boolean specifying whether to ignore automatically frozen boundary condition regions in the first design cycle. This is used with freezeBoundaryConditionRegions. The default value is ON.

quadMaxAngle=160

A Float specifying the maximum angle for quad elements during mesh smoothing. The default value is 160.0.

quadMinAngle=20

A Float specifying the minimum angle for quad elements during mesh smoothing. The default value is 20.0.

quadSkew=30

A Float specifying the skew angle for quad elements during mesh smoothing, used with reportQualityViolation. The default value is 30.0.

quadTaper=0

A Float specifying the taper for quad elements during mesh smoothing, used with reportQualityViolation. The default value is 0.5.

region=MODEL

The SymbolicConstant MODEL or a Region object specifying the region to which the optimization task is applied. The default value is MODEL.

reportPoorQualityElements=0

A Boolean specifying whether to report poor quality elements during mesh smoothing. The default value is OFF.

reportQualityViolation=0

A Boolean specifying whether to report a quality criteria violation during mesh smoothing. The default value is OFF.

shrinkScaleFactor=1

A Float specifying the scale factor to apply to optimization displacements for nodes with shrinkage. The default value is 1.0.

smoothingRegion=None

None or a Region object specifying the mesh smoothing region, used when meshSmoothingRegionMethod is REGION. The default value is None.

targetMeshQuality=LOW

A SymbolicConstant specifying the target mesh quality for mesh smoothing. Possible values are NONE, LOW, MEDIUM, and HIGH. The default value is LOW.

tetAspectRatio=100

A Float specifying the tet element aspect ratio during mesh smoothing. The default value is 100.0.

tetMaxAspect=8

A Float specifying the maximum tet element aspect ratio during mesh smoothing. The default value is 8.0.

tetMinAspect=0

A Float specifying the minimum tet element aspect ratio during mesh smoothing. The default value is 0.222.

tetSkew=100

A Float specifying the tet element skew value during mesh smoothing. The default value is 100.0.

triMaxAngle=140

A Float specifying the tri element maximum angle during mesh smoothing. The default value is 140.0.

triMinAngle=20

A Float specifying the tri element maximum angle during mesh smoothing. The default value is 20.0.

updateShapeBasisVectors=EVERY_CYCLE

A SymbolicConstant specifying whether to update shape basis vectors in the first design cycle or every design cycle. Possible values are EVERY_CYCLE and FIRST_CYCLE. The default value is EVERY_CYCLE.

Returns:

A ShapeTask object.

Return type:

ShapeTask

SizingTask(
name,
elementThicknessDeltaStopCriteria=0,
freezeBoundaryConditionRegions=0,
freezeLoadRegions=1,
modeTrackingRegion=MODEL,
numFulfilledStopCriteria=2,
numTrackedModes=5,
objectiveFunctionDeltaStopCriteria=0,
stopCriteriaDesignCycle=4,
thicknessMoveLimit=0,
thicknessUpdateStrategy=NORMAL,
)[source]

This method creates a SizingTask object.

Note

This function can be accessed by:

mdb.models[name].SizingTask
Parameters:
name

A String specifying the optimization task repository key.

elementThicknessDeltaStopCriteria=0

A Float specifying the stop criteria based on the change in element thickness. The default value is 0.5 x 10⁻².

freezeBoundaryConditionRegions=0

A Boolean specifying whether to exclude elements with boundary conditions from the optimization. The default value is OFF.

freezeLoadRegions=1

A Boolean specifying whether to exclude elements with loads and elements with loaded nodes from the optimization. The default value is ON.

modeTrackingRegion=MODEL

The SymbolicConstatnt MODEL or a Region object specifying the region to use for mode tracking. The default value is MODEL.

numFulfilledStopCriteria=2

An Int specifying the number of stop criteria. The default value is 2.

numTrackedModes=5

An Int specifying the number of modes included in mode tracking. The default value is 5.

objectiveFunctionDeltaStopCriteria=0

A Float specifying the stop criteria based on the change in objective function. The default value is 0.001.

stopCriteriaDesignCycle=4

An Int specifying the first design cycle used to evaluate convergence criteria. The default value is 4.

thicknessMoveLimit=0

A Float specifying the maximum change in thickness per design cycle. The default value is 0.25.

thicknessUpdateStrategy=NORMAL

A SymbolicConstant specifying the strategy for how the thickness is updated in the method of moving asymptotes. Possible values are NORMAL, CONSERVATIVE, and AGGRESSIVE. The default value is NORMAL.

Returns:

A SizingTask object.

Return type:

SizingTask

TopologyTask(
name,
algorithm=GENERAL_OPTIMIZATION,
densityMoveLimit=0,
densityUpdateStrategy=NORMAL,
elementDensityDeltaStopCriteria=0,
filterRadius=None,
firstCycleDeletedVolume=5,
firstCycleDeletedVolumeTechnique=0,
freezeBoundaryConditionRegions=0,
freezeLoadRegions=1,
frequencySpectrumWeight=6,
initialDensity=DEFAULT,
materialInterpolationPenalty=3,
materialInterpolationTechnique=DEFAULT,
maxDensity=1,
minDensity=None,
modeTrackingRegion=MODEL,
numDesignCycles=15,
numFulfilledStopCriteria=2,
numTrackedModes=5,
objectiveFunctionDeltaStopCriteria=None,
region=MODEL,
softDeletionMethod=STANDARD,
softDeletionRadius=0,
softDeletionRegion=None,
softDeletionThreshold=None,
stepSize=MEDIUM,
stiffnessMassDamping=AVERAGE_EDGE_LENGTH,
stopCriteriaDesignCycle=4,
structuralMassDamping=None,
viscousMassDamping=None,
viscousStiffnessDamping=None,
)[source]

This method creates a TopologyTask object.

Note

This function can be accessed by:

mdb.models[name].TopologyTask
Parameters:
name

A String specifying the optimization task repository key.

algorithm=GENERAL_OPTIMIZATION

A SymbolicConstant specifying the optimization task algorithm. Possible values are GENERAL_OPTIMIZATION and CONDITION_BASED_OPTIMIZATION. The default value is GENERAL_OPTIMIZATION.

densityMoveLimit=0

A Float specifying the maximum density change per design cycle. The default value is 0.25.

densityUpdateStrategy=NORMAL

A SymbolicConstant specifying the strategy for how the densities are updated in the method of moving asymptotes. Possible values are NORMAL, CONSERVATIVE, and AGGRESSIVE. The default value is NORMAL.

elementDensityDeltaStopCriteria=0

A Float specifying the stop criteria based upon the change in element densities. The default value is 0.5x10⁻².

filterRadius=None

None or a Float specifying the mesh filter radius for mesh independence and minimum size. The default value is None.

firstCycleDeletedVolume=5

A Float specifying the volume that can be removed immediately in the first design cycle. The default value is 5.0.

firstCycleDeletedVolumeTechnique=0

A SymbolicConstant specifying the method of quantifying volume that can be removed immediately in the first design cycle. Possible values are OFF, PERCENTAGE, and ABSOLUTE. The default value is OFF.

freezeBoundaryConditionRegions=0

A Boolean specifying whether to exclude elements with boundary conditions from the optimization. The default value is OFF.

freezeLoadRegions=1

A Boolean specifying whether to exclude elements with loads and elements with loaded nodes from the optimization. The default value is ON.

frequencySpectrumWeight=6

A Float specifying the weighting factor for frequency spectrum peaks. The default value is 6.0.

initialDensity=DEFAULT

A SymbolicConstant specifying the Optimization product default or a float specifying the initial density. The default value is DEFAULT.

materialInterpolationPenalty=3

A Float specifying the penalty factor for the material interpolation technique. The default value is 3.0.

materialInterpolationTechnique=DEFAULT

A SymbolicConstant specifying the material interpolation technique: optimization product default, solid isotropic material with penalization, or rational approximation of material properties. Possible values are DEFAULT, SIMP, and RAMP. The default value is DEFAULT.

maxDensity=1

A Float specifying the maximum density in the density update. The default value is 1.0.

minDensity=None

A Float specifying the minimum density in the density update. The default value is 10⁻³.

modeTrackingRegion=MODEL

The SymbolicConstant MODEL or a Region object specifying the region to use for mode tracking. The default value is MODEL.

numDesignCycles=15

An Int specifying the number of design cycles permitted when stepSize is DYNAMIC. The default value is 15.

numFulfilledStopCriteria=2

An Int specifying the number of stop criteria. The default value is 2.

numTrackedModes=5

An Int specifying the number of modes included in mode tracking. The default value is 5.

objectiveFunctionDeltaStopCriteria=None

A Float specifying the stop criteria based on the change in objective function. The default value is 10⁻³.

region=MODEL

The SymbolicConstant MODEL or a Region object specifying the region to which the optimization task is applied. The default value is MODEL.

softDeletionMethod=STANDARD

A SymbolicConstant specifying the method used when softDeletionRegion is specified. The STANDARD method avoids creating disconnected regions. The AGGRESSIVE method only considers the softDeletionThreshold. The MAX_SHEAR_STRAIN, MAX_ELASTOPLASTIC_STRAIN and VOLUME_COMPRESSION methods do not need the softDeletionRadius. Possible values are STANDARD, AGGRESSIVE, MAX_SHEAR_STRAIN, MIN_PRINCIPAL_STRAIN, MAX_ELASTOPLASTIC_STRAIN and VOLUME_COMPRESSION. The default value is STANDARD.

softDeletionRadius=0

A Float specifying the radius to use when considering neighboring soft elements to delete. The default value is 0.0.

softDeletionRegion=None

None or a Region object specifying the region in which the soft elements should be deleted during optimization. The default value is None.

softDeletionThreshold=None

A Float specifying the relative material density value used to identify soft elements. Those with values below the threshold are considered for removal. For STANDARD and AGGRESSIVE methods positive values are accepted and the default value is 0.05. For MAX_SHEAR_STRAIN and MAX_ELASTOPLASTIC_STRAIN methods positive values are accepted whereas for MIN_PRINCIPAL_STRAIN and VOLUME_COMPRESSION methods negative values are accepted.

stepSize=MEDIUM

A SymbolicConstant specifying the size of the increment for volume modification. Possible values are DYNAMIC, VERY_SMALL, SMALL, MODERATE, MEDIUM, and LARGE. The default value is MEDIUM.

stiffnessMassDamping=AVERAGE_EDGE_LENGTH

The SymbolicConstant AVERAGE_EDGE_LENGTH or a Float specifying the stiffness mass damping for the task region. The default value is AVERAGE_EDGE_LENGTH.

stopCriteriaDesignCycle=4

An Int specifying the first design cycle used to evaluate convergence criteria. The default value is 4.

structuralMassDamping=None

None or a Float specifying the structural mass damping for the task region. The default value is None.

viscousMassDamping=None

None or a Float specifying the viscous mass damping for the task region. The default value is None.

viscousStiffnessDamping=None

None or a Float specifying the viscous stiffness damping for the task region. The default value is None.

Returns:

A TopologyTask object.

Return type:

TopologyTask

Assign features to optimization tasks

class OptimizationTask[source]

Bases: OptimizationTaskBase

Public Data Attributes:

Inherited from OptimizationTaskBase

name

A String specifying the optimization task repository key.

region

The SymbolicConstant MODEL or a Region object specifying the region to which the optimization task is applied.

designResponses

A repository of DesignResponse objects.

objectiveFunctions

A repository of ObjectiveFunction objects.

optimizationConstraints

A repository of OptimizationConstraint objects.

geometricRestrictions

A repository of GeometricRestriction objects.

stopConditions

A repository of StopCondition objects.

Public Methods:

SingleTermDesignResponse(name, identifier[, ...])

This method creates a SingleTermDesignResponse object.

ObjectiveFunction(name, objectives[, target])

This method creates an ObjectiveFunction object.

OptimizationConstraint(name, designResponse, ...)

This method creates an OptimizationConstraint object.

BeadFixedRegion(name, region[, csys, u1, u2, u3])

This method creates a BeadFixedRegion object.

BeadGrowth(name, region[, beadGrowth, shrink])

This method creates a BeadGrowth object.

BeadPenetrationCheck(name, ...)

This method creates a BeadPenetrationCheck object.

BeadPlanarSymmetry(name, region[, axis, csys])

This method creates a BeadPlanarSymmetry object.

BeadPointSymmetry(name, region[, csys])

This method creates a BeadPointSymmetry object.

BeadRotationalSymmetry(name, angle, region)

This method creates a BeadRotationalSymmetry object.

DesignDirection(name, region[, csys, ...])

This method creates a DesignDirection object.

DrillControl(name, clientDirection, region)

This method creates a DrillControl object.

FixedRegion(name, region[, csys, ...])

This method creates a FixedRegion object.

FrozenArea(name[, region])

This method creates a FrozenArea object.

Growth(name, region[, growth, ...])

This method creates a Growth object.

PenetrationCheck(name, ...[, ...])

This method creates a PenetrationCheck object.

ShapeDemoldControl(name, pullDirection, region)

This method creates a ShapeDemoldControl object.

ShapeMemberSize(name, region[, ...])

This method creates a ShapeMemberSize object.

ShapePlanarSymmetry(name, clientDirection, ...)

This method creates a ShapePlanarSymmetry object.

ShapePointSymmetry(name, region[, csys, ...])

This method creates a ShapePointSymmetry object.

ShapeRotationalSymmetry(name, ...[, angle, ...])

This method creates a ShapeRotationalSymmetry object.

SizingClusterAreas(name, regions)

This method creates a SizingClusterAreas object.

SizingCyclicSymmetry(name, region, translation)

This method creates a SizingCyclicSymmetry object.

SizingFrozenArea(name, region)

This method creates a SizingFrozenArea object.

SizingMemberSize(name, region, minWidth)

This method creates a SizingMemberSize object.

SizingPlanarSymmetry(name, region[, axis, ...])

This method creates a SizingPlanarSymmetry object.

SizingPointSymmetry(name, region[, csys, ...])

This method creates a SizingPointSymmetry object.

SizingRotationalSymmetry(name, angle, region)

This method creates a SizingRotationalSymmetry object.

SlideRegionControl(name, clientDirection, region)

This method creates a SlideRegionControl object.

StampControl(name, clientDirection, region)

This method creates a StampControl object.

TopologyCyclicSymmetry(name, region, translation)

This method creates a TopologyCyclicSymmetry object.

TopologyDemoldControl(name, region[, csys, ...])

This method creates a TopologyDemoldControl object.

TopologyMemberSize(name, region[, ...])

This method creates a TopologyMemberSize object.

TopologyPlanarSymmetry(name, region[, axis, ...])

This method creates a TopologyPlanarSymmetry object.

TopologyPointSymmetry(name, region[, csys, ...])

This method creates a TopologyPointSymmetry object.

TopologyRotationalSymmetry(name, angle, region)

This method creates a TopologyRotationalSymmetry object.

TurnControl(name, clientDirection, region[, ...])

This method creates a TurnControl object.


Member Details:

BeadFixedRegion(name, region, csys=None, u1=0, u2=0, u3=0)[source]

This method creates a BeadFixedRegion object.

Note

This function can be accessed by:

mdb.models[name].optimizationTasks[name].BeadFixedRegion
Parameters:
name

A String specifying the geometric restriction repository key.

region

A Region object specifying the region to which the geometric restriction is applied.

csys=None

None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

u1=0

A Boolean specifying whether to fix the region in the 1-direction. The default value is OFF.

u2=0

A Boolean specifying whether to fix the region in the 2-direction. The default value is OFF.

u3=0

A Boolean specifying whether to fix the region in the 3-direction. The default value is OFF.

Returns:

A BeadFixedRegion object.

Return type:

BeadFixedRegion

BeadGrowth(name, region, beadGrowth=0, shrink=0)[source]

This method creates a BeadGrowth object.

Note

This function can be accessed by:

mdb.models[name].optimizationTasks[name].BeadGrowth
Parameters:
name

A String specifying the geometric restriction repository key.

region

A Region object specifying the region to which the geometric restriction is applied.

beadGrowth=0

A Float specifying the maximum optimization displacement in the growth direction. Either beadGrowth or shrink or both must be specified. The default value is 0.0.

shrink=0

A Float specifying the maximum optimization displacement in the shrink direction. Either beadGrowth or shrink or both must be specified The default value is 0.0.

Returns:

A BeadGrowth object.

Return type:

BeadGrowth

BeadPenetrationCheck(name, beadPenetrationCheckRegion, region)[source]

This method creates a BeadPenetrationCheck object.

Note

This function can be accessed by:

mdb.models[name].optimizationTasks[name].BeadPenetrationCheck
Parameters:
name

A String specifying the geometric restriction repository key.

beadPenetrationCheckRegion

A Region object specifying the penetration check region.

region

A Region object specifying the region to which the geometric restriction is applied.

Returns:

A BeadPenetrationCheck object.

Return type:

BeadPenetrationCheck

BeadPlanarSymmetry(name, region, axis=AXIS_1, csys=None)[source]

This method creates a BeadPlanarSymmetry object.

Note

This function can be accessed by:

mdb.models[name].optimizationTasks[name].BeadPlanarSymmetry
Parameters:
name

A String specifying the geometric restriction repository key.

region

A Region object specifying the region to which the geometric restriction is applied.

axis=AXIS_1

A SymbolicConstant specifying the axis of symmetry. Possible values are AXIS_1, AXIS_2, and AXIS_3. The default value is AXIS_1.

csys=None

None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

Returns:

A BeadPlanarSymmetry object.

Return type:

BeadPlanarSymmetry

BeadPointSymmetry(name, region, csys=None)[source]

This method creates a BeadPointSymmetry object.

Note

This function can be accessed by:

mdb.models[name].optimizationTasks[name].BeadPointSymmetry
Parameters:
name

A String specifying the geometric restriction repository key.

region

A Region object specifying the region to which the geometric restriction is applied.

csys=None

None or a DatumCsys object specifying the position of the symmetry point defined as the origin of a local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

Returns:

A BeadPointSymmetry object.

Return type:

BeadPointSymmetry

BeadRotationalSymmetry(name, angle, region, axis=AXIS_1, csys=None)[source]

This method creates a BeadRotationalSymmetry object.

Note

This function can be accessed by:

mdb.models[name].optimizationTasks[name].BeadRotationalSymmetry
Parameters:
name

A String specifying the geometric restriction repository key.

angle

A Float specifying the repeating segment size, an angle in degrees.

region

A Region object specifying the region to which the geometric restriction is applied.

axis=AXIS_1

A SymbolicConstant specifying the axis of symmetry. Possible values are AXIS_1, AXIS_2, and AXIS_3. The default value is AXIS_1.

csys=None

None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

Returns:

A BeadRotationalSymmetry object.

Return type:

BeadRotationalSymmetry

DesignDirection(
name,
region,
csys=None,
masterPoint=None,
masterPointDetermination=MAXIMUM,
movementRestriction=VECTOR,
presumeFeasibleRegionAtStart=1,
u1=1,
u2=1,
u3=1,
)[source]

This method creates a DesignDirection object.

Note

This function can be accessed by:

mdb.models[name].optimizationTasks[name].DesignDirection
Parameters:
name

A String specifying the geometric restriction repository key.

region

A Region object specifying the region to which the geometric restriction is applied. When used with a TopologyTask, there is no default value. When used with a ShapeTask, the default value is MODEL.

csys=None

None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

masterPoint=None

None or a Region object specifying the master point used when masterPointDetermination is SPECIFY. The default value is None.

masterPointDetermination=MAXIMUM

A SymbolicConstant specifying the rule for assigning point priority. Possible values are MAXIMUM, MINIMUM, and SPECIFY. The default value is MAXIMUM.

movementRestriction=VECTOR

A SymbolicConstant specifying whether movement in the region should follow only the direction of the masterPoint, only the magnitude, or both the magnitude of the masterPoint and the directions specified by u1, u2 and u3. Possible values are DIRECTION, MAGNITUDE, and VECTOR. The default value is VECTOR.

presumeFeasibleRegionAtStart=1

A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.

u1=1

A Boolean specifying whether movement in the region should follow the masterPoint in the 1-direction. This is used when movementRestriction is VECTOR. The default value is ON.

u2=1

A Boolean specifying whether movement in the region should follow the masterPoint in the 2-direction. This is used when movementRestriction is VECTOR. The default value is ON.

u3=1

A Boolean specifying whether movement in the region should follow the masterPoint in the 3-direction. This is used when movementRestriction is VECTOR. The default value is ON.

Returns:

A DesignDirection object.

Return type:

DesignDirection

DrillControl(
name,
clientDirection,
region,
csys=None,
drawAngle=0,
masterPoint=None,
masterPointDetermination=MAXIMUM,
presumeFeasibleRegionAtStart=1,
tolerance1=0,
tolerance2=0,
tolerance3=0,
undercutTolerance=0,
)[source]

This method creates a DrillControl object.

Note

This function can be accessed by:

mdb.models[name].optimizationTasks[name].DrillControl
Parameters:
name

A String specifying the geometric restriction repository key.

clientDirection

A VertexArray object of length 2 specifying the direction of the drill axis positioned at the csys origin. Instead of through a ConstrainedSketchVertex, each point may be specified through a tuple of coordinates.

region

A Region object specifying the region to which the geometric restriction is applied. When used with a TopologyTask, there is no default value. When used with a ShapeTask, the default value is MODEL.

csys=None

None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

drawAngle=0

A Float specifying the draw angle. The default value is 0.0.

masterPoint=None

None or a Region object specifying the master point used when masterPointDetermination is SPECIFY. The default value is None.

masterPointDetermination=MAXIMUM

A SymbolicConstant specifying the rule for assigning point priority. Possible values are MAXIMUM, MINIMUM, and SPECIFY. The default value is MAXIMUM.

presumeFeasibleRegionAtStart=1

A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.

tolerance1=0

A Float specifying the geometric tolerance in the 1-direction. The default value is 0.01.

tolerance2=0

A Float specifying the geometric tolerance in the 2-direction. The default value is 0.01.

tolerance3=0

A Float specifying the geometric tolerance in the 3-direction. The default value is 0.01.

undercutTolerance=0

A Float specifying the undercut tolerance. The default value is 0.0.

Returns:

A DrillControl object.

Return type:

DrillControl

FixedRegion(
name,
region,
csys=None,
presumeFeasibleRegionAtStart=1,
u1=0,
u2=0,
u3=0,
)[source]

This method creates a FixedRegion object.

Note

This function can be accessed by:

mdb.models[name].optimizationTasks[name].FixedRegion
Parameters:
name

A String specifying the geometric restriction repository key.

region

A Region object specifying the region to which the geometric restriction is applied. When used with a TopologyTask, there is no default value. When used with a ShapeTask, the default value is MODEL.

csys=None

None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

presumeFeasibleRegionAtStart=1

A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.

u1=0

A Boolean specifying whether to fix the region in the 1-direction. The default value is OFF.

u2=0

A Boolean specifying whether to fix the region in the 2-direction. The default value is OFF.

u3=0

A Boolean specifying whether to fix the region in the 3-direction. The default value is OFF.

Returns:

A FixedRegion object.

Return type:

FixedRegion

FrozenArea(name, region=<abaqus.Region.Region.Region object>)[source]

This method creates a FrozenArea object.

Note

This function can be accessed by:

mdb.models[name].optimizationTasks[name].FrozenArea
Parameters:
name

A String specifying the geometric restriction repository key.

region : Region, default: <abaqus.Region.Region.Region object at 0x7ff9e7dc6ed0>

A Region object specifying the region to which the geometric restriction is applied. When used with a TopologyTask, there is no default value. When used with a ShapeTask, the default value is MODEL.

Returns:

A FrozenArea object.

Return type:

FrozenArea

Growth(name, region, growth=0, presumeFeasibleRegionAtStart=1, shrink=0)[source]

This method creates a Growth object.

Note

This function can be accessed by:

mdb.models[name].optimizationTasks[name].Growth
Parameters:
name

A String specifying the geometric restriction repository key.

region

A Region object specifying the region to which the geometric restriction is applied. When used with a TopologyTask, there is no default value. When used with a ShapeTask, the default value is MODEL.

growth=0

A Float specifying the maximum optimization displacement in the growth direction. Either growth or shrink or both must be specified. The default value is 0.0.

presumeFeasibleRegionAtStart=1

A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.

shrink=0

A Float specifying the maximum optimization displacement in the shrink direction. Either growth or shrink or both must be specified The default value is 0.0.

Returns:

A Growth object.

Return type:

Growth

ObjectiveFunction(name, objectives, target=MINIMIZE)[source]

This method creates an ObjectiveFunction object.

Note

This function can be accessed by:

mdb.models[name].optimizationTasks[name].ObjectiveFunction
Parameters:
name

A String specifying the objective function repository key.

objectives

An OptimizationObjectiveArray object.

target=MINIMIZE

A SymbolicConstant specifying the target of the objective function. Possible values are MINIMIZE, MAXIMIZE, and MINIMIZE_MAXIMUM. The default value is MINIMIZE.

Returns:

An ObjectiveFunction object.

Return type:

ObjectiveFunction

Raises:
  • InvalidNameError

  • RangeError

OptimizationConstraint(
name,
designResponse,
restrictionValue,
restrictionMethod=ABSOLUTE_EQUAL,
)[source]

This method creates an OptimizationConstraint object.

Note

This function can be accessed by:

mdb.models[name].optimizationTasks[name].OptimizationConstraint
Parameters:
name

A String specifying the optimization constraint repository key.

designResponse

A String specifying the name of the design response to constrain.

restrictionValue

A Float specifying the value to which the design response should be constrained.

restrictionMethod=ABSOLUTE_EQUAL

A SymbolicConstant specifying the method used to constrain the design response. Possible values are ABSOLUTE_EQUAL, ABSOLUTE_GREATER_THAN_EQUAL, ABSOLUTE_LESS_THAN_EQUAL, RELATIVE_EQUAL, RELATIVE_GREATER_THAN_EQUAL, and RELATIVE_LESS_THAN_EQUAL. The default value is ABSOLUTE_EQUAL.

Returns:

An OptimizationConstraint object.

Return type:

OptimizationConstraint

Raises:
  • InvalidNameError

  • RangeError

PenetrationCheck(
name,
penetrationCheckRegion,
region,
presumeFeasibleRegionAtStart=1,
)[source]

This method creates a PenetrationCheck object.

Note

This function can be accessed by:

mdb.models[name].optimizationTasks[name].PenetrationCheck
Parameters:
name

A String specifying the geometric restriction repository key.

penetrationCheckRegion

A Region object specifying the penetration check region.

region

A Region object specifying the region to which the geometric restriction is applied. When used with a TopologyTask, there is no default value. When used with a ShapeTask, the default value is MODEL.

presumeFeasibleRegionAtStart=1

A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.

Returns:

A PenetrationCheck object.

Return type:

PenetrationCheck

ShapeDemoldControl(
name,
pullDirection,
region,
collisionCheckRegion=DEMOLD_REGION,
csys=None,
drawAngle=0,
masterPointDetermination=MAXIMUM,
presumeFeasibleRegionAtStart=1,
tolerance1=0,
tolerance2=0,
tolerance3=0,
undercutTolerance=0,
)[source]

This method creates a ShapeDemoldControl object.

Note

This function can be accessed by:

mdb.models[name].optimizationTasks[name].ShapeDemoldControl
Parameters:
name

A String specifying the geometric restriction repository key.

pullDirection

A VertexArray object of length 2 specifying the demold pull direction. Instead of through a ConstrainedSketchVertex, each point might be specified through a tuple of coordinates.

region

A Region object specifying the region to which the geometric restriction is applied. When used with a TopologyTask, there is no default value. When used with a ShapeTask, the default value is MODEL.

collisionCheckRegion=DEMOLD_REGION

The SymbolicConstant DEMOLD_REGION or a Region object specifying the collision check region. If the value is DEMOLD_REGION, then the value of region is used as both the demold region and the collision check region. The default value is DEMOLD_REGION.

csys=None

None or a DatumCsys object specifying the local coordinate system of the pullDirection. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int indicating the identifier of the DatumCsys. The default value is None.

drawAngle=0

A Float specifying the draw angle. The default value is 0.0.

masterPointDetermination=MAXIMUM

A SymbolicConstant specifying the rule for assigning point priority. Possible values are MAXIMUM and MINIMUM. The default value is MAXIMUM.

presumeFeasibleRegionAtStart=1

A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.

tolerance1=0

A Float specifying the geometric tolerance in the 1-direction. The default value is 0.01.

tolerance2=0

A Float specifying the geometric tolerance in the 2-direction. The default value is 0.01.

tolerance3=0

A Float specifying the geometric tolerance in the 3-direction. The default value is 0.01.

undercutTolerance=0

A Float specifying the undercut tolerance. The default value is 0.0.

Returns:

A ShapeDemoldControl object.

Return type:

ShapeDemoldControl

ShapeMemberSize(
name,
region,
maxThickness=0,
minThickness=0,
sizeRestriction=MINIMUM,
)[source]

This method creates a ShapeMemberSize object.

Note

This function can be accessed by:

mdb.models[name].optimizationTasks[name].ShapeMemberSize
Parameters:
name

A String specifying the geometric restriction repository key.

region

A Region object specifying the region to which the geometric restriction is applied. When used with a TopologyTask, there is no default value. When used with a ShapeTask, the default value is MODEL.

maxThickness=0

A Float specifying the maximum thickness. The default value is 0.0.

minThickness=0

A Float specifying the minimum thickness. The default value is 0.0.

sizeRestriction=MINIMUM

A SymbolicConstant specifying whether to restrict the minimum or maximum thickness. Possible values are MAXIMUM and MINIMUM. The default value is MINIMUM.

Returns:

A ShapeMemberSize object.

Return type:

ShapeMemberSize

ShapePlanarSymmetry(
name,
clientDirection,
region,
csys=None,
masterPointDetermination=MAXIMUM,
presumeFeasibleRegionAtStart=1,
tolerance1=0,
tolerance2=0,
tolerance3=0,
)[source]

This method creates a ShapePlanarSymmetry object.

Note

This function can be accessed by:

mdb.models[name].optimizationTasks[name].ShapePlanarSymmetry
Parameters:
name

A String specifying the geometric restriction repository key.

clientDirection

A VertexArray object of length 2 specifying the vector positioned at the csys origin that is normal to the symmetry plane. Instead of through a ConstrainedSketchVertex, each point may be specified through a tuple of coordinates.

region

A Region object specifying the region to which the geometric restriction is applied. When used with a TopologyTask, there is no default value. When used with a ShapeTask, the default value is MODEL.

csys=None

None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

masterPointDetermination=MAXIMUM

A SymbolicConstant specifying the rule for determining the master node. Possible values are MAXIMUM and MINIMUM. The default value is MAXIMUM.

presumeFeasibleRegionAtStart=1

A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.

tolerance1=0

A Float specifying the geometric tolerance in the 1-direction. The default value is 0.01.

tolerance2=0

A Float specifying the geometric tolerance in the 2-direction. The default value is 0.01.

tolerance3=0

A Float specifying the geometric tolerance in the 3-direction. The default value is 0.01.

Returns:

A ShapePlanarSymmetry object.

Return type:

ShapePlanarSymmetry

ShapePointSymmetry(
name,
region,
csys=None,
masterPointDetermination=MAXIMUM,
presumeFeasibleRegionAtStart=1,
tolerance1=0,
tolerance2=0,
tolerance3=0,
)[source]

This method creates a ShapePointSymmetry object.

Note

This function can be accessed by:

mdb.models[name].optimizationTasks[name].ShapePointSymmetry
Parameters:
name

A String specifying the geometric restriction repository key.

region

A Region object specifying the region to which the geometric restriction is applied. When used with a TopologyTask, there is no default value. When used with a ShapeTask, the default value is MODEL.

csys=None

None or a DatumCsys object specifying the symmetry point represented as the origin of a local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

masterPointDetermination=MAXIMUM

A SymbolicConstant specifying the rule for determining the master node. Possible values are MAXIMUM and MINIMUM. The default value is MAXIMUM.

presumeFeasibleRegionAtStart=1

A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.

tolerance1=0

A Float specifying the geometric tolerance in the 1-direction. The default value is 0.01.

tolerance2=0

A Float specifying the geometric tolerance in the 2-direction. The default value is 0.01.

tolerance3=0

A Float specifying the geometric tolerance in the 3-direction. The default value is 0.01.

Returns:

A ShapePointSymmetry object.

Return type:

ShapePointSymmetry

ShapeRotationalSymmetry(
name,
clientDirection,
region,
angle=0,
csys=None,
masterPoint=None,
masterPointDetermination=MAXIMUM,
presumeFeasibleRegionAtStart=1,
startPoint=None,
tolerance1=0,
tolerance2=0,
tolerance3=0,
)[source]

This method creates a ShapeRotationalSymmetry object.

Note

This function can be accessed by:

mdb.models[name].optimizationTasks[name].ShapeRotationalSymmetry
Parameters:
name

A String specifying the geometric restriction repository key.

clientDirection

A VertexArray object of length 2 specifying the vector positioned at the csys origin, used as the axis of symmetry. Instead of through a ConstrainedSketchVertex, each point might be specified through a tuple of coordinates.

region

A Region object specifying the region to which the geometric restriction is applied. When used with a TopologyTask, there is no default value. When used with a ShapeTask, the default value is MODEL.

angle=0

A Float specifying the segment size of the repeating pattern in degrees. If the angle value is 0, no repeating pattern is created. The default value is 0.0.

csys=None

None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

masterPoint=None

None or a Region object specifying the master point used when masterPointDetermination is SPECIFY. The default value is None.

masterPointDetermination=MAXIMUM

A SymbolicConstant specifying the rule for determining the master node. Possible values are MAXIMUM, MINIMUM, and SPECIFY. The default value is MAXIMUM.

presumeFeasibleRegionAtStart=1

A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.

startPoint=None

A tuple of Floats representing the coordinates of a start point of the rotational symmetry.

tolerance1=0

A Float specifying the geometric tolerance in the 1-direction. The default value is 0.01.

tolerance2=0

A Float specifying the geometric tolerance in the 2-direction. The default value is 0.01.

tolerance3=0

A Float specifying the geometric tolerance in the 3-direction. The default value is 0.01.

Returns:

A ShapeRotationalSymmetry object.

Return type:

ShapeRotationalSymmetry

SingleTermDesignResponse(
name,
identifier,
csys=None,
drivingRegion=None,
operation=SUM,
region=MODEL,
shellLayer=MAXIMUM,
stepOperation=SUM,
stepOptions=None,
)[source]

This method creates a SingleTermDesignResponse object.

Note

This function can be accessed by:

mdb.models[name].optimizationTasks[name].SingleTermDesignResponse
Parameters:
name

A String specifying the design response repository key.

identifier

A String specifying the name of the variable identifier.

csys=None

None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

drivingRegion=None

None or a sequence of Floats specifying the driving region used when identifier is an internal nodal variable. The default value is None.

operation=SUM

A SymbolicConstant specifying the operation used on values in the region. Possible values are MAXIMUM, MINIMUM, and SUM. The default value is SUM.

region=MODEL

The SymbolicConstant MODEL or a Region object specifying the region of the design response variable. The default value is MODEL.

shellLayer=MAXIMUM

A SymbolicConstant specifying the location used for shell layer values. Possible values are BOTTOM, MAXIMUM, MIDDLE, MINIMUM, and TOP. The default value is MAXIMUM.

stepOperation=SUM

A SymbolicConstant specifying the operation used on values across steps and load cases. Possible values are MAXIMUM, MINIMUM, and SUM. The default value is SUM.

stepOptions=None

A StepOptionArray object.

Returns:

A SingleTermDesignResponse object.

Return type:

SingleTermDesignResponse

SizingClusterAreas(name, regions)[source]

This method creates a SizingClusterAreas object.

Note

This function can be accessed by:

mdb.models[name].optimizationTasks[name].SizingClusterAreas
Parameters:
name

A String specifying the geometric restriction repository key.

regions

Tuple of Region objects specifying the regions to which the geometric restriction is applied.

Returns:

A SizingClusterAreas object.

Return type:

SizingClusterAreas

SizingCyclicSymmetry(
name,
region,
translation,
axis=AXIS_1,
csys=None,
ignoreFrozenArea=0,
)[source]

This method creates a SizingCyclicSymmetry object.

Note

This function can be accessed by:

mdb.models[name].optimizationTasks[name].SizingCyclicSymmetry
Parameters:
name

A String specifying the geometric restriction repository key.

region

A Region object specifying the region to which the geometric restriction is applied.

translation

A Float specifying the translation distance.

axis=AXIS_1

A SymbolicConstant specifying the translation direction defined along an axis positioned at the csys origin. Possible values are AXIS_1, AXIS_2, and AXIS_3. The default value is AXIS_1.

csys=None

None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

ignoreFrozenArea=0

A Boolean specifying whether to ignore frozen areas. The default value is OFF.

Returns:

A SizingCyclicSymmetry object.

Return type:

SizingCyclicSymmetry

SizingFrozenArea(name, region)[source]

This method creates a SizingFrozenArea object.

Note

This function can be accessed by:

mdb.models[name].optimizationTasks[name].SizingFrozenArea
Parameters:
name

A String specifying the geometric restriction repository key.

region

A Region object specifying the region to which the geometric restriction is applied.

Returns:

A SizingFrozenArea object.

Return type:

SizingFrozenArea

SizingMemberSize(name, region, minWidth)[source]

This method creates a SizingMemberSize object.

Note

This function can be accessed by:

mdb.models[name].optimizationTasks[name].SizingMemberSize
Parameters:
name

A String specifying the geometric restriction repository key.

region

A Region object specifying the region to which the geometric restriction is applied.

minWidth

A Float specifying the min width.

SizingPlanarSymmetry(
name,
region,
axis=AXIS_1,
csys=None,
ignoreFrozenArea=0,
)[source]

This method creates a SizingPlanarSymmetry object.

Note

This function can be accessed by:

mdb.models[name].optimizationTasks[name].SizingPlanarSymmetry
Parameters:
name

A String specifying the geometric restriction repository key.

region

A Region object specifying the region to which the geometric restriction is applied.

axis=AXIS_1

A SymbolicConstant specifying the axis of symmetry. Possible values are AXIS_1, AXIS_2, and AXIS_3. The default value is AXIS_1.

csys=None

None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

ignoreFrozenArea=0

A Boolean specifying whether to ignore frozen areas. The default value is OFF.

Returns:

A SizingPlanarSymmetry object.

Return type:

SizingPlanarSymmetry

SizingPointSymmetry(name, region, csys=None, ignoreFrozenArea=0)[source]

This method creates a SizingPointSymmetry object.

Note

This function can be accessed by:

mdb.models[name].optimizationTasks[name].SizingPointSymmetry
Parameters:
name

A String specifying the geometric restriction repository key.

region

A Region object specifying the region to which the geometric restriction is applied.

csys=None

None or a DatumCsys object specifying the position of the symmetry point defined as the origin of a local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

ignoreFrozenArea=0

A Boolean specifying whether to ignore frozen areas. The default value is OFF.

Returns:

A SizingPointSymmetry object.

Return type:

SizingPointSymmetry

SizingRotationalSymmetry(
name,
angle,
region,
axis=AXIS_1,
csys=None,
ignoreFrozenArea=0,
)[source]

This method creates a SizingRotationalSymmetry object.

Note

This function can be accessed by:

mdb.models[name].optimizationTasks[name].SizingRotationalSymmetry
Parameters:
name

A String specifying the geometric restriction repository key.

angle

A Float specifying the repeating segment size, an angle in degrees.

region

A Region object specifying the region to which the geometric restriction is applied.

axis=AXIS_1

A SymbolicConstant specifying the axis of symmetry. Possible values are AXIS_1, AXIS_2, and AXIS_3. The default value is AXIS_1.

csys=None

None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

ignoreFrozenArea=0

A Boolean specifying whether to ignore frozen areas. The default value is OFF.

Returns:

A SizingRotationalSymmetry object.

Return type:

SizingRotationalSymmetry

SlideRegionControl(
name,
clientDirection,
region,
approach=FREE_FORM,
csys=None,
freeFormRegion=None,
presumeFeasibleRegionAtStart=1,
revolvedRegion=None,
tolerance1=0,
tolerance2=0,
tolerance3=0,
)[source]

This method creates a SlideRegionControl object.

Note

This function can be accessed by:

mdb.models[name].optimizationTasks[name].SlideRegionControl
Parameters:
name

A String specifying the geometric restriction repository key.

clientDirection

A VertexArray object of length 2 specifying the axis of revolution. Instead of through a ConstrainedSketchVertex, each point may be specified through a tuple of coordinates. This is used when approach is TURN.

region

A Region object specifying the region to which the geometric restriction is applied. When used with a TopologyTask, there is no default value. When used with a ShapeTask, the default value is MODEL.

approach=FREE_FORM

A SymbolicConstant specifying the restriction approach. The SymbolicConstant FREE_FORM indicates a free-form slide region, and the SymbolicConstant TURN indicates that the restriction should conserve a turnable surface. Possible values are FREE_FORM and TURN. The default value is FREE_FORM.

csys=None

None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. This is used when approach is TURN. The default value is None.

freeFormRegion=None

None or a Region object specifying the free-form region. This is used when approach is FREE_FORM. The default value is None.

presumeFeasibleRegionAtStart=1

A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.

revolvedRegion=None

None or a Region object specifying the region to revolve into a slide region. This is used when approach is TURN. The default value is None.

tolerance1=0

A Float specifying the geometric tolerance in the 1-direction. This is used when approach is TURN. The default value is 0.01.

tolerance2=0

A Float specifying the geometric tolerance in the 2-direction. This is used when approach is TURN. The default value is 0.01.

tolerance3=0

A Float specifying the geometric tolerance in the 3-direction. This is used when approach is TURN. The default value is 0.01.

Returns:

A SlideRegionControl object.

Return type:

SlideRegionControl

StampControl(
name,
clientDirection,
region,
csys=None,
drawAngle=0,
masterPoint=None,
masterPointDetermination=MAXIMUM,
presumeFeasibleRegionAtStart=1,
tolerance1=0,
tolerance2=0,
tolerance3=0,
undercutTolerance=0,
)[source]

This method creates a StampControl object.

Note

This function can be accessed by:

mdb.models[name].optimizationTasks[name].StampControl
Parameters:
name

A String specifying the geometric restriction repository key.

clientDirection

A VertexArray object of length 2 specifying the stamping direction. Instead of through a ConstrainedSketchVertex, each point may be specified through a tuple of coordinates.

region

A Region object specifying the region to which the geometric restriction is applied. When used with a TopologyTask, there is no default value. When used with a ShapeTask, the default value is MODEL.

csys=None

None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

drawAngle=0

A Float specifying the draw angle. The default value is 0.0.

masterPoint=None

None or a Region object specifying the master point used when masterPointDetermination is SPECIFY. The default value is None.

masterPointDetermination=MAXIMUM

A SymbolicConstant specifying the rule for assigning point priority. Possible values are MAXIMUM, MINIMUM, and SPECIFY. The default value is MAXIMUM.

presumeFeasibleRegionAtStart=1

A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.

tolerance1=0

A Float specifying the geometric tolerance in the 1-direction. The default value is 0.01.

tolerance2=0

A Float specifying the geometric tolerance in the 2-direction. The default value is 0.01.

tolerance3=0

A Float specifying the geometric tolerance in the 3-direction. The default value is 0.01.

undercutTolerance=0

A Float specifying the undercut tolerance. The default value is 0.0.

Returns:

A StampControl object.

Return type:

StampControl

TopologyCyclicSymmetry(
name,
region,
translation,
axis=AXIS_1,
csys=None,
ignoreFrozenArea=0,
)[source]

This method creates a TopologyCyclicSymmetry object.

Note

This function can be accessed by:

mdb.models[name].optimizationTasks[name].TopologyCyclicSymmetry
Parameters:
name

A String specifying the geometric restriction repository key.

region

A Region object specifying the region to which the geometric restriction is applied. When used with a TopologyTask, there is no default value. When used with a ShapeTask, the default value is MODEL.

translation

A Float specifying the translation distance.

axis=AXIS_1

A SymbolicConstant specifying the translation direction defined along an axis positioned at the csys origin. Possible values are AXIS_1, AXIS_2, and AXIS_3. The default value is AXIS_1.

csys=None

None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

ignoreFrozenArea=0

A Boolean specifying whether to ignore frozen areas. The default value is OFF.

Returns:

A TopologyCyclicSymmetry object.

Return type:

TopologyCyclicSymmetry

TopologyDemoldControl(
name,
region,
csys=None,
draftAngle=0,
collisionCheckRegion=DEMOLD_REGION,
pointRegion=None,
pullDirection=(),
technique=AUTO,
)[source]

This method creates a TopologyDemoldControl object.

Note

This function can be accessed by:

mdb.models[name].optimizationTasks[name].TopologyDemoldControl
Parameters:
name

A String specifying the geometric restriction repository key.

region

A Region object specifying the region to which the geometric restriction is applied. When used with a TopologyTask, there is no default value. When used with a ShapeTask, the default value is MODEL.

csys=None

None or a DatumCsys object specifying the local coordinate system of the pullDirection. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int indicating the identifier of the DatumCsys. The default value is None.

draftAngle=0

A Float specifying the draft angle. The default value is 0.0.

collisionCheckRegion=DEMOLD_REGION

The SymbolicConstant DEMOLD_REGION or a Region object specifying the collision check region. If the value is DEMOLD_REGION, then the value of region is used as both the demold region and the collision check region. The default value is DEMOLD_REGION.

pointRegion=None

A Region object specifying the point on a plane perpendicular to the pull direction, used to specify the central plane when technique is POINT.

pullDirection=()

A VertexArray object of length 2 specifying the demold pull direction. Instead of through a ConstrainedSketchVertex, each point may be specified through a tuple of coordinates.

technique=AUTO

A SymbolicConstant specifying the demold technique. Possible values are AUTO, AUTO_TIGHT, POINT, SURFACE, and STAMP. The default value is AUTO.

Returns:

A TopologyDemoldControl object.

Return type:

TopologyDemoldControl

TopologyMemberSize(
name,
region,
maxThickness=0,
minThickness=0,
separation=0,
sizeRestriction=MINIMUM,
)[source]

This method creates a TopologyMemberSize object.

Note

This function can be accessed by:

mdb.models[name].optimizationTasks[name].TopologyMemberSize
Parameters:
name

A String specifying the geometric restriction repository key.

region

A Region object specifying the region to which the geometric restriction is applied. When used with a TopologyTask, there is no default value. When used with a ShapeTask, the default value is MODEL.

maxThickness=0

A Float specifying the maximum thickness. The default value is 0.0.

minThickness=0

A Float specifying the minimum thickness. The default value is 0.0.

separation=0

A Float specifying the minimum gap. The default value is 0.0.

sizeRestriction=MINIMUM

A SymbolicConstant specifying whether to restrict the minimum or maximum thickness or an envelope of both. Possible values are ENVELOPE, MAXIMUM, and MINIMUM. The default value is MINIMUM.

Returns:

A TopologyMemberSize object.

Return type:

TopologyMemberSize

TopologyPlanarSymmetry(
name,
region,
axis=AXIS_1,
csys=None,
ignoreFrozenArea=0,
)[source]

This method creates a TopologyPlanarSymmetry object.

Note

This function can be accessed by:

mdb.models[name].optimizationTasks[name].TopologyPlanarSymmetry
Parameters:
name

A String specifying the geometric restriction repository key.

region

A Region object specifying the region to which the geometric restriction is applied. When used with a TopologyTask, there is no default value. When used with a ShapeTask, the default value is MODEL.

axis=AXIS_1

A SymbolicConstant specifying the axis of symmetry. Possible values are AXIS_1, AXIS_2, and AXIS_3. The default value is AXIS_1.

csys=None

None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

ignoreFrozenArea=0

A Boolean specifying whether to ignore frozen areas. The default value is OFF.

Returns:

A TopologyPlanarSymmetry object.

Return type:

TopologyPlanarSymmetry

TopologyPointSymmetry(name, region, csys=None, ignoreFrozenArea=0)[source]

This method creates a TopologyPointSymmetry object.

Note

This function can be accessed by:

mdb.models[name].optimizationTasks[name].TopologyPointSymmetry
Parameters:
name

A String specifying the geometric restriction repository key.

region

A Region object specifying the region to which the geometric restriction is applied. When used with a TopologyTask, there is no default value. When used with a ShapeTask, the default value is MODEL.

csys=None

None or a DatumCsys object specifying the position of the symmetry point defined as the origin of a local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

ignoreFrozenArea=0

A Boolean specifying whether to ignore frozen areas. The default value is OFF.

Returns:

A TopologyPointSymmetry object.

Return type:

TopologyPointSymmetry

TopologyRotationalSymmetry(
name,
angle,
region,
axis=AXIS_1,
csys=None,
ignoreFrozenArea=0,
)[source]

This method creates a TopologyRotationalSymmetry object.

Note

This function can be accessed by:

mdb.models[name].optimizationTasks[name].TopologyRotationalSymmetry
Parameters:
name

A String specifying the geometric restriction repository key.

angle

A Float specifying the repeating segment size, an angle in degrees.

region

A Region object specifying the region to which the geometric restriction is applied. When used with a TopologyTask, there is no default value. When used with a ShapeTask, the default value is MODEL.

axis=AXIS_1

A SymbolicConstant specifying the axis of symmetry. Possible values are AXIS_1, AXIS_2, and AXIS_3. The default value is AXIS_1.

csys=None

None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

ignoreFrozenArea=0

A Boolean specifying whether to ignore frozen areas. The default value is OFF.

Returns:

A TopologyRotationalSymmetry object.

Return type:

TopologyRotationalSymmetry

TurnControl(
name,
clientDirection,
region,
csys=None,
masterPoint=None,
masterPointDetermination=MAXIMUM,
presumeFeasibleRegionAtStart=1,
tolerance1=0,
tolerance2=0,
tolerance3=0,
)[source]

This method creates a TurnControl object.

Note

This function can be accessed by:

mdb.models[name].optimizationTasks[name].TurnControl
Parameters:
name

A String specifying the geometric restriction repository key.

clientDirection

A VertexArray object of length 2 specifying the direction of the rotation axis as a vector positioned at the csys origin. Instead of through a ConstrainedSketchVertex, each point might be specified through a tuple of coordinates.

region

A Region object specifying the region to which the geometric restriction is applied. When used with a TopologyTask, there is no default value. When used with a ShapeTask, the default value is MODEL.

csys=None

None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

masterPoint=None

None or a Region object specifying the master point used when masterPointDetermination is SPECIFY. The default value is None.

masterPointDetermination=MAXIMUM

A SymbolicConstant specifying the rule for assigning point priority. Possible values are MAXIMUM, MINIMUM, and SPECIFY. The default value is MAXIMUM.

presumeFeasibleRegionAtStart=1

A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.

tolerance1=0

A Float specifying the geometric tolerance in the 1-direction. The default value is 0.01.

tolerance2=0

A Float specifying the geometric tolerance in the 2-direction. The default value is 0.01.

tolerance3=0

A Float specifying the geometric tolerance in the 3-direction. The default value is 0.01.

Returns:

A TurnControl object.

Return type:

TurnControl

Other Classes

class BeadFixedRegion(name, region, csys=None, u1=0, u2=0, u3=0)[source]

Bases: GeometricRestriction

The BeadFixedRegion object defines a fixed region geometric restriction. The BeadFixedRegion object is derived from the GeometricRestriction object.

Note

This object can be accessed by:

import optimization
mdb.models[name].optimizationTasks[name].geometricRestrictions[name]

Member Details:

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

None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

setValues(csys=None, u1=0, u2=0, u3=0)[source]

This method modifies the BeadFixedRegion object.

Parameters:
csys=None

None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

u1=0

A Boolean specifying whether to fix the region in the 1-direction. The default value is OFF.

u2=0

A Boolean specifying whether to fix the region in the 2-direction. The default value is OFF.

u3=0

A Boolean specifying whether to fix the region in the 3-direction. The default value is OFF.

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

A Boolean specifying whether to fix the region in the 1-direction. The default value is OFF.

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

A Boolean specifying whether to fix the region in the 2-direction. The default value is OFF.

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

A Boolean specifying whether to fix the region in the 3-direction. The default value is OFF.

class GeometricRestriction[source]

Bases: object

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

Note

This object can be accessed by:

import optimization
mdb.models[name].optimizationTasks[name].geometricRestrictions[name]

Member Details:

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

A String specifying the geometric restriction repository key.

region : --is-rst--:py:class:`~abaqus.Region.Region.Region` = <abaqus.Region.Region.Region object>[source]

A Region object specifying the region to which the geometric restriction is applied. When used with a TopologyTask, there is no default value. When used with a ShapeTask, the default value is MODEL.

class BeadGrowth(name, region, beadGrowth=0, shrink=0)[source]

Bases: GeometricRestriction

The BeadGrowth object defines a growth geometric restriction. The BeadGrowth object is derived from the GeometricRestriction object.

Note

This object can be accessed by:

import optimization
mdb.models[name].optimizationTasks[name].geometricRestrictions[name]

Member Details:

beadGrowth : --is-rst--:py:class:`float` = 0[source]

A Float specifying the maximum optimization displacement in the growth direction. Either beadGrowth or shrink or both must be specified. The default value is 0.0.

setValues(beadGrowth=0, shrink=0)[source]

This method modifies the BeadGrowth object.

Parameters:
beadGrowth=0

A Float specifying the maximum optimization displacement in the growth direction. Either beadGrowth or shrink or both must be specified. The default value is 0.0.

shrink=0

A Float specifying the maximum optimization displacement in the shrink direction. Either beadGrowth or shrink or both must be specified The default value is 0.0.

shrink : --is-rst--:py:class:`float` = 0[source]

A Float specifying the maximum optimization displacement in the shrink direction. Either beadGrowth or shrink or both must be specified The default value is 0.0.

class BeadPenetrationCheck(name, beadPenetrationCheckRegion, region)[source]

Bases: GeometricRestriction

The BeadPenetrationCheck object defines a penetration check geometric restriction. The BeadPenetrationCheck object is derived from the GeometricRestriction object.

Note

This object can be accessed by:

import optimization
mdb.models[name].optimizationTasks[name].geometricRestrictions[name]

Member Details:

beadPenetrationCheckRegion : --is-rst--:py:class:`~abaqus.Region.Region.Region`[source]

A Region object specifying the penetration check region.

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

This method modifies the BeadPenetrationCheck object.

class BeadPlanarSymmetry(name, region, axis=AXIS_1, csys=None)[source]

Bases: GeometricRestriction

The BeadPlanarSymmetry object defines a bead planar symmetry geometric restriction. The BeadPlanarSymmetry object is derived from the GeometricRestriction object.

Note

This object can be accessed by:

import optimization
mdb.models[name].optimizationTasks[name].geometricRestrictions[name]

Member Details:

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

A SymbolicConstant specifying the axis of symmetry. Possible values are AXIS_1, AXIS_2, and AXIS_3. The default value is AXIS_1.

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

None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

setValues(axis=AXIS_1, csys=None)[source]

This method modifies the BeadPlanarSymmetry object.

Parameters:
axis=AXIS_1

A SymbolicConstant specifying the axis of symmetry. Possible values are AXIS_1, AXIS_2, and AXIS_3. The default value is AXIS_1.

csys=None

None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

class BeadPointSymmetry(name, region, csys=None)[source]

Bases: GeometricRestriction

The BeadPointSymmetry object defines a point symmetry geometric restriction. The BeadPointSymmetry object is derived from the GeometricRestriction object.

Note

This object can be accessed by:

import optimization
mdb.models[name].optimizationTasks[name].geometricRestrictions[name]

Member Details:

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

None or a DatumCsys object specifying the position of the symmetry point defined as the origin of a local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

setValues(csys=None)[source]

This method modifies the BeadPointSymmetry object.

Parameters:
csys=None

None or a DatumCsys object specifying the position of the symmetry point defined as the origin of a local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

class BeadRotationalSymmetry(name, angle, region, axis=AXIS_1, csys=None)[source]

Bases: GeometricRestriction

The BeadRotationalSymmetry object defines a bead rotational symmetry geometric restriction. The BeadRotationalSymmetry object is derived from the GeometricRestriction object.

Note

This object can be accessed by:

import optimization
mdb.models[name].optimizationTasks[name].geometricRestrictions[name]

Member Details:

angle : --is-rst--:py:class:`float`[source]

A Float specifying the repeating segment size, an angle in degrees.

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

A SymbolicConstant specifying the axis of symmetry. Possible values are AXIS_1, AXIS_2, and AXIS_3. The default value is AXIS_1.

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

None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

setValues(axis=AXIS_1, csys=None)[source]

This method modifies the BeadRotationalSymmetry object.

Parameters:
axis=AXIS_1

A SymbolicConstant specifying the axis of symmetry. Possible values are AXIS_1, AXIS_2, and AXIS_3. The default value is AXIS_1.

csys=None

None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

class BeadTask(
name,
algorithm=GENERAL_OPTIMIZATION,
areBCRegionsFrozen=0,
beadIter=1,
beadMaxMembraneStress=0,
beadMinStress=0,
beadPerturbation=0,
beadWidth=DEFAULT,
curveSmooth=5,
filterRadius=4,
filterRadiusBy=VALUE,
flipNormalDir=0,
frozenBoundaryConditionRegion=MODEL,
isSensCalcOnlyOnDesignNodes=0,
modeTrackingRegion=MODEL,
nodalMoveLimit=0,
nodeSmooth=DEFAULT,
nodeUpdateStrategy=CONSERVATIVE,
numTrackedModes=5,
updateShapeBasisVectors=EVERY_CYCLE,
)[source]

Bases: OptimizationTask

The BeadTask object defines a bead task. The BeadTask object is derived from the OptimizationTask object.

Note

This object can be accessed by:

import optimization
mdb.models[name].optimizationTasks[name]

Member Details:

algorithm : --is-rst--SymbolicConstant = 'GENERAL_OPTIMIZATION'[source]

A SymbolicConstant specifying the optimization task algorithm. Possible values are GENERAL_OPTIMIZATION and CONDITION_BASED_OPTIMIZATION. The default value is GENERAL_OPTIMIZATION.

areBCRegionsFrozen : --is-rst--Boolean = 0[source]

A Boolean specifying whether to exclude elements with boundary conditions from the optimization. The default value is OFF.

beadIter : --is-rst--int = 1[source]

An int specifying the step size of the optimization. The default value is 1.

beadMaxMembraneStress : --is-rst--float = 0[source]

A float specifying maximum membrane/bending stress. The default value is 0.1.

beadMinStress : --is-rst--float = 0[source]

A float specifying minimum stress. The default value is 0.001.

beadPerturbation : --is-rst--float = 0[source]

A Sets perturbation size for finite differences. The default value is 0.0001.

beadWidth : --is-rst--SymbolicConstant = 'DEFAULT'[source]

A SymbolicConstant specifying the Optimization product default or a float specifying the bead width. The default value is DEFAULT.

curveSmooth : --is-rst--float = 5[source]

A float specifying relative value to the middle element edge length such that normals in this area do not cross each other. The default value is 5.

designResponses : --is-rst--dict[str, DesignResponse] = {}[source]

A repository of DesignResponse objects.

filterRadius : --is-rst--float = 4[source]

A float specifying the filter radius. The default value is 4.

filterRadiusBy : --is-rst--SymbolicConstant = 'VALUE'[source]

A SymbolicConstant specifying the method used to define filter radius. Possible values are VALUE and REFERENCE. The default is VALUE.

flipNormalDir : --is-rst--Boolean = 0[source]

A Boolean specifying whether the growth direction is along the normal direction of elements or opposite to the normal direction. The default value is OFF

frozenBoundaryConditionRegion : --is-rst--SymbolicConstant = 'MODEL'[source]

When nodes with boundary conditions are excluded from the optimization (frozenBoundaryConditionRegions = ON). you can specify that this exclusion apply to nodes throughout the model or only to those nodes from a specific region. Set this parameter to the SymbolicConstant MODEL to apply the freeze to the entire model, or set this parameter to a Region object to specify an individual region over which nodes with boundary conditions should be frozen. The default value is MODEL.

geometricRestrictions : --is-rst--dict[str, GeometricRestriction] = {}[source]

A repository of GeometricRestriction objects.

groupOperator : --is-rst--Boolean = 0[source]

A Boolean specifying whether the group in the design response will be evaluated using the existing algorithm or a new algorithm based on Abaqus sensitivities. The default value of False means that the existing algorithm will be used.

isSensCalcOnlyOnDesignNodes : --is-rst--Boolean = 0[source]

A Boolean specifying whether to calculate the sensitivities only on design nodes or the whole model. The default value is ON

modeTrackingRegion : --is-rst--SymbolicConstant = 'MODEL'[source]

The SymbolicConstant MODEL or a Region object specifying the region to use for mode tracking. The default value is MODEL.

nodalMoveLimit : --is-rst--float = 0[source]

A Float specifying the maximum change in nodal displacement per design cycle. The default value is 0.1.

nodeSmooth : --is-rst--SymbolicConstant = 'DEFAULT'[source]

A SymbolicConstant specifying the Optimization product default or a float specifying the node smooth. The default value is DEFAULT.

nodeUpdateStrategy : --is-rst--SymbolicConstant = 'CONSERVATIVE'[source]

A SymbolicConstant specifying the strategy for how the nodal displacements are updated in the method of moving asymptotes. Possible values are NORMAL, CONSERVATIVE, and AGGRESSIVE. The default value is CONSERVATIVE.

numTrackedModes : --is-rst--int = 5[source]

An Int specifying the number of modes included in mode tracking. The default value is 5.

objectiveFunctions : --is-rst--dict[str, ObjectiveFunction] = {}[source]

A repository of ObjectiveFunction objects.

optimizationConstraints : --is-rst--dict[str, OptimizationConstraint] = {}[source]

A repository of OptimizationConstraint objects.

setValues(
algorithm=GENERAL_OPTIMIZATION,
areBCRegionsFrozen=0,
beadIter=1,
beadMaxMembraneStress=0,
beadMinStress=0,
beadPerturbation=0,
beadWidth=DEFAULT,
curveSmooth=5,
filterRadius=4,
filterRadiusBy=VALUE,
flipNormalDir=0,
frozenBoundaryConditionRegion=MODEL,
isSensCalcOnlyOnDesignNodes=0,
modeTrackingRegion=MODEL,
nodalMoveLimit=0,
nodeSmooth=DEFAULT,
nodeUpdateStrategy=CONSERVATIVE,
numTrackedModes=5,
updateShapeBasisVectors=EVERY_CYCLE,
)[source]

This method modifies the BeadTask object.

Parameters:
algorithm=GENERAL_OPTIMIZATION

A SymbolicConstant specifying the optimization task algorithm. Possible values are GENERAL_OPTIMIZATION and CONDITION_BASED_OPTIMIZATION. The default value is GENERAL_OPTIMIZATION.

areBCRegionsFrozen=0

A Boolean specifying whether to exclude elements with boundary conditions from the optimization. The default value is OFF.

beadIter=1

An int specifying the step size of the optimization. The default value is 1.

beadMaxMembraneStress=0

A float specifying maximum membrane/bending stress. The default value is 0.1.

beadMinStress=0

A float specifying minimum stress. The default value is 0.001.

beadPerturbation=0

A Sets perturbation size for finite differences. The default value is 0.0001.

beadWidth=DEFAULT

A SymbolicConstant specifying the Optimization product default or a float specifying the bead width. The default value is DEFAULT.

curveSmooth=5

A float specifying relative value to the middle element edge length such that normals in this area do not cross each other. The default value is 5.

filterRadius=4

A float specifying the filter radius. The default value is 4.

filterRadiusBy=VALUE

A SymbolicConstant specifying the method used to define filter radius. Possible values are VALUE and REFERENCE. The default is VALUE.

flipNormalDir=0

A Boolean specifying whether the growth direction is along the normal direction of elements or opposite to the normal direction. The default value is OFF

frozenBoundaryConditionRegion=MODEL

When nodes with boundary conditions are excluded from the optimization (frozenBoundaryConditionRegions = ON). you can specify that this exclusion apply to nodes throughout the model or only to those nodes from a specific region. Set this parameter to the SymbolicConstant MODEL to apply the freeze to the entire model, or set this parameter to a Region object to specify an individual region over which nodes with boundary conditions should be frozen. The default value is MODEL.

isSensCalcOnlyOnDesignNodes=0

A Boolean specifying whether to calculate the sensitivities only on design nodes or the whole model. The default value is ON

modeTrackingRegion=MODEL

The SymbolicConstant MODEL or a Region object specifying the region to use for mode tracking. The default value is MODEL.

nodalMoveLimit=0

A Float specifying the maximum change in nodal displacement per design cycle. The default value is 0.1.

nodeSmooth=DEFAULT

A SymbolicConstant specifying the Optimization product default or a float specifying the node smooth. The default value is DEFAULT.

nodeUpdateStrategy=CONSERVATIVE

A SymbolicConstant specifying the strategy for how the nodal displacements are updated in the method of moving asymptotes. Possible values are NORMAL, CONSERVATIVE, and AGGRESSIVE. The default value is CONSERVATIVE.

numTrackedModes=5

An Int specifying the number of modes included in mode tracking. The default value is 5.

updateShapeBasisVectors=EVERY_CYCLE

A SymbolicConstant specifying whether to update shape basis vectors in the first design cycle or every design cycle. Possible values are EVERY_CYCLE and FIRST_CYCLE. The default value is EVERY_CYCLE.

updateShapeBasisVectors : --is-rst--SymbolicConstant = 'EVERY_CYCLE'[source]

A SymbolicConstant specifying whether to update shape basis vectors in the first design cycle or every design cycle. Possible values are EVERY_CYCLE and FIRST_CYCLE. The default value is EVERY_CYCLE.

class DesignResponse[source]

Bases: object

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

Note

This object can be accessed by:

import optimization
mdb.models[name].optimizationTasks[name].designResponses[name]

Member Details:

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

A String specifying the design response repository key.

class ObjectiveFunction(name, objectives, target=MINIMIZE)[source]

Bases: object

The ObjectiveFunction object defines the objective of the optimization.

Note

This object can be accessed by:

import optimization
mdb.models[name].optimizationTasks[name].objectiveFunctions[name]

Member Details:

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

A String specifying the objective function repository key.

objectives : --is-rst--:py:class:`~typing.List`\ \[:py:class:`~abaqus.Optimization.OptimizationObjective.OptimizationObjective`] = [][source]

Optimization objectives

setValues(target=MINIMIZE)[source]

This method modifies the ObjectiveFunction object.

Parameters:
target=MINIMIZE

A SymbolicConstant specifying the target of the objective function. Possible values are MINIMIZE, MAXIMIZE, and MINIMIZE_MAXIMUM. The default value is MINIMIZE.

Raises:

RangeError

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

A SymbolicConstant specifying the target of the objective function. Possible values are MINIMIZE, MAXIMIZE, and MINIMIZE_MAXIMUM. The default value is MINIMIZE.

class OptimizationConstraint(
name,
designResponse,
restrictionValue,
restrictionMethod=ABSOLUTE_EQUAL,
)[source]

Bases: object

The OptimizationConstraint object constrains an optimization from making changes to the topology of the model.

Note

This object can be accessed by:

import optimization
mdb.models[name].optimizationTasks[name].optimizationConstraints[name]

Member Details:

designResponse : --is-rst--:py:class:`str`[source]

A String specifying the name of the design response to constrain.

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

A String specifying the optimization constraint repository key.

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

A SymbolicConstant specifying the method used to constrain the design response. Possible values are ABSOLUTE_EQUAL, ABSOLUTE_GREATER_THAN_EQUAL, ABSOLUTE_LESS_THAN_EQUAL, RELATIVE_EQUAL, RELATIVE_GREATER_THAN_EQUAL, and RELATIVE_LESS_THAN_EQUAL. The default value is ABSOLUTE_EQUAL.

restrictionValue : --is-rst--:py:class:`float`[source]

A Float specifying the value to which the design response should be constrained.

setValues(restrictionMethod=ABSOLUTE_EQUAL)[source]

This method modifies the OptimizationConstraint object.

Parameters:
restrictionMethod=ABSOLUTE_EQUAL

A SymbolicConstant specifying the method used to constrain the design response. Possible values are ABSOLUTE_EQUAL, ABSOLUTE_GREATER_THAN_EQUAL, ABSOLUTE_LESS_THAN_EQUAL, RELATIVE_EQUAL, RELATIVE_GREATER_THAN_EQUAL, and RELATIVE_LESS_THAN_EQUAL. The default value is ABSOLUTE_EQUAL.

Raises:

RangeError

class CombinedTermDesignResponse(
name,
terms,
filterMaxRadius=None,
filterExponent=1,
filterRadiusReduction=0,
highCutOff=None,
lowCutOff=0,
method=ADD,
weights=(),
)[source]

Bases: DesignResponse

The CombinedTermDesignResponse object defines a combined-term design response. The CombinedTermDesignResponse object is derived from the DesignResponse object.

Note

This object can be accessed by:

import optimization
mdb.models[name].optimizationTasks[name].designResponses[name]

Member Details:

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

A Float specifying the exponent used when method is FILTER. The default value is 1.0.

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

None or a sequence of Floats specifying the maximum radius of influence used when method is FILTER. The default value is None.

filterRadiusReduction : --is-rst--:py:class:`float` = 0[source]

A Float specifying the reduction of the radius depending on surface bending, used when method is FILTER. The default value is 0.2.

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

None or a sequence of Floats specifying the upper bound of the vector value used when method is CUT_OFF. All values greater than the highCutOff are set to the highCutOff value. The default value is None.

lowCutOff : --is-rst--:py:class:`float` = 0[source]

A Float specifying the lower bound of the vector value used when method is CUT_OFF. All values less than the lowCutOff are treated as 0. The default value is 0.0.

method : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'ADD'[source]
  • ABSOLUTE_DIFFERENCE

  • ABSOLUTE_VALUE

  • ADD

  • COSINE

  • CUT_OFF

  • DELTA_OVER_1_ITERATION

  • DELTA_OVER_2_ITERATIONS

  • DELTA_OVER_3_ITERATIONS

  • DELTA_OVER_4_ITERATIONS

  • DELTA_OVER_5_ITERATIONS

  • DELTA_OVER_6_ITERATIONS

  • DIVIDE

  • EXPONENTIAL

  • FILTER

  • INTEGER

  • LOG

  • MAXIMUM

  • MINIMUM

  • MULTIPLY

  • NATURAL_LOG

  • NEAREST_INTEGER

  • NORM

  • NORM_FIRST

  • NTH_POWER

  • NTH_ROOT

  • SIGN

  • SINE

  • SQUARE_ROOT

  • SUBTRACT

  • TANGENT

  • WEIGHTED_ADD

The default value is ADD.

setValues(
filterMaxRadius=None,
filterExponent=1,
filterRadiusReduction=0,
highCutOff=None,
lowCutOff=0,
method=ADD,
weights=(),
)[source]

This method modifies the CombinedTermDesignResponse object.

Parameters:
filterMaxRadius=None

None or a sequence of Floats specifying the maximum radius of influence used when method is FILTER. The default value is None.

filterExponent=1

A Float specifying the exponent used when method is FILTER. The default value is 1.0.

filterRadiusReduction=0

A Float specifying the reduction of the radius depending on surface bending, used when method is FILTER. The default value is 0.2.

highCutOff=None

None or a sequence of Floats specifying the upper bound of the vector value used when method is CUT_OFF. All values greater than the highCutOff are set to the highCutOff value. The default value is None.

lowCutOff=0

A Float specifying the lower bound of the vector value used when method is CUT_OFF. All values less than the lowCutOff are treated as 0. The default value is 0.0.

method=ADD

A SymbolicConstant specifying the method used to combine selected design responses. Possible values are:

  • ABSOLUTE_DIFFERENCE

  • ABSOLUTE_VALUE

  • ADD

  • COSINE

  • CUT_OFF

  • DELTA_OVER_1_ITERATION

  • DELTA_OVER_2_ITERATIONS

  • DELTA_OVER_3_ITERATIONS

  • DELTA_OVER_4_ITERATIONS

  • DELTA_OVER_5_ITERATIONS

  • DELTA_OVER_6_ITERATIONS

  • DIVIDE

  • EXPONENTIAL

  • FILTER

  • INTEGER

  • LOG

  • MAXIMUM

  • MINIMUM

  • MULTIPLY

  • NATURAL_LOG

  • NEAREST_INTEGER

  • NORM

  • NORM_FIRST

  • NTH_POWER

  • NTH_ROOT

  • SIGN

  • SINE

  • SQUARE_ROOT

  • SUBTRACT

  • TANGENT

  • WEIGHTED_ADD

The default value is ADD.

weights=()

A sequence of Floats specifying the weights to apply to the list of design responses used when method is WEIGHTED_ADD. The default value is an empty sequence.

terms : --is-rst--:py:class:`tuple`\ \[:py:class:`str`, :py:data:`...<Ellipsis>`] = ()[source]

A sequence of Strings specifying the names of the design responses to combine.

weights : --is-rst--:py:class:`tuple`\ \[:py:class:`float`, :py:data:`...<Ellipsis>`] = ()[source]

A sequence of Floats specifying the weights to apply to the list of design responses used when method is WEIGHTED_ADD. The default value is an empty sequence.

class DesignDirection(
name,
region,
csys,
masterPoint=None,
masterPointDetermination=MAXIMUM,
movementRestriction=VECTOR,
presumeFeasibleRegionAtStart=1,
u1=1,
u2=1,
u3=1,
)[source]

Bases: GeometricRestriction

The DesignDirection object defines a design direction geometric restriction. The DesignDirection object is derived from the GeometricRestriction object.

Note

This object can be accessed by:

import optimization
mdb.models[name].optimizationTasks[name].geometricRestrictions[name]

Member Details:

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

None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

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

None or a Region object specifying the master point used when masterPointDetermination is SPECIFY. The default value is None.

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

A SymbolicConstant specifying the rule for assigning point priority. Possible values are MAXIMUM, MINIMUM, and SPECIFY. The default value is MAXIMUM.

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

A SymbolicConstant specifying whether movement in the region should follow only the direction of the masterPoint, only the magnitude, or both the magnitude of the masterPoint and the directions specified by u1, u2 and u3. Possible values are DIRECTION, MAGNITUDE, and VECTOR. The default value is VECTOR.

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

A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.

setValues(
csys,
masterPoint=None,
masterPointDetermination=MAXIMUM,
movementRestriction=VECTOR,
presumeFeasibleRegionAtStart=1,
u1=1,
u2=1,
u3=1,
)[source]

This method modifies the DesignDirection object.

Parameters:
csys

None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

masterPoint=None

None or a Region object specifying the master point used when masterPointDetermination is SPECIFY. The default value is None.

masterPointDetermination=MAXIMUM

A SymbolicConstant specifying the rule for assigning point priority. Possible values are MAXIMUM, MINIMUM, and SPECIFY. The default value is MAXIMUM.

movementRestriction=VECTOR

A SymbolicConstant specifying whether movement in the region should follow only the direction of the masterPoint, only the magnitude, or both the magnitude of the masterPoint and the directions specified by u1, u2 and u3. Possible values are DIRECTION, MAGNITUDE, and VECTOR. The default value is VECTOR.

presumeFeasibleRegionAtStart=1

A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.

u1=1

A Boolean specifying whether movement in the region should follow the masterPoint in the 1-direction. This is used when movementRestriction is VECTOR. The default value is ON.

u2=1

A Boolean specifying whether movement in the region should follow the masterPoint in the 2-direction. This is used when movementRestriction is VECTOR. The default value is ON.

u3=1

A Boolean specifying whether movement in the region should follow the masterPoint in the 3-direction. This is used when movementRestriction is VECTOR. The default value is ON.

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

A Boolean specifying whether movement in the region should follow the masterPoint in the 1-direction. This is used when movementRestriction is VECTOR. The default value is ON.

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

A Boolean specifying whether movement in the region should follow the masterPoint in the 2-direction. This is used when movementRestriction is VECTOR. The default value is ON.

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

A Boolean specifying whether movement in the region should follow the masterPoint in the 3-direction. This is used when movementRestriction is VECTOR. The default value is ON.

class DrillControl(
name,
clientDirection,
region,
csys=None,
drawAngle=0,
masterPoint=None,
masterPointDetermination=MAXIMUM,
presumeFeasibleRegionAtStart=1,
tolerance1=0,
tolerance2=0,
tolerance3=0,
undercutTolerance=0,
)[source]

Bases: GeometricRestriction

The DrillControl object defines a drill control geometric restriction. The DrillControl object is derived from the GeometricRestriction object.

Note

This object can be accessed by:

import optimization
mdb.models[name].optimizationTasks[name].geometricRestrictions[name]

Member Details:

clientDirection : --is-rst--:py:class:`tuple`[source]

A VertexArray object of length 2 specifying the direction of the drill axis positioned at the csys origin. Instead of through a ConstrainedSketchVertex, each point may be specified through a tuple of coordinates.

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

None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

drawAngle : --is-rst--:py:class:`float` = 0[source]

A Float specifying the draw angle. The default value is 0.0.

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

None or a Region object specifying the master point used when masterPointDetermination is SPECIFY. The default value is None.

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

A SymbolicConstant specifying the rule for assigning point priority. Possible values are MAXIMUM, MINIMUM, and SPECIFY. The default value is MAXIMUM.

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

A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.

setValues(
csys=None,
drawAngle=0,
masterPoint=None,
masterPointDetermination=MAXIMUM,
presumeFeasibleRegionAtStart=1,
tolerance1=0,
tolerance2=0,
tolerance3=0,
undercutTolerance=0,
)[source]

This method modifies the DrillControl object.

Parameters:
csys=None

None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

drawAngle=0

A Float specifying the draw angle. The default value is 0.0.

masterPoint=None

None or a Region object specifying the master point used when masterPointDetermination is SPECIFY. The default value is None.

masterPointDetermination=MAXIMUM

A SymbolicConstant specifying the rule for assigning point priority. Possible values are MAXIMUM, MINIMUM, and SPECIFY. The default value is MAXIMUM.

presumeFeasibleRegionAtStart=1

A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.

tolerance1=0

A Float specifying the geometric tolerance in the 1-direction. The default value is 0.01.

tolerance2=0

A Float specifying the geometric tolerance in the 2-direction. The default value is 0.01.

tolerance3=0

A Float specifying the geometric tolerance in the 3-direction. The default value is 0.01.

undercutTolerance=0

A Float specifying the undercut tolerance. The default value is 0.0.

tolerance1 : --is-rst--:py:class:`float` = 0[source]

A Float specifying the geometric tolerance in the 1-direction. The default value is 0.01.

tolerance2 : --is-rst--:py:class:`float` = 0[source]

A Float specifying the geometric tolerance in the 2-direction. The default value is 0.01.

tolerance3 : --is-rst--:py:class:`float` = 0[source]

A Float specifying the geometric tolerance in the 3-direction. The default value is 0.01.

undercutTolerance : --is-rst--:py:class:`float` = 0[source]

A Float specifying the undercut tolerance. The default value is 0.0.

class FixedRegion(name, region, csys=None, presumeFeasibleRegionAtStart=1, u1=0, u2=0, u3=0)[source]

Bases: GeometricRestriction

The FixedRegion object defines a fixed region geometric restriction. The FixedRegion object is derived from the GeometricRestriction object.

Note

This object can be accessed by:

import optimization
mdb.models[name].optimizationTasks[name].geometricRestrictions[name]

Member Details:

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

None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

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

A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.

setValues(csys=None, presumeFeasibleRegionAtStart=1, u1=0, u2=0, u3=0)[source]

This method modifies the FixedRegion object.

Parameters:
csys=None

None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

presumeFeasibleRegionAtStart=1

A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.

u1=0

A Boolean specifying whether to fix the region in the 1-direction. The default value is OFF.

u2=0

A Boolean specifying whether to fix the region in the 2-direction. The default value is OFF.

u3=0

A Boolean specifying whether to fix the region in the 3-direction. The default value is OFF.

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

A Boolean specifying whether to fix the region in the 1-direction. The default value is OFF.

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

A Boolean specifying whether to fix the region in the 2-direction. The default value is OFF.

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

A Boolean specifying whether to fix the region in the 3-direction. The default value is OFF.

class FrozenArea(name, region=<abaqus.Region.Region.Region object>)[source]

Bases: GeometricRestriction

The FrozenArea object defines a frozen area geometric restriction. The FrozenArea object is derived from the GeometricRestriction object.

Note

This object can be accessed by:

import optimization
mdb.models[name].optimizationTasks[name].geometricRestrictions[name]

Member Details:

region : --is-rst--:py:class:`~abaqus.Region.Region.Region` = <abaqus.Region.Region.Region object>[source]

A Region object specifying the region to which the geometric restriction is applied. When used with a TopologyTask, there is no default value. When used with a ShapeTask, the default value is MODEL.

setValues(region=<abaqus.Region.Region.Region object>)[source]

This method modifies the FrozenArea object.

Parameters:
region : Region, default: <abaqus.Region.Region.Region object at 0x7ff9e7dc6950>

A Region object specifying the region to which the geometric restriction is applied. When used with a TopologyTask, there is no default value. When used with a ShapeTask, the default value is MODEL.

class Growth(name, region, growth=0, presumeFeasibleRegionAtStart=1, shrink=0)[source]

Bases: GeometricRestriction

The Growth object defines a growth geometric restriction. The Growth object is derived from the GeometricRestriction object.

Note

This object can be accessed by:

import optimization
mdb.models[name].optimizationTasks[name].geometricRestrictions[name]

Member Details:

growth : --is-rst--:py:class:`float` = 0[source]

A Float specifying the maximum optimization displacement in the growth direction. Either growth or shrink or both must be specified. The default value is 0.0.

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

A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.

setValues(growth=0, presumeFeasibleRegionAtStart=1, shrink=0)[source]

This method modifies the Growth object.

Parameters:
growth=0

A Float specifying the maximum optimization displacement in the growth direction. Either growth or shrink or both must be specified. The default value is 0.0.

presumeFeasibleRegionAtStart=1

A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.

shrink=0

A Float specifying the maximum optimization displacement in the shrink direction. Either growth or shrink or both must be specified The default value is 0.0.

shrink : --is-rst--:py:class:`float` = 0[source]

A Float specifying the maximum optimization displacement in the shrink direction. Either growth or shrink or both must be specified The default value is 0.0.

class LocalStopCondition(
name,
referenceFactor,
comparisonOperation=LESS_THAN,
identifier=MOVEMENT,
identifierOperation=MAXIMUM,
referenceDesignCycle=PREVIOUS,
referenceOperation=ADD,
region=MODEL,
)[source]

Bases: StopCondition

The LocalStopCondition object defines a local stop condition. The LocalStopCondition object is derived from the StopCondition object.

Note

This object can be accessed by:

import optimization
mdb.models[name].optimizationTasks[name].stopConditions[name]

Member Details:

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

A SymbolicConstant specifying the operation used to compare the selected value to the reference value. Possible values are LESS_THAN, LESS_THAN_EQUAL, EQUAL, GREATER_THAN_EQUAL, and GREATER_THAN. The default value is LESS_THAN.

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

A SymbolicConstant specifying the variable identifier of the compared value. Possible values are:

  • ABSOLUTE_GROWTH_MOVEMENT

  • ABSOLUTE_SHRINK_MOVEMENT

  • GROWTH_MOVEMENT

  • SHRINK_MOVEMENT

  • MOVEMENT

  • TOTAL_ABSOLUTE_MOVEMENT

  • EQUIV_STRESS

  • FREE_TASK_REGION_EQUIV_STRESS

  • RESTRICTED_TASK_REGION_EQUIV_STRESS

  • SURFACE_POINT_EQUIV_STRESS

  • TASK_REGION_EQUIV_STRESS

The default value is MOVEMENT.

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

A SymbolicConstant specifying the operation used to evaluate values in the region. Possible values are MAXIMUM, MINIMUM, and SUM. The default value is MAXIMUM.

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

A SymbolicConstant specifying the iteration from which a value is compared to the reference value. Possible values are FIRST and PREVIOUS. The default value is PREVIOUS.

referenceFactor : --is-rst--:py:class:`float`[source]

A Float specifying the factor used to modify the reference value.

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

A SymbolicConstant specifying the operation used to modify the reference value by the reference factor. Possible values are ADD, DIVIDE, MULTIPLY, and SUBTRACT. The default value is ADD.

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

The SymbolicConstant MODEL or a Region object specifying the region to which the stop condition is applied. The default value is MODEL.

setValues(
comparisonOperation=LESS_THAN,
identifier=MOVEMENT,
identifierOperation=MAXIMUM,
referenceDesignCycle=PREVIOUS,
referenceOperation=ADD,
region=MODEL,
)[source]

This method modifies the LocalStopCondition object.

Parameters:
comparisonOperation=LESS_THAN

A SymbolicConstant specifying the operation used to compare the selected value to the reference value. Possible values are LESS_THAN, LESS_THAN_EQUAL, EQUAL, GREATER_THAN_EQUAL, and GREATER_THAN. The default value is LESS_THAN.

identifier=MOVEMENT

A SymbolicConstant specifying the variable identifier of the compared value. Possible values are: - ABSOLUTE_GROWTH_MOVEMENT - ABSOLUTE_SHRINK_MOVEMENT - GROWTH_MOVEMENT - SHRINK_MOVEMENT - MOVEMENT - TOTAL_ABSOLUTE_MOVEMENT - EQUIV_STRESS - FREE_TASK_REGION_EQUIV_STRESS - RESTRICTED_TASK_REGION_EQUIV_STRESS - SURFACE_POINT_EQUIV_STRESS - TASK_REGION_EQUIV_STRESS

The default value is MOVEMENT.

identifierOperation=MAXIMUM

A SymbolicConstant specifying the operation used to evaluate values in the region. Possible values are MAXIMUM, MINIMUM, and SUM. The default value is MAXIMUM.

referenceDesignCycle=PREVIOUS

A SymbolicConstant specifying the iteration from which a value is compared to the reference value. Possible values are FIRST and PREVIOUS. The default value is PREVIOUS.

referenceOperation=ADD

A SymbolicConstant specifying the operation used to modify the reference value by the reference factor. Possible values are ADD, DIVIDE, MULTIPLY, and SUBTRACT. The default value is ADD.

region=MODEL

The SymbolicConstant MODEL or a Region object specifying the region to which the stop condition is applied. The default value is MODEL.

class StopCondition[source]

Bases: object

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

Note

This object can be accessed by:

import optimization
mdb.models[name].optimizationTasks[name].stopConditions[name]

Member Details:

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

A String specifying the stop condition repository key.

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

The SymbolicConstant MODEL or a Region object specifying the region to which the stop condition is applied. The default value is MODEL.

class OptimizationObjective[source]

Bases: object

An OptimizationObjective is an object used to define objectives in an objective function.

Note

This object can be accessed by:

import optimization
mdb.models[name].optimizationTasks[name].objectiveFunctions[name].objectives[i]

Member Details:

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

A String specifying the name of the design response.

referenceValue : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`, :py:class:`float`] = 'DEFAULT'[source]

The SymbolicConstant DEFAULT or a Float specifying the reference value used in evaluating a design response. For topology optimization, DEFAULT> indicates the reference value is 0. For shape optimization, DEFAULT indicates the reference value is the nodal average. The default value is DEFAULT.

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

A Boolean specifying whether the objective is suppressed or not. The default value is OFF.

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

A Float specifying the weight applied to the design response value. The default value is 1.0.

class OptimizationTaskBase[source]

Bases: object

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

Note

This object can be accessed by:

import optimization
mdb.models[name].optimizationTasks[name]

Member Details:

designResponses : --is-rst--:py:class:`dict`\ \[:py:class:`str`, :py:class:`~abaqus.Optimization.DesignResponse.DesignResponse`] = {}[source]

A repository of DesignResponse objects.

geometricRestrictions : --is-rst--:py:class:`dict`\ \[:py:class:`str`, :py:class:`~abaqus.Optimization.GeometricRestriction.GeometricRestriction`] = {}[source]

A repository of GeometricRestriction objects.

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

A String specifying the optimization task repository key.

objectiveFunctions : --is-rst--:py:class:`dict`\ \[:py:class:`str`, :py:class:`~abaqus.Optimization.ObjectiveFunction.ObjectiveFunction`] = {}[source]

A repository of ObjectiveFunction objects.

optimizationConstraints : --is-rst--:py:class:`dict`\ \[:py:class:`str`, :py:class:`~abaqus.Optimization.OptimizationConstraint.OptimizationConstraint`] = {}[source]

A repository of OptimizationConstraint objects.

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

The SymbolicConstant MODEL or a Region object specifying the region to which the optimization task is applied. The default value is MODEL.

stopConditions : --is-rst--:py:class:`dict`\ \[:py:class:`str`, :py:class:`~abaqus.Optimization.StopCondition.StopCondition`] = {}[source]

A repository of StopCondition objects.

class PenetrationCheck(name, penetrationCheckRegion, region, presumeFeasibleRegionAtStart=1)[source]

Bases: GeometricRestriction

The PenetrationCheck object defines a penetration check geometric restriction. The PenetrationCheck object is derived from the GeometricRestriction object. This page discusses:

Note

This object can be accessed by:

import optimization
mdb.models[name].optimizationTasks[name].geometricRestrictions[name]

Member Details:

penetrationCheckRegion : --is-rst--:py:class:`~abaqus.Region.Region.Region`[source]

A Region object specifying the penetration check region.

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

A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.

setValues(presumeFeasibleRegionAtStart=1)[source]

This method modifies the PenetrationCheck object.

Parameters:
presumeFeasibleRegionAtStart=1

A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.

class ShapeDemoldControl(
name,
pullDirection,
region,
collisionCheckRegion=DEMOLD_REGION,
csys=None,
drawAngle=0,
masterPointDetermination=MAXIMUM,
presumeFeasibleRegionAtStart=1,
tolerance1=0,
tolerance2=0,
tolerance3=0,
undercutTolerance=0,
)[source]

Bases: GeometricRestriction

The ShapeDemoldControl object defines a shape demold control geometric restriction. The ShapeDemoldControl object is derived from the GeometricRestriction object.

Note

This object can be accessed by:

import optimization
mdb.models[name].optimizationTasks[name].geometricRestrictions[name]

Member Details:

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

The SymbolicConstant DEMOLD_REGION or a Region object specifying the collision check region. If the value is DEMOLD_REGION, then the value of region is used as both the demold region and the collision check region. The default value is DEMOLD_REGION.

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

None or a DatumCsys object specifying the local coordinate system of the pullDirection. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int indicating the identifier of the DatumCsys. The default value is None.

drawAngle : --is-rst--:py:class:`float` = 0[source]

A Float specifying the draw angle. The default value is 0.0.

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

A SymbolicConstant specifying the rule for assigning point priority. Possible values are MAXIMUM and MINIMUM. The default value is MAXIMUM.

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

A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.

pullDirection : --is-rst--:py:class:`tuple`[source]

A VertexArray object of length 2 specifying the demold pull direction. Instead of through a ConstrainedSketchVertex, each point might be specified through a tuple of coordinates.

setValues(
collisionCheckRegion=DEMOLD_REGION,
csys=None,
drawAngle=0,
masterPointDetermination=MAXIMUM,
presumeFeasibleRegionAtStart=1,
tolerance1=0,
tolerance2=0,
tolerance3=0,
undercutTolerance=0,
)[source]

This method modifies the ShapeDemoldControl object.

Parameters:
collisionCheckRegion=DEMOLD_REGION

The SymbolicConstant DEMOLD_REGION or a Region object specifying the collision check region. If the value is DEMOLD_REGION, then the value of region is used as both the demold region and the collision check region. The default value is DEMOLD_REGION.

csys=None

None or a DatumCsys object specifying the local coordinate system of the pullDirection. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int indicating the identifier of the DatumCsys. The default value is None.

drawAngle=0

A Float specifying the draw angle. The default value is 0.0.

masterPointDetermination=MAXIMUM

A SymbolicConstant specifying the rule for assigning point priority. Possible values are MAXIMUM and MINIMUM. The default value is MAXIMUM.

presumeFeasibleRegionAtStart=1

A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.

tolerance1=0

A Float specifying the geometric tolerance in the 1-direction. The default value is 0.01.

tolerance2=0

A Float specifying the geometric tolerance in the 2-direction. The default value is 0.01.

tolerance3=0

A Float specifying the geometric tolerance in the 3-direction. The default value is 0.01.

undercutTolerance=0

A Float specifying the undercut tolerance. The default value is 0.0.

tolerance1 : --is-rst--:py:class:`float` = 0[source]

A Float specifying the geometric tolerance in the 1-direction. The default value is 0.01.

tolerance2 : --is-rst--:py:class:`float` = 0[source]

A Float specifying the geometric tolerance in the 2-direction. The default value is 0.01.

tolerance3 : --is-rst--:py:class:`float` = 0[source]

A Float specifying the geometric tolerance in the 3-direction. The default value is 0.01.

undercutTolerance : --is-rst--:py:class:`float` = 0[source]

A Float specifying the undercut tolerance. The default value is 0.0.

class ShapeMemberSize(name, region, maxThickness=0, minThickness=0, sizeRestriction=MINIMUM)[source]

Bases: GeometricRestriction

The ShapeMemberSize object defines a shape member size geometric restriction. The ShapeMemberSize object is derived from the GeometricRestriction object.

Note

This object can be accessed by:

import optimization
mdb.models[name].optimizationTasks[name].geometricRestrictions[name]

Member Details:

maxThickness : --is-rst--:py:class:`float` = 0[source]

A Float specifying the maximum thickness. The default value is 0.0.

minThickness : --is-rst--:py:class:`float` = 0[source]

A Float specifying the minimum thickness. The default value is 0.0.

setValues(
maxThickness=0,
minThickness=0,
sizeRestriction=MINIMUM,
assignNodeGroupRegion=0,
nodeGroupRegion='',
)[source]

This method modifies the ShapeMemberSize object.

Parameters:
maxThickness=0

A Float specifying the maximum thickness. The default value is 0.0.

minThickness=0

A Float specifying the minimum thickness. The default value is 0.0.

sizeRestriction=MINIMUM

A SymbolicConstant specifying whether to restrict the minimum or maximum thickness. Possible values are MAXIMUM and MINIMUM. The default value is MINIMUM.

assignNodeGroupRegion=0

A bool specifying whether to use the node group region. The default value is OFF.

nodeGroupRegion=''

A Node Region object specifying the check node group.

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

A SymbolicConstant specifying whether to restrict the minimum or maximum thickness. Possible values are MAXIMUM and MINIMUM. The default value is MINIMUM.

class ShapePlanarSymmetry(
name,
clientDirection,
region,
csys=None,
masterPointDetermination=MAXIMUM,
presumeFeasibleRegionAtStart=1,
tolerance1=0,
tolerance2=0,
tolerance3=0,
)[source]

Bases: GeometricRestriction

The ShapePlanarSymmetry object defines a shape planar symmetry geometric restriction. The ShapePlanarSymmetry object is derived from the GeometricRestriction object.

Note

This object can be accessed by:

import optimization
mdb.models[name].optimizationTasks[name].geometricRestrictions[name]

Member Details:

clientDirection : --is-rst--:py:class:`tuple`[source]

A VertexArray object of length 2 specifying the vector positioned at the csys origin that is normal to the symmetry plane. Instead of through a ConstrainedSketchVertex, each point may be specified through a tuple of coordinates.

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

None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

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

A SymbolicConstant specifying the rule for determining the main node. Possible values are MAXIMUM and MINIMUM. The default value is MAXIMUM.

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

A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.

setValues(
csys=None,
masterPointDetermination=MAXIMUM,
presumeFeasibleRegionAtStart=1,
tolerance1=0,
tolerance2=0,
tolerance3=0,
)[source]

This method modifies the ShapePlanarSymmetry object.

Parameters:
csys=None

None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

masterPointDetermination=MAXIMUM

A SymbolicConstant specifying the rule for determining the master node. Possible values are MAXIMUM and MINIMUM. The default value is MAXIMUM.

presumeFeasibleRegionAtStart=1

A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.

tolerance1=0

A Float specifying the geometric tolerance in the 1-direction. The default value is 0.01.

tolerance2=0

A Float specifying the geometric tolerance in the 2-direction. The default value is 0.01.

tolerance3=0

A Float specifying the geometric tolerance in the 3-direction. The default value is 0.01.

tolerance1 : --is-rst--:py:class:`float` = 0[source]

A Float specifying the geometric tolerance in the 1-direction. The default value is 0.01.

tolerance2 : --is-rst--:py:class:`float` = 0[source]

A Float specifying the geometric tolerance in the 2-direction. The default value is 0.01.

tolerance3 : --is-rst--:py:class:`float` = 0[source]

A Float specifying the geometric tolerance in the 3-direction. The default value is 0.01.

class ShapePointSymmetry(
name,
region,
csys=None,
masterPointDetermination=MAXIMUM,
presumeFeasibleRegionAtStart=1,
tolerance1=0,
tolerance2=0,
tolerance3=0,
)[source]

Bases: GeometricRestriction

The ShapePointSymmetry object defines a shape point symmetry geometric restriction. The ShapePointSymmetry object is derived from the GeometricRestriction object.

Note

This object can be accessed by:

import optimization
mdb.models[name].optimizationTasks[name].geometricRestrictions[name]

Member Details:

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

None or a DatumCsys object specifying the symmetry point represented as the origin of a local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

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

A SymbolicConstant specifying the rule for determining the master node. Possible values are MAXIMUM and MINIMUM. The default value is MAXIMUM.

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

A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.

setValues(
csys=None,
masterPointDetermination=MAXIMUM,
presumeFeasibleRegionAtStart=1,
tolerance1=0,
tolerance2=0,
tolerance3=0,
)[source]

This method modifies the ShapePointSymmetry object.

Parameters:
csys=None

None or a DatumCsys object specifying the symmetry point represented as the origin of a local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

masterPointDetermination=MAXIMUM

A SymbolicConstant specifying the rule for determining the master node. Possible values are MAXIMUM and MINIMUM. The default value is MAXIMUM.

presumeFeasibleRegionAtStart=1

A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.

tolerance1=0

A Float specifying the geometric tolerance in the 1-direction. The default value is 0.01.

tolerance2=0

A Float specifying the geometric tolerance in the 2-direction. The default value is 0.01.

tolerance3=0

A Float specifying the geometric tolerance in the 3-direction. The default value is 0.01.

tolerance1 : --is-rst--:py:class:`float` = 0[source]

A Float specifying the geometric tolerance in the 1-direction. The default value is 0.01.

tolerance2 : --is-rst--:py:class:`float` = 0[source]

A Float specifying the geometric tolerance in the 2-direction. The default value is 0.01.

tolerance3 : --is-rst--:py:class:`float` = 0[source]

A Float specifying the geometric tolerance in the 3-direction. The default value is 0.01.

class ShapeRotationalSymmetry(
name,
clientDirection,
region,
angle=0,
csys=None,
masterPoint=None,
masterPointDetermination=MAXIMUM,
presumeFeasibleRegionAtStart=1,
startPoint=None,
tolerance1=0,
tolerance2=0,
tolerance3=0,
)[source]

Bases: GeometricRestriction

The ShapeRotationalSymmetry object defines a shape rotational symmetry geometric restriction. The ShapeRotationalSymmetry object is derived from the GeometricRestriction object.

Note

This object can be accessed by:

import optimization
mdb.models[name].optimizationTasks[name].geometricRestrictions[name]

Member Details:

angle : --is-rst--:py:class:`float` = 0[source]

A Float specifying the segment size of the repeating pattern in degrees. If the angle value is 0, no repeating pattern is created. The default value is 0.0.

clientDirection : --is-rst--:py:class:`tuple`[source]

A VertexArray object of length 2 specifying the vector positioned at the csys origin, used as the axis of symmetry. Instead of through a ConstrainedSketchVertex, each point might be specified through a tuple of coordinates.

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

None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

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

None or a Region object specifying the main point used when mainPointDetermination is SPECIFY. The default value is None.

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

A SymbolicConstant specifying the rule for determining the master node. Possible values are MAXIMUM, MINIMUM, and SPECIFY. The default value is MAXIMUM.

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

A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.

setValues(
angle=0,
csys=None,
masterPoint=None,
masterPointDetermination=MAXIMUM,
presumeFeasibleRegionAtStart=1,
startPoint=None,
tolerance1=0,
tolerance2=0,
tolerance3=0,
)[source]

This method modifies the ShapeRotationalSymmetry object.

Parameters:
angle=0

A Float specifying the segment size of the repeating pattern in degrees. If the angle value is 0, no repeating pattern is created. The default value is 0.0.

csys=None

None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

masterPoint=None

None or a Region object specifying the master point used when masterPointDetermination is SPECIFY. The default value is None.

masterPointDetermination=MAXIMUM

A SymbolicConstant specifying the rule for determining the master node. Possible values are MAXIMUM, MINIMUM, and SPECIFY. The default value is MAXIMUM.

presumeFeasibleRegionAtStart=1

A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.

startPoint=None

A tuple of Floats representing the coordinates of a start point of the rotational symmetry.

tolerance1=0

A Float specifying the geometric tolerance in the 1-direction. The default value is 0.01.

tolerance2=0

A Float specifying the geometric tolerance in the 2-direction. The default value is 0.01.

tolerance3=0

A Float specifying the geometric tolerance in the 3-direction. The default value is 0.01.

startPoint : --is-rst--:py:class:`tuple`\ \[:py:class:`float`, :py:data:`...<Ellipsis>`] = ()[source]

A tuple of Floats representing the coordinates of a start point of the rotational symmetry.

tolerance1 : --is-rst--:py:class:`float` = 0[source]

A Float specifying the geometric tolerance in the 1-direction. The default value is 0.01.

tolerance2 : --is-rst--:py:class:`float` = 0[source]

A Float specifying the geometric tolerance in the 2-direction. The default value is 0.01.

tolerance3 : --is-rst--:py:class:`float` = 0[source]

A Float specifying the geometric tolerance in the 3-direction. The default value is 0.01.

class SingleTermDesignResponse(
name,
identifier,
csys=None,
drivingRegion=None,
operation=SUM,
region=MODEL,
shellLayer=MAXIMUM,
stepOperation=SUM,
stepOptions=None,
)[source]

Bases: DesignResponse

The SingleTermDesignResponse object defines a single-term design response. The SingleTermDesignResponse object is derived from the DesignResponse object.

Note

This object can be accessed by:

import optimization
mdb.models[name].optimizationTasks[name].designResponses[name]

Member Details:

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

None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

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

None or a sequence of Floats specifying the driving region used when identifier is an internal nodal variable. The default value is None.

identifier : --is-rst--:py:class:`str`[source]

A String specifying the name of the variable identifier.

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

A SymbolicConstant specifying the operation used on values in the region. Possible values are MAXIMUM, MINIMUM, and SUM. The default value is SUM.

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

The SymbolicConstant MODEL or a Region object specifying the region of the design response variable. The default value is MODEL.

setValues(
csys=None,
drivingRegion=None,
operation=SUM,
region=MODEL,
shellLayer=MAXIMUM,
stepOperation=SUM,
stepOptions=None,
)[source]

This method modifies the SingleTermDesignResponse object.

Parameters:
csys=None

None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

drivingRegion=None

None or a sequence of Floats specifying the driving region used when identifier is an internal nodal variable. The default value is None.

operation=SUM

A SymbolicConstant specifying the operation used on values in the region. Possible values are MAXIMUM, MINIMUM, and SUM. The default value is SUM.

region=MODEL

The SymbolicConstant MODEL or a Region object specifying the region of the design response variable. The default value is MODEL.

shellLayer=MAXIMUM

A SymbolicConstant specifying the location used for shell layer values. Possible values are BOTTOM, MAXIMUM, MIDDLE, MINIMUM, and TOP. The default value is MAXIMUM.

stepOperation=SUM

A SymbolicConstant specifying the operation used on values across steps and load cases. Possible values are MAXIMUM, MINIMUM, and SUM. The default value is SUM.

stepOptions=None

A StepOptionArray object.

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

A SymbolicConstant specifying the location used for shell layer values. Possible values are BOTTOM, MAXIMUM, MIDDLE, MINIMUM, and TOP. The default value is MAXIMUM.

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

A SymbolicConstant specifying the operation used on values across steps and load cases. Possible values are MAXIMUM, MINIMUM, and SUM. The default value is SUM.

stepOptions : --is-rst--:py:data:`~typing.Optional`\ \[:py:class:`~typing.List`\ \[:py:class:`~abaqus.Optimization.StepOption.StepOption`]] = None[source]

A StepOptionArray object.

class SizingClusterAreas(name, regions)[source]

Bases: GeometricRestriction

The SizingClusterAreas object defines a sizing cluster areas geometric restriction. The SizingClusterAreas object is derived from the GeometricRestriction object.

Note

This object can be accessed by:

import optimization
mdb.models[name].optimizationTasks[name].geometricRestrictions[name]

Member Details:

regions : --is-rst--tuple[source]

tuple of Region objects specifying the regions to which the geometric restriction is applied.

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

This method modifies the SizingClusterAreas object.

class SizingCyclicSymmetry(
name,
region,
translation,
axis=AXIS_1,
csys=None,
ignoreFrozenArea=0,
)[source]

Bases: GeometricRestriction

The SizingCyclicSymmetry object defines a sizing cyclic symmetry geometric restriction. The SizingCyclicSymmetry object is derived from the GeometricRestriction object.

Note

This object can be accessed by:

import optimization
mdb.models[name].optimizationTasks[name].geometricRestrictions[name]

Member Details:

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

A SymbolicConstant specifying the translation direction defined along an axis positioned at the csys origin. Possible values are AXIS_1, AXIS_2, and AXIS_3. The default value is AXIS_1.

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

None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

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

A Boolean specifying whether to ignore frozen areas. The default value is OFF.

setValues(axis=AXIS_1, csys=None, ignoreFrozenArea=0)[source]

This method modifies the SizingCyclicSymmetry object.

Parameters:
axis=AXIS_1

A SymbolicConstant specifying the translation direction defined along an axis positioned at the csys origin. Possible values are AXIS_1, AXIS_2, and AXIS_3. The default value is AXIS_1.

csys=None

None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

ignoreFrozenArea=0

A Boolean specifying whether to ignore frozen areas. The default value is OFF.

translation : --is-rst--:py:class:`float`[source]

A Float specifying the translation distance.

class SizingFrozenArea(name, region)[source]

Bases: GeometricRestriction

The SizingFrozenArea object defines a sizing frozen area geometric restriction. The SizingFrozenArea object is derived from the GeometricRestriction object.

Note

This object can be accessed by:

import optimization
mdb.models[name].optimizationTasks[name].geometricRestrictions[name]

Member Details:

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

This method modifies the SizingFrozenArea object.

class SizingMemberSize(name, region, minWidth)[source]

Bases: GeometricRestriction

The SizingMemberSize object defines a sizing member size geometric restriction. The SizingMemberSize object is derived from the GeometricRestriction object.

Note

This object can be accessed by:

import optimization
mdb.models[name].optimizationTasks[name].geometricRestrictions[name]

Member Details:

minWidth : --is-rst--:py:class:`float`[source]

A Float specifying the min width.

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

This method modifies the sizingMemberSize object.

class SizingPlanarSymmetry(name, region, axis=AXIS_1, csys=None, ignoreFrozenArea=0)[source]

Bases: GeometricRestriction

The SizingPlanarSymmetry object defines a sizing planar symmetry geometric restriction. The SizingPlanarSymmetry object is derived from the GeometricRestriction object.

Note

This object can be accessed by:

import optimization
mdb.models[name].optimizationTasks[name].geometricRestrictions[name]

Member Details:

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

A SymbolicConstant specifying the axis of symmetry. Possible values are AXIS_1, AXIS_2, and AXIS_3. The default value is AXIS_1.

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

None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

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

A Boolean specifying whether to ignore frozen areas. The default value is OFF.

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

This method modifies the sizingPlanarSymmetry object.

class SizingPointSymmetry(name, region, csys=None, ignoreFrozenArea=0)[source]

Bases: GeometricRestriction

The SizingPointSymmetry object defines a sizing point symmetry geometric restriction. The SizingPointSymmetry object is derived from the GeometricRestriction object.

Note

This object can be accessed by:

import optimization
mdb.models[name].optimizationTasks[name].geometricRestrictions[name]

Member Details:

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

None or a DatumCsys object specifying the position of the symmetry point defined as the origin of a local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

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

A Boolean specifying whether to ignore frozen areas. The default value is OFF.

setValues(csys=None, ignoreFrozenArea=0)[source]

This method modifies the SizingPointSymmetry object.

Parameters:
csys=None

None or a DatumCsys object specifying the position of the symmetry point defined as the origin of a local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

ignoreFrozenArea=0

A Boolean specifying whether to ignore frozen areas. The default value is OFF.

class SizingRotationalSymmetry(name, angle, region, axis=AXIS_1, csys=None, ignoreFrozenArea=0)[source]

Bases: GeometricRestriction

The SizingRotationalSymmetry object defines a sizing rotational symmetry geometric restriction. The SizingRotationalSymmetry object is derived from the GeometricRestriction object.

Note

This object can be accessed by:

import optimization
mdb.models[name].optimizationTasks[name].geometricRestrictions[name]

Member Details:

angle : --is-rst--:py:class:`float`[source]

A Float specifying the repeating segment size, an angle in degrees.

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

A SymbolicConstant specifying the axis of symmetry. Possible values are AXIS_1, AXIS_2, and AXIS_3. The default value is AXIS_1.

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

None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

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

A Boolean specifying whether to ignore frozen areas. The default value is OFF.

setValues(axis=AXIS_1, csys=None, ignoreFrozenArea=0)[source]

This method modifies the SizingRotationalSymmetry object.

Parameters:
axis=AXIS_1

A SymbolicConstant specifying the axis of symmetry. Possible values are AXIS_1, AXIS_2, and AXIS_3. The default value is AXIS_1.

csys=None

None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

ignoreFrozenArea=0

A Boolean specifying whether to ignore frozen areas. The default value is OFF.

class SlideRegionControl(
name,
clientDirection,
region,
approach=FREE_FORM,
csys=None,
freeFormRegion=None,
presumeFeasibleRegionAtStart=1,
revolvedRegion=None,
tolerance1=0,
tolerance2=0,
tolerance3=0,
)[source]

Bases: GeometricRestriction

The SlideRegionControl object defines a slide region control geometric restriction. The SlideRegionControl object is derived from the GeometricRestriction object.

Note

This object can be accessed by:

import optimization
mdb.models[name].optimizationTasks[name].geometricRestrictions[name]

Member Details:

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

A SymbolicConstant specifying the restriction approach. The SymbolicConstant FREE_FORM indicates a free-form slide region, and the SymbolicConstant TURN indicates that the restriction should conserve a turnable surface. Possible values are FREE_FORM and TURN. The default value is FREE_FORM.

clientDirection : --is-rst--:py:class:`tuple`[source]

A VertexArray object of length 2 specifying the axis of revolution. Instead of through a ConstrainedSketchVertex, each point may be specified through a tuple of coordinates. This is used when approach is TURN.

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

None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. This is used when approach is TURN. The default value is None.

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

None or a Region object specifying the free-form region. This is used when approach is FREE_FORM. The default value is None.

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

A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.

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

None or a Region object specifying the region to revolve into a slide region. This is used when approach is TURN. The default value is None.

setValues(
approach=FREE_FORM,
csys=None,
freeFormRegion=None,
presumeFeasibleRegionAtStart=1,
revolvedRegion=None,
tolerance1=0,
tolerance2=0,
tolerance3=0,
)[source]

This method modifies the SlideRegionControl object.

Parameters:
approach=FREE_FORM

A SymbolicConstant specifying the restriction approach. The SymbolicConstant FREE_FORM indicates a free-form slide region, and the SymbolicConstant TURN indicates that the restriction should conserve a turnable surface. Possible values are FREE_FORM and TURN. The default value is FREE_FORM.

csys=None

None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. This is used when approach is TURN. The default value is None.

freeFormRegion=None

None or a Region object specifying the free-form region. This is used when approach is FREE_FORM. The default value is None.

presumeFeasibleRegionAtStart=1

A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.

revolvedRegion=None

None or a Region object specifying the region to revolve into a slide region. This is used when approach is TURN. The default value is None.

tolerance1=0

A Float specifying the geometric tolerance in the 1-direction. This is used when approach is TURN. The default value is 0.01.

tolerance2=0

A Float specifying the geometric tolerance in the 2-direction. This is used when approach is TURN. The default value is 0.01.

tolerance3=0

A Float specifying the geometric tolerance in the 3-direction. This is used when approach is TURN. The default value is 0.01.

tolerance1 : --is-rst--:py:class:`float` = 0[source]

A Float specifying the geometric tolerance in the 1-direction. This is used when approach is TURN. The default value is 0.01.

tolerance2 : --is-rst--:py:class:`float` = 0[source]

A Float specifying the geometric tolerance in the 2-direction. This is used when approach is TURN. The default value is 0.01.

tolerance3 : --is-rst--:py:class:`float` = 0[source]

A Float specifying the geometric tolerance in the 3-direction. This is used when approach is TURN. The default value is 0.01.

class StampControl(
name,
clientDirection,
region,
csys=None,
drawAngle=0,
masterPoint=None,
masterPointDetermination=MAXIMUM,
presumeFeasibleRegionAtStart=1,
tolerance1=0,
tolerance2=0,
tolerance3=0,
undercutTolerance=0,
)[source]

Bases: GeometricRestriction

The StampControl object defines a stamp control geometric restriction. The StampControl object is derived from the GeometricRestriction object.

Note

This object can be accessed by:

import optimization
mdb.models[name].optimizationTasks[name].geometricRestrictions[name]

Member Details:

clientDirection : --is-rst--:py:class:`tuple`[source]

A VertexArray object of length 2 specifying the stamping direction. Instead of through a ConstrainedSketchVertex, each point may be specified through a tuple of coordinates.

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

None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

drawAngle : --is-rst--:py:class:`float` = 0[source]

A Float specifying the draw angle. The default value is 0.0.

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

None or a Region object specifying the master point used when masterPointDetermination is SPECIFY. The default value is None.

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

A SymbolicConstant specifying the rule for assigning point priority. Possible values are MAXIMUM, MINIMUM, and SPECIFY. The default value is MAXIMUM.

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

A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.

setValues(
csys=None,
drawAngle=0,
masterPoint=None,
masterPointDetermination=MAXIMUM,
presumeFeasibleRegionAtStart=1,
tolerance1=0,
tolerance2=0,
tolerance3=0,
undercutTolerance=0,
)[source]

This method modifies the StampControl object.

Parameters:
csys=None

None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

drawAngle=0

A Float specifying the draw angle. The default value is 0.0.

masterPoint=None

None or a Region object specifying the master point used when masterPointDetermination is SPECIFY. The default value is None.

masterPointDetermination=MAXIMUM

A SymbolicConstant specifying the rule for assigning point priority. Possible values are MAXIMUM, MINIMUM, and SPECIFY. The default value is MAXIMUM.

presumeFeasibleRegionAtStart=1

A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.

tolerance1=0

A Float specifying the geometric tolerance in the 1-direction. The default value is 0.01.

tolerance2=0

A Float specifying the geometric tolerance in the 2-direction. The default value is 0.01.

tolerance3=0

A Float specifying the geometric tolerance in the 3-direction. The default value is 0.01.

undercutTolerance=0

A Float specifying the undercut tolerance. The default value is 0.0.

tolerance1 : --is-rst--:py:class:`float` = 0[source]

A Float specifying the geometric tolerance in the 1-direction. The default value is 0.01.

tolerance2 : --is-rst--:py:class:`float` = 0[source]

A Float specifying the geometric tolerance in the 2-direction. The default value is 0.01.

tolerance3 : --is-rst--:py:class:`float` = 0[source]

A Float specifying the geometric tolerance in the 3-direction. The default value is 0.01.

undercutTolerance : --is-rst--:py:class:`float` = 0[source]

A Float specifying the undercut tolerance. The default value is 0.0.

class TopologyCyclicSymmetry(
name,
region,
translation,
axis=AXIS_1,
csys=None,
ignoreFrozenArea=0,
)[source]

Bases: GeometricRestriction

The TopologyCyclicSymmetry object defines a topology cyclic symmetry geometric restriction. The TopologyCyclicSymmetry object is derived from the GeometricRestriction object.

Note

This object can be accessed by:

import optimization
mdb.models[name].optimizationTasks[name].geometricRestrictions[name]

Member Details:

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

A SymbolicConstant specifying the translation direction defined along an axis positioned at the csys origin. Possible values are AXIS_1, AXIS_2, and AXIS_3. The default value is AXIS_1.

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

None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

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

A Boolean specifying whether to ignore frozen areas. The default value is OFF.

setValues(axis=AXIS_1, csys=None, ignoreFrozenArea=0)[source]

This method modifies the TopologyCyclicSymmetry object.

Parameters:
axis=AXIS_1

A SymbolicConstant specifying the translation direction defined along an axis positioned at the csys origin. Possible values are AXIS_1, AXIS_2, and AXIS_3. The default value is AXIS_1.

csys=None

None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

ignoreFrozenArea=0

A Boolean specifying whether to ignore frozen areas. The default value is OFF.

translation : --is-rst--:py:class:`float`[source]

A Float specifying the translation distance.

class TopologyDemoldControl(
name,
region,
csys=None,
draftAngle=0,
collisionCheckRegion=DEMOLD_REGION,
pointRegion=None,
pullDirection=(),
technique=AUTO,
)[source]

Bases: GeometricRestriction

The TopologyDemoldControl object defines a topology demold control geometric restriction. The TopologyDemoldControl object is derived from the GeometricRestriction object.

Note

This object can be accessed by:

import optimization
mdb.models[name].optimizationTasks[name].geometricRestrictions[name]

Member Details:

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

The SymbolicConstant DEMOLD_REGION or a Region object specifying the collision check region. If the value is DEMOLD_REGION, then the value of region is used as both the demold region and the collision check region. The default value is DEMOLD_REGION.

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

None or a DatumCsys object specifying the local coordinate system of the pullDirection. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int indicating the identifier of the DatumCsys. The default value is None.

draftAngle : --is-rst--:py:class:`float` = 0[source]

A Float specifying the draft angle. The default value is 0.0.

pointRegion : --is-rst--:py:class:`~abaqus.Region.Region.Region` | :py:obj:`None` = None[source]

A Region object specifying the point on a plane perpendicular to the pull direction, used to specify the central plane when technique is POINT.

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

A VertexArray object of length 2 specifying the demold pull direction. Instead of through a ConstrainedSketchVertex, each point may be specified through a tuple of coordinates.

setValues(
csys=None,
draftAngle=0,
collisionCheckRegion=DEMOLD_REGION,
pointRegion=None,
pullDirection=(),
technique=AUTO,
)[source]

This method modifies the TopologyDemoldControl object.

Parameters:
csys=None

None or a DatumCsys object specifying the local coordinate system of the pullDirection. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int indicating the identifier of the DatumCsys. The default value is None.

draftAngle=0

A Float specifying the draft angle. The default value is 0.0.

collisionCheckRegion=DEMOLD_REGION

The SymbolicConstant DEMOLD_REGION or a Region object specifying the collision check region. If the value is DEMOLD_REGION, then the value of region is used as both the demold region and the collision check region. The default value is DEMOLD_REGION.

pointRegion=None

A Region object specifying the point on a plane perpendicular to the pull direction, used to specify the central plane when technique is POINT.

pullDirection=()

A VertexArray object of length 2 specifying the demold pull direction. Instead of through a ConstrainedSketchVertex, each point may be specified through a tuple of coordinates.

technique=AUTO

A SymbolicConstant specifying the demold technique. Possible values are AUTO, AUTO_TIGHT, POINT, SURFACE, and STAMP. The default value is AUTO.

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

A SymbolicConstant specifying the demold technique. Possible values are AUTO, AUTO_TIGHT, POINT, SURFACE, and STAMP. The default value is AUTO.

class TopologyMemberSize(
name,
region,
maxThickness=0,
minThickness=0,
separation=0,
sizeRestriction=MINIMUM,
)[source]

Bases: GeometricRestriction

The TopologyMemberSize object defines a topology member size geometric restriction. The TopologyMemberSize object is derived from the GeometricRestriction object.

Note

This object can be accessed by:

import optimization
mdb.models[name].optimizationTasks[name].geometricRestrictions[name]

Member Details:

maxThickness : --is-rst--:py:class:`float` = 0[source]

A Float specifying the maximum thickness. The default value is 0.0.

minThickness : --is-rst--:py:class:`float` = 0[source]

A Float specifying the minimum thickness. The default value is 0.0.

separation : --is-rst--:py:class:`float` = 0[source]

A Float specifying the minimum gap. The default value is 0.0.

setValues(
maxThickness=0,
minThickness=0,
separation=0,
sizeRestriction=MINIMUM,
)[source]

This method modifies the TopologyMemberSize object.

Parameters:
maxThickness=0

A Float specifying the maximum thickness. The default value is 0.0.

minThickness=0

A Float specifying the minimum thickness. The default value is 0.0.

separation=0

A Float specifying the minimum gap. The default value is 0.0.

sizeRestriction=MINIMUM

A SymbolicConstant specifying whether to restrict the minimum or maximum thickness or an envelope of both. Possible values are ENVELOPE, MAXIMUM, and MINIMUM. The default value is MINIMUM.

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

A SymbolicConstant specifying whether to restrict the minimum or maximum thickness or an envelope of both. Possible values are ENVELOPE, MAXIMUM, and MINIMUM. The default value is MINIMUM.

class TopologyPlanarSymmetry(name, region, axis=AXIS_1, csys=None, ignoreFrozenArea=0)[source]

Bases: GeometricRestriction

The TopologyPlanarSymmetry object defines a topology planar symmetry geometric restriction. The TopologyPlanarSymmetry object is derived from the GeometricRestriction object.

Note

This object can be accessed by:

import optimization
mdb.models[name].optimizationTasks[name].geometricRestrictions[name]

Member Details:

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

A SymbolicConstant specifying the axis of symmetry. Possible values are AXIS_1, AXIS_2, and AXIS_3. The default value is AXIS_1.

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

None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

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

A Boolean specifying whether to ignore frozen areas. The default value is OFF.

setValues(axis=AXIS_1, csys=None, ignoreFrozenArea=0)[source]

This method modifies the TopologyPlanarSymmetry object.

Parameters:
axis=AXIS_1

A SymbolicConstant specifying the axis of symmetry. Possible values are AXIS_1, AXIS_2, and AXIS_3. The default value is AXIS_1.

csys=None

None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

ignoreFrozenArea=0

A Boolean specifying whether to ignore frozen areas. The default value is OFF.

class TopologyPointSymmetry(name, region, csys=None, ignoreFrozenArea=0)[source]

Bases: GeometricRestriction

The TopologyPointSymmetry object defines a topology point symmetry geometric restriction. The TopologyPointSymmetry object is derived from the GeometricRestriction object.

Note

This object can be accessed by:

import optimization
mdb.models[name].optimizationTasks[name].geometricRestrictions[name]

Member Details:

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

None or a DatumCsys object specifying the position of the symmetry point defined as the origin of a local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

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

A Boolean specifying whether to ignore frozen areas. The default value is OFF.

setValues(csys=None, ignoreFrozenArea=0)[source]

This method modifies the TopologyPointSymmetry object.

Parameters:
csys=None

None or a DatumCsys object specifying the position of the symmetry point defined as the origin of a local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

ignoreFrozenArea=0

A Boolean specifying whether to ignore frozen areas. The default value is OFF.

class TopologyRotationalSymmetry(
name,
angle,
region,
axis=AXIS_1,
csys=None,
ignoreFrozenArea=0,
)[source]

Bases: GeometricRestriction

The TopologyRotationalSymmetry object defines a topology rotational symmetry geometric restriction. The TopologyRotationalSymmetry object is derived from the GeometricRestriction object.

Note

This object can be accessed by:

import optimization
mdb.models[name].optimizationTasks[name].geometricRestrictions[name]

Member Details:

angle : --is-rst--:py:class:`float`[source]

A Float specifying the repeating segment size, an angle in degrees.

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

A SymbolicConstant specifying the axis of symmetry. Possible values are AXIS_1, AXIS_2, and AXIS_3. The default value is AXIS_1.

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

None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

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

A Boolean specifying whether to ignore frozen areas. The default value is OFF.

setValues(axis=AXIS_1, csys=None, ignoreFrozenArea=0)[source]

This method modifies the TopologyRotationalSymmetry object.

Parameters:
axis=AXIS_1

A SymbolicConstant specifying the axis of symmetry. Possible values are AXIS_1, AXIS_2, and AXIS_3. The default value is AXIS_1.

csys=None

None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

ignoreFrozenArea=0

A Boolean specifying whether to ignore frozen areas. The default value is OFF.

class TurnControl(
name,
clientDirection,
region,
csys,
masterPoint=None,
masterPointDetermination=MAXIMUM,
presumeFeasibleRegionAtStart=1,
tolerance1=0,
tolerance2=0,
tolerance3=0,
)[source]

Bases: GeometricRestriction

The TurnControl object defines a turn control geometric restriction. The TurnControl object is derived from the GeometricRestriction object.

Note

This object can be accessed by:

import optimization
mdb.models[name].optimizationTasks[name].geometricRestrictions[name]

Member Details:

clientDirection : --is-rst--:py:class:`tuple`[source]

A VertexArray object of length 2 specifying the direction of the rotation axis as a vector positioned at the csys origin. Instead of through a ConstrainedSketchVertex, each point might be specified through a tuple of coordinates.

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

None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

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

None or a Region object specifying the master point used when masterPointDetermination is SPECIFY. The default value is None.

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

A SymbolicConstant specifying the rule for assigning point priority. Possible values are MAXIMUM, MINIMUM, and SPECIFY. The default value is MAXIMUM.

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

A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.

setValues(
csys,
masterPoint=None,
masterPointDetermination=MAXIMUM,
presumeFeasibleRegionAtStart=1,
tolerance1=0,
tolerance2=0,
tolerance3=0,
)[source]

This method modifies the TurnControl object.

Parameters:
csys

None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

masterPoint=None

None or a Region object specifying the master point used when masterPointDetermination is SPECIFY. The default value is None.

masterPointDetermination=MAXIMUM

A SymbolicConstant specifying the rule for assigning point priority. Possible values are MAXIMUM, MINIMUM, and SPECIFY. The default value is MAXIMUM.

presumeFeasibleRegionAtStart=1

A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.

tolerance1=0

A Float specifying the geometric tolerance in the 1-direction. The default value is 0.01.

tolerance2=0

A Float specifying the geometric tolerance in the 2-direction. The default value is 0.01.

tolerance3=0

A Float specifying the geometric tolerance in the 3-direction. The default value is 0.01.

tolerance1 : --is-rst--:py:class:`float` = 0[source]

A Float specifying the geometric tolerance in the 1-direction. The default value is 0.01.

tolerance2 : --is-rst--:py:class:`float` = 0[source]

A Float specifying the geometric tolerance in the 2-direction. The default value is 0.01.

tolerance3 : --is-rst--:py:class:`float` = 0[source]

A Float specifying the geometric tolerance in the 3-direction. The default value is 0.01.

class ShapeTask(
name,
absoluteStepSizeControl=MINIMUM,
activateDurability=1,
additionalDurabilityFiles='',
constrainedLaplacianConvergenceLevel=NORMAL,
curvatureSmoothingEdgeLength=5,
durabilityInputfile='',
durabilitySolver=FE_SAFE,
equalityConstraintTolerance=None,
featureRecognitionAngle=30,
filterExponent=1,
filterMaxRadius=None,
filterRadiusReduction=None,
firstCycleDeletedVolumeTechnique=0,
freezeBoundaryConditionRegions=0,
frozenBoundaryConditionRegion=MODEL,
geometricRestrictionEvaluationFrequency=LOW,
growthScaleFactor=1,
haltUponViolation=0,
layerReferenceRegion=None,
meshSmoothingRegionMethod=TASK_REGION_LAYERS,
meshSmoothingStrategy=CONSTRAINED_LAPLACIAN,
midsideInterpolation=POSITIONS,
numFreeNodeLayers=0,
numSmoothedElementLayers=None,
presumeFeasibleBCRegionAtStart=1,
quadMaxAngle=160,
quadMinAngle=20,
quadSkew=30,
quadTaper=0,
region=MODEL,
reportPoorQualityElements=0,
reportQualityViolation=0,
shrinkScaleFactor=1,
smoothingRegion=None,
targetMeshQuality=LOW,
tetAspectRatio=100,
tetMaxAspect=8,
tetMinAspect=0,
tetSkew=100,
triMaxAngle=140,
triMinAngle=20,
updateShapeBasisVectors=EVERY_CYCLE,
)[source]

Bases: OptimizationTask

The ShapeTask object defines a shape task. The ShapeTask object is derived from the OptimizationTask object.

Note

This object can be accessed by:

import optimization
mdb.models[name].optimizationTasks[name]

Member Details:

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

A SymbolicConstant specifying whether to control the permitted absolute step size by the average optimization displacement or minimum optimization displacement. Possible values are MINIMUM and AVERAGE. The default value is MINIMUM.

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

A boolean specifying whether or not the durability approach of optimization is turned on. The default value is ON.

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

A String specifying the path of additional files pertaining to durability optimization. Only valid if the activateDurability argument is ON.

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

A SymbolicConstant specifying the constrained Laplacian convergence level. Possible values are NORMAL, CONSERVATIVE, and AGGRESSIVE. The default value is NORMAL.

curvatureSmoothingEdgeLength : --is-rst--:py:class:`float` = 5[source]

A Float specifying the edge length for the movement vector. The default value is 5.0.

designResponses : --is-rst--:py:class:`dict`\ \[:py:class:`str`, :py:class:`~abaqus.Optimization.DesignResponse.DesignResponse`] = {}[source]

A repository of DesignResponse objects.

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

A string specifying the path of the input file. Only valid if the activateDurability argument is ON and is a required argument in that case.

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

A String specifying the type of solver for durability optimization. Possible values are: FE_SAFE, FEMFAT, FALANCS, MSC_FATIGUE, FE_FATIGUE, DESIGN_LIFE, CUSTOM, FEMSITE. The default value is FE_SAFE. Only valid if the activateDurability argument is ON.

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

A Float specifying the equality constraint tolerance. The default value is 10⁻³.

featureRecognitionAngle : --is-rst--:py:class:`float` = 30[source]

A Float specifying the mesh smoothing feature recognition angle for edges and corners. The default value is 30.0.

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

A Float specifying the weight depending on the radius, used when filterMaxRadius is specified. The default value is 1.0.

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

None or a Float specifying the maximum influence radius for equivalent stress. The default value is None.

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

None or a Float specifying the reduction of the radius depending on surface bending, used when filterMaxRadius is specified. The default value is None.

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

A SymbolicConstant specifying the method of specifying volume that can be removed immediately in the first design cycle. Possible values are OFF, PERCENTAGE, and ABSOLUTE. The default value is OFF.

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

A Boolean specifying whether to exclude nodes with boundary conditions from the optimization. The default value is OFF.

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

The SymbolicConstant MODEL or a Region object specifying the region in which to freeze boundary condition regions, or the SymbolicConstant MODEL, used with freezeBoundaryConditionRegions. The default value is MODEL.

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

A SymbolicConstant specifying the frequency of evaluating geometric restrictions during mesh smoothing. Possible values are LOW, MEDIUM, and HIGH. The default value is LOW.

geometricRestrictions : --is-rst--:py:class:`dict`\ \[:py:class:`str`, :py:class:`~abaqus.Optimization.GeometricRestriction.GeometricRestriction`] = {}[source]

A repository of GeometricRestriction objects.

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

A Float specifying the scale factor to apply to optimization displacements for nodes with growth. The default value is 1.0.

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

A Boolean specifying whether to halt the optimization if quality criteria are not satisified. The default value is OFF.

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

None or a Region object specifying the region specifying the first node layer for mesh smoothing, used when meshSmoothingRegionMethod is TASK_REGION_LAYERS. The default value is None.

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

A SymbolicConstant specifying the method used to determine the mesh smoothing region. The REGION value uses the smoothingRegion. The NUMBER_OF_LAYERS value uses the layerReferenceRegion. The TASK_REGION_LAYERS value will smooth six layers using the task region. Possible values are TASK_REGION_LAYERS, REGION, and NUMBER_OF_LAYERS. The default value is TASK_REGION_LAYERS.

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

A SymbolicConstant specifying the method smoothing strategy. Possible values are CONSTRAINED_LAPLACIAN and LOCAL_GRADIENT. The default value is CONSTRAINED_LAPLACIAN.

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

A SymbolicConstant specifying the approach used when treating midside node positions during optimization. POSITIONS indicates midside node positions are interpolated linearly by position. OPTIMIZATION_DISPLACEMENT indicates they are interpolated by optimization displacement of corner nodes. Possible values are POSITIONS and OPTIMIZATION_DISPLACEMENT. The default value is POSITIONS.

numFreeNodeLayers : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` | :py:class:`int` = 0[source]

The SymbolicConstant FIX_NONE or an Int specifying the number of node layers adjoining the task region to remain free during mesh smoothing. A value of 0 indicates that no layers are free and all layers are fixed. The default value is 0.

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

None or an Int specifying the number of layers for mesh smoothing when meshSmoothingRegionMethod is NUMBER_OF_LAYERS. The default value is None.

objectiveFunctions : --is-rst--:py:class:`dict`\ \[:py:class:`str`, :py:class:`~abaqus.Optimization.ObjectiveFunction.ObjectiveFunction`] = {}[source]

A repository of ObjectiveFunction objects.

optimizationConstraints : --is-rst--:py:class:`dict`\ \[:py:class:`str`, :py:class:`~abaqus.Optimization.OptimizationConstraint.OptimizationConstraint`] = {}[source]

A repository of OptimizationConstraint objects.

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

A Boolean specifying whether to ignore automatically frozen boundary condition regions in the first design cycle. This is used with freezeBoundaryConditionRegions. The default value is ON.

quadMaxAngle : --is-rst--:py:class:`float` = 160[source]

A Float specifying the maximum angle for quad elements during mesh smoothing. The default value is 160.0.

quadMinAngle : --is-rst--:py:class:`float` = 20[source]

A Float specifying the minimum angle for quad elements during mesh smoothing. The default value is 20.0.

quadSkew : --is-rst--:py:class:`float` = 30[source]

A Float specifying the skew angle for quad elements during mesh smoothing, used with reportQualityViolation. The default value is 30.0.

quadTaper : --is-rst--:py:class:`float` = 0[source]

A Float specifying the taper for quad elements during mesh smoothing, used with reportQualityViolation. The default value is 0.5.

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

The SymbolicConstant MODEL or a Region object specifying the region to which the optimization task is applied. The default value is MODEL.

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

A Boolean specifying whether to report poor quality elements during mesh smoothing. The default value is OFF.

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

A Boolean specifying whether to report a quality criteria violation during mesh smoothing. The default value is OFF.

setValues(
absoluteStepSizeControl=MINIMUM,
activateDurability=1,
additionalDurabilityFiles='',
algorithm=CONDITION_BASED_OPTIMIZATION,
constrainedLaplacianConvergenceLevel=NORMAL,
curvatureSmoothingEdgeLength=5,
durabilityInputfile='',
durabilitySolver=FE_SAFE,
equalityConstraintTolerance=None,
featureRecognitionAngle=30,
filterExponent=1,
filterMaxRadius=None,
filterRadiusReduction=None,
firstCycleDeletedVolumeTechnique=0,
freezeBoundaryConditionRegions=0,
frozenBoundaryConditionRegion=MODEL,
geometricRestrictionEvaluationFrequency=LOW,
growthScaleFactor=1,
haltUponViolation=0,
layerReferenceRegion=None,
meshSmoothingRegionMethod=TASK_REGION_LAYERS,
meshSmoothingStrategy=CONSTRAINED_LAPLACIAN,
midsideInterpolation=POSITIONS,
numFreeNodeLayers=0,
numSmoothedElementLayers=None,
presumeFeasibleBCRegionAtStart=1,
quadMaxAngle=160,
quadMinAngle=20,
quadSkew=30,
quadTaper=0,
region=MODEL,
reportPoorQualityElements=0,
reportQualityViolation=0,
shrinkScaleFactor=1,
smoothingRegion=None,
targetMeshQuality=LOW,
tetAspectRatio=100,
tetMaxAspect=8,
tetMinAspect=0,
tetSkew=100,
triMaxAngle=140,
triMinAngle=20,
updateShapeBasisVectors=EVERY_CYCLE,
)[source]

This method modifies the ShapeTask object.

Parameters:
absoluteStepSizeControl=MINIMUM

A SymbolicConstant specifying whether to control the permitted absolute step size by the average optimization displacement or minimum optimization displacement. Possible values are MINIMUM and AVERAGE. The default value is MINIMUM.

activateDurability=1

A boolean specifying whether or not the durability approach of optimization is turned on. The default value is ON.

additionalDurabilityFiles=''

A String specifying the path of additional files pertaining to durability optimization. Only valid if the activateDurability argument is ON.

algorithm=CONDITION_BASED_OPTIMIZATION

A SymbolicConstant specifying the optimization task algorithm. Possible values are GENERAL_OPTIMIZATION and CONDITION_BASED_OPTIMIZATION. The default value is CONDITION_BASED_OPTIMIZATION.

constrainedLaplacianConvergenceLevel=NORMAL

A SymbolicConstant specifying the constrained Laplacian convergence level. Possible values are NORMAL, CONSERVATIVE, and AGGRESSIVE. The default value is NORMAL.

curvatureSmoothingEdgeLength=5

A Float specifying the edge length for the movement vector. The default value is 5.0.

durabilityInputfile=''

A string specifying the path of the input file. Only valid if the activateDurability argument is ON and is a required argument in that case.

durabilitySolver=FE_SAFE

A String specifying the type of solver for durability optimization. Possible values are: FE_SAFE, FEMFAT, FALANCS, MSC_FATIGUE, FE_FATIGUE, DESIGN_LIFE, CUSTOM, FEMSITE. The default value is FE_SAFE. Only valid if the activateDurability argument is ON.

equalityConstraintTolerance=None

A Float specifying the equality constraint tolerance. The default value is 10⁻³.

featureRecognitionAngle=30

A Float specifying the mesh smoothing feature recognition angle for edges and corners. The default value is 30.0.

filterExponent=1

A Float specifying the weight depending on the radius, used when filterMaxRadius is specified. The default value is 1.0.

filterMaxRadius=None

None or a Float specifying the maximum influence radius for equivalent stress. The default value is None.

filterRadiusReduction=None

None or a Float specifying the reduction of the radius depending on surface bending, used when filterMaxRadius is specified. The default value is None.

firstCycleDeletedVolumeTechnique=0

A SymbolicConstant specifying the method of specifying volume that can be removed immediately in the first design cycle. Possible values are OFF, PERCENTAGE, and ABSOLUTE. The default value is OFF.

freezeBoundaryConditionRegions=0

A Boolean specifying whether to exclude nodes with boundary conditions from the optimization. The default value is OFF.

frozenBoundaryConditionRegion=MODEL

The SymbolicConstant MODEL or a Region object specifying the region in which to freeze boundary condition regions, or the SymbolicConstant MODEL, used with freezeBoundaryConditionRegions. The default value is MODEL.

geometricRestrictionEvaluationFrequency=LOW

A SymbolicConstant specifying the frequency of evaluating geometric restrictions during mesh smoothing. Possible values are LOW, MEDIUM, and HIGH. The default value is LOW.

growthScaleFactor=1

A Float specifying the scale factor to apply to optimization displacements for nodes with growth. The default value is 1.0.

haltUponViolation=0

A Boolean specifying whether to halt the optimization if quality criteria are not satisified. The default value is OFF.

layerReferenceRegion=None

None or a Region object specifying the region specifying the first node layer for mesh smoothing, used when meshSmoothingRegionMethod is TASK_REGION_LAYERS. The default value is None.

meshSmoothingRegionMethod=TASK_REGION_LAYERS

A SymbolicConstant specifying the method used to determine the mesh smoothing region. The REGION value uses the smoothingRegion. The NUMBER_OF_LAYERS value uses the layerReferenceRegion. The TASK_REGION_LAYERS value will smooth six layers using the task region. Possible values are TASK_REGION_LAYERS, REGION, and NUMBER_OF_LAYERS. The default value is TASK_REGION_LAYERS.

meshSmoothingStrategy=CONSTRAINED_LAPLACIAN

A SymbolicConstant specifying the method smoothing strategy. Possible values are CONSTRAINED_LAPLACIAN and LOCAL_GRADIENT. The default value is CONSTRAINED_LAPLACIAN.

midsideInterpolation=POSITIONS

A SymbolicConstant specifying the approach used when treating midside node positions during optimization. POSITIONS indicates midside node positions are interpolated linearly by position. OPTIMIZATION_DISPLACEMENT indicates they are interpolated by optimization displacement of corner nodes. Possible values are POSITIONS and OPTIMIZATION_DISPLACEMENT. The default value is POSITIONS.

numFreeNodeLayers=0

The SymbolicConstant FIX_NONE or an Int specifying the number of node layers adjoining the task region to remain free during mesh smoothing. A value of 0 indicates that no layers are free and all layers are fixed. The default value is 0.

numSmoothedElementLayers=None

None or an Int specifying the number of layers for mesh smoothing when meshSmoothingRegionMethod is NUMBER_OF_LAYERS. The default value is None.

presumeFeasibleBCRegionAtStart=1

A Boolean specifying whether to ignore automatically frozen boundary condition regions in the first design cycle. This is used with freezeBoundaryConditionRegions. The default value is ON.

quadMaxAngle=160

A Float specifying the maximum angle for quad elements during mesh smoothing. The default value is 160.0.

quadMinAngle=20

A Float specifying the minimum angle for quad elements during mesh smoothing. The default value is 20.0.

quadSkew=30

A Float specifying the skew angle for quad elements during mesh smoothing, used with reportQualityViolation. The default value is 30.0.

quadTaper=0

A Float specifying the taper for quad elements during mesh smoothing, used with reportQualityViolation. The default value is 0.5.

region=MODEL

The SymbolicConstant MODEL or a Region object specifying the region to which the optimization task is applied. The default value is MODEL.

reportPoorQualityElements=0

A Boolean specifying whether to report poor quality elements during mesh smoothing. The default value is OFF.

reportQualityViolation=0

A Boolean specifying whether to report a quality criteria violation during mesh smoothing. The default value is OFF.

shrinkScaleFactor=1

A Float specifying the scale factor to apply to optimization displacements for nodes with shrinkage. The default value is 1.0.

smoothingRegion=None

None or a Region object specifying the mesh smoothing region, used when meshSmoothingRegionMethod is REGION. The default value is None.

targetMeshQuality=LOW

A SymbolicConstant specifying the target mesh quality for mesh smoothing. Possible values are NONE, LOW, MEDIUM, and HIGH. The default value is LOW.

tetAspectRatio=100

A Float specifying the tet element aspect ratio during mesh smoothing. The default value is 100.0.

tetMaxAspect=8

A Float specifying the maximum tet element aspect ratio during mesh smoothing. The default value is 8.0.

tetMinAspect=0

A Float specifying the minimum tet element aspect ratio during mesh smoothing. The default value is 0.222.

tetSkew=100

A Float specifying the tet element skew value during mesh smoothing. The default value is 100.0.

triMaxAngle=140

A Float specifying the tri element maximum angle during mesh smoothing. The default value is 140.0.

triMinAngle=20

A Float specifying the tri element maximum angle during mesh smoothing. The default value is 20.0.

updateShapeBasisVectors=EVERY_CYCLE

A SymbolicConstant specifying whether to update shape basis vectors in the first design cycle or every design cycle. Possible values are EVERY_CYCLE and FIRST_CYCLE. The default value is EVERY_CYCLE.

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

A Float specifying the scale factor to apply to optimization displacements for nodes with shrinkage. The default value is 1.0.

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

None or a Region object specifying the mesh smoothing region, used when meshSmoothingRegionMethod is REGION. The default value is None.

stopConditions : --is-rst--:py:class:`dict`\ \[:py:class:`str`, :py:class:`~abaqus.Optimization.StopCondition.StopCondition`] = {}[source]

A repository of StopCondition objects.

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

A SymbolicConstant specifying the target mesh quality for mesh smoothing. Possible values are NONE, LOW, MEDIUM, and HIGH. The default value is LOW.

tetAspectRatio : --is-rst--:py:class:`float` = 100[source]

A Float specifying the tet element aspect ratio during mesh smoothing. The default value is 100.0.

tetMaxAspect : --is-rst--:py:class:`float` = 8[source]

A Float specifying the maximum tet element aspect ratio during mesh smoothing. The default value is 8.0.

tetMinAspect : --is-rst--:py:class:`float` = 0[source]

A Float specifying the minimum tet element aspect ratio during mesh smoothing. The default value is 0.222.

tetSkew : --is-rst--:py:class:`float` = 100[source]

A Float specifying the tet element skew value during mesh smoothing. The default value is 100.0.

triMaxAngle : --is-rst--:py:class:`float` = 140[source]

A Float specifying the tri element maximum angle during mesh smoothing. The default value is 140.0.

triMinAngle : --is-rst--:py:class:`float` = 20[source]

A Float specifying the tri element maximum angle during mesh smoothing. The default value is 20.0.

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

A SymbolicConstant specifying whether to update shape basis vectors in the first design cycle or every design cycle. Possible values are EVERY_CYCLE and FIRST_CYCLE. The default value is EVERY_CYCLE.

class SizingTask(
name,
elementThicknessDeltaStopCriteria=0,
freezeBoundaryConditionRegions=0,
freezeLoadRegions=1,
modeTrackingRegion=MODEL,
numFulfilledStopCriteria=2,
numTrackedModes=5,
objectiveFunctionDeltaStopCriteria=0,
stopCriteriaDesignCycle=4,
thicknessMoveLimit=0,
thicknessUpdateStrategy=NORMAL,
)[source]

Bases: OptimizationTask

The SizingTask object defines a Sizing task. The SizingTask object is derived from the OptimizationTask object.

Note

This object can be accessed by:

import optimization
mdb.models[name].optimizationTasks[name]

Member Details:

designResponses : --is-rst--:py:class:`dict`\ \[:py:class:`str`, :py:class:`~abaqus.Optimization.DesignResponse.DesignResponse`] = {}[source]

A repository of DesignResponse objects.

elementThicknessDeltaStopCriteria : --is-rst--:py:class:`float` = 0[source]

A Float specifying the stop criteria based on the change in element thickness. The default value is 0.5 x 10⁻².

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

A Boolean specifying whether to exclude elements with boundary conditions from the optimization. The default value is OFF.

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

A Boolean specifying whether to exclude elements with loads and elements with loaded nodes from the optimization. The default value is ON.

geometricRestrictions : --is-rst--:py:class:`dict`\ \[:py:class:`str`, :py:class:`~abaqus.Optimization.GeometricRestriction.GeometricRestriction`] = {}[source]

A repository of GeometricRestriction objects.

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

The SymbolicConstatnt MODEL or a Region object specifying the region to use for mode tracking. The default value is MODEL.

numFulfilledStopCriteria : --is-rst--:py:class:`int` = 2[source]

An Int specifying the number of stop criteria. The default value is 2.

numTrackedModes : --is-rst--:py:class:`int` = 5[source]

An Int specifying the number of modes included in mode tracking. The default value is 5.

objectiveFunctionDeltaStopCriteria : --is-rst--:py:class:`float` = 0[source]

A Float specifying the stop criteria based on the change in objective function. The default value is 0.001.

objectiveFunctions : --is-rst--:py:class:`dict`\ \[:py:class:`str`, :py:class:`~abaqus.Optimization.ObjectiveFunction.ObjectiveFunction`] = {}[source]

A repository of ObjectiveFunction objects.

optimizationConstraints : --is-rst--:py:class:`dict`\ \[:py:class:`str`, :py:class:`~abaqus.Optimization.OptimizationConstraint.OptimizationConstraint`] = {}[source]

A repository of OptimizationConstraint objects.

setValues(
elementThicknessDeltaStopCriteria=0,
freezeBoundaryConditionRegions=0,
freezeLoadRegions=1,
modeTrackingRegion=MODEL,
numFulfilledStopCriteria=2,
numTrackedModes=5,
objectiveFunctionDeltaStopCriteria=0,
stopCriteriaDesignCycle=4,
thicknessMoveLimit=0,
thicknessUpdateStrategy=NORMAL,
)[source]

This method modifies the SizingTask object.

Parameters:
elementThicknessDeltaStopCriteria=0

A Float specifying the stop criteria based on the change in element thickness. The default value is 0.5 x 10⁻².

freezeBoundaryConditionRegions=0

A Boolean specifying whether to exclude elements with boundary conditions from the optimization. The default value is OFF.

freezeLoadRegions=1

A Boolean specifying whether to exclude elements with loads and elements with loaded nodes from the optimization. The default value is ON.

modeTrackingRegion=MODEL

The SymbolicConstatnt MODEL or a Region object specifying the region to use for mode tracking. The default value is MODEL.

numFulfilledStopCriteria=2

An Int specifying the number of stop criteria. The default value is 2.

numTrackedModes=5

An Int specifying the number of modes included in mode tracking. The default value is 5.

objectiveFunctionDeltaStopCriteria=0

A Float specifying the stop criteria based on the change in objective function. The default value is 0.001.

stopCriteriaDesignCycle=4

An Int specifying the first design cycle used to evaluate convergence criteria. The default value is 4.

thicknessMoveLimit=0

A Float specifying the maximum change in thickness per design cycle. The default value is 0.25.

thicknessUpdateStrategy=NORMAL

A SymbolicConstant specifying the strategy for how the thickness is updated in the method of moving asymptotes. Possible values are NORMAL, CONSERVATIVE, and AGGRESSIVE. The default value is NORMAL.

stopConditions : --is-rst--:py:class:`dict`\ \[:py:class:`str`, :py:class:`~abaqus.Optimization.StopCondition.StopCondition`] = {}[source]

A repository of StopCondition objects.

stopCriteriaDesignCycle : --is-rst--:py:class:`int` = 4[source]

An Int specifying the first design cycle used to evaluate convergence criteria. The default value is 4.

thicknessMoveLimit : --is-rst--:py:class:`float` = 0[source]

A Float specifying the maximum change in thickness per design cycle. The default value is 0.25.

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

A SymbolicConstant specifying the strategy for how the thickness is updated in the method of moving asymptotes. Possible values are NORMAL, CONSERVATIVE, and AGGRESSIVE. The default value is NORMAL.

class TopologyTask(
name,
abaqusSensitivities=True,
algorithm=GENERAL_OPTIMIZATION,
densityMoveLimit=0,
densityUpdateStrategy=NORMAL,
elementDensityDeltaStopCriteria=0,
filterRadius=None,
firstCycleDeletedVolume=5,
firstCycleDeletedVolumeTechnique=0,
freezeBoundaryConditionRegions=0,
freezeLoadRegions=1,
frequencySpectrumWeight=6,
initialDensity=DEFAULT,
materialInterpolationPenalty=3,
materialInterpolationTechnique=DEFAULT,
maxDensity=1,
minDensity=None,
modeTrackingRegion=MODEL,
numDesignCycles=15,
numFulfilledStopCriteria=2,
numTrackedModes=5,
objectiveFunctionDeltaStopCriteria=None,
region=MODEL,
softDeletionMethod=STANDARD,
softDeletionRadius=0,
softDeletionRegion=None,
softDeletionThreshold=None,
stepSize=MEDIUM,
stiffnessMassDamping=AVERAGE_EDGE_LENGTH,
stopCriteriaDesignCycle=4,
structuralMassDamping=None,
viscousMassDamping=None,
viscousStiffnessDamping=None,
)[source]

Bases: OptimizationTask

The TopologyTask object defines a topology task. The TopologyTask object is derived from the OptimizationTask object.

Note

This object can be accessed by:

import optimization
mdb.models[name].optimizationTasks[name]

Member Details:

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

A Boolean specifying whether to use Abaqus to compute the design responses and their sensitivities. The default value is True.

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

A SymbolicConstant specifying the optimization task algorithm. Possible values are GENERAL_OPTIMIZATION and CONDITION_BASED_OPTIMIZATION. The default value is GENERAL_OPTIMIZATION.

densityMoveLimit : --is-rst--:py:class:`float` = 0[source]

A Float specifying the maximum density change per design cycle. The default value is 0.25.

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

A SymbolicConstant specifying the strategy for how the densities are updated in the method of moving asymptotes. Possible values are NORMAL, CONSERVATIVE, and AGGRESSIVE. The default value is NORMAL.

designResponses : --is-rst--:py:class:`dict`\ \[:py:class:`str`, :py:class:`~abaqus.Optimization.DesignResponse.DesignResponse`] = {}[source]

A repository of DesignResponse objects.

elementDensityDeltaStopCriteria : --is-rst--:py:class:`float` = 0[source]

A Float specifying the stop criteria based upon the change in element densities. The default value is 0.5x10⁻².

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

None or a Float specifying the mesh filter radius for mesh independence and minimum size. The default value is None.

firstCycleDeletedVolume : --is-rst--:py:class:`float` = 5[source]

A Float specifying the volume that can be removed immediately in the first design cycle. The default value is 5.0.

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

A SymbolicConstant specifying the method of quantifying volume that can be removed immediately in the first design cycle. Possible values are OFF, PERCENTAGE, and ABSOLUTE. The default value is OFF.

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

A Boolean specifying whether to exclude elements with boundary conditions from the optimization. The default value is OFF.

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

A Boolean specifying whether to exclude elements with loads and elements with loaded nodes from the optimization. The default value is ON.

frequencySpectrumWeight : --is-rst--:py:class:`float` = 6[source]

A Float specifying the weighting factor for frequency spectrum peaks. The default value is 6.0.

geometricRestrictions : --is-rst--:py:class:`dict`\ \[:py:class:`str`, :py:class:`~abaqus.Optimization.GeometricRestriction.GeometricRestriction`] = {}[source]

A repository of GeometricRestriction objects.

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

A SymbolicConstant specifying the Optimization product default or a float specifying the initial density. The default value is DEFAULT.

materialInterpolationPenalty : --is-rst--:py:class:`float` = 3[source]

A Float specifying the penalty factor for the material interpolation technique. The default value is 3.0.

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

optimization product default, solid isotropic material with penalization, or rational approximation of material properties. Possible values are DEFAULT, SIMP, and RAMP. The default value is DEFAULT.

Type:

A SymbolicConstant specifying the material interpolation technique

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

A Float specifying the maximum density in the density update. The default value is 1.0.

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

A Float specifying the minimum density in the density update. The default value is 10⁻³.

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

The SymbolicConstant MODEL or a Region object specifying the region to use for mode tracking. The default value is MODEL.

numDesignCycles : --is-rst--:py:class:`int` = 15[source]

An Int specifying the number of design cycles permitted when stepSize is DYNAMIC. The default value is 15.

numFulfilledStopCriteria : --is-rst--:py:class:`int` = 2[source]

An Int specifying the number of stop criteria. The default value is 2.

numTrackedModes : --is-rst--:py:class:`int` = 5[source]

An Int specifying the number of modes included in mode tracking. The default value is 5.

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

A Float specifying the stop criteria based on the change in objective function. The default value is 10⁻³.

objectiveFunctions : --is-rst--:py:class:`dict`\ \[:py:class:`str`, :py:class:`~abaqus.Optimization.ObjectiveFunction.ObjectiveFunction`] = {}[source]

A repository of ObjectiveFunction objects.

optimizationConstraints : --is-rst--:py:class:`dict`\ \[:py:class:`str`, :py:class:`~abaqus.Optimization.OptimizationConstraint.OptimizationConstraint`] = {}[source]

A repository of OptimizationConstraint objects.

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

The SymbolicConstant MODEL or a Region object specifying the region to which the optimization task is applied. The default value is MODEL.

setValues(
abaqusSensitivities=True,
algorithm=GENERAL_OPTIMIZATION,
densityMoveLimit=0,
densityUpdateStrategy=NORMAL,
elementDensityDeltaStopCriteria=0,
filterRadius=None,
firstCycleDeletedVolume=5,
firstCycleDeletedVolumeTechnique=0,
freezeBoundaryConditionRegions=0,
freezeLoadRegions=1,
frequencySpectrumWeight=6,
initialDensity=DEFAULT,
materialInterpolationPenalty=3,
materialInterpolationTechnique=DEFAULT,
maxDensity=1,
minDensity=None,
modeTrackingRegion=MODEL,
numDesignCycles=15,
numFulfilledStopCriteria=2,
numTrackedModes=5,
objectiveFunctionDeltaStopCriteria=None,
region=MODEL,
softDeletionMethod=STANDARD,
softDeletionRadius=0,
softDeletionRegion=None,
softDeletionThreshold=None,
stepSize=MEDIUM,
stiffnessMassDamping=AVERAGE_EDGE_LENGTH,
stopCriteriaDesignCycle=4,
structuralMassDamping=None,
viscousMassDamping=None,
viscousStiffnessDamping=None,
)[source]

This method modifies the TopologyTask object.

Parameters:
abaqusSensitivities=True

A Boolean specifying whether to use Abaqus to compute the design responses and their sensitivities. The default value is True.

algorithm=GENERAL_OPTIMIZATION

A SymbolicConstant specifying the optimization task algorithm. Possible values are GENERAL_OPTIMIZATION and CONDITION_BASED_OPTIMIZATION. The default value is GENERAL_OPTIMIZATION.

densityMoveLimit=0

A Float specifying the maximum density change per design cycle. The default value is 0.25.

densityUpdateStrategy=NORMAL

A SymbolicConstant specifying the strategy for how the densities are updated in the method of moving asymptotes. Possible values are NORMAL, CONSERVATIVE, and AGGRESSIVE. The default value is NORMAL.

elementDensityDeltaStopCriteria=0

A Float specifying the stop criteria based upon the change in element densities. The default value is 0.5x10⁻².

filterRadius=None

None or a Float specifying the mesh filter radius for mesh independence and minimum size. The default value is None.

firstCycleDeletedVolume=5

A Float specifying the volume that can be removed immediately in the first design cycle. The default value is 5.0.

firstCycleDeletedVolumeTechnique=0

A SymbolicConstant specifying the method of quantifying volume that can be removed immediately in the first design cycle. Possible values are OFF, PERCENTAGE, and ABSOLUTE. The default value is OFF.

freezeBoundaryConditionRegions=0

A Boolean specifying whether to exclude elements with boundary conditions from the optimization. The default value is OFF.

freezeLoadRegions=1

A Boolean specifying whether to exclude elements with loads and elements with loaded nodes from the optimization. The default value is ON.

frequencySpectrumWeight=6

A Float specifying the weighting factor for frequency spectrum peaks. The default value is 6.0.

initialDensity=DEFAULT

A SymbolicConstant specifying the Optimization product default or a float specifying the initial density. The default value is DEFAULT.

materialInterpolationPenalty=3

A Float specifying the penalty factor for the material interpolation technique. The default value is 3.0.

materialInterpolationTechnique=DEFAULT

A SymbolicConstant specifying the material interpolation technique: optimization product default, solid isotropic material with penalization, or rational approximation of material properties. Possible values are DEFAULT, SIMP, and RAMP. The default value is DEFAULT.

maxDensity=1

A Float specifying the maximum density in the density update. The default value is 1.0.

minDensity=None

A Float specifying the minimum density in the density update. The default value is 10⁻³.

modeTrackingRegion=MODEL

The SymbolicConstant MODEL or a Region object specifying the region to use for mode tracking. The default value is MODEL.

numDesignCycles=15

An Int specifying the number of design cycles permitted when stepSize is DYNAMIC. The default value is 15.

numFulfilledStopCriteria=2

An Int specifying the number of stop criteria. The default value is 2.

numTrackedModes=5

An Int specifying the number of modes included in mode tracking. The default value is 5.

objectiveFunctionDeltaStopCriteria=None

A Float specifying the stop criteria based on the change in objective function. The default value is 10⁻³.

region=MODEL

The SymbolicConstant MODEL or a Region object specifying the region to which the optimization task is applied. The default value is MODEL.

softDeletionMethod=STANDARD

A SymbolicConstant specifying the method used when softDeletionRegion is specified. The STANDARD method avoids creating disconnected regions. The AGGRESSIVE method only considers the softDeletionThreshold. The MAX_SHEAR_STRAIN, MAX_ELASTOPLASTIC_STRAIN and VOLUME_COMPRESSION methods do not need the softDeletionRadius. Possible values are STANDARD, AGGRESSIVE, MAX_SHEAR_STRAIN, MIN_PRINCIPAL_STRAIN, MAX_ELASTOPLASTIC_STRAIN and VOLUME_COMPRESSION. The default value is STANDARD.

softDeletionRadius=0

A Float specifying the radius to use when considering neighboring soft elements to delete. The default value is 0.0.

softDeletionRegion=None

None or a Region object specifying the region in which the soft elements should be deleted during optimization. The default value is None.

softDeletionThreshold=None

A Float specifying the relative material density value used to identify soft elements. Those with values below the threshold are considered for removal. For STANDARD and AGGRESSIVE methods positive values are accepted and the default value is 0.05. For MAX_SHEAR_STRAIN and MAX_ELASTOPLASTIC_STRAIN methods positive values are accepted whereas for MIN_PRINCIPAL_STRAIN and VOLUME_COMPRESSION methods negative values are accepted.

stepSize=MEDIUM

A SymbolicConstant specifying the size of the increment for volume modification. Possible values are DYNAMIC, VERY_SMALL, SMALL, MODERATE, MEDIUM, and LARGE. The default value is MEDIUM.

stiffnessMassDamping=AVERAGE_EDGE_LENGTH

The SymbolicConstant AVERAGE_EDGE_LENGTH or a Float specifying the stiffness mass damping for the task region. The default value is AVERAGE_EDGE_LENGTH.

stopCriteriaDesignCycle=4

An Int specifying the first design cycle used to evaluate convergence criteria. The default value is 4.

structuralMassDamping=None

None or a Float specifying the structural mass damping for the task region. The default value is None.

viscousMassDamping=None

None or a Float specifying the viscous mass damping for the task region. The default value is None.

viscousStiffnessDamping=None

None or a Float specifying the viscous stiffness damping for the task region. The default value is None.

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

A SymbolicConstant specifying the method used when softDeletionRegion is specified. The STANDARD method avoids creating disconnected regions. The AGGRESSIVE method only considers the softDeletionThreshold. The MAX_SHEAR_STRAIN, MAX_ELASTOPLASTIC_STRAIN and VOLUME_COMPRESSION methods do not need the softDeletionRadius. Possible values are STANDARD, AGGRESSIVE, MAX_SHEAR_STRAIN, MIN_PRINCIPAL_STRAIN, MAX_ELASTOPLASTIC_STRAIN and VOLUME_COMPRESSION. The default value is STANDARD.

softDeletionRadius : --is-rst--:py:class:`float` = 0[source]

A Float specifying the radius to use when considering neighboring soft elements to delete. The default value is 0.0.

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

None or a Region object specifying the region in which the soft elements should be deleted during optimization. The default value is None.

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

A Float specifying the relative material density value used to identify soft elements. Those with values below the threshold are considered for removal. For STANDARD and AGGRESSIVE methods positive values are accepted and the default value is 0.05. For MAX_SHEAR_STRAIN and MAX_ELASTOPLASTIC_STRAIN methods positive values are accepted whereas for MIN_PRINCIPAL_STRAIN and VOLUME_COMPRESSION methods negative values are accepted.

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

A SymbolicConstant specifying the size of the increment for volume modification. Possible values are DYNAMIC, VERY_SMALL, SMALL, MODERATE, MEDIUM, and LARGE. The default value is MEDIUM.

stiffnessMassDamping : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`, :py:class:`float`] = 'AVERAGE_EDGE_LENGTH'[source]

The SymbolicConstant AVERAGE_EDGE_LENGTH or a Float specifying the stiffness mass damping for the task region. The default value is AVERAGE_EDGE_LENGTH.

stopConditions : --is-rst--:py:class:`dict`\ \[:py:class:`str`, :py:class:`~abaqus.Optimization.StopCondition.StopCondition`] = {}[source]

A repository of StopCondition objects.

stopCriteriaDesignCycle : --is-rst--:py:class:`int` = 4[source]

An Int specifying the first design cycle used to evaluate convergence criteria. The default value is 4.

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

None or a Float specifying the structural mass damping for the task region. The default value is None.

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

None or a Float specifying the viscous mass damping for the task region. The default value is None.

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

None or a Float specifying the viscous stiffness damping for the task region. The default value is None.

class StepOption[source]

Bases: object

A StepOption is an object used to define step options in a design response.

Note

This object can be accessed by:

import optimization
mdb.models[name].optimizationTasks[name].designResponses[name].stepOptions[i]

Member Details:

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

The SymbolicConstant ALL or a String specifying the name of the load case. loadCase is ignored when the specified step does not contain a load case. The default value is ALL.

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

The SymbolicConstant ALL or an Int specifying the lower mode in the range of modes to consider in the step. lowerMode is ignored for steps without modes. The default value is ALL.

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

A string specifying the name of the model from which the steps are supposed to be used in the design response. Specify only if the steps are not from the current model.

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

The SymbolicConstant ALL or a String specifying the name of the step. The default value is ALL.

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

The SymbolicConstant ALL or an Int specifying the upper mode in the range of modes to consider in the step. upperMode is ignored for steps without modes. The default value is ALL.