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=abaqusConstants.NOT_SET, modelType=abaqusConstants.STANDARD_EXPLICIT, universalGas=None, copyConstraints=ON, copyConnectors=ON, copyInteractions=ON)[source]#

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

Note

This object can be accessed by:

mdb.models[name]

Note

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

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

This method creates a BeadTask object.

Note

This function can be accessed by:

mdb.models[name].BeadTask

Note

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

Parameters:

name (str) – A String specifying the optimization task repository key.
abaqusSensitivities (Union[AbaqusBoolean, bool], default: True) –
A Boolean specifying whether to use Abaqus to compute the design responses and their sensitivities. The default value is True.

New in version 2019: The abaqusSensitivities argument was added.
algorithm (SymbolicConstant, default: 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 (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to exclude elements with boundary conditions from the optimization. The default value is OFF.
beadIter (str, default: 1) – An int specifying the step size of the optimization. The default value is 1.
beadMaxMembraneStress (str, default: 0) – A float specifying maximum membrane/bending stress. The default value is 0.1.
beadMinStress (str, default: 0) – A float specifying minimum stress. The default value is 0.001.
beadPerturbation (str, default: 0) – A Sets perturbation size for finite differences. The default value is 0.0001.
beadWidth (SymbolicConstant, default: DEFAULT) – A SymbolicConstant specifying the Optimization product default or a float specifying the bead width. The default value is DEFAULT.
curveSmooth (str, default: 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 (str, default: 4) – A float specifying the filter radius. The default value is 4.
filterRadiusBy (SymbolicConstant, default: VALUE) – A SymbolicConstant specifying the method used to define filter radius. Possible values are VALUE and REFERENCE. The default is VALUE.
flipNormalDir (Union[AbaqusBoolean, bool], default: OFF) – 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 (SymbolicConstant, default: 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 (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to calculate the sensitivities only on design nodes or the whole model. The default value is ON
modeTrackingRegion (SymbolicConstant, default: MODEL) – The SymbolicConstant MODEL or a Region object specifying the region to use for mode tracking. The default value is MODEL.
nodalMoveLimit (float, default: 0) – A Float specifying the maximum change in nodal displacement per design cycle. The default value is 0.1.
nodeSmooth (SymbolicConstant, default: DEFAULT) – A SymbolicConstant specifying the Optimization product default or a float specifying the node smooth. The default value is DEFAULT.
nodeUpdateStrategy (SymbolicConstant, default: 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 (int, default: 5) – An Int specifying the number of modes included in mode tracking. The default value is 5.
updateShapeBasisVectors (SymbolicConstant, default: 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.
groupOperator (Union[AbaqusBoolean, bool], default: OFF) –
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.

New in version 2022: The groupOperator argument was added.

Returns:

A BeadTask object.

Return type:

BeadTask

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

This method creates a ShapeTask object.

Note

This function can be accessed by:

mdb.models[name].ShapeTask

Note

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

Parameters:

name (str) – A String specifying the optimization task repository key.
abaqusSensitivities (Union[AbaqusBoolean, bool], default: True) –
A Boolean specifying whether to use Abaqus to compute the design responses and their sensitivities. The default value is True.

New in version 2019: The abaqusSensitivities argument was added.
absoluteStepSizeControl (SymbolicConstant, default: 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 (Union[AbaqusBoolean, bool], default: ON) – A boolean specifying whether or not the durability approach of optimization is turned on. The default value is ON.
additionalDurabilityFiles (str, default: '') – A String specifying the path of additional files pertaining to durability optimization. Only valid if the activateDurability argument is ON.
constrainedLaplacianConvergenceLevel (SymbolicConstant, default: NORMAL) – A SymbolicConstant specifying the constrained Laplacian convergence level. Possible values are NORMAL, CONSERVATIVE, and AGGRESSIVE. The default value is NORMAL.
curvatureSmoothingEdgeLength (float, default: 5) – A Float specifying the edge length for the movement vector. The default value is 5.0.
durabilityInputfile (str, default: '') – 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 (str, default: 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 (Optional[float], default: None) – A Float specifying the equality constraint tolerance. The default value is 10-3.
featureRecognitionAngle (float, default: 30) – A Float specifying the mesh smoothing feature recognition angle for edges and corners. The default value is 30.0.
filterExponent (float, default: 1) – A Float specifying the weight depending on the radius, used when filterMaxRadius is specified. The default value is 1.0.
filterMaxRadius (Optional[float], default: None) – None or a Float specifying the maximum influence radius for equivalent stress. The default value is None.
filterRadiusReduction (Optional[float], default: 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 (SymbolicConstant, default: OFF) – 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 (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to exclude nodes with boundary conditions from the optimization. The default value is OFF.
frozenBoundaryConditionRegion (SymbolicConstant, default: 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 (SymbolicConstant, default: 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 (float, default: 1) – A Float specifying the scale factor to apply to optimization displacements for nodes with growth. The default value is 1.0.
haltUponViolation (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to halt the optimization if quality criteria are not satisified. The default value is OFF.
layerReferenceRegion (Optional[str], default: 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 (SymbolicConstant, default: 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 (SymbolicConstant, default: CONSTRAINED_LAPLACIAN) – A SymbolicConstant specifying the method smoothing strategy. Possible values are CONSTRAINED_LAPLACIAN and LOCAL_GRADIENT. The default value is CONSTRAINED_LAPLACIAN.
midsideInterpolation (SymbolicConstant, default: 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 (SymbolicConstant, default: 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 (Optional[int], default: 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 (Union[AbaqusBoolean, bool], default: ON) – 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 (float, default: 160) – A Float specifying the maximum angle for quad elements during mesh smoothing. The default value is 160.0.
quadMinAngle (float, default: 20) – A Float specifying the minimum angle for quad elements during mesh smoothing. The default value is 20.0.
quadSkew (float, default: 30) – A Float specifying the skew angle for quad elements during mesh smoothing, used with reportQualityViolation. The default value is 30.0.
quadTaper (float, default: 0) – A Float specifying the taper for quad elements during mesh smoothing, used with reportQualityViolation. The default value is 0.5.
region (SymbolicConstant, default: MODEL) – The SymbolicConstant MODEL or a Region object specifying the region to which the optimization task is applied. The default value is MODEL.
reportPoorQualityElements (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to report poor quality elements during mesh smoothing. The default value is OFF.
reportQualityViolation (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to report a quality criteria violation during mesh smoothing. The default value is OFF.
shrinkScaleFactor (float, default: 1) – A Float specifying the scale factor to apply to optimization displacements for nodes with shrinkage. The default value is 1.0.
smoothingRegion (Optional[str], default: None) – None or a Region object specifying the mesh smoothing region, used when meshSmoothingRegionMethod is REGION. The default value is None.
targetMeshQuality (SymbolicConstant, default: 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 (float, default: 100) – A Float specifying the tet element aspect ratio during mesh smoothing. The default value is 100.0.
tetMaxAspect (float, default: 8) – A Float specifying the maximum tet element aspect ratio during mesh smoothing. The default value is 8.0.
tetMinAspect (float, default: 0) – A Float specifying the minimum tet element aspect ratio during mesh smoothing. The default value is 0.222.
tetSkew (float, default: 100) – A Float specifying the tet element skew value during mesh smoothing. The default value is 100.0.
triMaxAngle (float, default: 140) – A Float specifying the tri element maximum angle during mesh smoothing. The default value is 140.0.
triMinAngle (float, default: 20) – A Float specifying the tri element maximum angle during mesh smoothing. The default value is 20.0.
updateShapeBasisVectors (SymbolicConstant, default: 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.
groupOperator (Union[AbaqusBoolean, bool], default: OFF) –
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.

New in version 2022: The groupOperator argument was added.

Returns:

A ShapeTask object.

Return type:

ShapeTask

SizingTask(name, abaqusSensitivities=True, elementThicknessDeltaStopCriteria=0, freezeBoundaryConditionRegions=OFF, freezeLoadRegions=ON, modeTrackingRegion=abaqusConstants.MODEL, numFulfilledStopCriteria=2, numTrackedModes=5, objectiveFunctionDeltaStopCriteria=0, stopCriteriaDesignCycle=4, thicknessMoveLimit=0, thicknessUpdateStrategy=abaqusConstants.NORMAL, groupOperator=OFF)[source]#

This method creates a SizingTask object.

Note

This function can be accessed by:

mdb.models[name].SizingTask

Note

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

Parameters:

name (str) – A String specifying the optimization task repository key.
abaqusSensitivities (Union[AbaqusBoolean, bool], default: True) –
A Boolean specifying whether to use Abaqus to compute the design responses and their sensitivities. The default value is True.

New in version 2019: The abaqusSensitivities argument was added.
elementThicknessDeltaStopCriteria (float, default: 0) – A Float specifying the stop criteria based on the change in element thickness. The default value is 0.5 × 10-2.
freezeBoundaryConditionRegions (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to exclude elements with boundary conditions from the optimization. The default value is OFF.
freezeLoadRegions (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to exclude elements with loads and elements with loaded nodes from the optimization. The default value is ON.
modeTrackingRegion (str, default: MODEL) – The SymbolicConstatnt MODEL or a Region object specifying the region to use for mode tracking. The default value is MODEL.
numFulfilledStopCriteria (int, default: 2) – An Int specifying the number of stop criteria. The default value is 2.
numTrackedModes (int, default: 5) – An Int specifying the number of modes included in mode tracking. The default value is 5.
objectiveFunctionDeltaStopCriteria (float, default: 0) – A Float specifying the stop criteria based on the change in objective function. The default value is 0.001.
stopCriteriaDesignCycle (int, default: 4) – An Int specifying the first design cycle used to evaluate convergence criteria. The default value is 4.
thicknessMoveLimit (float, default: 0) – A Float specifying the maximum change in thickness per design cycle. The default value is 0.25.
thicknessUpdateStrategy (SymbolicConstant, default: 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.
groupOperator (Union[AbaqusBoolean, bool], default: OFF) –
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.

New in version 2022: The groupOperator argument was added.

Returns:

A SizingTask object.

Return type:

SizingTask

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

This method creates a TopologyTask object.

Note

This function can be accessed by:

mdb.models[name].TopologyTask

Note

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

Parameters:

name (str) – A String specifying the optimization task repository key.
abaqusSensitivities (Union[AbaqusBoolean, bool], default: True) –
A Boolean specifying whether to use Abaqus to compute the design responses and their sensitivities. The default value is True.

New in version 2019: The abaqusSensitivities argument was added.
algorithm (SymbolicConstant, default: 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 (float, default: 0) – A Float specifying the maximum density change per design cycle. The default value is 0.25.
densityUpdateStrategy (SymbolicConstant, default: 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 (float, default: 0) – A Float specifying the stop criteria based upon the change in element densities. The default value is 0.5×10-2.
filterRadius (Optional[float], default: None) – None or a Float specifying the mesh filter radius for mesh independence and minimum size. The default value is None.
firstCycleDeletedVolume (float, default: 5) – A Float specifying the volume that can be removed immediately in the first design cycle. The default value is 5.0.
firstCycleDeletedVolumeTechnique (SymbolicConstant, default: OFF) – 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 (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to exclude elements with boundary conditions from the optimization. The default value is OFF.
freezeLoadRegions (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to exclude elements with loads and elements with loaded nodes from the optimization. The default value is ON.
frequencySpectrumWeight (float, default: 6) – A Float specifying the weighting factor for frequency spectrum peaks. The default value is 6.0.
initialDensity (SymbolicConstant, default: DEFAULT) – A SymbolicConstant specifying the Optimization product default or a float specifying the initial density. The default value is DEFAULT.
materialInterpolationPenalty (float, default: 3) – A Float specifying the penalty factor for the material interpolation technique. The default value is 3.0.
materialInterpolationTechnique (SymbolicConstant, default: 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 (float, default: 1) – A Float specifying the maximum density in the density update. The default value is 1.0.
minDensity (Optional[float], default: None) – A Float specifying the minimum density in the density update. The default value is 10-3.
modeTrackingRegion (SymbolicConstant, default: MODEL) – The SymbolicConstant MODEL or a Region object specifying the region to use for mode tracking. The default value is MODEL.
numDesignCycles (int, default: 15) – An Int specifying the number of design cycles permitted when stepSize is DYNAMIC. The default value is 15.
numFulfilledStopCriteria (int, default: 2) – An Int specifying the number of stop criteria. The default value is 2.
numTrackedModes (int, default: 5) – An Int specifying the number of modes included in mode tracking. The default value is 5.
objectiveFunctionDeltaStopCriteria (Optional[float], default: None) – A Float specifying the stop criteria based on the change in objective function. The default value is 10-3.
region (SymbolicConstant, default: MODEL) – The SymbolicConstant MODEL or a Region object specifying the region to which the optimization task is applied. The default value is MODEL.
softDeletionMethod (SymbolicConstant, default: 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 (float, default: 0) – A Float specifying the radius to use when considering neighboring soft elements to delete. The default value is 0.0.
softDeletionRegion (Optional[str], default: 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 (Optional[float], default: 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 (SymbolicConstant, default: 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 (Union[SymbolicConstant, float], default: 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 (int, default: 4) – An Int specifying the first design cycle used to evaluate convergence criteria. The default value is 4.
structuralMassDamping (Optional[float], default: None) – None or a Float specifying the structural mass damping for the task region. The default value is None.
viscousMassDamping (Optional[float], default: None) – None or a Float specifying the viscous mass damping for the task region. The default value is None.
viscousStiffnessDamping (Optional[float], default: None) – None or a Float specifying the viscous stiffness damping for the task region. The default value is None.
groupOperator (Union[AbaqusBoolean, bool], default: OFF) –
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.

New in version 2022: The groupOperator argument was added.

Returns:

A TopologyTask object.

Return type:

TopologyTask

Assign features to optimization tasks#

class OptimizationTask[source]#

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, ...[, ...])	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.
`TopologyMillingControl`(name, ...[, csys, ...])	This method creates a TopologyMillingControl object.
`TopologyOverhangControl`(name, pullDirection, ...)	This method creates a TopologyOverhangControl 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.

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

This method creates a BeadFixedRegion object.

Note

This function can be accessed by:

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

Note

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

Parameters:

name (str) – A String specifying the geometric restriction repository key.
region (Region) – A Region object specifying the region to which the geometric restriction is applied.
csys (Optional[int], default: 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 (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to fix the region in the 1-direction. The default value is OFF.
u2 (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to fix the region in the 2-direction. The default value is OFF.
u3 (Union[AbaqusBoolean, bool], default: OFF) – 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

Note

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

Parameters:

name (str) – A String specifying the geometric restriction repository key.
region (Region) – A Region object specifying the region to which the geometric restriction is applied.
beadGrowth (float, default: 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 (float, default: 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

Note

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

Parameters:

name (str) – A String specifying the geometric restriction repository key.
beadPenetrationCheckRegion (Region) – A Region object specifying the penetration check region.
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=abaqusConstants.AXIS_1, csys=None)[source]#

This method creates a BeadPlanarSymmetry object.

Note

This function can be accessed by:

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

Note

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

Parameters:

name (str) – A String specifying the geometric restriction repository key.
region (Region) – A Region object specifying the region to which the geometric restriction is applied.
axis (SymbolicConstant, default: 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 (Optional[int], default: 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

Note

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

Parameters:

name (str) – A String specifying the geometric restriction repository key.
region (Region) – A Region object specifying the region to which the geometric restriction is applied.
csys (Optional[int], default: 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=abaqusConstants.AXIS_1, csys=None)[source]#

This method creates a BeadRotationalSymmetry object.

Note

This function can be accessed by:

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

Note

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

Parameters:

name (str) – A String specifying the geometric restriction repository key.
angle (float) – A Float specifying the repeating segment size, an angle in degrees.
region (Region) – A Region object specifying the region to which the geometric restriction is applied.
axis (SymbolicConstant, default: 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 (Optional[int], default: 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, mainPoint=None, mainPointDetermination=abaqusConstants.MAXIMUM, movementRestriction=abaqusConstants.VECTOR, presumeFeasibleRegionAtStart=ON, u1=ON, u2=ON, u3=ON)[source]#

This method creates a DesignDirection object.

Note

This function can be accessed by:

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

Note

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

Parameters:

name (str) – A String specifying the geometric restriction repository key.
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.
csys (Optional[int], default: 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.
mainPoint (Optional[str], default: None) –
None or a Region object specifying the main point used when mainPointDetermination is SPECIFY. The default value is None.

Changed in version 2022: The argument masterPoint was renamed to mainPoint.
mainPointDetermination (SymbolicConstant, default: MAXIMUM) –
A SymbolicConstant specifying the rule for assigning point priority. Possible values are MAXIMUM, MINIMUM, and SPECIFY. The default value is MAXIMUM.

Changed in version 2022: The argument masterPointDetermination was renamed to mainPointDetermination.
movementRestriction (SymbolicConstant, default: VECTOR) – A SymbolicConstant specifying whether movement in the region should follow only the direction of the mainPoint, only the magnitude, or both the magnitude of the mainPoint and the directions specified by u1, u2 and u3. Possible values are DIRECTION, MAGNITUDE, and VECTOR. The default value is VECTOR.
presumeFeasibleRegionAtStart (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.
u1 (Union[AbaqusBoolean, bool], default: ON) – 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 (Union[AbaqusBoolean, bool], default: ON) – 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 (Union[AbaqusBoolean, bool], default: ON) – 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, mainPoint=None, mainPointDetermination=abaqusConstants.MAXIMUM, presumeFeasibleRegionAtStart=ON, 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

Note

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

Parameters:

name (str) – A String specifying the geometric restriction repository key.
clientDirection (tuple) – 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 (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 (Optional[int], default: 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 (float, default: 0) – A Float specifying the draw angle. The default value is 0.0.
mainPoint (Optional[str], default: None) –
None or a Region object specifying the main point used when mainPointDetermination is SPECIFY. The default value is None.

Changed in version 2022: The argument masterPoint was renamed to mainPoint.
mainPointDetermination (SymbolicConstant, default: MAXIMUM) –
A SymbolicConstant specifying the rule for assigning point priority. Possible values are MAXIMUM, MINIMUM, and SPECIFY. The default value is MAXIMUM.

Changed in version 2022: The argument masterPointDetermination was renamed to mainPointDetermination.
presumeFeasibleRegionAtStart (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.
tolerance1 (float, default: 0) – A Float specifying the geometric tolerance in the 1-direction. The default value is 0.01.
tolerance2 (float, default: 0) – A Float specifying the geometric tolerance in the 2-direction. The default value is 0.01.
tolerance3 (float, default: 0) – A Float specifying the geometric tolerance in the 3-direction. The default value is 0.01.
undercutTolerance (float, default: 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=ON, u1=OFF, u2=OFF, u3=OFF)[source]#

This method creates a FixedRegion object.

Note

This function can be accessed by:

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

Note

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

Parameters:

name (str) – A String specifying the geometric restriction repository key.
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.
csys (Optional[int], default: 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 (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.
u1 (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to fix the region in the 1-direction. The default value is OFF.
u2 (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to fix the region in the 2-direction. The default value is OFF.
u3 (Union[AbaqusBoolean, bool], default: OFF) – 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

Note

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

Parameters:

name (str) – A String specifying the geometric restriction repository key.
region (Region, default: <abaqus.Region.Region.Region object at 0x7f350e1c8be0>) – 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=ON, shrink=0)[source]#

This method creates a Growth object.

Note

This function can be accessed by:

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

Note

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

Parameters:

name (str) – A String specifying the geometric restriction repository key.
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.
growth (float, default: 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 (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.
shrink (float, default: 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=abaqusConstants.MINIMIZE)[source]#

This method creates an ObjectiveFunction object.

Note

This function can be accessed by:

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

Note

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

Parameters:

name (str) – A String specifying the objective function repository key.
objectives (List[OptimizationObjective]) – An OptimizationObjectiveArray object.
target (SymbolicConstant, default: 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=abaqusConstants.ABSOLUTE_EQUAL)[source]#

This method creates an OptimizationConstraint object.

Note

This function can be accessed by:

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

Note

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

Parameters:

name (str) – A String specifying the optimization constraint repository key.
designResponse (str) – A String specifying the name of the design response to constrain.
restrictionValue (float) – A Float specifying the value to which the design response should be constrained.
restrictionMethod (SymbolicConstant, default: 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=ON)[source]#

This method creates a PenetrationCheck object.

Note

This function can be accessed by:

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

Note

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

Parameters:

name (str) – A String specifying the geometric restriction repository key.
penetrationCheckRegion (Region) – A Region object specifying the penetration check region.
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 (Union[AbaqusBoolean, bool], default: ON) – 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=abaqusConstants.DEMOLD_REGION, csys=None, drawAngle=0, mainPointDetermination=abaqusConstants.MAXIMUM, presumeFeasibleRegionAtStart=ON, 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

Note

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

Parameters:

name (str) – A String specifying the geometric restriction repository key.
pullDirection (tuple) – 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 (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 (SymbolicConstant, default: 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 (Optional[int], default: 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 (float, default: 0) – A Float specifying the draw angle. The default value is 0.0.
mainPointDetermination (SymbolicConstant, default: MAXIMUM) –
A SymbolicConstant specifying the rule for assigning point priority. Possible values are MAXIMUM and MINIMUM. The default value is MAXIMUM.

Changed in version 2022: The argument masterPointDetermination was renamed to mainPointDetermination.
presumeFeasibleRegionAtStart (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.
tolerance1 (float, default: 0) – A Float specifying the geometric tolerance in the 1-direction. The default value is 0.01.
tolerance2 (float, default: 0) – A Float specifying the geometric tolerance in the 2-direction. The default value is 0.01.
tolerance3 (float, default: 0) – A Float specifying the geometric tolerance in the 3-direction. The default value is 0.01.
undercutTolerance (float, default: 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=abaqusConstants.MINIMUM, assignNodeGroupRegion=OFF, nodeGroupRegion='')[source]#

This method creates a ShapeMemberSize object.

Note

This function can be accessed by:

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

Note

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

Parameters:

name (str) – A String specifying the geometric restriction repository key.
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.
maxThickness (float, default: 0) – A Float specifying the maximum thickness. The default value is 0.0.
minThickness (float, default: 0) – A Float specifying the minimum thickness. The default value is 0.0.
sizeRestriction (SymbolicConstant, default: MINIMUM) – A SymbolicConstant specifying whether to restrict the minimum or maximum thickness. Possible values are MAXIMUM and MINIMUM. The default value is MINIMUM.
assignNodeGroupRegion (str, default: OFF) –
A bool specifying whether to use the node group region. The default value is OFF.

New in version 2022: The assignNodeGroupRegion argument was added.
nodeGroupRegion (str, default: '') –
A Node Region object specifying the check node group.

New in version 2022: The nodeGroupRegion argument was added.

Returns:

A ShapeMemberSize object.

Return type:

ShapeMemberSize

ShapePlanarSymmetry(name, clientDirection, region, allowNonSymmetricMesh=True, csys=None, mainPointDetermination=abaqusConstants.MAXIMUM, presumeFeasibleRegionAtStart=ON, 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

Note

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

Parameters:

name (str) – A String specifying the geometric restriction repository key.
clientDirection (tuple) – 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 (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.
allowNonSymmetricMesh (Union[AbaqusBoolean, bool], default: True) –
A Boolean specifying whether to allow a nonsymmetric mesh for this geometric restriction. The default value is TRUE.

New in version 2021: The alloowNonSymmetricMesh argument was added.
csys (Optional[int], default: 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.
mainPointDetermination (SymbolicConstant, default: MAXIMUM) –
A SymbolicConstant specifying the rule for determining the main node. Possible values are MAXIMUM and MINIMUM. The default value is MAXIMUM.

Changed in version 2022: The argument masterPointDetermination was renamed to mainPointDetermination.
presumeFeasibleRegionAtStart (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.
tolerance1 (float, default: 0) – A Float specifying the geometric tolerance in the 1-direction. The default value is 0.01.
tolerance2 (float, default: 0) – A Float specifying the geometric tolerance in the 2-direction. The default value is 0.01.
tolerance3 (float, default: 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, mainPointDetermination=abaqusConstants.MAXIMUM, presumeFeasibleRegionAtStart=ON, 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

Note

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

Parameters:

name (str) – A String specifying the geometric restriction repository key.
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.
csys (Optional[int], default: 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.
mainPointDetermination (SymbolicConstant, default: MAXIMUM) –
A SymbolicConstant specifying the rule for determining the main node. Possible values are MAXIMUM and MINIMUM. The default value is MAXIMUM.

Changed in version 2022: The argument masterPointDetermination was renamed to mainPointDetermination.
presumeFeasibleRegionAtStart (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.
tolerance1 (float, default: 0) – A Float specifying the geometric tolerance in the 1-direction. The default value is 0.01.
tolerance2 (float, default: 0) – A Float specifying the geometric tolerance in the 2-direction. The default value is 0.01.
tolerance3 (float, default: 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, allowNonSymmetricMesh=True, angle=0, csys=None, mainPoint=None, mainPointDetermination=abaqusConstants.MAXIMUM, presumeFeasibleRegionAtStart=ON, 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

Note

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

Parameters:

name (str) – A String specifying the geometric restriction repository key.
clientDirection (tuple) – 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 (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.
allowNonSymmetricMesh (Union[AbaqusBoolean, bool], default: True) –
A Boolean specifying whether to allow a nonsymmetric mesh for this geometric restriction. The default value is TRUE.

New in version 2021: The alloowNonSymmetricMesh argument was added.
angle (float, default: 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 (Optional[int], default: 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.
mainPoint (Optional[str], default: None) –
None or a Region object specifying the main point used when mainPointDetermination is SPECIFY. The default value is None.

Changed in version 2022: The argument masterPoint was renamed to mainPoint.
mainPointDetermination (SymbolicConstant, default: MAXIMUM) –
A SymbolicConstant specifying the rule for determining the main node. Possible values are MAXIMUM, MINIMUM, and SPECIFY. The default value is MAXIMUM.

Changed in version 2022: The argument masterPointDetermination was renamed to mainPointDetermination.
presumeFeasibleRegionAtStart (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.
startPoint (Optional[float], default: None) – A tuple of Floats representing the coordinates of a start point of the rotational symmetry.
tolerance1 (float, default: 0) – A Float specifying the geometric tolerance in the 1-direction. The default value is 0.01.
tolerance2 (float, default: 0) – A Float specifying the geometric tolerance in the 2-direction. The default value is 0.01.
tolerance3 (float, default: 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=abaqusConstants.SUM, region=abaqusConstants.MODEL, shellLayer=abaqusConstants.MAXIMUM, stepOperation=abaqusConstants.SUM, stepOptions=None)[source]#

This method creates a SingleTermDesignResponse object.

Note

This function can be accessed by:

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

Note

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

Parameters:

name (str) – A String specifying the design response repository key.
identifier (str) – A String specifying the name of the variable identifier.
csys (Optional[int], default: 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 (Optional[str], default: 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 (SymbolicConstant, default: 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 (SymbolicConstant, default: MODEL) – The SymbolicConstant MODEL or a Region object specifying the region of the design response variable. The default value is MODEL.
shellLayer (SymbolicConstant, default: 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 (SymbolicConstant, default: 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 (Optional[List[StepOption]], default: 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

Note

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

Parameters:

name (str) – A String specifying the geometric restriction repository key.
regions (tuple) – 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=abaqusConstants.AXIS_1, csys=None, ignoreFrozenArea=OFF)[source]#

This method creates a SizingCyclicSymmetry object.

Note

This function can be accessed by:

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

Note

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

Parameters:

name (str) – A String specifying the geometric restriction repository key.
region (Region) – A Region object specifying the region to which the geometric restriction is applied.
translation (float) – A Float specifying the translation distance.
axis (SymbolicConstant, default: 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 (Optional[int], default: 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 (Union[AbaqusBoolean, bool], default: OFF) – 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

Note

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

Parameters:

name (str) – A String specifying the geometric restriction repository key.
region (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

Note

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

Parameters:

name (str) – A String specifying the geometric restriction repository key.
region (Region) – A Region object specifying the region to which the geometric restriction is applied.
minWidth (float) – A Float specifying the min width.

SizingPlanarSymmetry(name, region, axis=abaqusConstants.AXIS_1, csys=None, ignoreFrozenArea=OFF)[source]#

This method creates a SizingPlanarSymmetry object.

Note

This function can be accessed by:

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

Note

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

Parameters:

name (str) – A String specifying the geometric restriction repository key.
region (Region) – A Region object specifying the region to which the geometric restriction is applied.
axis (SymbolicConstant, default: 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 (Optional[int], default: 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 (Union[AbaqusBoolean, bool], default: OFF) – 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=OFF)[source]#

This method creates a SizingPointSymmetry object.

Note

This function can be accessed by:

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

Note

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

Parameters:

name (str) – A String specifying the geometric restriction repository key.
region (Region) – A Region object specifying the region to which the geometric restriction is applied.
csys (Optional[int], default: 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 (Union[AbaqusBoolean, bool], default: OFF) – 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=abaqusConstants.AXIS_1, csys=None, ignoreFrozenArea=OFF)[source]#

This method creates a SizingRotationalSymmetry object.

Note

This function can be accessed by:

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

Note

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

Parameters:

name (str) – A String specifying the geometric restriction repository key.
angle (float) – A Float specifying the repeating segment size, an angle in degrees.
region (Region) – A Region object specifying the region to which the geometric restriction is applied.
axis (SymbolicConstant, default: 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 (Optional[int], default: 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 (Union[AbaqusBoolean, bool], default: OFF) – 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=abaqusConstants.FREE_FORM, csys=None, freeFormRegion=None, presumeFeasibleRegionAtStart=ON, 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

Note

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

Parameters:

name (str) – A String specifying the geometric restriction repository key.
clientDirection (tuple) – 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 (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 (SymbolicConstant, default: 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 (Optional[int], default: 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 (Optional[str], default: 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 (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.
revolvedRegion (Optional[str], default: 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 (float, default: 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 (float, default: 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 (float, default: 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, mainPoint=None, mainPointDetermination=abaqusConstants.MAXIMUM, presumeFeasibleRegionAtStart=ON, 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

Note

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

Parameters:

name (str) – A String specifying the geometric restriction repository key.
clientDirection (tuple) – 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 (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 (Optional[int], default: 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 (float, default: 0) – A Float specifying the draw angle. The default value is 0.0.
mainPoint (Optional[str], default: None) –
None or a Region object specifying the main point used when mainPointDetermination is SPECIFY. The default value is None.

Changed in version 2022: The argument masterPoint was renamed to mainPoint.
mainPointDetermination (SymbolicConstant, default: MAXIMUM) –
A SymbolicConstant specifying the rule for assigning point priority. Possible values are MAXIMUM, MINIMUM, and SPECIFY. The default value is MAXIMUM.

Changed in version 2022: The argument masterPointDetermination was renamed to mainPointDetermination.
presumeFeasibleRegionAtStart (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.
tolerance1 (float, default: 0) – A Float specifying the geometric tolerance in the 1-direction. The default value is 0.01.
tolerance2 (float, default: 0) – A Float specifying the geometric tolerance in the 2-direction. The default value is 0.01.
tolerance3 (float, default: 0) – A Float specifying the geometric tolerance in the 3-direction. The default value is 0.01.
undercutTolerance (float, default: 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=abaqusConstants.AXIS_1, csys=None, ignoreFrozenArea=OFF)[source]#

This method creates a TopologyCyclicSymmetry object.

Note

This function can be accessed by:

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

Note

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

Parameters:

name (str) – A String specifying the geometric restriction repository key.
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.
translation (float) – A Float specifying the translation distance.
axis (SymbolicConstant, default: 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 (Optional[int], default: 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 (Union[AbaqusBoolean, bool], default: OFF) – 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=abaqusConstants.DEMOLD_REGION, pointRegion=None, pullDirection=(), technique=abaqusConstants.AUTO)[source]#

This method creates a TopologyDemoldControl object.

Note

This function can be accessed by:

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

Note

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

Parameters:

name (str) – A String specifying the geometric restriction repository key.
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.
csys (Optional[int], default: 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 (float, default: 0) – A Float specifying the draft angle. The default value is 0.0.
collisionCheckRegion (SymbolicConstant, default: 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 (Optional[Region], default: 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 (tuple, default: ()) – 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 (SymbolicConstant, default: 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=abaqusConstants.MINIMUM)[source]#

This method creates a TopologyMemberSize object.

Note

This function can be accessed by:

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

Note

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

Parameters:

name (str) – A String specifying the geometric restriction repository key.
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.
maxThickness (float, default: 0) – A Float specifying the maximum thickness. The default value is 0.0.
minThickness (float, default: 0) – A Float specifying the minimum thickness. The default value is 0.0.
separation (float, default: 0) – A Float specifying the minimum gap. The default value is 0.0.
sizeRestriction (SymbolicConstant, default: 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

TopologyMillingControl(name, millingDirections, region, csys=None, millingCheckRegion=abaqusConstants.MILLING_REGION, radius=None)[source]#

This method creates a TopologyMillingControl object.

Note

This function can be accessed by:

mdb.models[name].optimizationTasks[name].TopologyMillingControl

New in version 2022: The TopologyMillingControl method was added.

Note

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

Parameters:

name (str) – A String specifying the geometric restriction repository key.
millingDirections (tuple) – A tuple of VertexArray objects of length 2 specifying the milling directions. Each point can be specified through a tuple of coordinates instead of through a ConstrainedSketchVertex.
region (Region) – A Region object specifying the region to which the geometric restriction is applied.
csys (Optional[int], default: None) – None or a DatumCsys object specifying the local coordinate system of the millingDirections. 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.
millingCheckRegion (SymbolicConstant, default: MILLING_REGION) – The SymbolicConstant MILLING_REGION or a Region object specifying the milling check region. If the value is MILLING_REGION, the value of region is used as both the milling control region and the milling check region. The default value is MILLING_REGION.
radius (Optional[float], default: None) – A Float specifying the radius for the collision check during the removal of the elements for the milling criteria.

Returns:

A TopologyMillingControl object.

Return type:

TopologyMillingControl

TopologyOverhangControl(name, pullDirection, region, csys=None, draftAngle=45, overhangCheckRegion=abaqusConstants.OVERHANG_REGION, pointRegion=<abaqus.Region.Region.Region object>, radius=None, technique=abaqusConstants.AUTO)[source]#

This method creates a TopologyOverhangControl object.

Note

This function can be accessed by:

mdb.models[name].optimizationTasks[name].TopologyOverhangControl

New in version 2019: The TopologyOverhangControl method was added.

Note

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

Parameters:

name (str) – A String specifying the geometric restriction repository key.
pullDirection (tuple) – A VertexArray object of length 2 specifying the overhang control print direction. Instead of through a ConstrainedSketchVertex, each point can be specified through a tuple of coordinates.
region (Region) – A Region object specifying the region to which the geometric restriction is applied.
csys (Optional[int], default: 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 (float, default: 45) – A Float specifying the overhang angle. The default value is 45.0.
overhangCheckRegion (SymbolicConstant, default: OVERHANG_REGION) – The SymbolicConstant OVERHANG_REGION or a Region object specifying the overhang check region. If the value is OVERHANG_REGION, the value of region is used as both the overhang control region and the overhang check region. The default value is OVERHANG_REGION.
pointRegion (Region, default: <abaqus.Region.Region.Region object at 0x7f350e1c95d0>) – A Region object specifying the point on a plane perpendicular to the pullDirection that is used to specify the base plane when technique is POINT.
radius (Optional[float], default: None) – A Float specifying the radius to define the size of the cones that are used in the internal check for the overhang criteria.
technique (SymbolicConstant, default: AUTO) – A SymbolicConstant specifying the overhang control technique used to define the base plane. Possible values are AUTO, POINT, and NONE. The default value is AUTO.

Return type:

A TopologyOverhangControl object.

TopologyPlanarSymmetry(name, region, axis=abaqusConstants.AXIS_1, csys=None, ignoreFrozenArea=OFF)[source]#

This method creates a TopologyPlanarSymmetry object.

Note

This function can be accessed by:

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

Note

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

Parameters:

name (str) – A String specifying the geometric restriction repository key.
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.
axis (SymbolicConstant, default: 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 (Optional[int], default: 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 (Union[AbaqusBoolean, bool], default: OFF) – 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=OFF)[source]#

This method creates a TopologyPointSymmetry object.

Note

This function can be accessed by:

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

Note

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

Parameters:

name (str) – A String specifying the geometric restriction repository key.
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.
csys (Optional[int], default: 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 (Union[AbaqusBoolean, bool], default: OFF) – 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=abaqusConstants.AXIS_1, csys=None, ignoreFrozenArea=OFF)[source]#

This method creates a TopologyRotationalSymmetry object.

Note

This function can be accessed by:

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

Note

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

Parameters:

name (str) – A String specifying the geometric restriction repository key.
angle (float) – A Float specifying the repeating segment size, an angle in degrees.
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.
axis (SymbolicConstant, default: 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 (Optional[int], default: 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 (Union[AbaqusBoolean, bool], default: OFF) – 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, mainPoint=None, mainPointDetermination=abaqusConstants.MAXIMUM, presumeFeasibleRegionAtStart=ON, 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

Note

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

Parameters:

name (str) – A String specifying the geometric restriction repository key.
clientDirection (tuple) – 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 (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 (Optional[int], default: 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.
mainPoint (Optional[str], default: None) –
None or a Region object specifying the main point used when mainPointDetermination is SPECIFY. The default value is None.

Changed in version 2022: The argument masterPoint was renamed to mainPoint.
mainPointDetermination (SymbolicConstant, default: MAXIMUM) –
A SymbolicConstant specifying the rule for assigning point priority. Possible values are MAXIMUM, MINIMUM, and SPECIFY. The default value is MAXIMUM.

Changed in version 2022: The argument masterPointDetermination was renamed to mainPointDetermination.
presumeFeasibleRegionAtStart (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.
tolerance1 (float, default: 0) – A Float specifying the geometric tolerance in the 1-direction. The default value is 0.01.
tolerance2 (float, default: 0) – A Float specifying the geometric tolerance in the 2-direction. The default value is 0.01.
tolerance3 (float, default: 0) – A Float specifying the geometric tolerance in the 3-direction. The default value is 0.01.

Returns:

A TurnControl object.

Return type:

TurnControl

Object features#

BeadFixedRegion#

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

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]

Note

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

Public Data Attributes:

`csys`	None or a DatumCsys object specifying the local coordinate system.
`u1`	A Boolean specifying whether to fix the region in the 1-direction.
`u2`	A Boolean specifying whether to fix the region in the 2-direction.
`u3`	A Boolean specifying whether to fix the region in the 3-direction.

Inherited from GeometricRestriction

`name`	A String specifying the geometric restriction repository key.
`region`	A `Region` object specifying the region to which the geometric restriction is applied.

Public Methods:

`__init__`(name, region[, csys, u1, u2, u3])	This method creates a BeadFixedRegion object.
`setValues`([csys, u1, u2, u3])	This method modifies the BeadFixedRegion object.

csys: Optional[int] = 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=OFF, u2=OFF, u3=OFF)[source]#

This method modifies the BeadFixedRegion object.

Note

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

Parameters:

csys (Optional[int], default: 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 (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to fix the region in the 1-direction. The default value is OFF.
u2 (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to fix the region in the 2-direction. The default value is OFF.
u3 (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to fix the region in the 3-direction. The default value is OFF.

u1: Union[AbaqusBoolean, bool] = OFF[source]#: A Boolean specifying whether to fix the region in the 1-direction. The default value is OFF.

u2: Union[AbaqusBoolean, bool] = OFF[source]#: A Boolean specifying whether to fix the region in the 2-direction. The default value is OFF.

u3: Union[AbaqusBoolean, bool] = OFF[source]#: A Boolean specifying whether to fix the region in the 3-direction. The default value is OFF.

BeadGrowth#

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

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]

Note

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

Public Data Attributes:

`beadGrowth`	A Float specifying the maximum optimization displacement in the growth direction.
`shrink`	A Float specifying the maximum optimization displacement in the shrink direction.

Inherited from GeometricRestriction

`name`	A String specifying the geometric restriction repository key.
`region`	A `Region` object specifying the region to which the geometric restriction is applied.

Public Methods:

`__init__`(name, region[, beadGrowth, shrink])	This method creates a BeadGrowth object.
`setValues`([beadGrowth, shrink])	This method modifies the BeadGrowth object.

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

Note

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

Parameters:

beadGrowth (float, default: 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 (float, default: 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: 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.

BeadPenetrationCheck#

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

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]

Note

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

Public Data Attributes:

Inherited from GeometricRestriction

`name`	A String specifying the geometric restriction repository key.
`region`	A `Region` object specifying the region to which the geometric restriction is applied.

Public Methods:

`__init__`(name, beadPenetrationCheckRegion, ...)	This method creates a BeadPenetrationCheck object.
`setValues`(args, *kwargs)	This method modifies the BeadPenetrationCheck object.

beadPenetrationCheckRegion: Region[source]#: A Region object specifying the penetration check region.

setValues(*args, **kwargs)[source]#: This method modifies the BeadPenetrationCheck object.

BeadPlanarSymmetry#

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

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]

Note

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

Public Data Attributes:

`axis`	A SymbolicConstant specifying the axis of symmetry.
`csys`	None or a DatumCsys object specifying the local coordinate system.

Inherited from GeometricRestriction

`name`	A String specifying the geometric restriction repository key.
`region`	A `Region` object specifying the region to which the geometric restriction is applied.

Public Methods:

`__init__`(name, region[, axis, csys])	This method creates a BeadPlanarSymmetry object.
`setValues`([axis, csys])	This method modifies the BeadPlanarSymmetry object.

axis: 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: Optional[int] = 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=abaqusConstants.AXIS_1, csys=None)[source]#

This method modifies the BeadPlanarSymmetry object.

Note

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

Parameters:

axis (SymbolicConstant, default: 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 (Optional[int], default: 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.

BeadPointSymmetry#

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

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]

Note

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

Public Data Attributes:

csys

None or a DatumCsys object specifying the position of the symmetry point defined as the origin of a local coordinate system.

Inherited from GeometricRestriction

`name`	A String specifying the geometric restriction repository key.
`region`	A `Region` object specifying the region to which the geometric restriction is applied.

Public Methods:

`__init__`(name, region[, csys])	This method creates a BeadPointSymmetry object.
`setValues`([csys])	This method modifies the BeadPointSymmetry object.

csys: Optional[int] = 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.

Note

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

Parameters:: csys (Optional[int], default: 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.

BeadRotationalSymmetry#

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

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]

Note

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

Public Data Attributes:

`axis`	A SymbolicConstant specifying the axis of symmetry.
`csys`	None or a DatumCsys object specifying the local coordinate system.

Inherited from GeometricRestriction

`name`	A String specifying the geometric restriction repository key.
`region`	A `Region` object specifying the region to which the geometric restriction is applied.

Public Methods:

`__init__`(name, angle, region[, axis, csys])	This method creates a BeadRotationalSymmetry object.
`setValues`([axis, csys])	This method modifies the BeadRotationalSymmetry object.

angle: float[source]#: A Float specifying the repeating segment size, an angle in degrees.

axis: 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: Optional[int] = 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=abaqusConstants.AXIS_1, csys=None)[source]#

This method modifies the BeadRotationalSymmetry object.

Note

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

Parameters:

axis (SymbolicConstant, default: 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 (Optional[int], default: 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.

BeadTask#

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

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]

Note

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

Public Data Attributes:

`designResponses`	A repository of DesignResponse objects.
`objectiveFunctions`	A repository of ObjectiveFunction objects.
`optimizationConstraints`	A repository of OptimizationConstraint objects.
`geometricRestrictions`	A repository of GeometricRestriction objects.
`abaqusSensitivities`	A Boolean specifying whether to use Abaqus to compute the design responses and their sensitivities.
`algorithm`	A SymbolicConstant specifying the optimization task algorithm.
`areBCRegionsFrozen`	A Boolean specifying whether to exclude elements with boundary conditions from the optimization.
`beadIter`	An int specifying the step size of the optimization.
`beadMaxMembraneStress`	A float specifying maximum membrane/bending stress.
`beadMinStress`	A float specifying minimum stress.
`beadPerturbation`	A Sets perturbation size for finite differences.
`beadWidth`	A SymbolicConstant specifying the Optimization product default or a float specifying the bead width.
`curveSmooth`	A float specifying relative value to the middle element edge length such that normals in this area do not cross each other.
`filterRadius`	A float specifying the filter radius.
`filterRadiusBy`	A SymbolicConstant specifying the method used to define filter radius.
`flipNormalDir`	A Boolean specifying whether the growth direction is along the normal direction of elements or opposite to the normal direction.
`frozenBoundaryConditionRegion`	When nodes with boundary conditions are excluded from the optimization (frozenBoundaryConditionRegions = ON).
`isSensCalcOnlyOnDesignNodes`	A Boolean specifying whether to calculate the sensitivities only on design nodes or the whole model.
`modeTrackingRegion`	The SymbolicConstant MODEL or a Region object specifying the region to use for mode tracking.
`nodalMoveLimit`	A Float specifying the maximum change in nodal displacement per design cycle.
`nodeSmooth`	A SymbolicConstant specifying the Optimization product default or a float specifying the node smooth.
`nodeUpdateStrategy`	A SymbolicConstant specifying the strategy for how the nodal displacements are updated in the method of moving asymptotes.
`numTrackedModes`	An Int specifying the number of modes included in mode tracking.
`updateShapeBasisVectors`	A SymbolicConstant specifying whether to update shape basis vectors in the first design cycle or every design cycle.
`groupOperator`	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.

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:

`__init__`(name[, abaqusSensitivities, ...])	This method creates a BeadTask object.
`setValues`([abaqusSensitivities, algorithm, ...])	This method modifies the BeadTask object.

Inherited from OptimizationTask

`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, ...[, ...])	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.
`TopologyMillingControl`(name, ...[, csys, ...])	This method creates a TopologyMillingControl object.
`TopologyOverhangControl`(name, pullDirection, ...)	This method creates a TopologyOverhangControl 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.

abaqusSensitivities: Union[AbaqusBoolean, bool] = False[source]#: A Boolean specifying whether to use Abaqus to compute the design responses and their sensitivities. The default value is False.

New in version 2019: The abaqusSensitivities attribute was added.

algorithm: 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: Union[AbaqusBoolean, bool] = OFF[source]#: A Boolean specifying whether to exclude elements with boundary conditions from the optimization. The default value is OFF.

beadIter: str = 1[source]#: An int specifying the step size of the optimization. The default value is 1.

beadMaxMembraneStress: str = 0[source]#: A float specifying maximum membrane/bending stress. The default value is 0.1.

beadMinStress: str = 0[source]#: A float specifying minimum stress. The default value is 0.001.

beadPerturbation: str = 0[source]#: A Sets perturbation size for finite differences. The default value is 0.0001.

beadWidth: SymbolicConstant = DEFAULT[source]#: A SymbolicConstant specifying the Optimization product default or a float specifying the bead width. The default value is DEFAULT.

curveSmooth: str = 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: Dict[str, DesignResponse] = {}[source]#: A repository of DesignResponse objects.

filterRadius: str = 4[source]#: A float specifying the filter radius. The default value is 4.

filterRadiusBy: SymbolicConstant = VALUE[source]#: A SymbolicConstant specifying the method used to define filter radius. Possible values are VALUE and REFERENCE. The default is VALUE.

flipNormalDir: Union[AbaqusBoolean, bool] = OFF[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: 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: Dict[str, GeometricRestriction] = {}[source]#: A repository of GeometricRestriction objects.

groupOperator: Union[AbaqusBoolean, bool] = OFF[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.

New in version 2022: The groupSensitivities attribute was added.

isSensCalcOnlyOnDesignNodes: Union[AbaqusBoolean, bool] = OFF[source]#: A Boolean specifying whether to calculate the sensitivities only on design nodes or the whole model. The default value is ON

modeTrackingRegion: SymbolicConstant = MODEL[source]#: The SymbolicConstant MODEL or a Region object specifying the region to use for mode tracking. The default value is MODEL.

nodalMoveLimit: float = 0[source]#: A Float specifying the maximum change in nodal displacement per design cycle. The default value is 0.1.

nodeSmooth: SymbolicConstant = DEFAULT[source]#: A SymbolicConstant specifying the Optimization product default or a float specifying the node smooth. The default value is DEFAULT.

nodeUpdateStrategy: 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: int = 5[source]#: An Int specifying the number of modes included in mode tracking. The default value is 5.

objectiveFunctions: Dict[str, ObjectiveFunction] = {}[source]#: A repository of ObjectiveFunction objects.

optimizationConstraints: Dict[str, OptimizationConstraint] = {}[source]#: A repository of OptimizationConstraint objects.

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

This method modifies the BeadTask object.

Note

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

Parameters:

abaqusSensitivities (Union[AbaqusBoolean, bool], default: True) –
A Boolean specifying whether to use Abaqus to compute the design responses and their sensitivities. The default value is True.

New in version 2019: The abaqusSensitivities argument was added.
algorithm (SymbolicConstant, default: 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 (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to exclude elements with boundary conditions from the optimization. The default value is OFF.
beadIter (str, default: 1) – An int specifying the step size of the optimization. The default value is 1.
beadMaxMembraneStress (str, default: 0) – A float specifying maximum membrane/bending stress. The default value is 0.1.
beadMinStress (str, default: 0) – A float specifying minimum stress. The default value is 0.001.
beadPerturbation (str, default: 0) – A Sets perturbation size for finite differences. The default value is 0.0001.
beadWidth (SymbolicConstant, default: DEFAULT) – A SymbolicConstant specifying the Optimization product default or a float specifying the bead width. The default value is DEFAULT.
curveSmooth (str, default: 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 (str, default: 4) – A float specifying the filter radius. The default value is 4.
filterRadiusBy (SymbolicConstant, default: VALUE) – A SymbolicConstant specifying the method used to define filter radius. Possible values are VALUE and REFERENCE. The default is VALUE.
flipNormalDir (Union[AbaqusBoolean, bool], default: OFF) – 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 (SymbolicConstant, default: 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 (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to calculate the sensitivities only on design nodes or the whole model. The default value is ON
modeTrackingRegion (SymbolicConstant, default: MODEL) – The SymbolicConstant MODEL or a Region object specifying the region to use for mode tracking. The default value is MODEL.
nodalMoveLimit (float, default: 0) – A Float specifying the maximum change in nodal displacement per design cycle. The default value is 0.1.
nodeSmooth (SymbolicConstant, default: DEFAULT) – A SymbolicConstant specifying the Optimization product default or a float specifying the node smooth. The default value is DEFAULT.
nodeUpdateStrategy (SymbolicConstant, default: 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 (int, default: 5) – An Int specifying the number of modes included in mode tracking. The default value is 5.
updateShapeBasisVectors (SymbolicConstant, default: 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.
groupOperator (Union[AbaqusBoolean, bool], default: OFF) –
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.

New in version 2022: The groupOperator argument was added.

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

CombinedTermDesignResponse#

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

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]

Note

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

Public Data Attributes:

`filterMaxRadius`	None or a sequence of Floats specifying the maximum radius of influence used when method is FILTER.
`filterExponent`	A Float specifying the exponent used when method is FILTER.
`filterRadiusReduction`	A Float specifying the reduction of the radius depending on surface bending, used when method is FILTER.
`highCutOff`	None or a sequence of Floats specifying the upper bound of the vector value used when method is CUT_OFF.
`lowCutOff`	A Float specifying the lower bound of the vector value used when method is CUT_OFF.
`method`	ABSOLUTE_DIFFERENCE
`weights`	A sequence of Floats specifying the weights to apply to the list of design responses used when method is WEIGHTED_ADD.

Inherited from DesignResponse

name

A String specifying the design response repository key.

Public Methods:

`__init__`(name, terms[, filterMaxRadius, ...])	This method creates a CombinedTermDesignResponse object.
`setValues`([filterMaxRadius, filterExponent, ...])	This method modifies the CombinedTermDesignResponse object.

filterExponent: float = 1[source]#: A Float specifying the exponent used when method is FILTER. The default value is 1.0.

filterMaxRadius: Optional[str] = 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: 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: Optional[str] = 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: 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: 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=abaqusConstants.ADD, weights=())[source]#

This method modifies the CombinedTermDesignResponse object.

Note

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

Parameters:

filterMaxRadius (Optional[str], default: None) – None or a sequence of Floats specifying the maximum radius of influence used when method is FILTER. The default value is None.
filterExponent (float, default: 1) – A Float specifying the exponent used when method is FILTER. The default value is 1.0.
filterRadiusReduction (float, default: 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 (Optional[str], default: 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 (float, default: 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 (SymbolicConstant, default: 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 (tuple, default: ()) – 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: tuple[source]#: A sequence of Strings specifying the names of the design responses to combine.

weights: tuple = ()[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.

DesignDirection#

class DesignDirection(name, region, csys=None, mainPoint=None, mainPointDetermination=abaqusConstants.MAXIMUM, movementRestriction=abaqusConstants.VECTOR, presumeFeasibleRegionAtStart=ON, u1=ON, u2=ON, u3=ON)[source]#

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]

Note

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

Public Data Attributes:

`csys`	None or a DatumCsys object specifying the local coordinate system.
`mainPoint`	None or a Region object specifying the main point used when mainPointDetermination is SPECIFY.
`mainPointDetermination`	A SymbolicConstant specifying the rule for assigning point priority.
`movementRestriction`	A SymbolicConstant specifying whether movement in the region should follow only the direction of the mainPoint, only the magnitude, or both the magnitude of the mainPoint and the directions specified by u1, u2 and u3.
`presumeFeasibleRegionAtStart`	A Boolean specifying whether to ignore the geometric restriction in the first design cycle.
`u1`	A Boolean specifying whether movement in the region should follow the masterPoint in the 1-direction.
`u2`	A Boolean specifying whether movement in the region should follow the masterPoint in the 2-direction.
`u3`	A Boolean specifying whether movement in the region should follow the masterPoint in the 3-direction.

Inherited from GeometricRestriction

`name`	A String specifying the geometric restriction repository key.
`region`	A `Region` object specifying the region to which the geometric restriction is applied.

Public Methods:

`__init__`(name, region[, csys, mainPoint, ...])	This method creates a DesignDirection object.
`setValues`([csys, mainPoint, ...])	This method modifies the DesignDirection object.

csys: Optional[int] = 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.

mainPoint: Optional[str] = None[source]#: None or a Region object specifying the main point used when mainPointDetermination is SPECIFY. The default value is None.

Changed in version 2022: The attribute masterPoint was renamed to mainPoint.

mainPointDetermination: SymbolicConstant = MAXIMUM[source]#: A SymbolicConstant specifying the rule for assigning point priority. Possible values are MAXIMUM, MINIMUM, and SPECIFY. The default value is MAXIMUM.

Changed in version 2022: The attribute masterPointDetermination was renamed to mainPointDetermination.

movementRestriction: SymbolicConstant = VECTOR[source]#: A SymbolicConstant specifying whether movement in the region should follow only the direction of the mainPoint, only the magnitude, or both the magnitude of the mainPoint and the directions specified by u1, u2 and u3. Possible values are DIRECTION, MAGNITUDE, and VECTOR. The default value is VECTOR.

presumeFeasibleRegionAtStart: Union[AbaqusBoolean, bool] = ON[source]#: A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.

setValues(csys=None, mainPoint=None, mainPointDetermination=abaqusConstants.MAXIMUM, movementRestriction=abaqusConstants.VECTOR, presumeFeasibleRegionAtStart=ON, u1=ON, u2=ON, u3=ON)[source]#

This method modifies the DesignDirection object.

Note

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

Parameters:

csys (Optional[int], default: 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.
mainPoint (Optional[str], default: None) –
None or a Region object specifying the main point used when mainPointDetermination is SPECIFY. The default value is None.

Changed in version 2022: The argument masterPoint was renamed to mainPoint.
mainPointDetermination (SymbolicConstant, default: MAXIMUM) –
A SymbolicConstant specifying the rule for assigning point priority. Possible values are MAXIMUM, MINIMUM, and SPECIFY. The default value is MAXIMUM.

Changed in version 2022: The argument masterPointDetermination was renamed to mainPointDetermination.
movementRestriction (SymbolicConstant, default: VECTOR) – A SymbolicConstant specifying whether movement in the region should follow only the direction of the mainPoint, only the magnitude, or both the magnitude of the mainPoint and the directions specified by u1, u2 and u3. Possible values are DIRECTION, MAGNITUDE, and VECTOR. The default value is VECTOR.
presumeFeasibleRegionAtStart (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.
u1 (Union[AbaqusBoolean, bool], default: ON) – 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 (Union[AbaqusBoolean, bool], default: ON) – 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 (Union[AbaqusBoolean, bool], default: ON) – 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: Union[AbaqusBoolean, bool] = ON[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: Union[AbaqusBoolean, bool] = ON[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: Union[AbaqusBoolean, bool] = ON[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.

DesignResponse#

class DesignResponse[source]#

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]

Note

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

Public Data Attributes:

name

A String specifying the design response repository key.

name: str = ''[source]#: A String specifying the design response repository key.

DrillControl#

class DrillControl(name, clientDirection, region, csys=None, drawAngle=0, mainPoint=None, mainPointDetermination=abaqusConstants.MAXIMUM, presumeFeasibleRegionAtStart=ON, tolerance1=0, tolerance2=0, tolerance3=0, undercutTolerance=0)[source]#

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]

Note

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

Public Data Attributes:

`csys`	None or a DatumCsys object specifying the local coordinate system.
`drawAngle`	A Float specifying the draw angle.
`mainPoint`	None or a Region object specifying the main point used when mainPointDetermination is SPECIFY.
`mainPointDetermination`	A SymbolicConstant specifying the rule for assigning point priority.
`presumeFeasibleRegionAtStart`	A Boolean specifying whether to ignore the geometric restriction in the first design cycle.
`tolerance1`	A Float specifying the geometric tolerance in the 1-direction.
`tolerance2`	A Float specifying the geometric tolerance in the 2-direction.
`tolerance3`	A Float specifying the geometric tolerance in the 3-direction.
`undercutTolerance`	A Float specifying the undercut tolerance.

Inherited from GeometricRestriction

`name`	A String specifying the geometric restriction repository key.
`region`	A `Region` object specifying the region to which the geometric restriction is applied.

Public Methods:

`__init__`(name, clientDirection, region[, ...])	This method creates a DrillControl object.
`setValues`([csys, drawAngle, mainPoint, ...])	This method modifies the DrillControl object.

clientDirection: 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: Optional[int] = 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: float = 0[source]#: A Float specifying the draw angle. The default value is 0.0.

mainPoint: Optional[str] = None[source]#: None or a Region object specifying the main point used when mainPointDetermination is SPECIFY. The default value is None.

Changed in version 2022: The attribute masterPoint was renamed to mainPoint.

mainPointDetermination: SymbolicConstant = MAXIMUM[source]#: A SymbolicConstant specifying the rule for assigning point priority. Possible values are MAXIMUM, MINIMUM, and SPECIFY. The default value is MAXIMUM.

Changed in version 2022: The attribute masterPointDetermination was renamed to mainPointDetermination.

presumeFeasibleRegionAtStart: Union[AbaqusBoolean, bool] = ON[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, mainPoint=None, mainPointDetermination=abaqusConstants.MAXIMUM, presumeFeasibleRegionAtStart=ON, tolerance1=0, tolerance2=0, tolerance3=0, undercutTolerance=0)[source]#

This method modifies the DrillControl object.

Note

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

Parameters:

csys (Optional[int], default: 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 (float, default: 0) – A Float specifying the draw angle. The default value is 0.0.
mainPoint (Optional[str], default: None) –
None or a Region object specifying the main point used when mainPointDetermination is SPECIFY. The default value is None.

Changed in version 2022: The argument masterPoint was renamed to mainPoint.
mainPointDetermination (SymbolicConstant, default: MAXIMUM) –
A SymbolicConstant specifying the rule for assigning point priority. Possible values are MAXIMUM, MINIMUM, and SPECIFY. The default value is MAXIMUM.

Changed in version 2022: The argument masterPointDetermination was renamed to mainPointDetermination.
presumeFeasibleRegionAtStart (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.
tolerance1 (float, default: 0) – A Float specifying the geometric tolerance in the 1-direction. The default value is 0.01.
tolerance2 (float, default: 0) – A Float specifying the geometric tolerance in the 2-direction. The default value is 0.01.
tolerance3 (float, default: 0) – A Float specifying the geometric tolerance in the 3-direction. The default value is 0.01.
undercutTolerance (float, default: 0) – A Float specifying the undercut tolerance. The default value is 0.0.

tolerance1: float = 0[source]#: A Float specifying the geometric tolerance in the 1-direction. The default value is 0.01.

tolerance2: float = 0[source]#: A Float specifying the geometric tolerance in the 2-direction. The default value is 0.01.

tolerance3: float = 0[source]#: A Float specifying the geometric tolerance in the 3-direction. The default value is 0.01.

undercutTolerance: float = 0[source]#: A Float specifying the undercut tolerance. The default value is 0.0.

FixedRegion#

class FixedRegion(name, region, csys=None, presumeFeasibleRegionAtStart=ON, u1=OFF, u2=OFF, u3=OFF)[source]#

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]

Note

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

Public Data Attributes:

`csys`	None or a DatumCsys object specifying the local coordinate system.
`presumeFeasibleRegionAtStart`	A Boolean specifying whether to ignore the geometric restriction in the first design cycle.
`u1`	A Boolean specifying whether to fix the region in the 1-direction.
`u2`	A Boolean specifying whether to fix the region in the 2-direction.
`u3`	A Boolean specifying whether to fix the region in the 3-direction.

Inherited from GeometricRestriction

`name`	A String specifying the geometric restriction repository key.
`region`	A `Region` object specifying the region to which the geometric restriction is applied.

Public Methods:

`__init__`(name, region[, csys, ...])	This method creates a FixedRegion object.
`setValues`([csys, ...])	This method modifies the FixedRegion object.

csys: Optional[int] = 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: Union[AbaqusBoolean, bool] = ON[source]#: A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.

setValues(csys=None, presumeFeasibleRegionAtStart=ON, u1=OFF, u2=OFF, u3=OFF)[source]#

This method modifies the FixedRegion object.

Note

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

Parameters:

csys (Optional[int], default: 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 (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.
u1 (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to fix the region in the 1-direction. The default value is OFF.
u2 (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to fix the region in the 2-direction. The default value is OFF.
u3 (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to fix the region in the 3-direction. The default value is OFF.

u1: Union[AbaqusBoolean, bool] = OFF[source]#: A Boolean specifying whether to fix the region in the 1-direction. The default value is OFF.

u2: Union[AbaqusBoolean, bool] = OFF[source]#: A Boolean specifying whether to fix the region in the 2-direction. The default value is OFF.

u3: Union[AbaqusBoolean, bool] = OFF[source]#: A Boolean specifying whether to fix the region in the 3-direction. The default value is OFF.

FrozenArea#

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

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]

Note

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

Public Data Attributes:

region

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

Inherited from GeometricRestriction

`name`	A String specifying the geometric restriction repository key.
`region`	A `Region` object specifying the region to which the geometric restriction is applied.

Public Methods:

`__init__`(name[, region])	This method creates a FrozenArea object.
`setValues`([region])	This method modifies the FrozenArea object.

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.

Note

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

Parameters:: region (Region, default: <abaqus.Region.Region.Region object at 0x7f350e02d4e0>) – 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.

GeometricRestriction#

class GeometricRestriction[source]#

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]

Note

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

Public Data Attributes:

`name`	A String specifying the geometric restriction repository key.
`region`	A `Region` object specifying the region to which the geometric restriction is applied.

name: str = ''[source]#: A String specifying the geometric restriction repository key.

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.

Growth#

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

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]

Note

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

Public Data Attributes:

`growth`	A Float specifying the maximum optimization displacement in the growth direction.
`presumeFeasibleRegionAtStart`	A Boolean specifying whether to ignore the geometric restriction in the first design cycle.
`shrink`	A Float specifying the maximum optimization displacement in the shrink direction.

Inherited from GeometricRestriction

`name`	A String specifying the geometric restriction repository key.
`region`	A `Region` object specifying the region to which the geometric restriction is applied.

Public Methods:

`__init__`(name, region[, growth, ...])	This method creates a Growth object.
`setValues`([growth, ...])	This method modifies the Growth object.

growth: 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: Union[AbaqusBoolean, bool] = ON[source]#: A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.

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

This method modifies the Growth object.

Note

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

Parameters:

growth (float, default: 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 (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.
shrink (float, default: 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: 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.

LocalStopCondition#

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

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]

Note

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

Public Data Attributes:

`comparisonOperation`	A SymbolicConstant specifying the operation used to compare the selected value to the reference value.
`identifier`	A SymbolicConstant specifying the variable identifier of the compared value.
`identifierOperation`	A SymbolicConstant specifying the operation used to evaluate values in the region.
`referenceDesignCycle`	A SymbolicConstant specifying the iteration from which a value is compared to the reference value.
`referenceOperation`	A SymbolicConstant specifying the operation used to modify the reference value by the reference factor.
`region`	The SymbolicConstant MODEL or a Region object specifying the region to which the stop condition is applied.

Inherited from StopCondition

`name`	A String specifying the stop condition repository key.
`region`	The SymbolicConstant MODEL or a Region object specifying the region to which the stop condition is applied.

Public Methods:

`__init__`(name, referenceFactor[, ...])	This method creates a LocalStopCondition object.
`setValues`([comparisonOperation, identifier, ...])	This method modifies the LocalStopCondition object.

comparisonOperation: 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: 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: 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: 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: float[source]#: A Float specifying the factor used to modify the reference value.

referenceOperation: 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: 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=abaqusConstants.LESS_THAN, identifier=abaqusConstants.MOVEMENT, identifierOperation=abaqusConstants.MAXIMUM, referenceDesignCycle=abaqusConstants.PREVIOUS, referenceOperation=abaqusConstants.ADD, region=abaqusConstants.MODEL)[source]#

This method modifies the LocalStopCondition object.

Note

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

Parameters:

comparisonOperation (SymbolicConstant, default: 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 (SymbolicConstant, default: 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 (SymbolicConstant, default: 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 (SymbolicConstant, default: 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 (SymbolicConstant, default: 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 (SymbolicConstant, default: MODEL) – The SymbolicConstant MODEL or a Region object specifying the region to which the stop condition is applied. The default value is MODEL.

ObjectiveFunction#

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

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]

Note

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

Public Data Attributes:

`objectives`	An `OptimizationObjectiveArray` object.
`target`	A SymbolicConstant specifying the target of the objective function.

Public Methods:

`__init__`(name, objectives[, target])	This method creates an ObjectiveFunction object.
`setValues`([target])	This method modifies the ObjectiveFunction object.

name: str[source]#: A String specifying the objective function repository key.

objectives: List[OptimizationObjective] = [][source]#: An OptimizationObjectiveArray object.

setValues(target=abaqusConstants.MINIMIZE)[source]#

This method modifies the ObjectiveFunction object.

Note

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

Parameters:: target (SymbolicConstant, default: 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: 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.

OptimizationConstraint#

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

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]

Note

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

Public Data Attributes:

restrictionMethod

A SymbolicConstant specifying the method used to constrain the design response.

Public Methods:

`__init__`(name, designResponse, restrictionValue)	This method creates an OptimizationConstraint object.
`setValues`([restrictionMethod])	This method modifies the OptimizationConstraint object.

designResponse: str[source]#: A String specifying the name of the design response to constrain.

name: str[source]#: A String specifying the optimization constraint repository key.

restrictionMethod: 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: float[source]#: A Float specifying the value to which the design response should be constrained.

setValues(restrictionMethod=abaqusConstants.ABSOLUTE_EQUAL)[source]#

This method modifies the OptimizationConstraint object.

Note

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

Parameters:: restrictionMethod (SymbolicConstant, default: 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 –

OptimizationObjective#

class OptimizationObjective[source]#

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]

Note

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

Public Data Attributes:

`suppress`	A Boolean specifying whether the objective is suppressed or not.
`weight`	A Float specifying the weight applied to the design response value.
`referenceValue`	The SymbolicConstant DEFAULT or a Float specifying the reference value used in evaluating a design response.
`designResponse`	A String specifying the name of the design response.

designResponse: str = ''[source]#: A String specifying the name of the design response.

referenceValue: Union[SymbolicConstant, 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: Union[AbaqusBoolean, bool] = OFF[source]#: A Boolean specifying whether the objective is suppressed or not. The default value is OFF.

weight: float = 1[source]#: A Float specifying the weight applied to the design response value. The default value is 1.0.

OptimizationObjectiveArray#

OptimizationObjectiveArray[source]#: alias of List[OptimizationObjective]

PenetrationCheck#

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

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]

Note

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

Public Data Attributes:

presumeFeasibleRegionAtStart

A Boolean specifying whether to ignore the geometric restriction in the first design cycle.

Inherited from GeometricRestriction

`name`	A String specifying the geometric restriction repository key.
`region`	A `Region` object specifying the region to which the geometric restriction is applied.

Public Methods:

`__init__`(name, penetrationCheckRegion, region)	This method creates a PenetrationCheck object.
`setValues`([presumeFeasibleRegionAtStart])	This method modifies the PenetrationCheck object.

penetrationCheckRegion: Region[source]#: A Region object specifying the penetration check region.

presumeFeasibleRegionAtStart: Union[AbaqusBoolean, bool] = ON[source]#: A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.

setValues(presumeFeasibleRegionAtStart=ON)[source]#

This method modifies the PenetrationCheck object.

Note

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

Parameters:: presumeFeasibleRegionAtStart (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.

ShapeDemoldControl#

class ShapeDemoldControl(name, pullDirection, region, collisionCheckRegion=abaqusConstants.DEMOLD_REGION, csys=None, drawAngle=0, mainPointDetermination=abaqusConstants.MAXIMUM, presumeFeasibleRegionAtStart=ON, tolerance1=0, tolerance2=0, tolerance3=0, undercutTolerance=0)[source]#

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]

Note

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

Public Data Attributes:

`collisionCheckRegion`	The SymbolicConstant DEMOLD_REGION or a Region object specifying the collision check region.
`csys`	None or a DatumCsys object specifying the local coordinate system of the pullDirection.
`drawAngle`	A Float specifying the draw angle.
`mainPointDetermination`	A SymbolicConstant specifying the rule for assigning point priority.
`presumeFeasibleRegionAtStart`	A Boolean specifying whether to ignore the geometric restriction in the first design cycle.
`tolerance1`	A Float specifying the geometric tolerance in the 1-direction.
`tolerance2`	A Float specifying the geometric tolerance in the 2-direction.
`tolerance3`	A Float specifying the geometric tolerance in the 3-direction.
`undercutTolerance`	A Float specifying the undercut tolerance.

Inherited from GeometricRestriction

`name`	A String specifying the geometric restriction repository key.
`region`	A `Region` object specifying the region to which the geometric restriction is applied.

Public Methods:

`__init__`(name, pullDirection, region[, ...])	This method creates a ShapeDemoldControl object.
`setValues`([collisionCheckRegion, csys, ...])	This method modifies the ShapeDemoldControl object.

collisionCheckRegion: 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: Optional[int] = 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: float = 0[source]#: A Float specifying the draw angle. The default value is 0.0.

mainPointDetermination: SymbolicConstant = MAXIMUM[source]#: A SymbolicConstant specifying the rule for assigning point priority. Possible values are MAXIMUM and MINIMUM. The default value is MAXIMUM.

Changed in version 2022: The attribute masterPointDetermination was renamed to mainPointDetermination.

presumeFeasibleRegionAtStart: Union[AbaqusBoolean, bool] = ON[source]#: A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.

pullDirection: 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=abaqusConstants.DEMOLD_REGION, csys=None, drawAngle=0, mainPointDetermination=abaqusConstants.MAXIMUM, presumeFeasibleRegionAtStart=ON, tolerance1=0, tolerance2=0, tolerance3=0, undercutTolerance=0)[source]#

This method modifies the ShapeDemoldControl object.

Note

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

Parameters:

collisionCheckRegion (SymbolicConstant, default: 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 (Optional[int], default: 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 (float, default: 0) – A Float specifying the draw angle. The default value is 0.0.
mainPointDetermination (SymbolicConstant, default: MAXIMUM) –
A SymbolicConstant specifying the rule for assigning point priority. Possible values are MAXIMUM and MINIMUM. The default value is MAXIMUM.

Changed in version 2022: The argument masterPointDetermination was renamed to mainPointDetermination.
presumeFeasibleRegionAtStart (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.
tolerance1 (float, default: 0) – A Float specifying the geometric tolerance in the 1-direction. The default value is 0.01.
tolerance2 (float, default: 0) – A Float specifying the geometric tolerance in the 2-direction. The default value is 0.01.
tolerance3 (float, default: 0) – A Float specifying the geometric tolerance in the 3-direction. The default value is 0.01.
undercutTolerance (float, default: 0) – A Float specifying the undercut tolerance. The default value is 0.0.

tolerance1: float = 0[source]#: A Float specifying the geometric tolerance in the 1-direction. The default value is 0.01.

tolerance2: float = 0[source]#: A Float specifying the geometric tolerance in the 2-direction. The default value is 0.01.

tolerance3: float = 0[source]#: A Float specifying the geometric tolerance in the 3-direction. The default value is 0.01.

undercutTolerance: float = 0[source]#: A Float specifying the undercut tolerance. The default value is 0.0.

ShapeMemberSize#

class ShapeMemberSize(name, region, maxThickness=0, minThickness=0, sizeRestriction=abaqusConstants.MINIMUM, assignNodeGroupRegion=OFF, nodeGroupRegion='')[source]#

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]

Note

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

Public Data Attributes:

`maxThickness`	A Float specifying the maximum thickness.
`minThickness`	A Float specifying the minimum thickness.
`sizeRestriction`	A SymbolicConstant specifying whether to restrict the minimum or maximum thickness.
`assignNodeGroupRegion`	A bool specifying whether to use the node group region.
`nodeGroupRegion`	A Node Region object specifying the check node group.

Inherited from GeometricRestriction

`name`	A String specifying the geometric restriction repository key.
`region`	A `Region` object specifying the region to which the geometric restriction is applied.

Public Methods:

`__init__`(name, region[, maxThickness, ...])	This method creates a ShapeMemberSize object.
`setValues`([maxThickness, minThickness, ...])	This method modifies the ShapeMemberSize object.

assignNodeGroupRegion: str = OFF[source]#: A bool specifying whether to use the node group region. The default value is OFF.

New in version 2022: The assignNodeGroupRegion attribute was added.

maxThickness: float = 0[source]#: A Float specifying the maximum thickness. The default value is 0.0.

minThickness: float = 0[source]#: A Float specifying the minimum thickness. The default value is 0.0.

nodeGroupRegion: str = ''[source]#: A Node Region object specifying the check node group.

New in version 2022: The nodeGroupRegion attribute was added.

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

This method modifies the ShapeMemberSize object.

Note

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

Parameters:

maxThickness (float, default: 0) – A Float specifying the maximum thickness. The default value is 0.0.
minThickness (float, default: 0) – A Float specifying the minimum thickness. The default value is 0.0.
sizeRestriction (SymbolicConstant, default: MINIMUM) – A SymbolicConstant specifying whether to restrict the minimum or maximum thickness. Possible values are MAXIMUM and MINIMUM. The default value is MINIMUM.
assignNodeGroupRegion (str, default: OFF) –
A bool specifying whether to use the node group region. The default value is OFF.

New in version 2022: The assignNodeGroupRegion argument was added.
nodeGroupRegion (str, default: '') –
A Node Region object specifying the check node group.

New in version 2022: The nodeGroupRegion argument was added.

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

ShapePlanarSymmetry#

class ShapePlanarSymmetry(name, clientDirection, region, allowNonSymmetricMesh=True, csys=None, mainPointDetermination=abaqusConstants.MAXIMUM, presumeFeasibleRegionAtStart=ON, tolerance1=0, tolerance2=0, tolerance3=0)[source]#

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]

Note

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

Public Data Attributes:

`csys`	None or a DatumCsys object specifying the local coordinate system.
`allowNonSymmetricMesh`	A Boolean specifying whether to allow a nonsymmetric mesh for this geometric restriction.
`mainPointDetermination`	A SymbolicConstant specifying the rule for determining the main node.
`presumeFeasibleRegionAtStart`	A Boolean specifying whether to ignore the geometric restriction in the first design cycle.
`tolerance1`	A Float specifying the geometric tolerance in the 1-direction.
`tolerance2`	A Float specifying the geometric tolerance in the 2-direction.
`tolerance3`	A Float specifying the geometric tolerance in the 3-direction.

Inherited from GeometricRestriction

`name`	A String specifying the geometric restriction repository key.
`region`	A `Region` object specifying the region to which the geometric restriction is applied.

Public Methods:

`__init__`(name, clientDirection, region[, ...])	This method creates a ShapePlanarSymmetry object.
`setValues`([allowNonSymmetricMesh, csys, ...])	This method modifies the ShapePlanarSymmetry object.

allowNonSymmetricMesh: Union[AbaqusBoolean, bool] = True[source]#: A Boolean specifying whether to allow a nonsymmetric mesh for this geometric restriction. The default value is TRUE.

New in version 2021: The allowNonSymmetricMesh attribute was added.

clientDirection: 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: Optional[int] = 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.

mainPointDetermination: 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: Union[AbaqusBoolean, bool] = ON[source]#: A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.

setValues(allowNonSymmetricMesh=True, csys=None, mainPointDetermination=abaqusConstants.MAXIMUM, presumeFeasibleRegionAtStart=ON, tolerance1=0, tolerance2=0, tolerance3=0)[source]#

This method modifies the ShapePlanarSymmetry object.

Note

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

Parameters:

allowNonSymmetricMesh (Union[AbaqusBoolean, bool], default: True) – A Boolean specifying whether to allow a nonsymmetric mesh for this geometric restriction. The default value is TRUE.
csys (Optional[int], default: 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.
mainPointDetermination (SymbolicConstant, default: MAXIMUM) – A SymbolicConstant specifying the rule for determining the main node. Possible values are MAXIMUM and MINIMUM. The default value is MAXIMUM.
presumeFeasibleRegionAtStart (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.
tolerance1 (float, default: 0) – A Float specifying the geometric tolerance in the 1-direction. The default value is 0.01.
tolerance2 (float, default: 0) – A Float specifying the geometric tolerance in the 2-direction. The default value is 0.01.
tolerance3 (float, default: 0) – A Float specifying the geometric tolerance in the 3-direction. The default value is 0.01.

tolerance1: float = 0[source]#: A Float specifying the geometric tolerance in the 1-direction. The default value is 0.01.

tolerance2: float = 0[source]#: A Float specifying the geometric tolerance in the 2-direction. The default value is 0.01.

tolerance3: float = 0[source]#: A Float specifying the geometric tolerance in the 3-direction. The default value is 0.01.

ShapePointSymmetry#

class ShapePointSymmetry(name, region, csys=None, mainPointDetermination=abaqusConstants.MAXIMUM, presumeFeasibleRegionAtStart=ON, tolerance1=0, tolerance2=0, tolerance3=0)[source]#

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]

Note

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

Public Data Attributes:

`csys`	None or a DatumCsys object specifying the symmetry point represented as the origin of a local coordinate system.
`mainPointDetermination`	A SymbolicConstant specifying the rule for determining the main node.
`presumeFeasibleRegionAtStart`	A Boolean specifying whether to ignore the geometric restriction in the first design cycle.
`tolerance1`	A Float specifying the geometric tolerance in the 1-direction.
`tolerance2`	A Float specifying the geometric tolerance in the 2-direction.
`tolerance3`	A Float specifying the geometric tolerance in the 3-direction.

Inherited from GeometricRestriction

`name`	A String specifying the geometric restriction repository key.
`region`	A `Region` object specifying the region to which the geometric restriction is applied.

Public Methods:

`__init__`(name, region[, csys, ...])	This method creates a ShapePointSymmetry object.
`setValues`([csys, mainPointDetermination, ...])	This method modifies the ShapePointSymmetry object.

csys: Optional[int] = 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.

mainPointDetermination: SymbolicConstant = MAXIMUM[source]#: A SymbolicConstant specifying the rule for determining the main node. Possible values are MAXIMUM and MINIMUM. The default value is MAXIMUM.

Changed in version 2022: The attribute masterPointDetermination was renamed to mainPointDetermination.

presumeFeasibleRegionAtStart: Union[AbaqusBoolean, bool] = ON[source]#: A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.

setValues(csys=None, mainPointDetermination=abaqusConstants.MAXIMUM, presumeFeasibleRegionAtStart=ON, tolerance1=0, tolerance2=0, tolerance3=0)[source]#

This method modifies the ShapePointSymmetry object.

Note

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

Parameters:

csys (Optional[int], default: 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.
mainPointDetermination (SymbolicConstant, default: MAXIMUM) –
A SymbolicConstant specifying the rule for determining the main node. Possible values are MAXIMUM and MINIMUM. The default value is MAXIMUM.

Changed in version 2022: The argument masterPointDetermination was renamed to mainPointDetermination.
presumeFeasibleRegionAtStart (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.
tolerance1 (float, default: 0) – A Float specifying the geometric tolerance in the 1-direction. The default value is 0.01.
tolerance2 (float, default: 0) – A Float specifying the geometric tolerance in the 2-direction. The default value is 0.01.
tolerance3 (float, default: 0) – A Float specifying the geometric tolerance in the 3-direction. The default value is 0.01.

tolerance1: float = 0[source]#: A Float specifying the geometric tolerance in the 1-direction. The default value is 0.01.

tolerance2: float = 0[source]#: A Float specifying the geometric tolerance in the 2-direction. The default value is 0.01.

tolerance3: float = 0[source]#: A Float specifying the geometric tolerance in the 3-direction. The default value is 0.01.

ShapeRotationalSymmetry#

class ShapeRotationalSymmetry(name, clientDirection, region, allowNonSymmetricMesh=True, angle=0, csys=None, mainPoint=None, mainPointDetermination=abaqusConstants.MAXIMUM, presumeFeasibleRegionAtStart=ON, startPoint=None, tolerance1=0, tolerance2=0, tolerance3=0)[source]#

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]

Note

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

Public Data Attributes:

`angle`	A Float specifying the segment size of the repeating pattern in degrees.
`csys`	None or a DatumCsys object specifying the local coordinate system.
`allowNonSymmetricMesh`	A Boolean specifying whether to allow a nonsymmetric mesh for this geometric restriction.
`mainPoint`	None or a Region object specifying the main point used when mainPointDetermination is SPECIFY.
`mainPointDetermination`	A SymbolicConstant specifying the rule for determining the main node.
`presumeFeasibleRegionAtStart`	A Boolean specifying whether to ignore the geometric restriction in the first design cycle.
`startPoint`	A tuple of Floats representing the coordinates of a start point of the rotational symmetry.
`tolerance1`	A Float specifying the geometric tolerance in the 1-direction.
`tolerance2`	A Float specifying the geometric tolerance in the 2-direction.
`tolerance3`	A Float specifying the geometric tolerance in the 3-direction.

Inherited from GeometricRestriction

`name`	A String specifying the geometric restriction repository key.
`region`	A `Region` object specifying the region to which the geometric restriction is applied.

Public Methods:

`__init__`(name, clientDirection, region[, ...])	This method creates a ShapeRotationalSymmetry object.
`setValues`([allowNonSymmetricMesh, angle, ...])	This method modifies the ShapeRotationalSymmetry object.

allowNonSymmetricMesh: Union[AbaqusBoolean, bool] = True[source]#: A Boolean specifying whether to allow a nonsymmetric mesh for this geometric restriction. The default value is TRUE.

New in version 2021: The allowNonSymmetricMesh attribute was added.

angle: 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: 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: Optional[int] = 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.

mainPoint: Optional[str] = None[source]#: None or a Region object specifying the main point used when mainPointDetermination is SPECIFY. The default value is None.

Changed in version 2022: The attribute masterPoint was renamed to mainPoint.

mainPointDetermination: SymbolicConstant = MAXIMUM[source]#: A SymbolicConstant specifying the rule for determining the main node. Possible values are MAXIMUM, MINIMUM, and SPECIFY. The default value is MAXIMUM.

Changed in version 2022: The attribute masterPointDetermination was renamed to mainPointDetermination.

presumeFeasibleRegionAtStart: Union[AbaqusBoolean, bool] = ON[source]#: A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.

setValues(allowNonSymmetricMesh=True, angle=0, csys=None, mainPoint=None, mainPointDetermination=abaqusConstants.MAXIMUM, presumeFeasibleRegionAtStart=ON, startPoint=None, tolerance1=0, tolerance2=0, tolerance3=0)[source]#

This method modifies the ShapeRotationalSymmetry object.

Note

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

Parameters:

allowNonSymmetricMesh (Union[AbaqusBoolean, bool], default: True) – A Boolean specifying whether to allow a nonsymmetric mesh for this geometric restriction. The default value is TRUE.
angle (float, default: 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 (Optional[int], default: 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.
mainPoint (Optional[str], default: None) –
None or a Region object specifying the main point used when mainPointDetermination is SPECIFY. The default value is None.

Changed in version 2022: The argument masterPoint was renamed to mainPoint.
mainPointDetermination (SymbolicConstant, default: MAXIMUM) –
A SymbolicConstant specifying the rule for determining the main node. Possible values are MAXIMUM, MINIMUM, and SPECIFY. The default value is MAXIMUM.

Changed in version 2022: The argument masterPointDetermination was renamed to mainPointDetermination.
presumeFeasibleRegionAtStart (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.
startPoint (Optional[float], default: None) – A tuple of Floats representing the coordinates of a start point of the rotational symmetry.
tolerance1 (float, default: 0) – A Float specifying the geometric tolerance in the 1-direction. The default value is 0.01.
tolerance2 (float, default: 0) – A Float specifying the geometric tolerance in the 2-direction. The default value is 0.01.
tolerance3 (float, default: 0) – A Float specifying the geometric tolerance in the 3-direction. The default value is 0.01.

startPoint: Optional[float] = None[source]#: A tuple of Floats representing the coordinates of a start point of the rotational symmetry.

tolerance1: float = 0[source]#: A Float specifying the geometric tolerance in the 1-direction. The default value is 0.01.

tolerance2: float = 0[source]#: A Float specifying the geometric tolerance in the 2-direction. The default value is 0.01.

tolerance3: float = 0[source]#: A Float specifying the geometric tolerance in the 3-direction. The default value is 0.01.

ShapeTask#

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

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]

Note

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

Public Data Attributes:

`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.
`abaqusSensitivities`	A Boolean specifying whether to use Abaqus to compute the design responses and their sensitivities.
`absoluteStepSizeControl`	A SymbolicConstant specifying whether to control the permitted absolute step size by the average optimization displacement or minimum optimization displacement.
`activateDurability`	A boolean specifying whether or not the durability approach of optimization is turned on.
`additionalDurabilityFiles`	A String specifying the path of additional files pertaining to durability optimization.
`constrainedLaplacianConvergenceLevel`	A SymbolicConstant specifying the constrained Laplacian convergence level.
`curvatureSmoothingEdgeLength`	A Float specifying the edge length for the movement vector.
`durabilityInputfile`	A string specifying the path of the input file.
`durabilitySolver`	A String specifying the type of solver for durability optimization.
`equalityConstraintTolerance`	A Float specifying the equality constraint tolerance.
`featureRecognitionAngle`	A Float specifying the mesh smoothing feature recognition angle for edges and corners.
`filterExponent`	A Float specifying the weight depending on the radius, used when filterMaxRadius is specified.
`filterMaxRadius`	None or a Float specifying the maximum influence radius for equivalent stress.
`filterRadiusReduction`	None or a Float specifying the reduction of the radius depending on surface bending, used when filterMaxRadius is specified.
`firstCycleDeletedVolumeTechnique`	A SymbolicConstant specifying the method of specifying volume that can be removed immediately in the first design cycle.
`freezeBoundaryConditionRegions`	A Boolean specifying whether to exclude nodes with boundary conditions from the optimization.
`frozenBoundaryConditionRegion`	The SymbolicConstant MODEL or a Region object specifying the region in which to freeze boundary condition regions, or the SymbolicConstant MODEL, used with freezeBoundaryConditionRegions.
`geometricRestrictionEvaluationFrequency`	A SymbolicConstant specifying the frequency of evaluating geometric restrictions during mesh smoothing.
`growthScaleFactor`	A Float specifying the scale factor to apply to optimization displacements for nodes with growth.
`haltUponViolation`	A Boolean specifying whether to halt the optimization if quality criteria are not satisified.
`layerReferenceRegion`	None or a Region object specifying the region specifying the first node layer for mesh smoothing, used when meshSmoothingRegionMethod is TASK_REGION_LAYERS.
`meshSmoothingRegionMethod`	A SymbolicConstant specifying the method used to determine the mesh smoothing region.
`meshSmoothingStrategy`	A SymbolicConstant specifying the method smoothing strategy.
`midsideInterpolation`	A SymbolicConstant specifying the approach used when treating midside node positions during optimization.
`numFreeNodeLayers`	The SymbolicConstant FIX_NONE or an Int specifying the number of node layers adjoining the task region to remain free during mesh smoothing.
`numSmoothedElementLayers`	None or an Int specifying the number of layers for mesh smoothing when meshSmoothingRegionMethod is NUMBER_OF_LAYERS.
`presumeFeasibleBCRegionAtStart`	A Boolean specifying whether to ignore automatically frozen boundary condition regions in the first design cycle.
`quadMaxAngle`	A Float specifying the maximum angle for quad elements during mesh smoothing.
`quadMinAngle`	A Float specifying the minimum angle for quad elements during mesh smoothing.
`quadSkew`	A Float specifying the skew angle for quad elements during mesh smoothing, used with reportQualityViolation.
`quadTaper`	A Float specifying the taper for quad elements during mesh smoothing, used with reportQualityViolation.
`region`	The SymbolicConstant MODEL or a Region object specifying the region to which the optimization task is applied.
`reportPoorQualityElements`	A Boolean specifying whether to report poor quality elements during mesh smoothing.
`reportQualityViolation`	A Boolean specifying whether to report a quality criteria violation during mesh smoothing.
`shrinkScaleFactor`	A Float specifying the scale factor to apply to optimization displacements for nodes with shrinkage.
`smoothingRegion`	None or a Region object specifying the mesh smoothing region, used when meshSmoothingRegionMethod is REGION.
`targetMeshQuality`	A SymbolicConstant specifying the target mesh quality for mesh smoothing.
`tetAspectRatio`	A Float specifying the tet element aspect ratio during mesh smoothing.
`tetMaxAspect`	A Float specifying the maximum tet element aspect ratio during mesh smoothing.
`tetMinAspect`	A Float specifying the minimum tet element aspect ratio during mesh smoothing.
`tetSkew`	A Float specifying the tet element skew value during mesh smoothing.
`triMaxAngle`	A Float specifying the tri element maximum angle during mesh smoothing.
`triMinAngle`	A Float specifying the tri element maximum angle during mesh smoothing.
`updateShapeBasisVectors`	A SymbolicConstant specifying whether to update shape basis vectors in the first design cycle or every design cycle.
`groupOperator`	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.

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:

`__init__`(name[, abaqusSensitivities, ...])	This method creates a ShapeTask object.
`setValues`([abaqusSensitivities, ...])	This method modifies the ShapeTask object.

Inherited from OptimizationTask

`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, ...[, ...])	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.
`TopologyMillingControl`(name, ...[, csys, ...])	This method creates a TopologyMillingControl object.
`TopologyOverhangControl`(name, pullDirection, ...)	This method creates a TopologyOverhangControl 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.

abaqusSensitivities: Union[AbaqusBoolean, bool] = False[source]#: A Boolean specifying whether to use Abaqus to compute the design responses and their sensitivities. The default value is False.

New in version 2019: The abaqusSensitivities attribute was added.

absoluteStepSizeControl: 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: Union[AbaqusBoolean, bool] = ON[source]#: A boolean specifying whether or not the durability approach of optimization is turned on. The default value is ON.

additionalDurabilityFiles: str = ''[source]#: A String specifying the path of additional files pertaining to durability optimization. Only valid if the activateDurability argument is ON.

constrainedLaplacianConvergenceLevel: SymbolicConstant = NORMAL[source]#: A SymbolicConstant specifying the constrained Laplacian convergence level. Possible values are NORMAL, CONSERVATIVE, and AGGRESSIVE. The default value is NORMAL.

curvatureSmoothingEdgeLength: float = 5[source]#: A Float specifying the edge length for the movement vector. The default value is 5.0.

designResponses: Dict[str, DesignResponse] = {}[source]#: A repository of DesignResponse objects.

durabilityInputfile: 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: 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: Optional[float] = None[source]#: A Float specifying the equality constraint tolerance. The default value is 10-3.

featureRecognitionAngle: float = 30[source]#: A Float specifying the mesh smoothing feature recognition angle for edges and corners. The default value is 30.0.

filterExponent: float = 1[source]#: A Float specifying the weight depending on the radius, used when filterMaxRadius is specified. The default value is 1.0.

filterMaxRadius: Optional[float] = None[source]#: None or a Float specifying the maximum influence radius for equivalent stress. The default value is None.

filterRadiusReduction: Optional[float] = 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: SymbolicConstant = OFF[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: Union[AbaqusBoolean, bool] = OFF[source]#: A Boolean specifying whether to exclude nodes with boundary conditions from the optimization. The default value is OFF.

frozenBoundaryConditionRegion: 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: 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: Dict[str, GeometricRestriction] = {}[source]#: A repository of GeometricRestriction objects.

groupOperator: Union[AbaqusBoolean, bool] = OFF[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.

New in version 2022: The groupSensitivities attribute was added.

growthScaleFactor: 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: Union[AbaqusBoolean, bool] = OFF[source]#: A Boolean specifying whether to halt the optimization if quality criteria are not satisified. The default value is OFF.

layerReferenceRegion: Optional[str] = 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: 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: 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: 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: SymbolicConstant = 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: Optional[int] = 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: Dict[str, ObjectiveFunction] = {}[source]#: A repository of ObjectiveFunction objects.

optimizationConstraints: Dict[str, OptimizationConstraint] = {}[source]#: A repository of OptimizationConstraint objects.

presumeFeasibleBCRegionAtStart: Union[AbaqusBoolean, bool] = ON[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: float = 160[source]#: A Float specifying the maximum angle for quad elements during mesh smoothing. The default value is 160.0.

quadMinAngle: float = 20[source]#: A Float specifying the minimum angle for quad elements during mesh smoothing. The default value is 20.0.

quadSkew: 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: float = 0[source]#: A Float specifying the taper for quad elements during mesh smoothing, used with reportQualityViolation. The default value is 0.5.

region: 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: Union[AbaqusBoolean, bool] = OFF[source]#: A Boolean specifying whether to report poor quality elements during mesh smoothing. The default value is OFF.

reportQualityViolation: Union[AbaqusBoolean, bool] = OFF[source]#: A Boolean specifying whether to report a quality criteria violation during mesh smoothing. The default value is OFF.

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

This method modifies the ShapeTask object.

Note

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

Parameters:

abaqusSensitivities (Union[AbaqusBoolean, bool], default: True) –
A Boolean specifying whether to use Abaqus to compute the design responses and their sensitivities. The default value is True.

New in version 2019: The abaqusSensitivities argument was added.
absoluteStepSizeControl (SymbolicConstant, default: 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 (Union[AbaqusBoolean, bool], default: ON) – A boolean specifying whether or not the durability approach of optimization is turned on. The default value is ON.
additionalDurabilityFiles (str, default: '') – A String specifying the path of additional files pertaining to durability optimization. Only valid if the activateDurability argument is ON.
algorithm (SymbolicConstant, default: 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 (SymbolicConstant, default: NORMAL) – A SymbolicConstant specifying the constrained Laplacian convergence level. Possible values are NORMAL, CONSERVATIVE, and AGGRESSIVE. The default value is NORMAL.
curvatureSmoothingEdgeLength (float, default: 5) – A Float specifying the edge length for the movement vector. The default value is 5.0.
durabilityInputfile (str, default: '') – 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 (str, default: 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 (Optional[float], default: None) – A Float specifying the equality constraint tolerance. The default value is 10-3.
featureRecognitionAngle (float, default: 30) – A Float specifying the mesh smoothing feature recognition angle for edges and corners. The default value is 30.0.
filterExponent (float, default: 1) – A Float specifying the weight depending on the radius, used when filterMaxRadius is specified. The default value is 1.0.
filterMaxRadius (Optional[float], default: None) – None or a Float specifying the maximum influence radius for equivalent stress. The default value is None.
filterRadiusReduction (Optional[float], default: 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 (SymbolicConstant, default: OFF) – 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 (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to exclude nodes with boundary conditions from the optimization. The default value is OFF.
frozenBoundaryConditionRegion (SymbolicConstant, default: 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 (SymbolicConstant, default: 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 (float, default: 1) – A Float specifying the scale factor to apply to optimization displacements for nodes with growth. The default value is 1.0.
haltUponViolation (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to halt the optimization if quality criteria are not satisified. The default value is OFF.
layerReferenceRegion (Optional[str], default: 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 (SymbolicConstant, default: 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 (SymbolicConstant, default: CONSTRAINED_LAPLACIAN) – A SymbolicConstant specifying the method smoothing strategy. Possible values are CONSTRAINED_LAPLACIAN and LOCAL_GRADIENT. The default value is CONSTRAINED_LAPLACIAN.
midsideInterpolation (SymbolicConstant, default: 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 (SymbolicConstant, default: 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 (Optional[int], default: 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 (Union[AbaqusBoolean, bool], default: ON) – 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 (float, default: 160) – A Float specifying the maximum angle for quad elements during mesh smoothing. The default value is 160.0.
quadMinAngle (float, default: 20) – A Float specifying the minimum angle for quad elements during mesh smoothing. The default value is 20.0.
quadSkew (float, default: 30) – A Float specifying the skew angle for quad elements during mesh smoothing, used with reportQualityViolation. The default value is 30.0.
quadTaper (float, default: 0) – A Float specifying the taper for quad elements during mesh smoothing, used with reportQualityViolation. The default value is 0.5.
region (SymbolicConstant, default: MODEL) – The SymbolicConstant MODEL or a Region object specifying the region to which the optimization task is applied. The default value is MODEL.
reportPoorQualityElements (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to report poor quality elements during mesh smoothing. The default value is OFF.
reportQualityViolation (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to report a quality criteria violation during mesh smoothing. The default value is OFF.
shrinkScaleFactor (float, default: 1) – A Float specifying the scale factor to apply to optimization displacements for nodes with shrinkage. The default value is 1.0.
smoothingRegion (Optional[str], default: None) – None or a Region object specifying the mesh smoothing region, used when meshSmoothingRegionMethod is REGION. The default value is None.
targetMeshQuality (SymbolicConstant, default: 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 (float, default: 100) – A Float specifying the tet element aspect ratio during mesh smoothing. The default value is 100.0.
tetMaxAspect (float, default: 8) – A Float specifying the maximum tet element aspect ratio during mesh smoothing. The default value is 8.0.
tetMinAspect (float, default: 0) – A Float specifying the minimum tet element aspect ratio during mesh smoothing. The default value is 0.222.
tetSkew (float, default: 100) – A Float specifying the tet element skew value during mesh smoothing. The default value is 100.0.
triMaxAngle (float, default: 140) – A Float specifying the tri element maximum angle during mesh smoothing. The default value is 140.0.
triMinAngle (float, default: 20) – A Float specifying the tri element maximum angle during mesh smoothing. The default value is 20.0.
updateShapeBasisVectors (SymbolicConstant, default: 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.
groupOperator (Union[AbaqusBoolean, bool], default: OFF) –
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.

New in version 2022: The groupOperator argument was added.

shrinkScaleFactor: 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: Optional[str] = None[source]#: None or a Region object specifying the mesh smoothing region, used when meshSmoothingRegionMethod is REGION. The default value is None.

stopConditions: Dict[str, StopCondition] = {}[source]#: A repository of StopCondition objects.

targetMeshQuality: 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: float = 100[source]#: A Float specifying the tet element aspect ratio during mesh smoothing. The default value is 100.0.

tetMaxAspect: float = 8[source]#: A Float specifying the maximum tet element aspect ratio during mesh smoothing. The default value is 8.0.

tetMinAspect: float = 0[source]#: A Float specifying the minimum tet element aspect ratio during mesh smoothing. The default value is 0.222.

tetSkew: float = 100[source]#: A Float specifying the tet element skew value during mesh smoothing. The default value is 100.0.

triMaxAngle: float = 140[source]#: A Float specifying the tri element maximum angle during mesh smoothing. The default value is 140.0.

triMinAngle: float = 20[source]#: A Float specifying the tri element maximum angle during mesh smoothing. The default value is 20.0.

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

SingleTermDesignResponse#

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

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]

Note

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

Public Data Attributes:

`csys`	None or a DatumCsys object specifying the local coordinate system.
`drivingRegion`	None or a sequence of Floats specifying the driving region used when identifier is an internal nodal variable.
`operation`	A SymbolicConstant specifying the operation used on values in the region.
`region`	The SymbolicConstant MODEL or a Region object specifying the region of the design response variable.
`shellLayer`	A SymbolicConstant specifying the location used for shell layer values.
`stepOperation`	A SymbolicConstant specifying the operation used on values across steps and load cases.
`stepOptions`	A `StepOptionArray` object.

Inherited from DesignResponse

name

A String specifying the design response repository key.

Public Methods:

`__init__`(name, identifier[, csys, ...])	This method creates a SingleTermDesignResponse object.
`setValues`([csys, drivingRegion, operation, ...])	This method modifies the SingleTermDesignResponse object.

csys: Optional[int] = 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: Optional[str] = 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: str[source]#: A String specifying the name of the variable identifier.

operation: 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: 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=abaqusConstants.SUM, region=abaqusConstants.MODEL, shellLayer=abaqusConstants.MAXIMUM, stepOperation=abaqusConstants.SUM, stepOptions=None)[source]#

This method modifies the SingleTermDesignResponse object.

Note

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

Parameters:

csys (Optional[int], default: 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 (Optional[str], default: 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 (SymbolicConstant, default: 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 (SymbolicConstant, default: MODEL) – The SymbolicConstant MODEL or a Region object specifying the region of the design response variable. The default value is MODEL.
shellLayer (SymbolicConstant, default: 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 (SymbolicConstant, default: 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 (Optional[List[StepOption]], default: None) – A StepOptionArray object.

shellLayer: 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: 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: Optional[List[StepOption]] = None[source]#: A StepOptionArray object.

SizingClusterAreas#

class SizingClusterAreas(name, regions)[source]#

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]

Note

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

Public Data Attributes:

Inherited from GeometricRestriction

`name`	A String specifying the geometric restriction repository key.
`region`	A `Region` object specifying the region to which the geometric restriction is applied.

Public Methods:

`__init__`(name, regions)	This method creates a SizingClusterAreas object.
`setValues`(args, *kwargs)	This method modifies the SizingClusterAreas object.

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

SizingCyclicSymmetry#

class SizingCyclicSymmetry(name, region, translation, axis=abaqusConstants.AXIS_1, csys=None, ignoreFrozenArea=OFF)[source]#

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]

Note

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

Public Data Attributes:

`axis`	A SymbolicConstant specifying the translation direction defined along an axis positioned at the csys origin.
`csys`	None or a DatumCsys object specifying the local coordinate system.
`ignoreFrozenArea`	A Boolean specifying whether to ignore frozen areas.

Inherited from GeometricRestriction

`name`	A String specifying the geometric restriction repository key.
`region`	A `Region` object specifying the region to which the geometric restriction is applied.

Public Methods:

`__init__`(name, region, translation[, axis, ...])	This method creates a SizingCyclicSymmetry object.
`setValues`([axis, csys, ignoreFrozenArea])	This method modifies the SizingCyclicSymmetry object.

axis: 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: Optional[int] = 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: Union[AbaqusBoolean, bool] = OFF[source]#: A Boolean specifying whether to ignore frozen areas. The default value is OFF.

setValues(axis=abaqusConstants.AXIS_1, csys=None, ignoreFrozenArea=OFF)[source]#

This method modifies the SizingCyclicSymmetry object.

Note

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

Parameters:

axis (SymbolicConstant, default: 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 (Optional[int], default: 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 (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to ignore frozen areas. The default value is OFF.

translation: float[source]#: A Float specifying the translation distance.

SizingFrozenArea#

class SizingFrozenArea(name, region)[source]#

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]

Note

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

Public Data Attributes:

Inherited from GeometricRestriction

`name`	A String specifying the geometric restriction repository key.
`region`	A `Region` object specifying the region to which the geometric restriction is applied.

Public Methods:

`__init__`(name, region)	This method creates a SizingFrozenArea object.
`setValues`(args, *kwargs)	This method modifies the SizingFrozenArea object.

setValues(*args, **kwargs)[source]#: This method modifies the SizingFrozenArea object.

SizingMemberSize#

class SizingMemberSize(name, region, minWidth)[source]#

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]

Note

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

Public Data Attributes:

Inherited from GeometricRestriction

`name`	A String specifying the geometric restriction repository key.
`region`	A `Region` object specifying the region to which the geometric restriction is applied.

Public Methods:

`__init__`(name, region, minWidth)	This method creates a SizingMemberSize object.
`setValues`(args, *kwargs)	This method modifies the sizingMemberSize object.

minWidth: float[source]#: A Float specifying the min width.

setValues(*args, **kwargs)[source]#: This method modifies the sizingMemberSize object.

SizingPlanarSymmetry#

class SizingPlanarSymmetry(name, region, axis=abaqusConstants.AXIS_1, csys=None, ignoreFrozenArea=OFF)[source]#

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]

Note

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

Public Data Attributes:

`axis`	A SymbolicConstant specifying the axis of symmetry.
`csys`	None or a DatumCsys object specifying the local coordinate system.
`ignoreFrozenArea`	A Boolean specifying whether to ignore frozen areas.

Inherited from GeometricRestriction

`name`	A String specifying the geometric restriction repository key.
`region`	A `Region` object specifying the region to which the geometric restriction is applied.

Public Methods:

`__init__`(name, region[, axis, csys, ...])	This method creates a SizingPlanarSymmetry object.
`setValues`(args, *kwargs)	This method modifies the sizingPlanarSymmetry object.

axis: 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: Optional[int] = 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: Union[AbaqusBoolean, bool] = OFF[source]#: A Boolean specifying whether to ignore frozen areas. The default value is OFF.

setValues(*args, **kwargs)[source]#: This method modifies the sizingPlanarSymmetry object.

SizingPointSymmetry#

class SizingPointSymmetry(name, region, csys=None, ignoreFrozenArea=OFF)[source]#

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]

Note

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

Public Data Attributes:

`csys`	None or a DatumCsys object specifying the position of the symmetry point defined as the origin of a local coordinate system.
`ignoreFrozenArea`	A Boolean specifying whether to ignore frozen areas.

Inherited from GeometricRestriction

`name`	A String specifying the geometric restriction repository key.
`region`	A `Region` object specifying the region to which the geometric restriction is applied.

Public Methods:

`__init__`(name, region[, csys, ignoreFrozenArea])	This method creates a SizingPointSymmetry object.
`setValues`([csys, ignoreFrozenArea])	This method modifies the SizingPointSymmetry object.

csys: Optional[int] = 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: Union[AbaqusBoolean, bool] = OFF[source]#: A Boolean specifying whether to ignore frozen areas. The default value is OFF.

setValues(csys=None, ignoreFrozenArea=OFF)[source]#

This method modifies the SizingPointSymmetry object.

Note

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

Parameters:

csys (Optional[int], default: 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 (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to ignore frozen areas. The default value is OFF.

SizingRotationalSymmetry#

class SizingRotationalSymmetry(name, angle, region, axis=abaqusConstants.AXIS_1, csys=None, ignoreFrozenArea=OFF)[source]#

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]

Note

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

Public Data Attributes:

`axis`	A SymbolicConstant specifying the axis of symmetry.
`csys`	None or a DatumCsys object specifying the local coordinate system.
`ignoreFrozenArea`	A Boolean specifying whether to ignore frozen areas.

Inherited from GeometricRestriction

`name`	A String specifying the geometric restriction repository key.
`region`	A `Region` object specifying the region to which the geometric restriction is applied.

Public Methods:

`__init__`(name, angle, region[, axis, csys, ...])	This method creates a SizingRotationalSymmetry object.
`setValues`([axis, csys, ignoreFrozenArea])	This method modifies the SizingRotationalSymmetry object.

angle: float[source]#: A Float specifying the repeating segment size, an angle in degrees.

axis: 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: Optional[int] = 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: Union[AbaqusBoolean, bool] = OFF[source]#: A Boolean specifying whether to ignore frozen areas. The default value is OFF.

setValues(axis=abaqusConstants.AXIS_1, csys=None, ignoreFrozenArea=OFF)[source]#

This method modifies the SizingRotationalSymmetry object.

Note

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

Parameters:

axis (SymbolicConstant, default: 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 (Optional[int], default: 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 (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to ignore frozen areas. The default value is OFF.

SizingTask#

class SizingTask(name, abaqusSensitivities=True, elementThicknessDeltaStopCriteria=0, freezeBoundaryConditionRegions=OFF, freezeLoadRegions=ON, modeTrackingRegion=abaqusConstants.MODEL, numFulfilledStopCriteria=2, numTrackedModes=5, objectiveFunctionDeltaStopCriteria=0, stopCriteriaDesignCycle=4, thicknessMoveLimit=0, thicknessUpdateStrategy=abaqusConstants.NORMAL, groupOperator=OFF)[source]#

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]

Note

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

Public Data Attributes:

`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.
`abaqusSensitivities`	A Boolean specifying whether to use Abaqus to compute the design responses and their sensitivities.
`elementThicknessDeltaStopCriteria`	A Float specifying the stop criteria based on the change in element thickness.
`freezeBoundaryConditionRegions`	A Boolean specifying whether to exclude elements with boundary conditions from the optimization.
`freezeLoadRegions`	A Boolean specifying whether to exclude elements with loads and elements with loaded nodes from the optimization.
`modeTrackingRegion`	The SymbolicConstatnt MODEL or a Region object specifying the region to use for mode tracking.
`numFulfilledStopCriteria`	An Int specifying the number of stop criteria.
`numTrackedModes`	An Int specifying the number of modes included in mode tracking.
`objectiveFunctionDeltaStopCriteria`	A Float specifying the stop criteria based on the change in objective function.
`stopCriteriaDesignCycle`	An Int specifying the first design cycle used to evaluate convergence criteria.
`thicknessMoveLimit`	A Float specifying the maximum change in thickness per design cycle.
`thicknessUpdateStrategy`	A SymbolicConstant specifying the strategy for how the thickness is updated in the method of moving asymptotes.
`groupOperator`	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.

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:

`__init__`(name[, abaqusSensitivities, ...])	This method creates a SizingTask object.
`setValues`([abaqusSensitivities, ...])	This method modifies the SizingTask object.

Inherited from OptimizationTask

`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, ...[, ...])	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.
`TopologyMillingControl`(name, ...[, csys, ...])	This method creates a TopologyMillingControl object.
`TopologyOverhangControl`(name, pullDirection, ...)	This method creates a TopologyOverhangControl 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.

abaqusSensitivities: Union[AbaqusBoolean, bool] = False[source]#: A Boolean specifying whether to use Abaqus to compute the design responses and their sensitivities. The default value is False.

New in version 2019: The abaqusSensitivities attribute was added.

designResponses: Dict[str, DesignResponse] = {}[source]#: A repository of DesignResponse objects.

elementThicknessDeltaStopCriteria: float = 0[source]#: A Float specifying the stop criteria based on the change in element thickness. The default value is 0.5 × 10-2.

freezeBoundaryConditionRegions: Union[AbaqusBoolean, bool] = OFF[source]#: A Boolean specifying whether to exclude elements with boundary conditions from the optimization. The default value is OFF.

freezeLoadRegions: Union[AbaqusBoolean, bool] = ON[source]#: A Boolean specifying whether to exclude elements with loads and elements with loaded nodes from the optimization. The default value is ON.

geometricRestrictions: Dict[str, GeometricRestriction] = {}[source]#: A repository of GeometricRestriction objects.

groupOperator: Union[AbaqusBoolean, bool] = OFF[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.

New in version 2022: The groupSensitivities attribute was added.

modeTrackingRegion: str = MODEL[source]#: The SymbolicConstatnt MODEL or a Region object specifying the region to use for mode tracking. The default value is MODEL.

numFulfilledStopCriteria: int = 2[source]#: An Int specifying the number of stop criteria. The default value is 2.

numTrackedModes: int = 5[source]#: An Int specifying the number of modes included in mode tracking. The default value is 5.

objectiveFunctionDeltaStopCriteria: float = 0[source]#: A Float specifying the stop criteria based on the change in objective function. The default value is 0.001.

objectiveFunctions: Dict[str, ObjectiveFunction] = {}[source]#: A repository of ObjectiveFunction objects.

optimizationConstraints: Dict[str, OptimizationConstraint] = {}[source]#: A repository of OptimizationConstraint objects.

setValues(abaqusSensitivities=True, elementThicknessDeltaStopCriteria=0, freezeBoundaryConditionRegions=OFF, freezeLoadRegions=ON, modeTrackingRegion=abaqusConstants.MODEL, numFulfilledStopCriteria=2, numTrackedModes=5, objectiveFunctionDeltaStopCriteria=0, stopCriteriaDesignCycle=4, thicknessMoveLimit=0, thicknessUpdateStrategy=abaqusConstants.NORMAL, groupOperator=OFF)[source]#

This method modifies the SizingTask object.

Note

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

Parameters:

abaqusSensitivities (Union[AbaqusBoolean, bool], default: True) –
A Boolean specifying whether to use Abaqus to compute the design responses and their sensitivities. The default value is True.

New in version 2019: The abaqusSensitivities argument was added.
elementThicknessDeltaStopCriteria (float, default: 0) – A Float specifying the stop criteria based on the change in element thickness. The default value is 0.5 × 10-2.
freezeBoundaryConditionRegions (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to exclude elements with boundary conditions from the optimization. The default value is OFF.
freezeLoadRegions (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to exclude elements with loads and elements with loaded nodes from the optimization. The default value is ON.
modeTrackingRegion (str, default: MODEL) – The SymbolicConstatnt MODEL or a Region object specifying the region to use for mode tracking. The default value is MODEL.
numFulfilledStopCriteria (int, default: 2) – An Int specifying the number of stop criteria. The default value is 2.
numTrackedModes (int, default: 5) – An Int specifying the number of modes included in mode tracking. The default value is 5.
objectiveFunctionDeltaStopCriteria (float, default: 0) – A Float specifying the stop criteria based on the change in objective function. The default value is 0.001.
stopCriteriaDesignCycle (int, default: 4) – An Int specifying the first design cycle used to evaluate convergence criteria. The default value is 4.
thicknessMoveLimit (float, default: 0) – A Float specifying the maximum change in thickness per design cycle. The default value is 0.25.
thicknessUpdateStrategy (SymbolicConstant, default: 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.
groupOperator (Union[AbaqusBoolean, bool], default: OFF) –
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.

New in version 2022: The groupOperator argument was added.

stopConditions: Dict[str, StopCondition] = {}[source]#: A repository of StopCondition objects.

stopCriteriaDesignCycle: int = 4[source]#: An Int specifying the first design cycle used to evaluate convergence criteria. The default value is 4.

thicknessMoveLimit: float = 0[source]#: A Float specifying the maximum change in thickness per design cycle. The default value is 0.25.

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

SlideRegionControl#

class SlideRegionControl(name, clientDirection, region, approach=abaqusConstants.FREE_FORM, csys=None, freeFormRegion=None, presumeFeasibleRegionAtStart=ON, revolvedRegion=None, tolerance1=0, tolerance2=0, tolerance3=0)[source]#

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]

Note

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

Public Data Attributes:

`approach`	A SymbolicConstant specifying the restriction approach.
`csys`	None or a DatumCsys object specifying the local coordinate system.
`freeFormRegion`	None or a Region object specifying the free-form region.
`presumeFeasibleRegionAtStart`	A Boolean specifying whether to ignore the geometric restriction in the first design cycle.
`revolvedRegion`	None or a Region object specifying the region to revolve into a slide region.
`tolerance1`	A Float specifying the geometric tolerance in the 1-direction.
`tolerance2`	A Float specifying the geometric tolerance in the 2-direction.
`tolerance3`	A Float specifying the geometric tolerance in the 3-direction.

Inherited from GeometricRestriction

`name`	A String specifying the geometric restriction repository key.
`region`	A `Region` object specifying the region to which the geometric restriction is applied.

Public Methods:

`__init__`(name, clientDirection, region[, ...])	This method creates a SlideRegionControl object.
`setValues`([approach, csys, freeFormRegion, ...])	This method modifies the SlideRegionControl object.

approach: 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: 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: Optional[int] = 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: Optional[str] = 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: Union[AbaqusBoolean, bool] = ON[source]#: A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.

revolvedRegion: Optional[str] = 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=abaqusConstants.FREE_FORM, csys=None, freeFormRegion=None, presumeFeasibleRegionAtStart=ON, revolvedRegion=None, tolerance1=0, tolerance2=0, tolerance3=0)[source]#

This method modifies the SlideRegionControl object.

Note

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

Parameters:

approach (SymbolicConstant, default: 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 (Optional[int], default: 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 (Optional[str], default: 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 (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.
revolvedRegion (Optional[str], default: 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 (float, default: 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 (float, default: 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 (float, default: 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: 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: 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: 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.

StampControl#

class StampControl(name, clientDirection, region, csys=None, drawAngle=0, mainPoint=None, mainPointDetermination=abaqusConstants.MAXIMUM, presumeFeasibleRegionAtStart=ON, tolerance1=0, tolerance2=0, tolerance3=0, undercutTolerance=0)[source]#

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]

Note

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

Public Data Attributes:

`csys`	None or a DatumCsys object specifying the local coordinate system.
`drawAngle`	A Float specifying the draw angle.
`mainPoint`	None or a Region object specifying the main point used when mainPointDetermination is SPECIFY.
`mainPointDetermination`	A SymbolicConstant specifying the rule for assigning point priority.
`presumeFeasibleRegionAtStart`	A Boolean specifying whether to ignore the geometric restriction in the first design cycle.
`tolerance1`	A Float specifying the geometric tolerance in the 1-direction.
`tolerance2`	A Float specifying the geometric tolerance in the 2-direction.
`tolerance3`	A Float specifying the geometric tolerance in the 3-direction.
`undercutTolerance`	A Float specifying the undercut tolerance.

Inherited from GeometricRestriction

`name`	A String specifying the geometric restriction repository key.
`region`	A `Region` object specifying the region to which the geometric restriction is applied.

Public Methods:

`__init__`(name, clientDirection, region[, ...])	This method creates a StampControl object.
`setValues`([csys, drawAngle, mainPoint, ...])	This method modifies the StampControl object.

clientDirection: 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: Optional[int] = 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: float = 0[source]#: A Float specifying the draw angle. The default value is 0.0.

mainPoint: Optional[str] = None[source]#: None or a Region object specifying the main point used when mainPointDetermination is SPECIFY. The default value is None.

Changed in version 2022: The attribute masterPoint was renamed to mainPoint.

mainPointDetermination: SymbolicConstant = MAXIMUM[source]#: A SymbolicConstant specifying the rule for assigning point priority. Possible values are MAXIMUM, MINIMUM, and SPECIFY. The default value is MAXIMUM.

Changed in version 2022: The attribute masterPointDetermination was renamed to mainPointDetermination.

presumeFeasibleRegionAtStart: Union[AbaqusBoolean, bool] = ON[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, mainPoint=None, mainPointDetermination=abaqusConstants.MAXIMUM, presumeFeasibleRegionAtStart=ON, tolerance1=0, tolerance2=0, tolerance3=0, undercutTolerance=0)[source]#

This method modifies the StampControl object.

Note

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

Parameters:

csys (Optional[int], default: 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 (float, default: 0) – A Float specifying the draw angle. The default value is 0.0.
mainPoint (Optional[str], default: None) –
None or a Region object specifying the main point used when mainPointDetermination is SPECIFY. The default value is None.

Changed in version 2022: The argument masterPoint was renamed to mainPoint.
mainPointDetermination (SymbolicConstant, default: MAXIMUM) –
A SymbolicConstant specifying the rule for assigning point priority. Possible values are MAXIMUM, MINIMUM, and SPECIFY. The default value is MAXIMUM.

Changed in version 2022: The argument masterPointDetermination was renamed to mainPointDetermination.
presumeFeasibleRegionAtStart (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.
tolerance1 (float, default: 0) – A Float specifying the geometric tolerance in the 1-direction. The default value is 0.01.
tolerance2 (float, default: 0) – A Float specifying the geometric tolerance in the 2-direction. The default value is 0.01.
tolerance3 (float, default: 0) – A Float specifying the geometric tolerance in the 3-direction. The default value is 0.01.
undercutTolerance (float, default: 0) – A Float specifying the undercut tolerance. The default value is 0.0.

tolerance1: float = 0[source]#: A Float specifying the geometric tolerance in the 1-direction. The default value is 0.01.

tolerance2: float = 0[source]#: A Float specifying the geometric tolerance in the 2-direction. The default value is 0.01.

tolerance3: float = 0[source]#: A Float specifying the geometric tolerance in the 3-direction. The default value is 0.01.

undercutTolerance: float = 0[source]#: A Float specifying the undercut tolerance. The default value is 0.0.

StepOption#

class StepOption[source]#

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]

Note

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

Public Data Attributes:

`lowerMode`	The SymbolicConstant ALL or an Int specifying the lower mode in the range of modes to consider in the step.
`upperMode`	The SymbolicConstant ALL or an Int specifying the upper mode in the range of modes to consider in the step.
`loadCase`	The SymbolicConstant ALL or a String specifying the name of the load case.
`step`	The SymbolicConstant ALL or a String specifying the name of the step.
`model`	A string specifying the name of the model from which the steps are supposed to be used in the design response.

loadCase: 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: 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: 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: SymbolicConstant = ALL[source]#: The SymbolicConstant ALL or a String specifying the name of the step. The default value is ALL.

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

StepOptionArray#

StepOptionArray[source]#: alias of List[StepOption]

StopCondition#

class StopCondition[source]#

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]

Note

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

Public Data Attributes:

`name`	A String specifying the stop condition repository key.
`region`	The SymbolicConstant MODEL or a Region object specifying the region to which the stop condition is applied.

name: str = ''[source]#: A String specifying the stop condition repository key.

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

TopologyCyclicSymmetry#

class TopologyCyclicSymmetry(name, region, translation, axis=abaqusConstants.AXIS_1, csys=None, ignoreFrozenArea=OFF)[source]#

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]

Note

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

Public Data Attributes:

`axis`	A SymbolicConstant specifying the translation direction defined along an axis positioned at the csys origin.
`csys`	None or a DatumCsys object specifying the local coordinate system.
`ignoreFrozenArea`	A Boolean specifying whether to ignore frozen areas.

Inherited from GeometricRestriction

`name`	A String specifying the geometric restriction repository key.
`region`	A `Region` object specifying the region to which the geometric restriction is applied.

Public Methods:

`__init__`(name, region, translation[, axis, ...])	This method creates a TopologyCyclicSymmetry object.
`setValues`([axis, csys, ignoreFrozenArea])	This method modifies the TopologyCyclicSymmetry object.

axis: 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: Optional[int] = 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: Union[AbaqusBoolean, bool] = OFF[source]#: A Boolean specifying whether to ignore frozen areas. The default value is OFF.

setValues(axis=abaqusConstants.AXIS_1, csys=None, ignoreFrozenArea=OFF)[source]#

This method modifies the TopologyCyclicSymmetry object.

Note

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

Parameters:

axis (SymbolicConstant, default: 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 (Optional[int], default: 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 (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to ignore frozen areas. The default value is OFF.

translation: float[source]#: A Float specifying the translation distance.

TopologyDemoldControl#

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

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]

Note

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

Public Data Attributes:

`csys`	None or a DatumCsys object specifying the local coordinate system of the pullDirection.
`draftAngle`	A Float specifying the draft angle.
`collisionCheckRegion`	The SymbolicConstant DEMOLD_REGION or a Region object specifying the collision check region.
`pointRegion`	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.
`technique`	A SymbolicConstant specifying the demold technique.

Inherited from GeometricRestriction

`name`	A String specifying the geometric restriction repository key.
`region`	A `Region` object specifying the region to which the geometric restriction is applied.

Public Methods:

`__init__`(name, region[, csys, draftAngle, ...])	This method creates a TopologyDemoldControl object.
`setValues`([csys, draftAngle, ...])	This method modifies the TopologyDemoldControl object.

collisionCheckRegion: 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: Optional[int] = 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: float = 0[source]#: A Float specifying the draft angle. The default value is 0.0.

pointRegion: Optional[Region] = 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: 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=abaqusConstants.DEMOLD_REGION, pointRegion=None, pullDirection=(), technique=abaqusConstants.AUTO)[source]#

This method modifies the TopologyDemoldControl object.

Note

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

Parameters:

csys (Optional[int], default: 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 (float, default: 0) – A Float specifying the draft angle. The default value is 0.0.
collisionCheckRegion (SymbolicConstant, default: 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 (Optional[Region], default: 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 (tuple, default: ()) – 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 (SymbolicConstant, default: AUTO) – A SymbolicConstant specifying the demold technique. Possible values are AUTO, AUTO_TIGHT, POINT, SURFACE, and STAMP. The default value is AUTO.

technique: SymbolicConstant = AUTO[source]#: A SymbolicConstant specifying the demold technique. Possible values are AUTO, AUTO_TIGHT, POINT, SURFACE, and STAMP. The default value is AUTO.

TopologyMemberSize#

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

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]

Note

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

Public Data Attributes:

`maxThickness`	A Float specifying the maximum thickness.
`minThickness`	A Float specifying the minimum thickness.
`separation`	A Float specifying the minimum gap.
`sizeRestriction`	A SymbolicConstant specifying whether to restrict the minimum or maximum thickness or an envelope of both.

Inherited from GeometricRestriction

`name`	A String specifying the geometric restriction repository key.
`region`	A `Region` object specifying the region to which the geometric restriction is applied.

Public Methods:

`__init__`(name, region[, maxThickness, ...])	This method creates a TopologyMemberSize object.
`setValues`([maxThickness, minThickness, ...])	This method modifies the TopologyMemberSize object.

maxThickness: float = 0[source]#: A Float specifying the maximum thickness. The default value is 0.0.

minThickness: float = 0[source]#: A Float specifying the minimum thickness. The default value is 0.0.

separation: float = 0[source]#: A Float specifying the minimum gap. The default value is 0.0.

setValues(maxThickness=0, minThickness=0, separation=0, sizeRestriction=abaqusConstants.MINIMUM)[source]#

This method modifies the TopologyMemberSize object.

Note

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

Parameters:

maxThickness (float, default: 0) – A Float specifying the maximum thickness. The default value is 0.0.
minThickness (float, default: 0) – A Float specifying the minimum thickness. The default value is 0.0.
separation (float, default: 0) – A Float specifying the minimum gap. The default value is 0.0.
sizeRestriction (SymbolicConstant, default: 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: 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.

TopologyMillingControl#

class TopologyMillingControl(name, millingDirections, region, csys=None, millingCheckRegion=abaqusConstants.MILLING_REGION, radius=None)[source]#

The TopologyMillingControl object defines a topology milling control geometric restriction. The TopologyMillingControl object is derived from the GeometricRestriction object.

Note

This object can be accessed by:

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

New in version 2022: The TopologyMillingControl class was added.

Note

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

Public Data Attributes:

`csys`	None or a DatumCsys object specifying the local coordinate system of the millingDirections.
`millingCheckRegion`	The SymbolicConstant MILLING_REGION or a Region object specifying the milling check region.
`radius`	A Float specifying the radius for the collision check during the removal of the elements for the milling criteria.

Inherited from GeometricRestriction

`name`	A String specifying the geometric restriction repository key.
`region`	A `Region` object specifying the region to which the geometric restriction is applied.

Public Methods:

`__init__`(name, millingDirections, region[, ...])	This method creates a TopologyMillingControl object.
`setValues`([csys, millingCheckRegion, radius])	This method modifies the TopologyMillingControl object.

csys: Optional[int] = None[source]#: None or a DatumCsys object specifying the local coordinate system of the millingDirections. 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.

millingCheckRegion: SymbolicConstant = MILLING_REGION[source]#: The SymbolicConstant MILLING_REGION or a Region object specifying the milling check region. If the value is MILLING_REGION, the value of region is used as both the milling control region and the milling check region. The default value is MILLING_REGION.

millingDirections: tuple[source]#: A tuple of VertexArray objects of length 2 specifying the milling directions. Each point can be specified through a tuple of coordinates instead of through a ConstrainedSketchVertex.

radius: Optional[float] = None[source]#: A Float specifying the radius for the collision check during the removal of the elements for the milling criteria.

setValues(csys=None, millingCheckRegion=abaqusConstants.MILLING_REGION, radius=None)[source]#

This method modifies the TopologyMillingControl object.

Note

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

Parameters:

csys (Optional[int], default: None) – None or a DatumCsys object specifying the local coordinate system of the millingDirections. 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.
millingCheckRegion (SymbolicConstant, default: MILLING_REGION) – The SymbolicConstant MILLING_REGION or a Region object specifying the milling check region. If the value is MILLING_REGION, the value of region is used as both the milling control region and the milling check region. The default value is MILLING_REGION.
radius (Optional[float], default: None) – A Float specifying the radius for the collision check during the removal of the elements for the milling criteria.

TopologyPlanarSymmetry#

class TopologyPlanarSymmetry(name, region, axis=abaqusConstants.AXIS_1, csys=None, ignoreFrozenArea=OFF)[source]#

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]

Note

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

Public Data Attributes:

`axis`	A SymbolicConstant specifying the axis of symmetry.
`csys`	None or a DatumCsys object specifying the local coordinate system.
`ignoreFrozenArea`	A Boolean specifying whether to ignore frozen areas.

Inherited from GeometricRestriction

`name`	A String specifying the geometric restriction repository key.
`region`	A `Region` object specifying the region to which the geometric restriction is applied.

Public Methods:

`__init__`(name, region[, axis, csys, ...])	This method creates a TopologyPlanarSymmetry object.
`setValues`([axis, csys, ignoreFrozenArea])	This method modifies the TopologyPlanarSymmetry object.

axis: 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: Optional[int] = 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: Union[AbaqusBoolean, bool] = OFF[source]#: A Boolean specifying whether to ignore frozen areas. The default value is OFF.

setValues(axis=abaqusConstants.AXIS_1, csys=None, ignoreFrozenArea=OFF)[source]#

This method modifies the TopologyPlanarSymmetry object.

Note

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

Parameters:

axis (SymbolicConstant, default: 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 (Optional[int], default: 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 (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to ignore frozen areas. The default value is OFF.

TopologyPointSymmetry#

class TopologyPointSymmetry(name, region, csys=None, ignoreFrozenArea=OFF)[source]#

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]

Note

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

Public Data Attributes:

`csys`	None or a DatumCsys object specifying the position of the symmetry point defined as the origin of a local coordinate system.
`ignoreFrozenArea`	A Boolean specifying whether to ignore frozen areas.

Inherited from GeometricRestriction

`name`	A String specifying the geometric restriction repository key.
`region`	A `Region` object specifying the region to which the geometric restriction is applied.

Public Methods:

`__init__`(name, region[, csys, ignoreFrozenArea])	This method creates a TopologyPointSymmetry object.
`setValues`([csys, ignoreFrozenArea])	This method modifies the TopologyPointSymmetry object.

csys: Optional[int] = 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: Union[AbaqusBoolean, bool] = OFF[source]#: A Boolean specifying whether to ignore frozen areas. The default value is OFF.

setValues(csys=None, ignoreFrozenArea=OFF)[source]#

This method modifies the TopologyPointSymmetry object.

Note

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

Parameters:

csys (Optional[int], default: 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 (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to ignore frozen areas. The default value is OFF.

TopologyRotationalSymmetry#

class TopologyRotationalSymmetry(name, angle, region, axis=abaqusConstants.AXIS_1, csys=None, ignoreFrozenArea=OFF)[source]#

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]

Note

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

Public Data Attributes:

`axis`	A SymbolicConstant specifying the axis of symmetry.
`csys`	None or a DatumCsys object specifying the local coordinate system.
`ignoreFrozenArea`	A Boolean specifying whether to ignore frozen areas.

Inherited from GeometricRestriction

`name`	A String specifying the geometric restriction repository key.
`region`	A `Region` object specifying the region to which the geometric restriction is applied.

Public Methods:

`__init__`(name, angle, region[, axis, csys, ...])	This method creates a TopologyRotationalSymmetry object.
`setValues`([axis, csys, ignoreFrozenArea])	This method modifies the TopologyRotationalSymmetry object.

angle: float[source]#: A Float specifying the repeating segment size, an angle in degrees.

axis: 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: Optional[int] = 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: Union[AbaqusBoolean, bool] = OFF[source]#: A Boolean specifying whether to ignore frozen areas. The default value is OFF.

setValues(axis=abaqusConstants.AXIS_1, csys=None, ignoreFrozenArea=OFF)[source]#

This method modifies the TopologyRotationalSymmetry object.

Note

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

Parameters:

axis (SymbolicConstant, default: 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 (Optional[int], default: 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 (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to ignore frozen areas. The default value is OFF.

TopologyTask#

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

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]

Note

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

Public Data Attributes:

`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.
`abaqusSensitivities`	A Boolean specifying whether to use Abaqus to compute the design responses and their sensitivities.
`algorithm`	A SymbolicConstant specifying the optimization task algorithm.
`densityMoveLimit`	A Float specifying the maximum density change per design cycle.
`densityUpdateStrategy`	A SymbolicConstant specifying the strategy for how the densities are updated in the method of moving asymptotes.
`elementDensityDeltaStopCriteria`	A Float specifying the stop criteria based upon the change in element densities.
`filterRadius`	None or a Float specifying the mesh filter radius for mesh independence and minimum size.
`firstCycleDeletedVolume`	A Float specifying the volume that can be removed immediately in the first design cycle.
`firstCycleDeletedVolumeTechnique`	A SymbolicConstant specifying the method of quantifying volume that can be removed immediately in the first design cycle.
`freezeBoundaryConditionRegions`	A Boolean specifying whether to exclude elements with boundary conditions from the optimization.
`freezeLoadRegions`	A Boolean specifying whether to exclude elements with loads and elements with loaded nodes from the optimization.
`frequencySpectrumWeight`	A Float specifying the weighting factor for frequency spectrum peaks.
`initialDensity`	A SymbolicConstant specifying the Optimization product default or a float specifying the initial density.
`materialInterpolationPenalty`	A Float specifying the penalty factor for the material interpolation technique.
`materialInterpolationTechnique`	optimization product default, solid isotropic material with penalization, or rational approximation of material properties.
`maxDensity`	A Float specifying the maximum density in the density update.
`minDensity`	A Float specifying the minimum density in the density update.
`modeTrackingRegion`	The SymbolicConstant MODEL or a Region object specifying the region to use for mode tracking.
`numDesignCycles`	An Int specifying the number of design cycles permitted when stepSize is DYNAMIC.
`numFulfilledStopCriteria`	An Int specifying the number of stop criteria.
`numTrackedModes`	An Int specifying the number of modes included in mode tracking.
`objectiveFunctionDeltaStopCriteria`	A Float specifying the stop criteria based on the change in objective function.
`region`	The SymbolicConstant MODEL or a Region object specifying the region to which the optimization task is applied.
`softDeletionMethod`	A SymbolicConstant specifying the method used when softDeletionRegion is specified.
`softDeletionRadius`	A Float specifying the radius to use when considering neighboring soft elements to delete.
`softDeletionRegion`	None or a Region object specifying the region in which the soft elements should be deleted during optimization.
`softDeletionThreshold`	A Float specifying the relative material density value used to identify soft elements.
`stepSize`	A SymbolicConstant specifying the size of the increment for volume modification.
`stiffnessMassDamping`	The SymbolicConstant AVERAGE_EDGE_LENGTH or a Float specifying the stiffness mass damping for the task region.
`stopCriteriaDesignCycle`	An Int specifying the first design cycle used to evaluate convergence criteria.
`structuralMassDamping`	None or a Float specifying the structural mass damping for the task region.
`viscousMassDamping`	None or a Float specifying the viscous mass damping for the task region.
`viscousStiffnessDamping`	None or a Float specifying the viscous stiffness damping for the task region.
`groupOperator`	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.

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:

`__init__`(name[, abaqusSensitivities, ...])	This method creates a TopologyTask object.
`setValues`([abaqusSensitivities, algorithm, ...])	This method modifies the TopologyTask object.

Inherited from OptimizationTask

`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, ...[, ...])	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.
`TopologyMillingControl`(name, ...[, csys, ...])	This method creates a TopologyMillingControl object.
`TopologyOverhangControl`(name, pullDirection, ...)	This method creates a TopologyOverhangControl 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.

abaqusSensitivities: Union[AbaqusBoolean, bool] = False[source]#: A Boolean specifying whether to use Abaqus to compute the design responses and their sensitivities. The default value is False.

New in version 2019: The abaqusSensitivities attribute was added.

algorithm: 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: float = 0[source]#: A Float specifying the maximum density change per design cycle. The default value is 0.25.

densityUpdateStrategy: 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: Dict[str, DesignResponse] = {}[source]#: A repository of DesignResponse objects.

elementDensityDeltaStopCriteria: float = 0[source]#: A Float specifying the stop criteria based upon the change in element densities. The default value is 0.5×10-2.

filterRadius: Optional[float] = None[source]#: None or a Float specifying the mesh filter radius for mesh independence and minimum size. The default value is None.

firstCycleDeletedVolume: 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: SymbolicConstant = OFF[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: Union[AbaqusBoolean, bool] = OFF[source]#: A Boolean specifying whether to exclude elements with boundary conditions from the optimization. The default value is OFF.

freezeLoadRegions: Union[AbaqusBoolean, bool] = ON[source]#: A Boolean specifying whether to exclude elements with loads and elements with loaded nodes from the optimization. The default value is ON.

frequencySpectrumWeight: float = 6[source]#: A Float specifying the weighting factor for frequency spectrum peaks. The default value is 6.0.

geometricRestrictions: Dict[str, GeometricRestriction] = {}[source]#: A repository of GeometricRestriction objects.

groupOperator: Union[AbaqusBoolean, bool] = OFF[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.

New in version 2022: The groupSensitivities attribute was added.

initialDensity: SymbolicConstant = DEFAULT[source]#: A SymbolicConstant specifying the Optimization product default or a float specifying the initial density. The default value is DEFAULT.

materialInterpolationPenalty: float = 3[source]#: A Float specifying the penalty factor for the material interpolation technique. The default value is 3.0.

materialInterpolationTechnique: 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: float = 1[source]#: A Float specifying the maximum density in the density update. The default value is 1.0.

minDensity: Optional[float] = None[source]#: A Float specifying the minimum density in the density update. The default value is 10-3.

modeTrackingRegion: SymbolicConstant = MODEL[source]#: The SymbolicConstant MODEL or a Region object specifying the region to use for mode tracking. The default value is MODEL.

numDesignCycles: int = 15[source]#: An Int specifying the number of design cycles permitted when stepSize is DYNAMIC. The default value is 15.

numFulfilledStopCriteria: int = 2[source]#: An Int specifying the number of stop criteria. The default value is 2.

numTrackedModes: int = 5[source]#: An Int specifying the number of modes included in mode tracking. The default value is 5.

objectiveFunctionDeltaStopCriteria: Optional[float] = None[source]#: A Float specifying the stop criteria based on the change in objective function. The default value is 10-3.

objectiveFunctions: Dict[str, ObjectiveFunction] = {}[source]#: A repository of ObjectiveFunction objects.

optimizationConstraints: Dict[str, OptimizationConstraint] = {}[source]#: A repository of OptimizationConstraint objects.

region: 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=abaqusConstants.GENERAL_OPTIMIZATION, densityMoveLimit=0, densityUpdateStrategy=abaqusConstants.NORMAL, elementDensityDeltaStopCriteria=0, filterRadius=None, firstCycleDeletedVolume=5, firstCycleDeletedVolumeTechnique=OFF, freezeBoundaryConditionRegions=OFF, freezeLoadRegions=ON, frequencySpectrumWeight=6, initialDensity=abaqusConstants.DEFAULT, materialInterpolationPenalty=3, materialInterpolationTechnique=abaqusConstants.DEFAULT, maxDensity=1, minDensity=None, modeTrackingRegion=abaqusConstants.MODEL, numDesignCycles=15, numFulfilledStopCriteria=2, numTrackedModes=5, objectiveFunctionDeltaStopCriteria=None, region=abaqusConstants.MODEL, softDeletionMethod=abaqusConstants.STANDARD, softDeletionRadius=0, softDeletionRegion=None, softDeletionThreshold=None, stepSize=abaqusConstants.MEDIUM, stiffnessMassDamping=abaqusConstants.AVERAGE_EDGE_LENGTH, stopCriteriaDesignCycle=4, structuralMassDamping=None, viscousMassDamping=None, viscousStiffnessDamping=None, groupOperator=OFF)[source]#

This method modifies the TopologyTask object.

Note

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

Parameters:

abaqusSensitivities (Union[AbaqusBoolean, bool], default: True) –
A Boolean specifying whether to use Abaqus to compute the design responses and their sensitivities. The default value is True.

New in version 2019: The abaqusSensitivities argument was added.
algorithm (SymbolicConstant, default: 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 (float, default: 0) – A Float specifying the maximum density change per design cycle. The default value is 0.25.
densityUpdateStrategy (SymbolicConstant, default: 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 (float, default: 0) – A Float specifying the stop criteria based upon the change in element densities. The default value is 0.5×10-2.
filterRadius (Optional[float], default: None) – None or a Float specifying the mesh filter radius for mesh independence and minimum size. The default value is None.
firstCycleDeletedVolume (float, default: 5) – A Float specifying the volume that can be removed immediately in the first design cycle. The default value is 5.0.
firstCycleDeletedVolumeTechnique (SymbolicConstant, default: OFF) – 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 (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to exclude elements with boundary conditions from the optimization. The default value is OFF.
freezeLoadRegions (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to exclude elements with loads and elements with loaded nodes from the optimization. The default value is ON.
frequencySpectrumWeight (float, default: 6) – A Float specifying the weighting factor for frequency spectrum peaks. The default value is 6.0.
initialDensity (SymbolicConstant, default: DEFAULT) – A SymbolicConstant specifying the Optimization product default or a float specifying the initial density. The default value is DEFAULT.
materialInterpolationPenalty (float, default: 3) – A Float specifying the penalty factor for the material interpolation technique. The default value is 3.0.
materialInterpolationTechnique (SymbolicConstant, default: 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 (float, default: 1) – A Float specifying the maximum density in the density update. The default value is 1.0.
minDensity (Optional[float], default: None) – A Float specifying the minimum density in the density update. The default value is 10-3.
modeTrackingRegion (SymbolicConstant, default: MODEL) – The SymbolicConstant MODEL or a Region object specifying the region to use for mode tracking. The default value is MODEL.
numDesignCycles (int, default: 15) – An Int specifying the number of design cycles permitted when stepSize is DYNAMIC. The default value is 15.
numFulfilledStopCriteria (int, default: 2) – An Int specifying the number of stop criteria. The default value is 2.
numTrackedModes (int, default: 5) – An Int specifying the number of modes included in mode tracking. The default value is 5.
objectiveFunctionDeltaStopCriteria (Optional[float], default: None) – A Float specifying the stop criteria based on the change in objective function. The default value is 10-3.
region (SymbolicConstant, default: MODEL) – The SymbolicConstant MODEL or a Region object specifying the region to which the optimization task is applied. The default value is MODEL.
softDeletionMethod (SymbolicConstant, default: 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 (float, default: 0) – A Float specifying the radius to use when considering neighboring soft elements to delete. The default value is 0.0.
softDeletionRegion (Optional[str], default: 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 (Optional[float], default: 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 (SymbolicConstant, default: 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 (Union[SymbolicConstant, float], default: 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 (int, default: 4) – An Int specifying the first design cycle used to evaluate convergence criteria. The default value is 4.
structuralMassDamping (Optional[float], default: None) – None or a Float specifying the structural mass damping for the task region. The default value is None.
viscousMassDamping (Optional[float], default: None) – None or a Float specifying the viscous mass damping for the task region. The default value is None.
viscousStiffnessDamping (Optional[float], default: None) – None or a Float specifying the viscous stiffness damping for the task region. The default value is None.
groupOperator (Union[AbaqusBoolean, bool], default: OFF) –
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.

New in version 2022: The groupOperator argument was added.

softDeletionMethod: 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: float = 0[source]#: A Float specifying the radius to use when considering neighboring soft elements to delete. The default value is 0.0.

softDeletionRegion: Optional[str] = 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: Optional[float] = 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: 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: Union[SymbolicConstant, 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: Dict[str, StopCondition] = {}[source]#: A repository of StopCondition objects.

stopCriteriaDesignCycle: int = 4[source]#: An Int specifying the first design cycle used to evaluate convergence criteria. The default value is 4.

structuralMassDamping: Optional[float] = None[source]#: None or a Float specifying the structural mass damping for the task region. The default value is None.

viscousMassDamping: Optional[float] = None[source]#: None or a Float specifying the viscous mass damping for the task region. The default value is None.

viscousStiffnessDamping: Optional[float] = None[source]#: None or a Float specifying the viscous stiffness damping for the task region. The default value is None.

TurnControl#

class TurnControl(name, clientDirection, region, csys=None, mainPoint=None, mainPointDetermination=abaqusConstants.MAXIMUM, presumeFeasibleRegionAtStart=ON, tolerance1=0, tolerance2=0, tolerance3=0)[source]#

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]

Note

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

Public Data Attributes:

`csys`	None or a DatumCsys object specifying the local coordinate system.
`mainPoint`	None or a Region object specifying the main point used when mainPointDetermination is SPECIFY.
`mainPointDetermination`	A SymbolicConstant specifying the rule for assigning point priority.
`presumeFeasibleRegionAtStart`	A Boolean specifying whether to ignore the geometric restriction in the first design cycle.
`tolerance1`	A Float specifying the geometric tolerance in the 1-direction.
`tolerance2`	A Float specifying the geometric tolerance in the 2-direction.
`tolerance3`	A Float specifying the geometric tolerance in the 3-direction.

Inherited from GeometricRestriction

`name`	A String specifying the geometric restriction repository key.
`region`	A `Region` object specifying the region to which the geometric restriction is applied.

Public Methods:

`__init__`(name, clientDirection, region[, ...])	This method creates a TurnControl object.
`setValues`([csys, mainPoint, ...])	This method modifies the TurnControl object.

clientDirection: 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: Optional[int] = 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.

mainPoint: Optional[str] = None[source]#: None or a Region object specifying the main point used when mainPointDetermination is SPECIFY. The default value is None.

Changed in version 2022: The attribute masterPoint was renamed to mainPoint.

mainPointDetermination: SymbolicConstant = MAXIMUM[source]#: A SymbolicConstant specifying the rule for assigning point priority. Possible values are MAXIMUM, MINIMUM, and SPECIFY. The default value is MAXIMUM.

Changed in version 2022: The attribute masterPointDetermination was renamed to mainPointDetermination.

presumeFeasibleRegionAtStart: Union[AbaqusBoolean, bool] = ON[source]#: A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.

setValues(csys=None, mainPoint=None, mainPointDetermination=abaqusConstants.MAXIMUM, presumeFeasibleRegionAtStart=ON, tolerance1=0, tolerance2=0, tolerance3=0)[source]#

This method modifies the TurnControl object.

Note

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

Parameters:

csys (Optional[int], default: 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.
mainPoint (Optional[str], default: None) – None or a Region object specifying the main point used when mainPointDetermination is SPECIFY. The default value is None.
mainPointDetermination (SymbolicConstant, default: MAXIMUM) –
A SymbolicConstant specifying the rule for assigning point priority. Possible values are MAXIMUM, MINIMUM, and SPECIFY. The default value is MAXIMUM.

Changed in version 2022: The argument masterPointDetermination was renamed to mainPointDetermination.
presumeFeasibleRegionAtStart (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.
tolerance1 (float, default: 0) – A Float specifying the geometric tolerance in the 1-direction. The default value is 0.01.
tolerance2 (float, default: 0) – A Float specifying the geometric tolerance in the 2-direction. The default value is 0.01.
tolerance3 (float, default: 0) – A Float specifying the geometric tolerance in the 3-direction. The default value is 0.01.

tolerance1: float = 0[source]#: A Float specifying the geometric tolerance in the 1-direction. The default value is 0.01.

tolerance2: float = 0[source]#: A Float specifying the geometric tolerance in the 2-direction. The default value is 0.01.

tolerance3: float = 0[source]#: A Float specifying the geometric tolerance in the 3-direction. The default value is 0.01.