Optimization¶

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

Create optimization tasks¶

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

Bases: ModelBase

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

Note

This object can be accessed by:

mdb.models[name]

Note

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

Public Data Attributes:

Inherited from ModelBase

`name`	A String specifying the repository key.
`stefanBoltzmann`	None or a Float specifying the Stefan-Boltzmann constant.
`absoluteZero`	None or a Float specifying the absolute zero constant.
`waveFormulation`	A SymbolicConstant specifying the type of incident wave formulation to be used in acoustic problems.
`universalGas`	None or a Float specifying the universal gas constant.
`noPartsInputFile`	A Boolean specifying whether an input file should be written without parts and assemblies.
`endRestartStep`	A Boolean specifying that the step specified by restartStep should be terminated at the increment specified by restartIncrement.
`shellToSolid`	A Boolean specifying that a shell global model drives a solid submodel.
`lastChangedCount`	A Float specifying the time stamp that indicates when the model was last changed.
`description`	A String specifying the purpose and contents of the Model object.
`restartJob`	A String specifying the name of the job that generated the restart data.
`restartStep`	A String specifying the name of the step where the restart analysis will start.
`globalJob`	A String specifying the name of the job that generated the results for the global model.
`copyConstraints`	A boolean specifying the status of constraints created in a model, in the model which instances this model.
`copyConnectors`	A boolean specifying the status of connectors created in a model, in the model which instances this model.
`copyInteractions`	A boolean specifying the status of interactions created in a model, in the model which instances this model.
`keywordBlock`	A KeywordBlock object.
`amplitudes`	A repository of Amplitude objects.
`profiles`	A repository of Profile objects.
`boundaryConditions`	A repository of BoundaryCondition objects.
`constraints`	A repository of ConstrainedSketchConstraint objects.
`analyticalFields`	A repository of AnalyticalField objects.
`discreteFields`	A repository of DiscreteField objects.
`predefinedFields`	A repository of PredefinedField objects.
`interactions`	A repository of Interaction objects.
`interactionProperties`	A repository of InteractionProperty objects.
`contactControls`	A repository of ContactControl objects.
`contactInitializations`	A repository of ContactInitialization objects.
`contactStabilizations`	A repository of ContactStabilization objects.
`linkedInstances`	A tuple of tuples of Strings specifying the linked child PartInstance name in the current model to the corresponding parent PartInstance name in a different model.
`linkedParts`	A tuple of tuples of Strings specifying the linked child Part name in the current model to the corresponding parent Part name in a different model.
`loads`	A repository of Load objects.
`materials`	A repository of Material objects.
`calibrations`	A repository of Calibration objects.
`sections`	A repository of Section objects.
`remeshingRules`	A repository of RemeshingRule objects.
`sketches`	A repository of ConstrainedSketch objects.
`parts`	A repository of Part objects.
`steps`	A repository of Step objects.
`featureOptions`	A FeatureOptions object.
`adaptiveMeshConstraints`	A repository of AdaptiveMeshConstraint objects.
`adaptiveMeshControls`	A repository of AdaptiveMeshControl objects.
`timePoints`	A repository of TimePoint objects.
`filters`	A repository of Filter objects.
`integratedOutputSections`	A repository of IntegratedOutputSection objects.
`fieldOutputRequests`	A repository of FieldOutputRequest objects.
`historyOutputRequests`	A repository of HistoryOutputRequest objects.
`optimizationTasks`	A repository of OptimizationTask objects.
`tableCollections`	A repository of TableCollection objects.
`eventSeriesTypes`	A repository of EventSeriesType objects.
`eventSeriesDatas`	A repository of EventSeriesData objects.
`restartIncrement`	An Int specifying the increment, interval, iteration or cycle where the restart analysis will start.
`rootAssembly`	An Assembly object.

Public Methods:

`BeadTask`(name[, abaqusSensitivities, ...])	This method creates a BeadTask object.
`ShapeTask`(name[, abaqusSensitivities, ...])	This method creates a ShapeTask object.
`SizingTask`(name[, abaqusSensitivities, ...])	This method creates a SizingTask object.
`TopologyTask`(name[, abaqusSensitivities, ...])	This method creates a TopologyTask object.

Inherited from ModelBase

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

Member Details:

BeadTask( name, abaqusSensitivities=True, algorithm=GENERAL_OPTIMIZATION, areBCRegionsFrozen=0, beadIter=1, beadMaxMembraneStress=0, beadMinStress=0, beadPerturbation=0, beadWidth=DEFAULT, curveSmooth=5, filterRadius=4, filterRadiusBy=VALUE, flipNormalDir=0, frozenBoundaryConditionRegion=MODEL, isSensCalcOnlyOnDesignNodes=0, modeTrackingRegion=MODEL, nodalMoveLimit=0, nodeSmooth=DEFAULT, nodeUpdateStrategy=CONSERVATIVE, numTrackedModes=5, updateShapeBasisVectors=EVERY_CYCLE, groupOperator=0, )[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/2023.

Parameters:¶

name¶

A String specifying the optimization task repository key.

abaqusSensitivities=True¶

A Boolean specifying whether to use Abaqus to compute the design responses and their sensitivities. The default value is True.

Added in version 2019: The abaqusSensitivities argument was added.

algorithm=GENERAL_OPTIMIZATION¶

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

areBCRegionsFrozen=0¶

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

beadIter=1¶

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

beadMaxMembraneStress=0¶

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

beadMinStress=0¶

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

beadPerturbation=0¶

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

beadWidth=DEFAULT¶

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

curveSmooth=5¶

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

filterRadius=4¶

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

filterRadiusBy=VALUE¶

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

flipNormalDir=0¶

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

frozenBoundaryConditionRegion=MODEL¶

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

isSensCalcOnlyOnDesignNodes=0¶

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

modeTrackingRegion=MODEL¶

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

nodalMoveLimit=0¶

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

nodeSmooth=DEFAULT¶

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

nodeUpdateStrategy=CONSERVATIVE¶

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

numTrackedModes=5¶

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

updateShapeBasisVectors=EVERY_CYCLE¶

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

groupOperator=0¶

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.

Added in version 2022: The groupOperator argument was added.

Returns:¶

A BeadTask object.

Return type:¶

BeadTask

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

Parameters:¶

name¶

A String specifying the optimization task repository key.

abaqusSensitivities=True¶

A Boolean specifying whether to use Abaqus to compute the design responses and their sensitivities. The default value is True.

Added in version 2019: The abaqusSensitivities argument was added.

absoluteStepSizeControl=MINIMUM¶

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

activateDurability=1¶

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

additionalDurabilityFiles=''¶

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

constrainedLaplacianConvergenceLevel=NORMAL¶

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

curvatureSmoothingEdgeLength=5¶

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

durabilityInputfile=''¶

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

durabilitySolver=FE_SAFE¶

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

equalityConstraintTolerance=None¶

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

featureRecognitionAngle=30¶

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

filterExponent=1¶

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

filterMaxRadius=None¶

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

filterRadiusReduction=None¶

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

firstCycleDeletedVolumeTechnique=0¶

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

freezeBoundaryConditionRegions=0¶

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

frozenBoundaryConditionRegion=MODEL¶

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

geometricRestrictionEvaluationFrequency=LOW¶

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

growthScaleFactor=1¶

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

haltUponViolation=0¶

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

layerReferenceRegion=None¶

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

meshSmoothingRegionMethod=TASK_REGION_LAYERS¶

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

meshSmoothingStrategy=CONSTRAINED_LAPLACIAN¶

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

midsideInterpolation=POSITIONS¶

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

numFreeNodeLayers=0¶

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

numSmoothedElementLayers=None¶

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

presumeFeasibleBCRegionAtStart=1¶

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

quadMaxAngle=160¶

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

quadMinAngle=20¶

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

quadSkew=30¶

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

quadTaper=0¶

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

region=MODEL¶

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

reportPoorQualityElements=0¶

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

reportQualityViolation=0¶

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

shrinkScaleFactor=1¶

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

smoothingRegion=None¶

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

targetMeshQuality=LOW¶

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

tetAspectRatio=100¶

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

tetMaxAspect=8¶

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

tetMinAspect=0¶

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

tetSkew=100¶

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

triMaxAngle=140¶

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

triMinAngle=20¶

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

updateShapeBasisVectors=EVERY_CYCLE¶

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

groupOperator=0¶

Added in version 2022: The groupOperator argument was added.

Returns:¶

A ShapeTask object.

Return type:¶

ShapeTask

SizingTask( name, abaqusSensitivities=True, elementThicknessDeltaStopCriteria=0, freezeBoundaryConditionRegions=0, freezeLoadRegions=1, modeTrackingRegion=MODEL, numFulfilledStopCriteria=2, numTrackedModes=5, objectiveFunctionDeltaStopCriteria=0, stopCriteriaDesignCycle=4, thicknessMoveLimit=0, thicknessUpdateStrategy=NORMAL, groupOperator=0, )[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/2023.

Parameters:¶

name¶

A String specifying the optimization task repository key.

abaqusSensitivities=True¶

A Boolean specifying whether to use Abaqus to compute the design responses and their sensitivities. The default value is True.

Added in version 2019: The abaqusSensitivities argument was added.

elementThicknessDeltaStopCriteria=0¶

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

freezeBoundaryConditionRegions=0¶

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

freezeLoadRegions=1¶

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

modeTrackingRegion=MODEL¶

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

numFulfilledStopCriteria=2¶

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

numTrackedModes=5¶

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

objectiveFunctionDeltaStopCriteria=0¶

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

stopCriteriaDesignCycle=4¶

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

thicknessMoveLimit=0¶

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

thicknessUpdateStrategy=NORMAL¶

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

groupOperator=0¶

Added in version 2022: The groupOperator argument was added.

Returns:¶

A SizingTask object.

Return type:¶

SizingTask

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

Parameters:¶

name¶

A String specifying the optimization task repository key.

abaqusSensitivities=True¶

A Boolean specifying whether to use Abaqus to compute the design responses and their sensitivities. The default value is True.

Added in version 2019: The abaqusSensitivities argument was added.

algorithm=GENERAL_OPTIMIZATION¶

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

densityMoveLimit=0¶

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

densityUpdateStrategy=NORMAL¶

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

elementDensityDeltaStopCriteria=0¶

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

filterRadius=None¶

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

firstCycleDeletedVolume=5¶

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

firstCycleDeletedVolumeTechnique=0¶

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

freezeBoundaryConditionRegions=0¶

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

freezeLoadRegions=1¶

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

frequencySpectrumWeight=6¶

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

initialDensity=DEFAULT¶

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

materialInterpolationPenalty=3¶

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

materialInterpolationTechnique=DEFAULT¶

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

maxDensity=1¶

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

minDensity=None¶

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

modeTrackingRegion=MODEL¶

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

numDesignCycles=15¶

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

numFulfilledStopCriteria=2¶

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

numTrackedModes=5¶

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

objectiveFunctionDeltaStopCriteria=None¶

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

region=MODEL¶

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

softDeletionMethod=STANDARD¶

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

softDeletionRadius=0¶

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

softDeletionRegion=None¶

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

softDeletionThreshold=None¶

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

stepSize=MEDIUM¶

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

stiffnessMassDamping=AVERAGE_EDGE_LENGTH¶

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

stopCriteriaDesignCycle=4¶

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

structuralMassDamping=None¶

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

viscousMassDamping=None¶

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

viscousStiffnessDamping=None¶

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

groupOperator=0¶

Added in version 2022: The groupOperator argument was added.

Returns:¶

A TopologyTask object.

Return type:¶

TopologyTask

Assign features to optimization tasks¶

class OptimizationTask[source]¶

Bases: OptimizationTaskBase

Public Data Attributes:

Inherited from OptimizationTaskBase

`name`	A String specifying the optimization task repository key.
`region`	The SymbolicConstant MODEL or a Region object specifying the region to which the optimization task is applied.
`designResponses`	A repository of DesignResponse objects.
`objectiveFunctions`	A repository of ObjectiveFunction objects.
`optimizationConstraints`	A repository of OptimizationConstraint objects.
`geometricRestrictions`	A repository of GeometricRestriction objects.
`stopConditions`	A repository of StopCondition objects.

Public Methods:

`SingleTermDesignResponse`(name, identifier[, ...])	This method creates a SingleTermDesignResponse object.
`ObjectiveFunction`(name, objectives[, target])	This method creates an ObjectiveFunction object.
`OptimizationConstraint`(name, designResponse, ...)	This method creates an OptimizationConstraint object.
`BeadFilter`(name, region[, radius, ...])	This method creates a BeadFilter 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.
`TopologyRibDesign`(name, ribDirection, ...[, ...])	This method creates a TopologyRibDesign object.
`TopologyRotationalSymmetry`(name, angle, region)	This method creates a TopologyRotationalSymmetry object.
`TurnControl`(name, clientDirection, region[, ...])	This method creates a TurnControl object.

Member Details:

BeadFilter( name, region, radius=None, filterRadiusBy=ABSOLUTE_VALUE, filterCheckRegion=FILTER_REGION, )[source]¶

This method creates a BeadFilter object.

Note

This function can be accessed by:

mdb.models[name].optimizationTasks[name].BeadFilter

Added in version 2023.

The BeadFilter method was added.

Note

Check BeadFilter on help.3ds.com/2023.

Parameters:¶

name¶: A String specifying the geometric restriction repository key.
region¶: A Region object specifying the region to which the geometric restriction is applied.
radius=None¶: A Float specifying the filter radius. The default value is double the average edge length of the model.
filterRadiusBy=ABSOLUTE_VALUE¶: The SymbolicConstant defines whether the filter radius is in absolute or relative units. For an absolute radius, the value is ABSOLUTE_VALUE. For a relative radius, the value is RELATIVE. The default value is ABSOLUTE_VALUE.
filterCheckRegion=FILTER_REGION¶: The SymbolicConstant FILTER_REGION or a Region object specifying the filter check region. If the value is FILTER_REGION, the value of the region is used as both the filter region and the filter check region. The default value is FILTER_REGION.

Returns:¶

A BeadFilter object.

Return type:¶

BeadFilter

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

This method creates a BeadFixedRegion object.

Note

This function can be accessed by:

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

Note

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

Parameters:¶

name¶: A String specifying the geometric restriction repository key.
region¶: A Region object specifying the region to which the geometric restriction is applied.
csys=None¶: None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.
u1=0¶: A Boolean specifying whether to fix the region in the 1-direction. The default value is OFF.
u2=0¶: A Boolean specifying whether to fix the region in the 2-direction. The default value is OFF.
u3=0¶: A Boolean specifying whether to fix the region in the 3-direction. The default value is OFF.

Returns:¶

A BeadFixedRegion object.

Return type:¶

BeadFixedRegion

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

This method creates a BeadGrowth object.

Note

This function can be accessed by:

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

Note

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

Parameters:¶

name¶: A String specifying the geometric restriction repository key.
region¶: A Region object specifying the region to which the geometric restriction is applied.
beadGrowth=0¶: A Float specifying the maximum optimization displacement in the growth direction. Either beadGrowth or shrink or both must be specified. The default value is 0.0.
shrink=0¶: A Float specifying the maximum optimization displacement in the shrink direction. Either beadGrowth or shrink or both must be specified The default value is 0.0.

Returns:¶

A BeadGrowth object.

Return type:¶

BeadGrowth

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

This method creates a BeadPenetrationCheck object.

Note

This function can be accessed by:

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

Note

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

Parameters:¶

name¶: A String specifying the geometric restriction repository key.
beadPenetrationCheckRegion¶: A Region object specifying the penetration check region.
region¶: A Region object specifying the region to which the geometric restriction is applied.

Returns:¶

A BeadPenetrationCheck object.

Return type:¶

BeadPenetrationCheck

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

This method creates a BeadPlanarSymmetry object.

Note

This function can be accessed by:

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

Note

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

Parameters:¶

name¶: A String specifying the geometric restriction repository key.
region¶: A Region object specifying the region to which the geometric restriction is applied.
axis=AXIS_1¶: A SymbolicConstant specifying the axis of symmetry. Possible values are AXIS_1, AXIS_2, and AXIS_3. The default value is AXIS_1.
csys=None¶: None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

Returns:¶

A BeadPlanarSymmetry object.

Return type:¶

BeadPlanarSymmetry

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

This method creates a BeadPointSymmetry object.

Note

This function can be accessed by:

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

Note

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

Parameters:¶

name¶: A String specifying the geometric restriction repository key.
region¶: A Region object specifying the region to which the geometric restriction is applied.
csys=None¶: None or a DatumCsys object specifying the position of the symmetry point defined as the origin of a local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

Returns:¶

A BeadPointSymmetry object.

Return type:¶

BeadPointSymmetry

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

This method creates a BeadRotationalSymmetry object.

Note

This function can be accessed by:

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

Note

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

Parameters:¶

name¶: A String specifying the geometric restriction repository key.
angle¶: A Float specifying the repeating segment size, an angle in degrees.
region¶: A Region object specifying the region to which the geometric restriction is applied.
axis=AXIS_1¶: A SymbolicConstant specifying the axis of symmetry. Possible values are AXIS_1, AXIS_2, and AXIS_3. The default value is AXIS_1.
csys=None¶: None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

Returns:¶

A BeadRotationalSymmetry object.

Return type:¶

BeadRotationalSymmetry

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

This method creates a DesignDirection object.

Note

This function can be accessed by:

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

Note

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

Parameters:¶

name¶

A String specifying the geometric restriction repository key.

region¶

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

csys=None¶

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

mainPoint=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=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=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=1¶

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

u1=1¶

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

u2=1¶

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

u3=1¶

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

Returns:¶

A DesignDirection object.

Return type:¶

DesignDirection

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

This method creates a DrillControl object.

Note

This function can be accessed by:

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

Note

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

Parameters:¶

name¶

A String specifying the geometric restriction repository key.

clientDirection¶

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

region¶

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

csys=None¶

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

drawAngle=0¶

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

mainPoint=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=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=1¶

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

tolerance1=0¶

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

tolerance2=0¶

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

tolerance3=0¶

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

undercutTolerance=0¶

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

Returns:¶

A DrillControl object.

Return type:¶

DrillControl

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

This method creates a FixedRegion object.

Note

This function can be accessed by:

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

Note

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

Parameters:¶

name¶: A String specifying the geometric restriction repository key.
region¶: A Region object specifying the region to which the geometric restriction is applied. When used with a TopologyTask, there is no default value. When used with a ShapeTask, the default value is MODEL.
csys=None¶: None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.
presumeFeasibleRegionAtStart=1¶: A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.
u1=0¶: A Boolean specifying whether to fix the region in the 1-direction. The default value is OFF.
u2=0¶: A Boolean specifying whether to fix the region in the 2-direction. The default value is OFF.
u3=0¶: A Boolean specifying whether to fix the region in the 3-direction. The default value is OFF.

Returns:¶

A FixedRegion object.

Return type:¶

FixedRegion

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

This method creates a FrozenArea object.

Note

This function can be accessed by:

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

Note

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

Parameters:¶

name¶: A String specifying the geometric restriction repository key.
region : Region, default: <abaqus.Region.Region.Region object at 0x7ff7134918d0>: A Region object specifying the region to which the geometric restriction is applied. When used with a TopologyTask, there is no default value. When used with a ShapeTask, the default value is MODEL.

Returns:¶

A FrozenArea object.

Return type:¶

FrozenArea

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

This method creates a Growth object.

Note

This function can be accessed by:

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

Note

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

Parameters:¶

name¶: A String specifying the geometric restriction repository key.
region¶: A Region object specifying the region to which the geometric restriction is applied. When used with a TopologyTask, there is no default value. When used with a ShapeTask, the default value is MODEL.
growth=0¶: A Float specifying the maximum optimization displacement in the growth direction. Either growth or shrink or both must be specified. The default value is 0.0.
presumeFeasibleRegionAtStart=1¶: A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.
shrink=0¶: A Float specifying the maximum optimization displacement in the shrink direction. Either growth or shrink or both must be specified The default value is 0.0.

Returns:¶

A Growth object.

Return type:¶

Growth

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

This method creates an ObjectiveFunction object.

Note

This function can be accessed by:

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

Note

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

Parameters:¶

name¶: A String specifying the objective function repository key.
objectives¶: An OptimizationObjectiveArray object.
target=MINIMIZE¶: A SymbolicConstant specifying the target of the objective function. Possible values are MINIMIZE, MAXIMIZE, and MINIMIZE_MAXIMUM. The default value is MINIMIZE.

Returns:¶

An ObjectiveFunction object.

Return type:¶

ObjectiveFunction

Raises:¶

InvalidNameError –
RangeError –

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

This method creates an OptimizationConstraint object.

Note

This function can be accessed by:

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

Note

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

Parameters:¶

name¶: A String specifying the optimization constraint repository key.
designResponse¶: A String specifying the name of the design response to constrain.
restrictionValue¶: A Float specifying the value to which the design response should be constrained.
restrictionMethod=ABSOLUTE_EQUAL¶: A SymbolicConstant specifying the method used to constrain the design response. Possible values are ABSOLUTE_EQUAL, ABSOLUTE_GREATER_THAN_EQUAL, ABSOLUTE_LESS_THAN_EQUAL, RELATIVE_EQUAL, RELATIVE_GREATER_THAN_EQUAL, and RELATIVE_LESS_THAN_EQUAL. The default value is ABSOLUTE_EQUAL.

Returns:¶

An OptimizationConstraint object.

Return type:¶

OptimizationConstraint

Raises:¶

InvalidNameError –
RangeError –

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

This method creates a PenetrationCheck object.

Note

This function can be accessed by:

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

Note

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

Parameters:¶

name¶: A String specifying the geometric restriction repository key.
penetrationCheckRegion¶: A Region object specifying the penetration check region.
region¶: A Region object specifying the region to which the geometric restriction is applied. When used with a TopologyTask, there is no default value. When used with a ShapeTask, the default value is MODEL.
presumeFeasibleRegionAtStart=1¶: A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.

Returns:¶

A PenetrationCheck object.

Return type:¶

PenetrationCheck

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

This method creates a ShapeDemoldControl object.

Note

This function can be accessed by:

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

Note

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

Parameters:¶

name¶

A String specifying the geometric restriction repository key.

pullDirection¶

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

region¶

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

collisionCheckRegion=DEMOLD_REGION¶

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

csys=None¶

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

drawAngle=0¶

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

mainPointDetermination=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=1¶

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

tolerance1=0¶

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

tolerance2=0¶

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

tolerance3=0¶

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

undercutTolerance=0¶

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

Returns:¶

A ShapeDemoldControl object.

Return type:¶

ShapeDemoldControl

ShapeMemberSize( name, region, maxThickness=0, minThickness=0, sizeRestriction=MINIMUM, assignNodeGroupRegion=0, 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/2023.

Parameters:¶

name¶

A String specifying the geometric restriction repository key.

region¶

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

maxThickness=0¶

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

minThickness=0¶

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

sizeRestriction=MINIMUM¶

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

assignNodeGroupRegion=0¶

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

Added in version 2022: The assignNodeGroupRegion argument was added.

nodeGroupRegion=''¶

A Node Region object specifying the check node group.

Added in version 2022: The nodeGroupRegion argument was added.

Returns:¶

A ShapeMemberSize object.

Return type:¶

ShapeMemberSize

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

This method creates a ShapePlanarSymmetry object.

Note

This function can be accessed by:

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

Note

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

Parameters:¶

name¶

A String specifying the geometric restriction repository key.

clientDirection¶

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

region¶

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

allowNonSymmetricMesh=True¶

A Boolean specifying whether to allow a nonsymmetric mesh for this geometric restriction. The default value is TRUE.

Added in version 2021: The alloowNonSymmetricMesh argument was added.

csys=None¶

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

mainPointDetermination=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=1¶

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

tolerance1=0¶

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

tolerance2=0¶

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

tolerance3=0¶

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

Returns:¶

A ShapePlanarSymmetry object.

Return type:¶

ShapePlanarSymmetry

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

This method creates a ShapePointSymmetry object.

Note

This function can be accessed by:

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

Note

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

Parameters:¶

name¶

A String specifying the geometric restriction repository key.

region¶

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

csys=None¶

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

mainPointDetermination=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=1¶

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

tolerance1=0¶

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

tolerance2=0¶

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

tolerance3=0¶

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

Returns:¶

A ShapePointSymmetry object.

Return type:¶

ShapePointSymmetry

ShapeRotationalSymmetry( name, clientDirection, region, allowNonSymmetricMesh=True, angle=0, csys=None, mainPoint=None, mainPointDetermination=MAXIMUM, presumeFeasibleRegionAtStart=1, startPoint=None, tolerance1=0, tolerance2=0, tolerance3=0, )[source]¶

This method creates a ShapeRotationalSymmetry object.

Note

This function can be accessed by:

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

Note

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

Parameters:¶

name¶

A String specifying the geometric restriction repository key.

clientDirection¶

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

region¶

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

allowNonSymmetricMesh=True¶

A Boolean specifying whether to allow a nonsymmetric mesh for this geometric restriction. The default value is TRUE.

Added in version 2021: The alloowNonSymmetricMesh argument was added.

angle=0¶

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

csys=None¶

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

mainPoint=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=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=1¶

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

startPoint=None¶

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

tolerance1=0¶

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

tolerance2=0¶

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

tolerance3=0¶

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

Returns:¶

A ShapeRotationalSymmetry object.

Return type:¶

ShapeRotationalSymmetry

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

This method creates a SingleTermDesignResponse object.

Note

This function can be accessed by:

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

Note

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

Parameters:¶

name¶: A String specifying the design response repository key.
identifier¶: A String specifying the name of the variable identifier.
csys=None¶: None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.
drivingRegion=None¶: None or a sequence of Floats specifying the driving region used when identifier is an internal nodal variable. The default value is None.
operation=SUM¶: A SymbolicConstant specifying the operation used on values in the region. Possible values are MAXIMUM, MINIMUM, and SUM. The default value is SUM.
region=MODEL¶: The SymbolicConstant MODEL or a Region object specifying the region of the design response variable. The default value is MODEL.
shellLayer=MAXIMUM¶: A SymbolicConstant specifying the location used for shell layer values. Possible values are BOTTOM, MAXIMUM, MIDDLE, MINIMUM, and TOP. The default value is MAXIMUM.
stepOperation=SUM¶: A SymbolicConstant specifying the operation used on values across steps and load cases. Possible values are MAXIMUM, MINIMUM, and SUM. The default value is SUM.
stepOptions=None¶: A StepOptionArray object.

Returns:¶

A SingleTermDesignResponse object.

Return type:¶

SingleTermDesignResponse

SizingClusterAreas(name, regions)[source]¶

This method creates a SizingClusterAreas object.

Note

This function can be accessed by:

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

Note

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

Parameters:¶

name¶: A String specifying the geometric restriction repository key.
regions¶: Tuple of Region objects specifying the regions to which the geometric restriction is applied.

Returns:¶

A SizingClusterAreas object.

Return type:¶

SizingClusterAreas

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

This method creates a SizingCyclicSymmetry object.

Note

This function can be accessed by:

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

Note

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

Parameters:¶

name¶: A String specifying the geometric restriction repository key.
region¶: A Region object specifying the region to which the geometric restriction is applied.
translation¶: A Float specifying the translation distance.
axis=AXIS_1¶: A SymbolicConstant specifying the translation direction defined along an axis positioned at the csys origin. Possible values are AXIS_1, AXIS_2, and AXIS_3. The default value is AXIS_1.
csys=None¶: None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.
ignoreFrozenArea=0¶: A Boolean specifying whether to ignore frozen areas. The default value is OFF.

Returns:¶

A SizingCyclicSymmetry object.

Return type:¶

SizingCyclicSymmetry

SizingFrozenArea(name, region)[source]¶

This method creates a SizingFrozenArea object.

Note

This function can be accessed by:

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

Note

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

Parameters:¶

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

Returns:¶

A SizingFrozenArea object.

Return type:¶

SizingFrozenArea

SizingMemberSize(name, region, minWidth)[source]¶

This method creates a SizingMemberSize object.

Note

This function can be accessed by:

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

Note

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

Parameters:¶

name¶: A String specifying the geometric restriction repository key.
region¶: A Region object specifying the region to which the geometric restriction is applied.
minWidth¶: A Float specifying the min width.

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

This method creates a SizingPlanarSymmetry object.

Note

This function can be accessed by:

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

Note

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

Parameters:¶

name¶: A String specifying the geometric restriction repository key.
region¶: A Region object specifying the region to which the geometric restriction is applied.
axis=AXIS_1¶: A SymbolicConstant specifying the axis of symmetry. Possible values are AXIS_1, AXIS_2, and AXIS_3. The default value is AXIS_1.
csys=None¶: None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.
ignoreFrozenArea=0¶: A Boolean specifying whether to ignore frozen areas. The default value is OFF.

Returns:¶

A SizingPlanarSymmetry object.

Return type:¶

SizingPlanarSymmetry

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

This method creates a SizingPointSymmetry object.

Note

This function can be accessed by:

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

Note

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

Parameters:¶

name¶: A String specifying the geometric restriction repository key.
region¶: A Region object specifying the region to which the geometric restriction is applied.
csys=None¶: None or a DatumCsys object specifying the position of the symmetry point defined as the origin of a local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.
ignoreFrozenArea=0¶: A Boolean specifying whether to ignore frozen areas. The default value is OFF.

Returns:¶

A SizingPointSymmetry object.

Return type:¶

SizingPointSymmetry

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

This method creates a SizingRotationalSymmetry object.

Note

This function can be accessed by:

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

Note

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

Parameters:¶

name¶: A String specifying the geometric restriction repository key.
angle¶: A Float specifying the repeating segment size, an angle in degrees.
region¶: A Region object specifying the region to which the geometric restriction is applied.
axis=AXIS_1¶: A SymbolicConstant specifying the axis of symmetry. Possible values are AXIS_1, AXIS_2, and AXIS_3. The default value is AXIS_1.
csys=None¶: None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.
ignoreFrozenArea=0¶: A Boolean specifying whether to ignore frozen areas. The default value is OFF.

Returns:¶

A SizingRotationalSymmetry object.

Return type:¶

SizingRotationalSymmetry

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

This method creates a SlideRegionControl object.

Note

This function can be accessed by:

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

Note

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

Parameters:¶

name¶: A String specifying the geometric restriction repository key.
clientDirection¶: A VertexArray object of length 2 specifying the axis of revolution. Instead of through a ConstrainedSketchVertex, each point may be specified through a tuple of coordinates. This is used when approach is TURN.
region¶: A Region object specifying the region to which the geometric restriction is applied. When used with a TopologyTask, there is no default value. When used with a ShapeTask, the default value is MODEL.
approach=FREE_FORM¶: A SymbolicConstant specifying the restriction approach. The SymbolicConstant FREE_FORM indicates a free-form slide region, and the SymbolicConstant TURN indicates that the restriction should conserve a turnable surface. Possible values are FREE_FORM and TURN. The default value is FREE_FORM.
csys=None¶: None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. This is used when approach is TURN. The default value is None.
freeFormRegion=None¶: None or a Region object specifying the free-form region. This is used when approach is FREE_FORM. The default value is None.
presumeFeasibleRegionAtStart=1¶: A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.
revolvedRegion=None¶: None or a Region object specifying the region to revolve into a slide region. This is used when approach is TURN. The default value is None.
tolerance1=0¶: A Float specifying the geometric tolerance in the 1-direction. This is used when approach is TURN. The default value is 0.01.
tolerance2=0¶: A Float specifying the geometric tolerance in the 2-direction. This is used when approach is TURN. The default value is 0.01.
tolerance3=0¶: A Float specifying the geometric tolerance in the 3-direction. This is used when approach is TURN. The default value is 0.01.

Returns:¶

A SlideRegionControl object.

Return type:¶

SlideRegionControl

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

This method creates a StampControl object.

Note

This function can be accessed by:

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

Note

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

Parameters:¶

name¶

A String specifying the geometric restriction repository key.

clientDirection¶

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

region¶

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

csys=None¶

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

drawAngle=0¶

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

mainPoint=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=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=1¶

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

tolerance1=0¶

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

tolerance2=0¶

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

tolerance3=0¶

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

undercutTolerance=0¶

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

Returns:¶

A StampControl object.

Return type:¶

StampControl

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

This method creates a TopologyCyclicSymmetry object.

Note

This function can be accessed by:

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

Note

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

Parameters:¶

name¶: A String specifying the geometric restriction repository key.
region¶: A Region object specifying the region to which the geometric restriction is applied. When used with a TopologyTask, there is no default value. When used with a ShapeTask, the default value is MODEL.
translation¶: A Float specifying the translation distance.
axis=AXIS_1¶: A SymbolicConstant specifying the translation direction defined along an axis positioned at the csys origin. Possible values are AXIS_1, AXIS_2, and AXIS_3. The default value is AXIS_1.
csys=None¶: None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.
ignoreFrozenArea=0¶: A Boolean specifying whether to ignore frozen areas. The default value is OFF.

Returns:¶

A TopologyCyclicSymmetry object.

Return type:¶

TopologyCyclicSymmetry

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

This method creates a TopologyDemoldControl object.

Note

This function can be accessed by:

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

Note

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

Parameters:¶

name¶: A String specifying the geometric restriction repository key.
region¶: A Region object specifying the region to which the geometric restriction is applied. When used with a TopologyTask, there is no default value. When used with a ShapeTask, the default value is MODEL.
csys=None¶: None or a DatumCsys object specifying the local coordinate system of the pullDirection. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int indicating the identifier of the DatumCsys. The default value is None.
draftAngle=0¶: A Float specifying the draft angle. The default value is 0.0.
collisionCheckRegion=DEMOLD_REGION¶: The SymbolicConstant DEMOLD_REGION or a Region object specifying the collision check region. If the value is DEMOLD_REGION, then the value of region is used as both the demold region and the collision check region. The default value is DEMOLD_REGION.
pointRegion=None¶: A Region object specifying the point on a plane perpendicular to the pull direction, used to specify the central plane when technique is POINT.
pullDirection=()¶: A VertexArray object of length 2 specifying the demold pull direction. Instead of through a ConstrainedSketchVertex, each point may be specified through a tuple of coordinates.
technique=AUTO¶: A SymbolicConstant specifying the demold technique. Possible values are AUTO, AUTO_TIGHT, POINT, SURFACE, and STAMP. The default value is AUTO.

Returns:¶

A TopologyDemoldControl object.

Return type:¶

TopologyDemoldControl

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

This method creates a TopologyMemberSize object.

Note

This function can be accessed by:

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

Note

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

Parameters:¶

name¶: A String specifying the geometric restriction repository key.
region¶: A Region object specifying the region to which the geometric restriction is applied. When used with a TopologyTask, there is no default value. When used with a ShapeTask, the default value is MODEL.
maxThickness=0¶: A Float specifying the maximum thickness. The default value is 0.0.
minThickness=0¶: A Float specifying the minimum thickness. The default value is 0.0.
separation=0¶: A Float specifying the minimum gap. The default value is 0.0.
sizeRestriction=MINIMUM¶: A SymbolicConstant specifying whether to restrict the minimum or maximum thickness or an envelope of both. Possible values are ENVELOPE, MAXIMUM, and MINIMUM. The default value is MINIMUM.

Returns:¶

A TopologyMemberSize object.

Return type:¶

TopologyMemberSize

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

This method creates a TopologyMillingControl object.

Note

This function can be accessed by:

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

Added in version 2022: The TopologyMillingControl method was added.

Note

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

Parameters:¶

name¶: A String specifying the geometric restriction repository key.
millingDirections¶: 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¶: A Region object specifying the region to which the geometric restriction is applied.
csys=None¶: None or a DatumCsys object specifying the local coordinate system 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=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=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=OVERHANG_REGION, pointRegion=<abaqus.Region.Region.Region object>, radius=None, technique=AUTO, )[source]¶

This method creates a TopologyOverhangControl object.

Note

This function can be accessed by:

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

Added in version 2019: The TopologyOverhangControl method was added.

Note

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

Parameters:¶

name¶: A String specifying the geometric restriction repository key.
pullDirection¶: 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¶: A Region object specifying the region to which the geometric restriction is applied.
csys : int | None, 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 : Literal[OVERHANG_REGION], 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 0x7ff713573150>: 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 : float | None, 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 : Literal[POINT, NONE, AUTO], 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.

Returns:¶

A TopologyOverhangControl object.

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

This method creates a TopologyPlanarSymmetry object.

Note

This function can be accessed by:

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

Note

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

Parameters:¶

name¶: A String specifying the geometric restriction repository key.
region¶: A Region object specifying the region to which the geometric restriction is applied. When used with a TopologyTask, there is no default value. When used with a ShapeTask, the default value is MODEL.
axis=AXIS_1¶: A SymbolicConstant specifying the axis of symmetry. Possible values are AXIS_1, AXIS_2, and AXIS_3. The default value is AXIS_1.
csys=None¶: None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.
ignoreFrozenArea=0¶: A Boolean specifying whether to ignore frozen areas. The default value is OFF.

Returns:¶

A TopologyPlanarSymmetry object.

Return type:¶

TopologyPlanarSymmetry

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

This method creates a TopologyPointSymmetry object.

Note

This function can be accessed by:

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

Note

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

Parameters:¶

name¶: A String specifying the geometric restriction repository key.
region¶: A Region object specifying the region to which the geometric restriction is applied. When used with a TopologyTask, there is no default value. When used with a ShapeTask, the default value is MODEL.
csys=None¶: None or a DatumCsys object specifying the position of the symmetry point defined as the origin of a local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.
ignoreFrozenArea=0¶: A Boolean specifying whether to ignore frozen areas. The default value is OFF.

Returns:¶

A TopologyPointSymmetry object.

Return type:¶

TopologyPointSymmetry

TopologyRibDesign( name, ribDirection, ribThickness, ribDistance, region, csys=None, ribDesignCheckRegion=RIBDESIGN_REGION, )[source]¶

This method creates a TopologyRibDesign object.

Note

This function can be accessed by:

mdb.models[name].optimizationTasks[name].TopologyRibDesign

Added in version 2022: The TopologyRibDesign method was added.

Note

Check TopologyRibDesign on help.3ds.com/2023.

Parameters:¶

name¶: A String specifying the geometric restriction repository key.
ribDirection¶: A VertexArray object of length 2 specifying the out-of-plane growth direction of the ribs. Instead of through a Vertex, each point can be specified through a tuple of coordinates.
ribThickness¶: A Float specifying the average thickness of the ribs.
ribDistance¶: A Float specifying the average distance between the rib centers. The distance must be larger than twice the average element edge length.
region¶: A Region object specifying the region to which the geometric restriction is applied. When used with a TopologyTask, there is no default value. When used with a ShapeTask, the default value is MODEL.
csys=None¶: None or a DatumCsys object specifying the position of the symmetry point defined as the origin of a local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.
ribDesignCheckRegion=RIBDESIGN_REGION¶: The SymbolicConstant RIBDESIGN_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 RIBDESIGN_REGION.

Returns:¶

A TopologyRibDesign object.

Return type:¶

TopologyRibDesign

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

This method creates a TopologyRotationalSymmetry object.

Note

This function can be accessed by:

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

Note

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

Parameters:¶

name¶: A String specifying the geometric restriction repository key.
angle¶: A Float specifying the repeating segment size, an angle in degrees.
region¶: A Region object specifying the region to which the geometric restriction is applied. When used with a TopologyTask, there is no default value. When used with a ShapeTask, the default value is MODEL.
axis=AXIS_1¶: A SymbolicConstant specifying the axis of symmetry. Possible values are AXIS_1, AXIS_2, and AXIS_3. The default value is AXIS_1.
csys=None¶: None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.
ignoreFrozenArea=0¶: A Boolean specifying whether to ignore frozen areas. The default value is OFF.

Returns:¶

A TopologyRotationalSymmetry object.

Return type:¶

TopologyRotationalSymmetry

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

This method creates a TurnControl object.

Note

This function can be accessed by:

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

Note

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

Parameters:¶

name¶

A String specifying the geometric restriction repository key.

clientDirection¶

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

region¶

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

csys=None¶

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

mainPoint=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=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=1¶

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

tolerance1=0¶

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

tolerance2=0¶

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

tolerance3=0¶

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

Returns:¶

A TurnControl object.

Return type:¶

TurnControl

Other Classes¶

class BeadFilter( name, region, radius=None, filterRadiusBy=ABSOLUTE_VALUE, filterCheckRegion=FILTER_REGION, )[source]¶

Bases: GeometricRestriction

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

Note

This object can be accessed by:

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

Added in version 2023: The BeadFilter class was added.

Note

Check BeadFilter on help.3ds.com/2023.

Member Details:

filterCheckRegion : --is-rst--:py:data:`~typing.Union`\ \[:py:data:`~typing.Literal`\ \[``FILTER_REGION``], :py:class:`~abaqus.Region.Region.Region`] = 'FILTER_REGION'[source]¶: The SymbolicConstant FILTER_REGION or a Region object specifying the filter check region. If the value is FILTER_REGION, the value of the region is used as both the filter region and the filter check region. The default value is FILTER_REGION.

filterRadiusBy : --is-rst--:py:data:`~typing.Literal`\ \[``ABSOLUTE_VALUE``, ``RELATIVE``] = 'ABSOLUTE_VALUE'[source]¶: The SymbolicConstant defines whether the filter radius is in absolute or relative units. For an absolute radius, the value is ABSOLUTE_VALUE. For a relative radius, the value is RELATIVE. The default value is ABSOLUTE_VALUE.

radius : --is-rst--:py:class:`float`[source]¶: A Float specifying the filter radius. The default value is double the average edge length of the model.

setValues( region, radius=None, filterRadiusBy=ABSOLUTE_VALUE, filterCheckRegion=FILTER_REGION, )[source]¶

This method modifies the BeadFilter object.

Note

Check BeadFilter.setValues on help.3ds.com/2023.

Parameters:¶

region¶: A Region object specifying the region to which the geometric restriction is applied.
radius=None¶: A Float specifying the filter radius. The default value is double the average edge length of the model.
filterRadiusBy=ABSOLUTE_VALUE¶: The SymbolicConstant defines whether the filter radius is in absolute or relative units. For an absolute radius, the value is ABSOLUTE_VALUE. For a relative radius, the value is RELATIVE. The default value is ABSOLUTE_VALUE.
filterCheckRegion=FILTER_REGION¶: The SymbolicConstant FILTER_REGION or a Region object specifying the filter check region. If the value is FILTER_REGION, the value of the region is used as both the filter region and the filter check region. The default value is FILTER_REGION.

class GeometricRestriction[source]¶

Bases: object

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

Note

This object can be accessed by:

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

Note

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

Member Details:

name : --is-rst--:py:class:`str` = ''[source]¶: A String specifying the geometric restriction repository key.

region : --is-rst--:py:class:`~abaqus.Region.Region.Region` = <abaqus.Region.Region.Region object>[source]¶: A Region object specifying the region to which the geometric restriction is applied. When used with a TopologyTask, there is no default value. When used with a ShapeTask, the default value is MODEL.

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

Bases: GeometricRestriction

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

Note

This object can be accessed by:

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

Note

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

Member Details:

csys : --is-rst--:py:class:`int` | :py:obj:`None` = None[source]¶: None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

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

This method modifies the BeadFixedRegion object.

Note

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

Parameters:¶

csys=None¶: None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.
u1=0¶: A Boolean specifying whether to fix the region in the 1-direction. The default value is OFF.
u2=0¶: A Boolean specifying whether to fix the region in the 2-direction. The default value is OFF.
u3=0¶: A Boolean specifying whether to fix the region in the 3-direction. The default value is OFF.

u1 : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]¶: A Boolean specifying whether to fix the region in the 1-direction. The default value is OFF.

u2 : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]¶: A Boolean specifying whether to fix the region in the 2-direction. The default value is OFF.

u3 : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]¶: A Boolean specifying whether to fix the region in the 3-direction. The default value is OFF.

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

Bases: GeometricRestriction

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

Note

This object can be accessed by:

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

Note

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

Member Details:

beadGrowth : --is-rst--:py:class:`float` = 0[source]¶: A Float specifying the maximum optimization displacement in the growth direction. Either beadGrowth or shrink or both must be specified. The default value is 0.0.

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

This method modifies the BeadGrowth object.

Note

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

Parameters:¶

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

shrink : --is-rst--:py:class:`float` = 0[source]¶: A Float specifying the maximum optimization displacement in the shrink direction. Either beadGrowth or shrink or both must be specified The default value is 0.0.

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

Bases: GeometricRestriction

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

Note

This object can be accessed by:

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

Note

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

Member Details:

beadPenetrationCheckRegion : --is-rst--:py:class:`~abaqus.Region.Region.Region`[source]¶: A Region object specifying the penetration check region.

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

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

Bases: GeometricRestriction

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

Note

This object can be accessed by:

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

Note

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

Member Details:

axis : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'AXIS_1'[source]¶: A SymbolicConstant specifying the axis of symmetry. Possible values are AXIS_1, AXIS_2, and AXIS_3. The default value is AXIS_1.

csys : --is-rst--:py:class:`int` | :py:obj:`None` = None[source]¶: None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

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

This method modifies the BeadPlanarSymmetry object.

Note

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

Parameters:¶

axis=AXIS_1¶: A SymbolicConstant specifying the axis of symmetry. Possible values are AXIS_1, AXIS_2, and AXIS_3. The default value is AXIS_1.
csys=None¶: None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

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

Bases: GeometricRestriction

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

Note

This object can be accessed by:

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

Note

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

Member Details:

csys : --is-rst--:py:class:`int` | :py:obj:`None` = None[source]¶: None or a DatumCsys object specifying the position of the symmetry point defined as the origin of a local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

setValues(csys=None)[source]¶

This method modifies the BeadPointSymmetry object.

Note

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

Parameters:¶

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

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

Bases: GeometricRestriction

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

Note

This object can be accessed by:

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

Note

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

Member Details:

angle : --is-rst--:py:class:`float`[source]¶: A Float specifying the repeating segment size, an angle in degrees.

axis : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'AXIS_1'[source]¶: A SymbolicConstant specifying the axis of symmetry. Possible values are AXIS_1, AXIS_2, and AXIS_3. The default value is AXIS_1.

csys : --is-rst--:py:class:`int` | :py:obj:`None` = None[source]¶: None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

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

This method modifies the BeadRotationalSymmetry object.

Note

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

Parameters:¶

axis=AXIS_1¶: A SymbolicConstant specifying the axis of symmetry. Possible values are AXIS_1, AXIS_2, and AXIS_3. The default value is AXIS_1.
csys=None¶: None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

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

Bases: OptimizationTask

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

Note

This object can be accessed by:

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

Note

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

Member Details:

abaqusSensitivities : --is-rst--Boolean = False[source]¶: A Boolean specifying whether to use Abaqus to compute the design responses and their sensitivities. The default value is False.

Added in version 2019: The abaqusSensitivities attribute was added.

algorithm : --is-rst--SymbolicConstant = 'GENERAL_OPTIMIZATION'[source]¶: A SymbolicConstant specifying the optimization task algorithm. Possible values are GENERAL_OPTIMIZATION and CONDITION_BASED_OPTIMIZATION. The default value is GENERAL_OPTIMIZATION.

areBCRegionsFrozen : --is-rst--Boolean = 0[source]¶: A Boolean specifying whether to exclude elements with boundary conditions from the optimization. The default value is OFF.

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

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

beadMinStress : --is-rst--float = 0[source]¶: A float specifying minimum stress. The default value is 0.001.

beadPerturbation : --is-rst--float = 0[source]¶: A Sets perturbation size for finite differences. The default value is 0.0001.

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

curveSmooth : --is-rst--float = 5[source]¶: A float specifying relative value to the middle element edge length such that normals in this area do not cross each other. The default value is 5.

designResponses : --is-rst--dict[str, DesignResponse] = {}[source]¶: A repository of DesignResponse objects.

filterRadius : --is-rst--float = 4[source]¶: A float specifying the filter radius. The default value is 4.

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

flipNormalDir : --is-rst--Boolean = 0[source]¶: A Boolean specifying whether the growth direction is along the normal direction of elements or opposite to the normal direction. The default value is OFF

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

geometricRestrictions : --is-rst--dict[str, GeometricRestriction] = {}[source]¶: A repository of GeometricRestriction objects.

groupOperator : --is-rst--Boolean = 0[source]¶: A Boolean specifying whether the group in the design response will be evaluated using the existing algorithm or a new algorithm based on Abaqus sensitivities. The default value of False means that the existing algorithm will be used.

Added in version 2022: The groupSensitivities attribute was added.

isSensCalcOnlyOnDesignNodes : --is-rst--Boolean = 0[source]¶: A Boolean specifying whether to calculate the sensitivities only on design nodes or the whole model. The default value is ON

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

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

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

nodeUpdateStrategy : --is-rst--SymbolicConstant = 'CONSERVATIVE'[source]¶: A SymbolicConstant specifying the strategy for how the nodal displacements are updated in the method of moving asymptotes. Possible values are NORMAL, CONSERVATIVE, and AGGRESSIVE. The default value is CONSERVATIVE.

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

objectiveFunctions : --is-rst--dict[str, ObjectiveFunction] = {}[source]¶: A repository of ObjectiveFunction objects.

optimizationConstraints : --is-rst--dict[str, OptimizationConstraint] = {}[source]¶: A repository of OptimizationConstraint objects.

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

This method modifies the BeadTask object.

Note

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

Parameters:¶

abaqusSensitivities=True¶

A Boolean specifying whether to use Abaqus to compute the design responses and their sensitivities. The default value is True.

Added in version 2019: The abaqusSensitivities argument was added.

algorithm=GENERAL_OPTIMIZATION¶

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

areBCRegionsFrozen=0¶

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

beadIter=1¶

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

beadMaxMembraneStress=0¶

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

beadMinStress=0¶

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

beadPerturbation=0¶

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

beadWidth=DEFAULT¶

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

curveSmooth=5¶

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

filterRadius=4¶

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

filterRadiusBy=VALUE¶

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

flipNormalDir=0¶

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

frozenBoundaryConditionRegion=MODEL¶

isSensCalcOnlyOnDesignNodes=0¶

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

modeTrackingRegion=MODEL¶

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

nodalMoveLimit=0¶

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

nodeSmooth=DEFAULT¶

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

nodeUpdateStrategy=CONSERVATIVE¶

numTrackedModes=5¶

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

updateShapeBasisVectors=EVERY_CYCLE¶

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

groupOperator=0¶

Added in version 2022: The groupOperator argument was added.

updateShapeBasisVectors : --is-rst--SymbolicConstant = 'EVERY_CYCLE'[source]¶: A SymbolicConstant specifying whether to update shape basis vectors in the first design cycle or every design cycle. Possible values are EVERY_CYCLE and FIRST_CYCLE. The default value is EVERY_CYCLE.

class DesignResponse[source]¶

Bases: object

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

Note

This object can be accessed by:

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

Note

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

Member Details:

name : --is-rst--:py:class:`str` = ''[source]¶: A String specifying the design response repository key.

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

Bases: object

The ObjectiveFunction object defines the objective of the optimization.

Note

This object can be accessed by:

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

Note

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

Member Details:

name : --is-rst--:py:class:`str`[source]¶: A String specifying the objective function repository key.

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

setValues(target=MINIMIZE)[source]¶

This method modifies the ObjectiveFunction object.

Note

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

Parameters:¶

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

Raises:¶

RangeError –

target : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'MINIMIZE'[source]¶: A SymbolicConstant specifying the target of the objective function. Possible values are MINIMIZE, MAXIMIZE, and MINIMIZE_MAXIMUM. The default value is MINIMIZE.

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

Bases: object

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

Note

This object can be accessed by:

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

Note

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

Member Details:

designResponse : --is-rst--:py:class:`str`[source]¶: A String specifying the name of the design response to constrain.

name : --is-rst--:py:class:`str`[source]¶: A String specifying the optimization constraint repository key.

restrictionMethod : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'ABSOLUTE_EQUAL'[source]¶: A SymbolicConstant specifying the method used to constrain the design response. Possible values are ABSOLUTE_EQUAL, ABSOLUTE_GREATER_THAN_EQUAL, ABSOLUTE_LESS_THAN_EQUAL, RELATIVE_EQUAL, RELATIVE_GREATER_THAN_EQUAL, and RELATIVE_LESS_THAN_EQUAL. The default value is ABSOLUTE_EQUAL.

restrictionValue : --is-rst--:py:class:`float`[source]¶: A Float specifying the value to which the design response should be constrained.

setValues(restrictionMethod=ABSOLUTE_EQUAL)[source]¶

This method modifies the OptimizationConstraint object.

Note

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

Parameters:¶

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

Raises:¶

RangeError –

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

Bases: DesignResponse

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

Note

This object can be accessed by:

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

Note

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

Member Details:

filterExponent : --is-rst--:py:class:`float` = 1[source]¶: A Float specifying the exponent used when method is FILTER. The default value is 1.0.

filterMaxRadius : --is-rst--:py:class:`str` | :py:obj:`None` = None[source]¶: None or a sequence of Floats specifying the maximum radius of influence used when method is FILTER. The default value is None.

filterRadiusReduction : --is-rst--:py:class:`float` = 0[source]¶: A Float specifying the reduction of the radius depending on surface bending, used when method is FILTER. The default value is 0.2.

highCutOff : --is-rst--:py:class:`str` | :py:obj:`None` = None[source]¶: None or a sequence of Floats specifying the upper bound of the vector value used when method is CUT_OFF. All values greater than the highCutOff are set to the highCutOff value. The default value is None.

lowCutOff : --is-rst--:py:class:`float` = 0[source]¶: A Float specifying the lower bound of the vector value used when method is CUT_OFF. All values less than the lowCutOff are treated as 0. The default value is 0.0.

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

ABSOLUTE_DIFFERENCE
ABSOLUTE_VALUE
ADD
COSINE
CUT_OFF
DELTA_OVER_1_ITERATION
DELTA_OVER_2_ITERATIONS
DELTA_OVER_3_ITERATIONS
DELTA_OVER_4_ITERATIONS
DELTA_OVER_5_ITERATIONS
DELTA_OVER_6_ITERATIONS
DIVIDE
EXPONENTIAL
FILTER
INTEGER
LOG
MAXIMUM
MINIMUM
MULTIPLY
NATURAL_LOG
NEAREST_INTEGER
NORM
NORM_FIRST
NTH_POWER
NTH_ROOT
SIGN
SINE
SQUARE_ROOT
SUBTRACT
TANGENT
WEIGHTED_ADD

The default value is ADD.

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

This method modifies the CombinedTermDesignResponse object.

Note

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

Parameters:¶

filterMaxRadius=None¶

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

filterExponent=1¶

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

filterRadiusReduction=0¶

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

highCutOff=None¶

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

lowCutOff=0¶

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

method=ADD¶

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

ABSOLUTE_DIFFERENCE
ABSOLUTE_VALUE
ADD
COSINE
CUT_OFF
DELTA_OVER_1_ITERATION
DELTA_OVER_2_ITERATIONS
DELTA_OVER_3_ITERATIONS
DELTA_OVER_4_ITERATIONS
DELTA_OVER_5_ITERATIONS
DELTA_OVER_6_ITERATIONS
DIVIDE
EXPONENTIAL
FILTER
INTEGER
LOG
MAXIMUM
MINIMUM
MULTIPLY
NATURAL_LOG
NEAREST_INTEGER
NORM
NORM_FIRST
NTH_POWER
NTH_ROOT
SIGN
SINE
SQUARE_ROOT
SUBTRACT
TANGENT
WEIGHTED_ADD

The default value is ADD.

weights=()¶

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

terms : --is-rst--:py:class:`tuple`\ \[:py:class:`str`, :py:data:`...<Ellipsis>`] = ()[source]¶: A sequence of Strings specifying the names of the design responses to combine.

weights : --is-rst--:py:class:`tuple`\ \[:py:class:`float`, :py:data:`...<Ellipsis>`] = ()[source]¶: A sequence of Floats specifying the weights to apply to the list of design responses used when method is WEIGHTED_ADD. The default value is an empty sequence.

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

Bases: GeometricRestriction

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

Note

This object can be accessed by:

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

Note

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

Member Details:

csys : --is-rst--:py:class:`int` | :py:obj:`None` = None[source]¶: None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

mainPoint : --is-rst--:py:class:`str` | :py:obj:`None` = None[source]¶: None or a Region object specifying the main point used when mainPointDetermination is SPECIFY. The default value is None.

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

mainPointDetermination : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'MAXIMUM'[source]¶: A SymbolicConstant specifying the rule for assigning point priority. Possible values are MAXIMUM, MINIMUM, and SPECIFY. The default value is MAXIMUM.

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

movementRestriction : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'VECTOR'[source]¶: A SymbolicConstant specifying whether movement in the region should follow only the direction of the 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 : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 1[source]¶: A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.

setValues( csys=None, mainPoint=None, mainPointDetermination=MAXIMUM, movementRestriction=VECTOR, presumeFeasibleRegionAtStart=1, u1=1, u2=1, u3=1, )[source]¶

This method modifies the DesignDirection object.

Note

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

Parameters:¶

csys=None¶

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

mainPoint=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=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=VECTOR¶

presumeFeasibleRegionAtStart=1¶

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

u1=1¶

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

u2=1¶

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

u3=1¶

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

u1 : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 1[source]¶: A Boolean specifying whether movement in the region should follow the masterPoint in the 1-direction. This is used when movementRestriction is VECTOR. The default value is ON.

u2 : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 1[source]¶: A Boolean specifying whether movement in the region should follow the masterPoint in the 2-direction. This is used when movementRestriction is VECTOR. The default value is ON.

u3 : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 1[source]¶: A Boolean specifying whether movement in the region should follow the masterPoint in the 3-direction. This is used when movementRestriction is VECTOR. The default value is ON.

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

Bases: GeometricRestriction

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

Note

This object can be accessed by:

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

Note

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

Member Details:

clientDirection : --is-rst--:py:class:`tuple`[source]¶: A VertexArray object of length 2 specifying the direction of the drill axis positioned at the csys origin. Instead of through a ConstrainedSketchVertex, each point may be specified through a tuple of coordinates.

csys : --is-rst--:py:class:`int` | :py:obj:`None` = None[source]¶: None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

drawAngle : --is-rst--:py:class:`float` = 0[source]¶: A Float specifying the draw angle. The default value is 0.0.

mainPoint : --is-rst--:py:class:`str` | :py:obj:`None` = None[source]¶: None or a Region object specifying the main point used when mainPointDetermination is SPECIFY. The default value is None.

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

mainPointDetermination : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'MAXIMUM'[source]¶: A SymbolicConstant specifying the rule for assigning point priority. Possible values are MAXIMUM, MINIMUM, and SPECIFY. The default value is MAXIMUM.

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

presumeFeasibleRegionAtStart : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 1[source]¶: A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.

setValues( csys=None, drawAngle=0, mainPoint=None, mainPointDetermination=MAXIMUM, presumeFeasibleRegionAtStart=1, tolerance1=0, tolerance2=0, tolerance3=0, undercutTolerance=0, )[source]¶

This method modifies the DrillControl object.

Note

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

Parameters:¶

csys=None¶

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

drawAngle=0¶

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

mainPoint=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=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=1¶

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

tolerance1=0¶

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

tolerance2=0¶

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

tolerance3=0¶

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

undercutTolerance=0¶

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

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

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

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

undercutTolerance : --is-rst--:py:class:`float` = 0[source]¶: A Float specifying the undercut tolerance. The default value is 0.0.

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

Bases: GeometricRestriction

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

Note

This object can be accessed by:

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

Note

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

Member Details:

csys : --is-rst--:py:class:`int` | :py:obj:`None` = None[source]¶: None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

presumeFeasibleRegionAtStart : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 1[source]¶: A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.

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

This method modifies the FixedRegion object.

Note

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

Parameters:¶

csys=None¶: None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.
presumeFeasibleRegionAtStart=1¶: A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.
u1=0¶: A Boolean specifying whether to fix the region in the 1-direction. The default value is OFF.
u2=0¶: A Boolean specifying whether to fix the region in the 2-direction. The default value is OFF.
u3=0¶: A Boolean specifying whether to fix the region in the 3-direction. The default value is OFF.

u1 : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]¶: A Boolean specifying whether to fix the region in the 1-direction. The default value is OFF.

u2 : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]¶: A Boolean specifying whether to fix the region in the 2-direction. The default value is OFF.

u3 : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]¶: A Boolean specifying whether to fix the region in the 3-direction. The default value is OFF.

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

Bases: GeometricRestriction

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

Note

This object can be accessed by:

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

Note

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

Member Details:

region : --is-rst--:py:class:`~abaqus.Region.Region.Region` = <abaqus.Region.Region.Region object>[source]¶: A Region object specifying the region to which the geometric restriction is applied. When used with a TopologyTask, there is no default value. When used with a ShapeTask, the default value is MODEL.

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

This method modifies the FrozenArea object.

Note

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

Parameters:¶

region : Region, default: <abaqus.Region.Region.Region object at 0x7ff7134923d0>: A Region object specifying the region to which the geometric restriction is applied. When used with a TopologyTask, there is no default value. When used with a ShapeTask, the default value is MODEL.

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

Bases: GeometricRestriction

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

Note

This object can be accessed by:

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

Note

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

Member Details:

growth : --is-rst--:py:class:`float` = 0[source]¶: A Float specifying the maximum optimization displacement in the growth direction. Either growth or shrink or both must be specified. The default value is 0.0.

presumeFeasibleRegionAtStart : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 1[source]¶: A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.

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

This method modifies the Growth object.

Note

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

Parameters:¶

growth=0¶: A Float specifying the maximum optimization displacement in the growth direction. Either growth or shrink or both must be specified. The default value is 0.0.
presumeFeasibleRegionAtStart=1¶: A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.
shrink=0¶: A Float specifying the maximum optimization displacement in the shrink direction. Either growth or shrink or both must be specified The default value is 0.0.

shrink : --is-rst--:py:class:`float` = 0[source]¶: A Float specifying the maximum optimization displacement in the shrink direction. Either growth or shrink or both must be specified The default value is 0.0.

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

Bases: StopCondition

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

Note

This object can be accessed by:

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

Note

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

Member Details:

comparisonOperation : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'LESS_THAN'[source]¶: A SymbolicConstant specifying the operation used to compare the selected value to the reference value. Possible values are LESS_THAN, LESS_THAN_EQUAL, EQUAL, GREATER_THAN_EQUAL, and GREATER_THAN. The default value is LESS_THAN.

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

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

ABSOLUTE_GROWTH_MOVEMENT
ABSOLUTE_SHRINK_MOVEMENT
GROWTH_MOVEMENT
SHRINK_MOVEMENT
MOVEMENT
TOTAL_ABSOLUTE_MOVEMENT
EQUIV_STRESS
FREE_TASK_REGION_EQUIV_STRESS
RESTRICTED_TASK_REGION_EQUIV_STRESS
SURFACE_POINT_EQUIV_STRESS
TASK_REGION_EQUIV_STRESS

The default value is MOVEMENT.

identifierOperation : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'MAXIMUM'[source]¶: A SymbolicConstant specifying the operation used to evaluate values in the region. Possible values are MAXIMUM, MINIMUM, and SUM. The default value is MAXIMUM.

referenceDesignCycle : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'PREVIOUS'[source]¶: A SymbolicConstant specifying the iteration from which a value is compared to the reference value. Possible values are FIRST and PREVIOUS. The default value is PREVIOUS.

referenceFactor : --is-rst--:py:class:`float`[source]¶: A Float specifying the factor used to modify the reference value.

referenceOperation : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'ADD'[source]¶: A SymbolicConstant specifying the operation used to modify the reference value by the reference factor. Possible values are ADD, DIVIDE, MULTIPLY, and SUBTRACT. The default value is ADD.

region : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'MODEL'[source]¶: The SymbolicConstant MODEL or a Region object specifying the region to which the stop condition is applied. The default value is MODEL.

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

This method modifies the LocalStopCondition object.

Note

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

Parameters:¶

comparisonOperation=LESS_THAN¶

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

identifier=MOVEMENT¶

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

The default value is MOVEMENT.

identifierOperation=MAXIMUM¶

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

referenceDesignCycle=PREVIOUS¶

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

referenceOperation=ADD¶

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

region=MODEL¶

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

class StopCondition[source]¶

Bases: object

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

Note

This object can be accessed by:

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

Note

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

Member Details:

name : --is-rst--:py:class:`str` = ''[source]¶: A String specifying the stop condition repository key.

region : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'MODEL'[source]¶: The SymbolicConstant MODEL or a Region object specifying the region to which the stop condition is applied. The default value is MODEL.

class OptimizationObjective[source]¶

Bases: object

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

Note

This object can be accessed by:

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

Note

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

Member Details:

designResponse : --is-rst--:py:class:`str` = ''[source]¶: A String specifying the name of the design response.

referenceValue : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`, :py:class:`float`] = 'DEFAULT'[source]¶: The SymbolicConstant DEFAULT or a Float specifying the reference value used in evaluating a design response. For topology optimization, DEFAULT> indicates the reference value is 0. For shape optimization, DEFAULT indicates the reference value is the nodal average. The default value is DEFAULT.

suppress : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]¶: A Boolean specifying whether the objective is suppressed or not. The default value is OFF.

weight : --is-rst--:py:class:`float` = 1[source]¶: A Float specifying the weight applied to the design response value. The default value is 1.0.

class OptimizationTaskBase[source]¶

Bases: object

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

Note

This object can be accessed by:

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

Note

Check OptimizationTaskBase on help.3ds.com/2023.

Member Details:

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

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

name : --is-rst--:py:class:`str` = ''[source]¶: A String specifying the optimization task repository key.

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

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

region : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'MODEL'[source]¶: The SymbolicConstant MODEL or a Region object specifying the region to which the optimization task is applied. The default value is MODEL.

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

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

Bases: GeometricRestriction

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

Note

This object can be accessed by:

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

Note

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

Member Details:

penetrationCheckRegion : --is-rst--:py:class:`~abaqus.Region.Region.Region`[source]¶: A Region object specifying the penetration check region.

presumeFeasibleRegionAtStart : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 1[source]¶: A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.

setValues(presumeFeasibleRegionAtStart=1)[source]¶

This method modifies the PenetrationCheck object.

Note

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

Parameters:¶

presumeFeasibleRegionAtStart=1¶: A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.

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

Bases: GeometricRestriction

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

Note

This object can be accessed by:

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

Note

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

Member Details:

collisionCheckRegion : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'DEMOLD_REGION'[source]¶: The SymbolicConstant DEMOLD_REGION or a Region object specifying the collision check region. If the value is DEMOLD_REGION, then the value of region is used as both the demold region and the collision check region. The default value is DEMOLD_REGION.

csys : --is-rst--:py:class:`int` | :py:obj:`None` = None[source]¶: None or a DatumCsys object specifying the local coordinate system of the pullDirection. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int indicating the identifier of the DatumCsys. The default value is None.

drawAngle : --is-rst--:py:class:`float` = 0[source]¶: A Float specifying the draw angle. The default value is 0.0.

mainPointDetermination : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'MAXIMUM'[source]¶: A SymbolicConstant specifying the rule for assigning point priority. Possible values are MAXIMUM and MINIMUM. The default value is MAXIMUM.

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

presumeFeasibleRegionAtStart : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 1[source]¶: A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.

pullDirection : --is-rst--:py:class:`tuple`[source]¶: A VertexArray object of length 2 specifying the demold pull direction. Instead of through a ConstrainedSketchVertex, each point might be specified through a tuple of coordinates.

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

This method modifies the ShapeDemoldControl object.

Note

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

Parameters:¶

collisionCheckRegion=DEMOLD_REGION¶

csys=None¶

drawAngle=0¶

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

mainPointDetermination=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=1¶

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

tolerance1=0¶

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

tolerance2=0¶

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

tolerance3=0¶

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

undercutTolerance=0¶

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

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

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

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

undercutTolerance : --is-rst--:py:class:`float` = 0[source]¶: A Float specifying the undercut tolerance. The default value is 0.0.

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

Bases: GeometricRestriction

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

Note

This object can be accessed by:

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

Note

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

Member Details:

assignNodeGroupRegion : --is-rst--:py:class:`str` = 0[source]¶: A bool specifying whether to use the node group region. The default value is OFF.

Added in version 2022: The assignNodeGroupRegion attribute was added.

maxThickness : --is-rst--:py:class:`float` = 0[source]¶: A Float specifying the maximum thickness. The default value is 0.0.

minThickness : --is-rst--:py:class:`float` = 0[source]¶: A Float specifying the minimum thickness. The default value is 0.0.

nodeGroupRegion : --is-rst--:py:class:`str` = ''[source]¶: A Node Region object specifying the check node group.

Added in version 2022: The nodeGroupRegion attribute was added.

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

This method modifies the ShapeMemberSize object.

Note

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

Parameters:¶

maxThickness=0¶

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

minThickness=0¶

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

sizeRestriction=MINIMUM¶

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

assignNodeGroupRegion=0¶

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

Added in version 2022: The assignNodeGroupRegion argument was added.

nodeGroupRegion=''¶

A Node Region object specifying the check node group.

Added in version 2022: The nodeGroupRegion argument was added.

sizeRestriction : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'MINIMUM'[source]¶: A SymbolicConstant specifying whether to restrict the minimum or maximum thickness. Possible values are MAXIMUM and MINIMUM. The default value is MINIMUM.

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

Bases: GeometricRestriction

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

Note

This object can be accessed by:

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

Note

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

Member Details:

allowNonSymmetricMesh : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = True[source]¶: A Boolean specifying whether to allow a nonsymmetric mesh for this geometric restriction. The default value is TRUE.

Added in version 2021: The allowNonSymmetricMesh attribute was added.

clientDirection : --is-rst--:py:class:`tuple`[source]¶: A VertexArray object of length 2 specifying the vector positioned at the csys origin that is normal to the symmetry plane. Instead of through a ConstrainedSketchVertex, each point may be specified through a tuple of coordinates.

csys : --is-rst--:py:class:`int` | :py:obj:`None` = None[source]¶: None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

mainPointDetermination : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'MAXIMUM'[source]¶: A SymbolicConstant specifying the rule for determining the main node. Possible values are MAXIMUM and MINIMUM. The default value is MAXIMUM.

presumeFeasibleRegionAtStart : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 1[source]¶: A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.

setValues( allowNonSymmetricMesh=True, csys=None, mainPointDetermination=MAXIMUM, presumeFeasibleRegionAtStart=1, tolerance1=0, tolerance2=0, tolerance3=0, )[source]¶

This method modifies the ShapePlanarSymmetry object.

Note

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

Parameters:¶

allowNonSymmetricMesh=True¶: A Boolean specifying whether to allow a nonsymmetric mesh for this geometric restriction. The default value is TRUE.
csys=None¶: None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.
mainPointDetermination=MAXIMUM¶: A SymbolicConstant specifying the rule for determining the main node. Possible values are MAXIMUM and MINIMUM. The default value is MAXIMUM.
presumeFeasibleRegionAtStart=1¶: A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.
tolerance1=0¶: A Float specifying the geometric tolerance in the 1-direction. The default value is 0.01.
tolerance2=0¶: A Float specifying the geometric tolerance in the 2-direction. The default value is 0.01.
tolerance3=0¶: A Float specifying the geometric tolerance in the 3-direction. The default value is 0.01.

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

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

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

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

Bases: GeometricRestriction

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

Note

This object can be accessed by:

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

Note

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

Member Details:

csys : --is-rst--:py:class:`int` | :py:obj:`None` = None[source]¶: None or a DatumCsys object specifying the symmetry point represented as the origin of a local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

mainPointDetermination : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'MAXIMUM'[source]¶: A SymbolicConstant specifying the rule for determining the main node. Possible values are MAXIMUM and MINIMUM. The default value is MAXIMUM.

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

presumeFeasibleRegionAtStart : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 1[source]¶: A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.

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

This method modifies the ShapePointSymmetry object.

Note

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

Parameters:¶

csys=None¶

mainPointDetermination=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=1¶

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

tolerance1=0¶

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

tolerance2=0¶

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

tolerance3=0¶

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

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

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

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

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

Bases: GeometricRestriction

The ShapeRotationalSymmetry object defines a shape rotational symmetry geometric restriction. The ShapeRotationalSymmetry object is derived from the GeometricRestriction object.

Note

This object can be accessed by:

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

Note

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

Member Details:

allowNonSymmetricMesh : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = True[source]¶: A Boolean specifying whether to allow a nonsymmetric mesh for this geometric restriction. The default value is TRUE.

Added in version 2021: The allowNonSymmetricMesh attribute was added.

angle : --is-rst--:py:class:`float` = 0[source]¶: A Float specifying the segment size of the repeating pattern in degrees. If the angle value is 0, no repeating pattern is created. The default value is 0.0.

clientDirection : --is-rst--:py:class:`tuple`[source]¶: A VertexArray object of length 2 specifying the vector positioned at the csys origin, used as the axis of symmetry. Instead of through a ConstrainedSketchVertex, each point might be specified through a tuple of coordinates.

csys : --is-rst--:py:class:`int` | :py:obj:`None` = None[source]¶: None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

mainPoint : --is-rst--:py:class:`str` | :py:obj:`None` = None[source]¶: None or a Region object specifying the main point used when mainPointDetermination is SPECIFY. The default value is None.

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

mainPointDetermination : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.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 : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 1[source]¶: A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.

setValues( allowNonSymmetricMesh=True, angle=0, csys=None, mainPoint=None, mainPointDetermination=MAXIMUM, presumeFeasibleRegionAtStart=1, startPoint=None, tolerance1=0, tolerance2=0, tolerance3=0, )[source]¶

This method modifies the ShapeRotationalSymmetry object.

Note

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

Parameters:¶

allowNonSymmetricMesh=True¶

A Boolean specifying whether to allow a nonsymmetric mesh for this geometric restriction. The default value is TRUE.

angle=0¶

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

csys=None¶

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

mainPoint=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=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=1¶

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

startPoint=None¶

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

tolerance1=0¶

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

tolerance2=0¶

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

tolerance3=0¶

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

startPoint : --is-rst--:py:class:`tuple`\ \[:py:class:`float`, :py:data:`...<Ellipsis>`] = ()[source]¶: A tuple of Floats representing the coordinates of a start point of the rotational symmetry.

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

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

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

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

Bases: DesignResponse

The SingleTermDesignResponse object defines a single-term design response. The SingleTermDesignResponse object is derived from the DesignResponse object.

Note

This object can be accessed by:

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

Note

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

Member Details:

csys : --is-rst--:py:class:`int` | :py:obj:`None` = None[source]¶: None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

drivingRegion : --is-rst--:py:class:`str` | :py:obj:`None` = None[source]¶: None or a sequence of Floats specifying the driving region used when identifier is an internal nodal variable. The default value is None.

identifier : --is-rst--:py:class:`str`[source]¶: A String specifying the name of the variable identifier.

operation : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'SUM'[source]¶: A SymbolicConstant specifying the operation used on values in the region. Possible values are MAXIMUM, MINIMUM, and SUM. The default value is SUM.

region : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'MODEL'[source]¶: The SymbolicConstant MODEL or a Region object specifying the region of the design response variable. The default value is MODEL.

setValues( csys=None, drivingRegion=None, operation=SUM, region=MODEL, shellLayer=MAXIMUM, stepOperation=SUM, stepOptions=None, )[source]¶

This method modifies the SingleTermDesignResponse object.

Note

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

Parameters:¶

csys=None¶: None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.
drivingRegion=None¶: None or a sequence of Floats specifying the driving region used when identifier is an internal nodal variable. The default value is None.
operation=SUM¶: A SymbolicConstant specifying the operation used on values in the region. Possible values are MAXIMUM, MINIMUM, and SUM. The default value is SUM.
region=MODEL¶: The SymbolicConstant MODEL or a Region object specifying the region of the design response variable. The default value is MODEL.
shellLayer=MAXIMUM¶: A SymbolicConstant specifying the location used for shell layer values. Possible values are BOTTOM, MAXIMUM, MIDDLE, MINIMUM, and TOP. The default value is MAXIMUM.
stepOperation=SUM¶: A SymbolicConstant specifying the operation used on values across steps and load cases. Possible values are MAXIMUM, MINIMUM, and SUM. The default value is SUM.
stepOptions=None¶: A StepOptionArray object.

shellLayer : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'MAXIMUM'[source]¶: A SymbolicConstant specifying the location used for shell layer values. Possible values are BOTTOM, MAXIMUM, MIDDLE, MINIMUM, and TOP. The default value is MAXIMUM.

stepOperation : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'SUM'[source]¶: A SymbolicConstant specifying the operation used on values across steps and load cases. Possible values are MAXIMUM, MINIMUM, and SUM. The default value is SUM.

stepOptions : --is-rst--:py:data:`~typing.Optional`\ \[:py:class:`~typing.List`\ \[:py:class:`~abaqus.Optimization.StepOption.StepOption`]] = None[source]¶: A StepOptionArray object.

class SizingClusterAreas(name, regions)[source]¶

Bases: GeometricRestriction

The SizingClusterAreas object defines a sizing cluster areas geometric restriction. The SizingClusterAreas object is derived from the GeometricRestriction object.

Note

This object can be accessed by:

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

Note

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

Member Details:

regions : --is-rst--tuple[source]¶: tuple of Region objects specifying the regions to which the geometric restriction is applied.

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

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

Bases: GeometricRestriction

The SizingCyclicSymmetry object defines a sizing cyclic symmetry geometric restriction. The SizingCyclicSymmetry object is derived from the GeometricRestriction object.

Note

This object can be accessed by:

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

Note

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

Member Details:

axis : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'AXIS_1'[source]¶: A SymbolicConstant specifying the translation direction defined along an axis positioned at the csys origin. Possible values are AXIS_1, AXIS_2, and AXIS_3. The default value is AXIS_1.

csys : --is-rst--:py:class:`int` | :py:obj:`None` = None[source]¶: None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

ignoreFrozenArea : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]¶: A Boolean specifying whether to ignore frozen areas. The default value is OFF.

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

This method modifies the SizingCyclicSymmetry object.

Note

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

Parameters:¶

axis=AXIS_1¶: A SymbolicConstant specifying the translation direction defined along an axis positioned at the csys origin. Possible values are AXIS_1, AXIS_2, and AXIS_3. The default value is AXIS_1.
csys=None¶: None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.
ignoreFrozenArea=0¶: A Boolean specifying whether to ignore frozen areas. The default value is OFF.

translation : --is-rst--:py:class:`float`[source]¶: A Float specifying the translation distance.

class SizingFrozenArea(name, region)[source]¶

Bases: GeometricRestriction

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

Note

This object can be accessed by:

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

Note

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

Member Details:

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

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

Bases: GeometricRestriction

The SizingMemberSize object defines a sizing member size geometric restriction. The SizingMemberSize object is derived from the GeometricRestriction object.

Note

This object can be accessed by:

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

Note

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

Member Details:

minWidth : --is-rst--:py:class:`float`[source]¶: A Float specifying the min width.

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

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

Bases: GeometricRestriction

The SizingPlanarSymmetry object defines a sizing planar symmetry geometric restriction. The SizingPlanarSymmetry object is derived from the GeometricRestriction object.

Note

This object can be accessed by:

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

Note

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

Member Details:

axis : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'AXIS_1'[source]¶: A SymbolicConstant specifying the axis of symmetry. Possible values are AXIS_1, AXIS_2, and AXIS_3. The default value is AXIS_1.

csys : --is-rst--:py:class:`int` | :py:obj:`None` = None[source]¶: None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

ignoreFrozenArea : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]¶: A Boolean specifying whether to ignore frozen areas. The default value is OFF.

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

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

Bases: GeometricRestriction

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

Note

This object can be accessed by:

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

Note

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

Member Details:

csys : --is-rst--:py:class:`int` | :py:obj:`None` = None[source]¶: None or a DatumCsys object specifying the position of the symmetry point defined as the origin of a local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

ignoreFrozenArea : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]¶: A Boolean specifying whether to ignore frozen areas. The default value is OFF.

setValues(csys=None, ignoreFrozenArea=0)[source]¶

This method modifies the SizingPointSymmetry object.

Note

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

Parameters:¶

csys=None¶: None or a DatumCsys object specifying the position of the symmetry point defined as the origin of a local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.
ignoreFrozenArea=0¶: A Boolean specifying whether to ignore frozen areas. The default value is OFF.

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

Bases: GeometricRestriction

The SizingRotationalSymmetry object defines a sizing rotational symmetry geometric restriction. The SizingRotationalSymmetry object is derived from the GeometricRestriction object.

Note

This object can be accessed by:

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

Note

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

Member Details:

angle : --is-rst--:py:class:`float`[source]¶: A Float specifying the repeating segment size, an angle in degrees.

axis : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'AXIS_1'[source]¶: A SymbolicConstant specifying the axis of symmetry. Possible values are AXIS_1, AXIS_2, and AXIS_3. The default value is AXIS_1.

csys : --is-rst--:py:class:`int` | :py:obj:`None` = None[source]¶: None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

ignoreFrozenArea : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]¶: A Boolean specifying whether to ignore frozen areas. The default value is OFF.

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

This method modifies the SizingRotationalSymmetry object.

Note

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

Parameters:¶

axis=AXIS_1¶: A SymbolicConstant specifying the axis of symmetry. Possible values are AXIS_1, AXIS_2, and AXIS_3. The default value is AXIS_1.
csys=None¶: None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.
ignoreFrozenArea=0¶: A Boolean specifying whether to ignore frozen areas. The default value is OFF.

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

Bases: GeometricRestriction

The SlideRegionControl object defines a slide region control geometric restriction. The SlideRegionControl object is derived from the GeometricRestriction object.

Note

This object can be accessed by:

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

Note

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

Member Details:

approach : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'FREE_FORM'[source]¶: A SymbolicConstant specifying the restriction approach. The SymbolicConstant FREE_FORM indicates a free-form slide region, and the SymbolicConstant TURN indicates that the restriction should conserve a turnable surface. Possible values are FREE_FORM and TURN. The default value is FREE_FORM.

clientDirection : --is-rst--:py:class:`tuple`[source]¶: A VertexArray object of length 2 specifying the axis of revolution. Instead of through a ConstrainedSketchVertex, each point may be specified through a tuple of coordinates. This is used when approach is TURN.

csys : --is-rst--:py:class:`int` | :py:obj:`None` = None[source]¶: None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. This is used when approach is TURN. The default value is None.

freeFormRegion : --is-rst--:py:class:`str` | :py:obj:`None` = None[source]¶: None or a Region object specifying the free-form region. This is used when approach is FREE_FORM. The default value is None.

presumeFeasibleRegionAtStart : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 1[source]¶: A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.

revolvedRegion : --is-rst--:py:class:`str` | :py:obj:`None` = None[source]¶: None or a Region object specifying the region to revolve into a slide region. This is used when approach is TURN. The default value is None.

setValues( approach=FREE_FORM, csys=None, freeFormRegion=None, presumeFeasibleRegionAtStart=1, revolvedRegion=None, tolerance1=0, tolerance2=0, tolerance3=0, )[source]¶

This method modifies the SlideRegionControl object.

Note

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

Parameters:¶

approach=FREE_FORM¶: A SymbolicConstant specifying the restriction approach. The SymbolicConstant FREE_FORM indicates a free-form slide region, and the SymbolicConstant TURN indicates that the restriction should conserve a turnable surface. Possible values are FREE_FORM and TURN. The default value is FREE_FORM.
csys=None¶: None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. This is used when approach is TURN. The default value is None.
freeFormRegion=None¶: None or a Region object specifying the free-form region. This is used when approach is FREE_FORM. The default value is None.
presumeFeasibleRegionAtStart=1¶: A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.
revolvedRegion=None¶: None or a Region object specifying the region to revolve into a slide region. This is used when approach is TURN. The default value is None.
tolerance1=0¶: A Float specifying the geometric tolerance in the 1-direction. This is used when approach is TURN. The default value is 0.01.
tolerance2=0¶: A Float specifying the geometric tolerance in the 2-direction. This is used when approach is TURN. The default value is 0.01.
tolerance3=0¶: A Float specifying the geometric tolerance in the 3-direction. This is used when approach is TURN. The default value is 0.01.

tolerance1 : --is-rst--:py:class:`float` = 0[source]¶: A Float specifying the geometric tolerance in the 1-direction. This is used when approach is TURN. The default value is 0.01.

tolerance2 : --is-rst--:py:class:`float` = 0[source]¶: A Float specifying the geometric tolerance in the 2-direction. This is used when approach is TURN. The default value is 0.01.

tolerance3 : --is-rst--:py:class:`float` = 0[source]¶: A Float specifying the geometric tolerance in the 3-direction. This is used when approach is TURN. The default value is 0.01.

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

Bases: GeometricRestriction

The StampControl object defines a stamp control geometric restriction. The StampControl object is derived from the GeometricRestriction object.

Note

This object can be accessed by:

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

Note

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

Member Details:

clientDirection : --is-rst--:py:class:`tuple`[source]¶: A VertexArray object of length 2 specifying the stamping direction. Instead of through a ConstrainedSketchVertex, each point may be specified through a tuple of coordinates.

csys : --is-rst--:py:class:`int` | :py:obj:`None` = None[source]¶: None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

drawAngle : --is-rst--:py:class:`float` = 0[source]¶: A Float specifying the draw angle. The default value is 0.0.

mainPoint : --is-rst--:py:class:`str` | :py:obj:`None` = None[source]¶: None or a Region object specifying the main point used when mainPointDetermination is SPECIFY. The default value is None.

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

mainPointDetermination : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'MAXIMUM'[source]¶: A SymbolicConstant specifying the rule for assigning point priority. Possible values are MAXIMUM, MINIMUM, and SPECIFY. The default value is MAXIMUM.

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

presumeFeasibleRegionAtStart : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 1[source]¶: A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.

This method modifies the StampControl object.

Note

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

Parameters:¶

csys=None¶

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

drawAngle=0¶

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

mainPoint=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=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=1¶

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

tolerance1=0¶

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

tolerance2=0¶

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

tolerance3=0¶

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

undercutTolerance=0¶

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

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

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

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

undercutTolerance : --is-rst--:py:class:`float` = 0[source]¶: A Float specifying the undercut tolerance. The default value is 0.0.

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

Bases: GeometricRestriction

The TopologyCyclicSymmetry object defines a topology cyclic symmetry geometric restriction. The TopologyCyclicSymmetry object is derived from the GeometricRestriction object.

Note

This object can be accessed by:

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

Note

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

Member Details:

axis : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'AXIS_1'[source]¶: A SymbolicConstant specifying the translation direction defined along an axis positioned at the csys origin. Possible values are AXIS_1, AXIS_2, and AXIS_3. The default value is AXIS_1.

csys : --is-rst--:py:class:`int` | :py:obj:`None` = None[source]¶: None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

ignoreFrozenArea : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]¶: A Boolean specifying whether to ignore frozen areas. The default value is OFF.

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

This method modifies the TopologyCyclicSymmetry object.

Note

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

Parameters:¶

axis=AXIS_1¶: A SymbolicConstant specifying the translation direction defined along an axis positioned at the csys origin. Possible values are AXIS_1, AXIS_2, and AXIS_3. The default value is AXIS_1.
csys=None¶: None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.
ignoreFrozenArea=0¶: A Boolean specifying whether to ignore frozen areas. The default value is OFF.

translation : --is-rst--:py:class:`float`[source]¶: A Float specifying the translation distance.

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

Bases: GeometricRestriction

The TopologyDemoldControl object defines a topology demold control geometric restriction. The TopologyDemoldControl object is derived from the GeometricRestriction object.

Note

This object can be accessed by:

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

Note

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

Member Details:

collisionCheckRegion : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'DEMOLD_REGION'[source]¶: The SymbolicConstant DEMOLD_REGION or a Region object specifying the collision check region. If the value is DEMOLD_REGION, then the value of region is used as both the demold region and the collision check region. The default value is DEMOLD_REGION.

csys : --is-rst--:py:class:`int` | :py:obj:`None` = None[source]¶: None or a DatumCsys object specifying the local coordinate system of the pullDirection. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int indicating the identifier of the DatumCsys. The default value is None.

draftAngle : --is-rst--:py:class:`float` = 0[source]¶: A Float specifying the draft angle. The default value is 0.0.

pointRegion : --is-rst--:py:class:`~abaqus.Region.Region.Region` | :py:obj:`None` = None[source]¶: A Region object specifying the point on a plane perpendicular to the pull direction, used to specify the central plane when technique is POINT.

pullDirection : --is-rst--:py:class:`tuple` = ()[source]¶: A VertexArray object of length 2 specifying the demold pull direction. Instead of through a ConstrainedSketchVertex, each point may be specified through a tuple of coordinates.

setValues( csys=None, draftAngle=0, collisionCheckRegion=DEMOLD_REGION, pointRegion=None, pullDirection=(), technique=AUTO, )[source]¶

This method modifies the TopologyDemoldControl object.

Note

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

Parameters:¶

csys=None¶: None or a DatumCsys object specifying the local coordinate system of the pullDirection. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int indicating the identifier of the DatumCsys. The default value is None.
draftAngle=0¶: A Float specifying the draft angle. The default value is 0.0.
collisionCheckRegion=DEMOLD_REGION¶: The SymbolicConstant DEMOLD_REGION or a Region object specifying the collision check region. If the value is DEMOLD_REGION, then the value of region is used as both the demold region and the collision check region. The default value is DEMOLD_REGION.
pointRegion=None¶: A Region object specifying the point on a plane perpendicular to the pull direction, used to specify the central plane when technique is POINT.
pullDirection=()¶: A VertexArray object of length 2 specifying the demold pull direction. Instead of through a ConstrainedSketchVertex, each point may be specified through a tuple of coordinates.
technique=AUTO¶: A SymbolicConstant specifying the demold technique. Possible values are AUTO, AUTO_TIGHT, POINT, SURFACE, and STAMP. The default value is AUTO.

technique : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'AUTO'[source]¶: A SymbolicConstant specifying the demold technique. Possible values are AUTO, AUTO_TIGHT, POINT, SURFACE, and STAMP. The default value is AUTO.

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

Bases: GeometricRestriction

The TopologyMemberSize object defines a topology member size geometric restriction. The TopologyMemberSize object is derived from the GeometricRestriction object.

Note

This object can be accessed by:

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

Note

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

Member Details:

maxThickness : --is-rst--:py:class:`float` = 0[source]¶: A Float specifying the maximum thickness. The default value is 0.0.

minThickness : --is-rst--:py:class:`float` = 0[source]¶: A Float specifying the minimum thickness. The default value is 0.0.

separation : --is-rst--:py:class:`float` = 0[source]¶: A Float specifying the minimum gap. The default value is 0.0.

setValues( maxThickness=0, minThickness=0, separation=0, sizeRestriction=MINIMUM, )[source]¶

This method modifies the TopologyMemberSize object.

Note

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

Parameters:¶

maxThickness=0¶: A Float specifying the maximum thickness. The default value is 0.0.
minThickness=0¶: A Float specifying the minimum thickness. The default value is 0.0.
separation=0¶: A Float specifying the minimum gap. The default value is 0.0.
sizeRestriction=MINIMUM¶: A SymbolicConstant specifying whether to restrict the minimum or maximum thickness or an envelope of both. Possible values are ENVELOPE, MAXIMUM, and MINIMUM. The default value is MINIMUM.

sizeRestriction : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'MINIMUM'[source]¶: A SymbolicConstant specifying whether to restrict the minimum or maximum thickness or an envelope of both. Possible values are ENVELOPE, MAXIMUM, and MINIMUM. The default value is MINIMUM.

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

Bases: GeometricRestriction

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]

Added in version 2022: The TopologyMillingControl class was added.

Note

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

Member Details:

csys : --is-rst--:py:class:`int` | :py:obj:`None` = 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 : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.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 : --is-rst--:py:class:`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 : --is-rst--:py:class:`float` | :py:obj:`None` = 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=MILLING_REGION, radius=None, )[source]¶

This method modifies the TopologyMillingControl object.

Note

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

Parameters:¶

csys=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=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=None¶: A Float specifying the radius for the collision check during the removal of the elements for the milling criteria.

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

Bases: GeometricRestriction

The TopologyOverhangControl object defines a topology overhang control geometric restriction. The TopologyOverhangControl object is derived from the GeometricRestriction object.

Note

This object can be accessed by:

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

Added in version 2019: The TopologyOverhangControl class was added.

Note

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

Member Details:

setValues( csys=None, draftAngle=45, overhangCheckRegion=OVERHANG_REGION, pointRegion=<abaqus.Region.Region.Region object>, radius=None, technique=AUTO, )[source]¶

This method modifies the TopologyOverhangControl object.

Note

Check TopologyOverhangControl.setValues on help.3ds.com/2023.

Parameters:¶

csys : int | None, 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 : Literal[OVERHANG_REGION], 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 0x7ff713482290>: 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 : float | None, 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 : Literal[POINT, NONE, AUTO], 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.

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

Bases: GeometricRestriction

The TopologyPlanarSymmetry object defines a topology planar symmetry geometric restriction. The TopologyPlanarSymmetry object is derived from the GeometricRestriction object.

Note

This object can be accessed by:

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

Note

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

Member Details:

axis : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'AXIS_1'[source]¶: A SymbolicConstant specifying the axis of symmetry. Possible values are AXIS_1, AXIS_2, and AXIS_3. The default value is AXIS_1.

csys : --is-rst--:py:class:`int` | :py:obj:`None` = None[source]¶: None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

ignoreFrozenArea : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]¶: A Boolean specifying whether to ignore frozen areas. The default value is OFF.

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

This method modifies the TopologyPlanarSymmetry object.

Note

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

Parameters:¶

axis=AXIS_1¶: A SymbolicConstant specifying the axis of symmetry. Possible values are AXIS_1, AXIS_2, and AXIS_3. The default value is AXIS_1.
csys=None¶: None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.
ignoreFrozenArea=0¶: A Boolean specifying whether to ignore frozen areas. The default value is OFF.

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

Bases: GeometricRestriction

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

Note

This object can be accessed by:

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

Note

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

Member Details:

csys : --is-rst--:py:class:`int` | :py:obj:`None` = None[source]¶: None or a DatumCsys object specifying the position of the symmetry point defined as the origin of a local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

ignoreFrozenArea : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]¶: A Boolean specifying whether to ignore frozen areas. The default value is OFF.

setValues(csys=None, ignoreFrozenArea=0)[source]¶

This method modifies the TopologyPointSymmetry object.

Note

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

Parameters:¶

csys=None¶: None or a DatumCsys object specifying the position of the symmetry point defined as the origin of a local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.
ignoreFrozenArea=0¶: A Boolean specifying whether to ignore frozen areas. The default value is OFF.

class TopologyRibDesign( name, ribDirection, ribThickness, ribDistance, region, csys=None, ribDesignCheckRegion=RIBDESIGN_REGION, )[source]¶

Bases: GeometricRestriction

The TopologyRibDesign object defines a topology rib design geometric restriction. The TopologyRibDesign object is derived from the GeometricRestriction object.

Note

This object can be accessed by:

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

Added in version 2023: The TopologyRibDesign class was added.

Note

Check TopologyRibDesign on help.3ds.com/2023.

Member Details:

csys : --is-rst--:py:class:`~abaqus.Datum.DatumCsys.DatumCsys` | :py:obj:`None` = <abaqus.Datum.DatumCsys.DatumCsys object>[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.

ribDesignCheckRegion : --is-rst--:py:data:`~typing.Union`\ \[:py:data:`~typing.Literal`\ \[``RIBDESIGN_REGION``], :py:class:`~abaqus.Region.Region.Region`] = 'RIBDESIGN_REGION'[source]¶: The SymbolicConstant RIBDESIGN_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 RIBDESIGN_REGION.

ribDirection : --is-rst--:py:class:`~abaqus.BasicGeometry.VertexArray.VertexArray`[source]¶: A VertexArray object of length 2 specifying the out-of-plane growth direction of the ribs. Instead of through a Vertex, each point can be specified through a tuple of coordinates.

ribDistance : --is-rst--:py:class:`float`[source]¶: A Float specifying the average distance between the rib centers. The distance must be larger than twice the average element edge length.

ribThickness : --is-rst--:py:class:`float`[source]¶: A Float specifying the average thickness of the ribs.

setValues( ribDirection, ribThickness, ribDistance, region, csys=None, ribDesignCheckRegion=RIBDESIGN_REGION, )[source]¶

This method modifies the TopologyRibDesign object.

Note

Check TopologyRibDesign.setValues on help.3ds.com/2023.

Parameters:¶

ribDirection¶: A VertexArray object of length 2 specifying the out-of-plane growth direction of the ribs. Instead of through a Vertex, each point can be specified through a tuple of coordinates.
ribThickness¶: A Float specifying the average thickness of the ribs.
ribDistance¶: A Float specifying the average distance between the rib centers. The distance must be larger than twice the average element edge length.
region¶: A Region object specifying the region to which the geometric restriction is applied. When used with a TopologyTask, there is no default value. When used with a ShapeTask, the default value is MODEL.
csys=None¶: None or a DatumCsys object specifying the position of the symmetry point defined as the origin of a local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.
ribDesignCheckRegion=RIBDESIGN_REGION¶: The SymbolicConstant RIBDESIGN_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 RIBDESIGN_REGION.

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

Bases: GeometricRestriction

The TopologyRotationalSymmetry object defines a topology rotational symmetry geometric restriction. The TopologyRotationalSymmetry object is derived from the GeometricRestriction object.

Note

This object can be accessed by:

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

Note

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

Member Details:

angle : --is-rst--:py:class:`float`[source]¶: A Float specifying the repeating segment size, an angle in degrees.

axis : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'AXIS_1'[source]¶: A SymbolicConstant specifying the axis of symmetry. Possible values are AXIS_1, AXIS_2, and AXIS_3. The default value is AXIS_1.

csys : --is-rst--:py:class:`int` | :py:obj:`None` = None[source]¶: None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

ignoreFrozenArea : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]¶: A Boolean specifying whether to ignore frozen areas. The default value is OFF.

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

This method modifies the TopologyRotationalSymmetry object.

Note

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

Parameters:¶

axis=AXIS_1¶: A SymbolicConstant specifying the axis of symmetry. Possible values are AXIS_1, AXIS_2, and AXIS_3. The default value is AXIS_1.
csys=None¶: None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.
ignoreFrozenArea=0¶: A Boolean specifying whether to ignore frozen areas. The default value is OFF.

class TurnControl( name, clientDirection, region, csys=None, mainPoint=None, mainPointDetermination=MAXIMUM, presumeFeasibleRegionAtStart=1, tolerance1=0, tolerance2=0, tolerance3=0, )[source]¶

Bases: GeometricRestriction

The TurnControl object defines a turn control geometric restriction. The TurnControl object is derived from the GeometricRestriction object.

Note

This object can be accessed by:

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

Note

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

Member Details:

clientDirection : --is-rst--:py:class:`tuple`[source]¶: A VertexArray object of length 2 specifying the direction of the rotation axis as a vector positioned at the csys origin. Instead of through a ConstrainedSketchVertex, each point might be specified through a tuple of coordinates.

csys : --is-rst--:py:class:`int` | :py:obj:`None` = None[source]¶: None or a DatumCsys object specifying the local coordinate system. If csys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

mainPoint : --is-rst--:py:class:`str` | :py:obj:`None` = None[source]¶: None or a Region object specifying the main point used when mainPointDetermination is SPECIFY. The default value is None.

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

mainPointDetermination : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'MAXIMUM'[source]¶: A SymbolicConstant specifying the rule for assigning point priority. Possible values are MAXIMUM, MINIMUM, and SPECIFY. The default value is MAXIMUM.

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

presumeFeasibleRegionAtStart : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 1[source]¶: A Boolean specifying whether to ignore the geometric restriction in the first design cycle. The default value is ON.

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

This method modifies the TurnControl object.

Note

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

Parameters:¶

csys=None¶

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

mainPoint=None¶

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

mainPointDetermination=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=1¶

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

tolerance1=0¶

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

tolerance2=0¶

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

tolerance3=0¶

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

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

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

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

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

Bases: OptimizationTask

The ShapeTask object defines a shape task. The ShapeTask object is derived from the OptimizationTask object.

Note

This object can be accessed by:

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

Note

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

Member Details:

abaqusSensitivities : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = False[source]¶: A Boolean specifying whether to use Abaqus to compute the design responses and their sensitivities. The default value is False.

Added in version 2019: The abaqusSensitivities attribute was added.

absoluteStepSizeControl : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'MINIMUM'[source]¶: A SymbolicConstant specifying whether to control the permitted absolute step size by the average optimization displacement or minimum optimization displacement. Possible values are MINIMUM and AVERAGE. The default value is MINIMUM.

activateDurability : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 1[source]¶: A boolean specifying whether or not the durability approach of optimization is turned on. The default value is ON.

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

constrainedLaplacianConvergenceLevel : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'NORMAL'[source]¶: A SymbolicConstant specifying the constrained Laplacian convergence level. Possible values are NORMAL, CONSERVATIVE, and AGGRESSIVE. The default value is NORMAL.

curvatureSmoothingEdgeLength : --is-rst--:py:class:`float` = 5[source]¶: A Float specifying the edge length for the movement vector. The default value is 5.0.

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

durabilityInputfile : --is-rst--:py:class:`str` = ''[source]¶: A string specifying the path of the input file. Only valid if the activateDurability argument is ON and is a required argument in that case.

durabilitySolver : --is-rst--:py:class:`str` = 'FE_SAFE'[source]¶: A String specifying the type of solver for durability optimization. Possible values are: FE_SAFE, FEMFAT, FALANCS, MSC_FATIGUE, FE_FATIGUE, DESIGN_LIFE, CUSTOM, FEMSITE. The default value is FE_SAFE. Only valid if the activateDurability argument is ON.

equalityConstraintTolerance : --is-rst--:py:class:`float` | :py:obj:`None` = None[source]¶: A Float specifying the equality constraint tolerance. The default value is 10⁻³.

featureRecognitionAngle : --is-rst--:py:class:`float` = 30[source]¶: A Float specifying the mesh smoothing feature recognition angle for edges and corners. The default value is 30.0.

filterExponent : --is-rst--:py:class:`float` = 1[source]¶: A Float specifying the weight depending on the radius, used when filterMaxRadius is specified. The default value is 1.0.

filterMaxRadius : --is-rst--:py:class:`float` | :py:obj:`None` = None[source]¶: None or a Float specifying the maximum influence radius for equivalent stress. The default value is None.

filterRadiusReduction : --is-rst--:py:class:`float` | :py:obj:`None` = None[source]¶: None or a Float specifying the reduction of the radius depending on surface bending, used when filterMaxRadius is specified. The default value is None.

firstCycleDeletedVolumeTechnique : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`, :py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]¶: A SymbolicConstant specifying the method of specifying volume that can be removed immediately in the first design cycle. Possible values are OFF, PERCENTAGE, and ABSOLUTE. The default value is OFF.

freezeBoundaryConditionRegions : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]¶: A Boolean specifying whether to exclude nodes with boundary conditions from the optimization. The default value is OFF.

frozenBoundaryConditionRegion : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'MODEL'[source]¶: The SymbolicConstant MODEL or a Region object specifying the region in which to freeze boundary condition regions, or the SymbolicConstant MODEL, used with freezeBoundaryConditionRegions. The default value is MODEL.

geometricRestrictionEvaluationFrequency : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'LOW'[source]¶: A SymbolicConstant specifying the frequency of evaluating geometric restrictions during mesh smoothing. Possible values are LOW, MEDIUM, and HIGH. The default value is LOW.

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

groupOperator : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]¶: A Boolean specifying whether the group in the design response will be evaluated using the existing algorithm or a new algorithm based on Abaqus sensitivities. The default value of False means that the existing algorithm will be used.

Added in version 2022: The groupSensitivities attribute was added.

growthScaleFactor : --is-rst--:py:class:`float` = 1[source]¶: A Float specifying the scale factor to apply to optimization displacements for nodes with growth. The default value is 1.0.

haltUponViolation : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]¶: A Boolean specifying whether to halt the optimization if quality criteria are not satisified. The default value is OFF.

layerReferenceRegion : --is-rst--:py:class:`str` | :py:obj:`None` = None[source]¶: None or a Region object specifying the region specifying the first node layer for mesh smoothing, used when meshSmoothingRegionMethod is TASK_REGION_LAYERS. The default value is None.

meshSmoothingRegionMethod : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'TASK_REGION_LAYERS'[source]¶: A SymbolicConstant specifying the method used to determine the mesh smoothing region. The REGION value uses the smoothingRegion. The NUMBER_OF_LAYERS value uses the layerReferenceRegion. The TASK_REGION_LAYERS value will smooth six layers using the task region. Possible values are TASK_REGION_LAYERS, REGION, and NUMBER_OF_LAYERS. The default value is TASK_REGION_LAYERS.

meshSmoothingStrategy : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'CONSTRAINED_LAPLACIAN'[source]¶: A SymbolicConstant specifying the method smoothing strategy. Possible values are CONSTRAINED_LAPLACIAN and LOCAL_GRADIENT. The default value is CONSTRAINED_LAPLACIAN.

midsideInterpolation : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'POSITIONS'[source]¶: A SymbolicConstant specifying the approach used when treating midside node positions during optimization. POSITIONS indicates midside node positions are interpolated linearly by position. OPTIMIZATION_DISPLACEMENT indicates they are interpolated by optimization displacement of corner nodes. Possible values are POSITIONS and OPTIMIZATION_DISPLACEMENT. The default value is POSITIONS.

numFreeNodeLayers : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` | :py:class:`int` = 0[source]¶: The SymbolicConstant FIX_NONE or an Int specifying the number of node layers adjoining the task region to remain free during mesh smoothing. A value of 0 indicates that no layers are free and all layers are fixed. The default value is 0.

numSmoothedElementLayers : --is-rst--:py:class:`int` | :py:obj:`None` = None[source]¶: None or an Int specifying the number of layers for mesh smoothing when meshSmoothingRegionMethod is NUMBER_OF_LAYERS. The default value is None.

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

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

presumeFeasibleBCRegionAtStart : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 1[source]¶: A Boolean specifying whether to ignore automatically frozen boundary condition regions in the first design cycle. This is used with freezeBoundaryConditionRegions. The default value is ON.

quadMaxAngle : --is-rst--:py:class:`float` = 160[source]¶: A Float specifying the maximum angle for quad elements during mesh smoothing. The default value is 160.0.

quadMinAngle : --is-rst--:py:class:`float` = 20[source]¶: A Float specifying the minimum angle for quad elements during mesh smoothing. The default value is 20.0.

quadSkew : --is-rst--:py:class:`float` = 30[source]¶: A Float specifying the skew angle for quad elements during mesh smoothing, used with reportQualityViolation. The default value is 30.0.

quadTaper : --is-rst--:py:class:`float` = 0[source]¶: A Float specifying the taper for quad elements during mesh smoothing, used with reportQualityViolation. The default value is 0.5.

region : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'MODEL'[source]¶: The SymbolicConstant MODEL or a Region object specifying the region to which the optimization task is applied. The default value is MODEL.

reportPoorQualityElements : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]¶: A Boolean specifying whether to report poor quality elements during mesh smoothing. The default value is OFF.

reportQualityViolation : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]¶: A Boolean specifying whether to report a quality criteria violation during mesh smoothing. The default value is OFF.

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

This method modifies the ShapeTask object.

Note

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

Parameters:¶

abaqusSensitivities=True¶

A Boolean specifying whether to use Abaqus to compute the design responses and their sensitivities. The default value is True.

Added in version 2019: The abaqusSensitivities argument was added.

absoluteStepSizeControl=MINIMUM¶

activateDurability=1¶

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

additionalDurabilityFiles=''¶

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

algorithm=CONDITION_BASED_OPTIMIZATION¶

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

constrainedLaplacianConvergenceLevel=NORMAL¶

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

curvatureSmoothingEdgeLength=5¶

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

durabilityInputfile=''¶

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

durabilitySolver=FE_SAFE¶

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

equalityConstraintTolerance=None¶

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

featureRecognitionAngle=30¶

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

filterExponent=1¶

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

filterMaxRadius=None¶

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

filterRadiusReduction=None¶

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

firstCycleDeletedVolumeTechnique=0¶

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

freezeBoundaryConditionRegions=0¶

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

frozenBoundaryConditionRegion=MODEL¶

geometricRestrictionEvaluationFrequency=LOW¶

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

growthScaleFactor=1¶

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

haltUponViolation=0¶

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

layerReferenceRegion=None¶

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

meshSmoothingRegionMethod=TASK_REGION_LAYERS¶

meshSmoothingStrategy=CONSTRAINED_LAPLACIAN¶

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

midsideInterpolation=POSITIONS¶

numFreeNodeLayers=0¶

numSmoothedElementLayers=None¶

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

presumeFeasibleBCRegionAtStart=1¶

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

quadMaxAngle=160¶

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

quadMinAngle=20¶

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

quadSkew=30¶

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

quadTaper=0¶

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

region=MODEL¶

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

reportPoorQualityElements=0¶

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

reportQualityViolation=0¶

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

shrinkScaleFactor=1¶

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

smoothingRegion=None¶

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

targetMeshQuality=LOW¶

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

tetAspectRatio=100¶

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

tetMaxAspect=8¶

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

tetMinAspect=0¶

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

tetSkew=100¶

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

triMaxAngle=140¶

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

triMinAngle=20¶

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

updateShapeBasisVectors=EVERY_CYCLE¶

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

groupOperator=0¶

Added in version 2022: The groupOperator argument was added.

shrinkScaleFactor : --is-rst--:py:class:`float` = 1[source]¶: A Float specifying the scale factor to apply to optimization displacements for nodes with shrinkage. The default value is 1.0.

smoothingRegion : --is-rst--:py:class:`str` | :py:obj:`None` = None[source]¶: None or a Region object specifying the mesh smoothing region, used when meshSmoothingRegionMethod is REGION. The default value is None.

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

targetMeshQuality : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'LOW'[source]¶: A SymbolicConstant specifying the target mesh quality for mesh smoothing. Possible values are NONE, LOW, MEDIUM, and HIGH. The default value is LOW.

tetAspectRatio : --is-rst--:py:class:`float` = 100[source]¶: A Float specifying the tet element aspect ratio during mesh smoothing. The default value is 100.0.

tetMaxAspect : --is-rst--:py:class:`float` = 8[source]¶: A Float specifying the maximum tet element aspect ratio during mesh smoothing. The default value is 8.0.

tetMinAspect : --is-rst--:py:class:`float` = 0[source]¶: A Float specifying the minimum tet element aspect ratio during mesh smoothing. The default value is 0.222.

tetSkew : --is-rst--:py:class:`float` = 100[source]¶: A Float specifying the tet element skew value during mesh smoothing. The default value is 100.0.

triMaxAngle : --is-rst--:py:class:`float` = 140[source]¶: A Float specifying the tri element maximum angle during mesh smoothing. The default value is 140.0.

triMinAngle : --is-rst--:py:class:`float` = 20[source]¶: A Float specifying the tri element maximum angle during mesh smoothing. The default value is 20.0.

updateShapeBasisVectors : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'EVERY_CYCLE'[source]¶: A SymbolicConstant specifying whether to update shape basis vectors in the first design cycle or every design cycle. Possible values are EVERY_CYCLE and FIRST_CYCLE. The default value is EVERY_CYCLE.

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

Bases: OptimizationTask

The SizingTask object defines a Sizing task. The SizingTask object is derived from the OptimizationTask object.

Note

This object can be accessed by:

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

Note

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

Member Details:

abaqusSensitivities : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = False[source]¶: A Boolean specifying whether to use Abaqus to compute the design responses and their sensitivities. The default value is False.

Added in version 2019: The abaqusSensitivities attribute was added.

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

elementThicknessDeltaStopCriteria : --is-rst--:py:class:`float` = 0[source]¶: A Float specifying the stop criteria based on the change in element thickness. The default value is 0.5 x 10⁻².

freezeBoundaryConditionRegions : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]¶: A Boolean specifying whether to exclude elements with boundary conditions from the optimization. The default value is OFF.

freezeLoadRegions : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 1[source]¶: A Boolean specifying whether to exclude elements with loads and elements with loaded nodes from the optimization. The default value is ON.

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

groupOperator : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]¶: A Boolean specifying whether the group in the design response will be evaluated using the existing algorithm or a new algorithm based on Abaqus sensitivities. The default value of False means that the existing algorithm will be used.

Added in version 2022: The groupSensitivities attribute was added.

modeTrackingRegion : --is-rst--:py:class:`str` = 'MODEL'[source]¶: The SymbolicConstatnt MODEL or a Region object specifying the region to use for mode tracking. The default value is MODEL.

numFulfilledStopCriteria : --is-rst--:py:class:`int` = 2[source]¶: An Int specifying the number of stop criteria. The default value is 2.

numTrackedModes : --is-rst--:py:class:`int` = 5[source]¶: An Int specifying the number of modes included in mode tracking. The default value is 5.

objectiveFunctionDeltaStopCriteria : --is-rst--:py:class:`float` = 0[source]¶: A Float specifying the stop criteria based on the change in objective function. The default value is 0.001.

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

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

setValues( abaqusSensitivities=True, elementThicknessDeltaStopCriteria=0, freezeBoundaryConditionRegions=0, freezeLoadRegions=1, modeTrackingRegion=MODEL, numFulfilledStopCriteria=2, numTrackedModes=5, objectiveFunctionDeltaStopCriteria=0, stopCriteriaDesignCycle=4, thicknessMoveLimit=0, thicknessUpdateStrategy=NORMAL, groupOperator=0, )[source]¶

This method modifies the SizingTask object.

Note

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

Parameters:¶

abaqusSensitivities=True¶

A Boolean specifying whether to use Abaqus to compute the design responses and their sensitivities. The default value is True.

Added in version 2019: The abaqusSensitivities argument was added.

elementThicknessDeltaStopCriteria=0¶

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

freezeBoundaryConditionRegions=0¶

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

freezeLoadRegions=1¶

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

modeTrackingRegion=MODEL¶

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

numFulfilledStopCriteria=2¶

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

numTrackedModes=5¶

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

objectiveFunctionDeltaStopCriteria=0¶

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

stopCriteriaDesignCycle=4¶

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

thicknessMoveLimit=0¶

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

thicknessUpdateStrategy=NORMAL¶

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

groupOperator=0¶

Added in version 2022: The groupOperator argument was added.

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

stopCriteriaDesignCycle : --is-rst--:py:class:`int` = 4[source]¶: An Int specifying the first design cycle used to evaluate convergence criteria. The default value is 4.

thicknessMoveLimit : --is-rst--:py:class:`float` = 0[source]¶: A Float specifying the maximum change in thickness per design cycle. The default value is 0.25.

thicknessUpdateStrategy : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'NORMAL'[source]¶: A SymbolicConstant specifying the strategy for how the thickness is updated in the method of moving asymptotes. Possible values are NORMAL, CONSERVATIVE, and AGGRESSIVE. The default value is NORMAL.

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

Bases: OptimizationTask

The TopologyTask object defines a topology task. The TopologyTask object is derived from the OptimizationTask object.

Note

This object can be accessed by:

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

Note

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

Member Details:

abaqusSensitivities : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = False[source]¶: A Boolean specifying whether to use Abaqus to compute the design responses and their sensitivities. The default value is False.

Added in version 2019: The abaqusSensitivities attribute was added.

algorithm : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'GENERAL_OPTIMIZATION'[source]¶: A SymbolicConstant specifying the optimization task algorithm. Possible values are GENERAL_OPTIMIZATION and CONDITION_BASED_OPTIMIZATION. The default value is GENERAL_OPTIMIZATION.

densityMoveLimit : --is-rst--:py:class:`float` = 0[source]¶: A Float specifying the maximum density change per design cycle. The default value is 0.25.

densityUpdateStrategy : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'NORMAL'[source]¶: A SymbolicConstant specifying the strategy for how the densities are updated in the method of moving asymptotes. Possible values are NORMAL, CONSERVATIVE, and AGGRESSIVE. The default value is NORMAL.

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

elementDensityDeltaStopCriteria : --is-rst--:py:class:`float` = 0[source]¶: A Float specifying the stop criteria based upon the change in element densities. The default value is 0.5x10⁻².

filterRadius : --is-rst--:py:class:`float` | :py:obj:`None` = None[source]¶: None or a Float specifying the mesh filter radius for mesh independence and minimum size. The default value is None.

firstCycleDeletedVolume : --is-rst--:py:class:`float` = 5[source]¶: A Float specifying the volume that can be removed immediately in the first design cycle. The default value is 5.0.

firstCycleDeletedVolumeTechnique : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`, :py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]¶: A SymbolicConstant specifying the method of quantifying volume that can be removed immediately in the first design cycle. Possible values are OFF, PERCENTAGE, and ABSOLUTE. The default value is OFF.

freezeBoundaryConditionRegions : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]¶: A Boolean specifying whether to exclude elements with boundary conditions from the optimization. The default value is OFF.

freezeLoadRegions : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 1[source]¶: A Boolean specifying whether to exclude elements with loads and elements with loaded nodes from the optimization. The default value is ON.

frequencySpectrumWeight : --is-rst--:py:class:`float` = 6[source]¶: A Float specifying the weighting factor for frequency spectrum peaks. The default value is 6.0.

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

groupOperator : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]¶: A Boolean specifying whether the group in the design response will be evaluated using the existing algorithm or a new algorithm based on Abaqus sensitivities. The default value of False means that the existing algorithm will be used.

Added in version 2022: The groupSensitivities attribute was added.

initialDensity : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'DEFAULT'[source]¶: A SymbolicConstant specifying the Optimization product default or a float specifying the initial density. The default value is DEFAULT.

materialInterpolationPenalty : --is-rst--:py:class:`float` = 3[source]¶: A Float specifying the penalty factor for the material interpolation technique. The default value is 3.0.

materialInterpolationTechnique : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'DEFAULT'[source]¶

optimization product default, solid isotropic material with penalization, or rational approximation of material properties. Possible values are DEFAULT, SIMP, and RAMP. The default value is DEFAULT.

Type:¶: A SymbolicConstant specifying the material interpolation technique

maxDensity : --is-rst--:py:class:`float` = 1[source]¶: A Float specifying the maximum density in the density update. The default value is 1.0.

minDensity : --is-rst--:py:class:`float` | :py:obj:`None` = None[source]¶: A Float specifying the minimum density in the density update. The default value is 10⁻³.

modeTrackingRegion : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'MODEL'[source]¶: The SymbolicConstant MODEL or a Region object specifying the region to use for mode tracking. The default value is MODEL.

numDesignCycles : --is-rst--:py:class:`int` = 15[source]¶: An Int specifying the number of design cycles permitted when stepSize is DYNAMIC. The default value is 15.

numFulfilledStopCriteria : --is-rst--:py:class:`int` = 2[source]¶: An Int specifying the number of stop criteria. The default value is 2.

numTrackedModes : --is-rst--:py:class:`int` = 5[source]¶: An Int specifying the number of modes included in mode tracking. The default value is 5.

objectiveFunctionDeltaStopCriteria : --is-rst--:py:class:`float` | :py:obj:`None` = None[source]¶: A Float specifying the stop criteria based on the change in objective function. The default value is 10⁻³.

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

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

region : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'MODEL'[source]¶: The SymbolicConstant MODEL or a Region object specifying the region to which the optimization task is applied. The default value is MODEL.

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

This method modifies the TopologyTask object.

Note

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

Parameters:¶

abaqusSensitivities=True¶

A Boolean specifying whether to use Abaqus to compute the design responses and their sensitivities. The default value is True.

Added in version 2019: The abaqusSensitivities argument was added.

algorithm=GENERAL_OPTIMIZATION¶

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

densityMoveLimit=0¶

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

densityUpdateStrategy=NORMAL¶

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

elementDensityDeltaStopCriteria=0¶

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

filterRadius=None¶

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

firstCycleDeletedVolume=5¶

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

firstCycleDeletedVolumeTechnique=0¶

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

freezeBoundaryConditionRegions=0¶

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

freezeLoadRegions=1¶

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

frequencySpectrumWeight=6¶

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

initialDensity=DEFAULT¶

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

materialInterpolationPenalty=3¶

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

materialInterpolationTechnique=DEFAULT¶

maxDensity=1¶

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

minDensity=None¶

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

modeTrackingRegion=MODEL¶

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

numDesignCycles=15¶

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

numFulfilledStopCriteria=2¶

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

numTrackedModes=5¶

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

objectiveFunctionDeltaStopCriteria=None¶

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

region=MODEL¶

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

softDeletionMethod=STANDARD¶

softDeletionRadius=0¶

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

softDeletionRegion=None¶

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

softDeletionThreshold=None¶

stepSize=MEDIUM¶

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

stiffnessMassDamping=AVERAGE_EDGE_LENGTH¶

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

stopCriteriaDesignCycle=4¶

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

structuralMassDamping=None¶

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

viscousMassDamping=None¶

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

viscousStiffnessDamping=None¶

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

groupOperator=0¶

Added in version 2022: The groupOperator argument was added.

softDeletionMethod : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'STANDARD'[source]¶: A SymbolicConstant specifying the method used when softDeletionRegion is specified. The STANDARD method avoids creating disconnected regions. The AGGRESSIVE method only considers the softDeletionThreshold. The MAX_SHEAR_STRAIN, MAX_ELASTOPLASTIC_STRAIN and VOLUME_COMPRESSION methods do not need the softDeletionRadius. Possible values are STANDARD, AGGRESSIVE, MAX_SHEAR_STRAIN, MIN_PRINCIPAL_STRAIN, MAX_ELASTOPLASTIC_STRAIN and VOLUME_COMPRESSION. The default value is STANDARD.

softDeletionRadius : --is-rst--:py:class:`float` = 0[source]¶: A Float specifying the radius to use when considering neighboring soft elements to delete. The default value is 0.0.

softDeletionRegion : --is-rst--:py:class:`str` | :py:obj:`None` = None[source]¶: None or a Region object specifying the region in which the soft elements should be deleted during optimization. The default value is None.

softDeletionThreshold : --is-rst--:py:class:`float` | :py:obj:`None` = None[source]¶: A Float specifying the relative material density value used to identify soft elements. Those with values below the threshold are considered for removal. For STANDARD and AGGRESSIVE methods positive values are accepted and the default value is 0.05. For MAX_SHEAR_STRAIN and MAX_ELASTOPLASTIC_STRAIN methods positive values are accepted whereas for MIN_PRINCIPAL_STRAIN and VOLUME_COMPRESSION methods negative values are accepted.

stepSize : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'MEDIUM'[source]¶: A SymbolicConstant specifying the size of the increment for volume modification. Possible values are DYNAMIC, VERY_SMALL, SMALL, MODERATE, MEDIUM, and LARGE. The default value is MEDIUM.

stiffnessMassDamping : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`, :py:class:`float`] = 'AVERAGE_EDGE_LENGTH'[source]¶: The SymbolicConstant AVERAGE_EDGE_LENGTH or a Float specifying the stiffness mass damping for the task region. The default value is AVERAGE_EDGE_LENGTH.

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

stopCriteriaDesignCycle : --is-rst--:py:class:`int` = 4[source]¶: An Int specifying the first design cycle used to evaluate convergence criteria. The default value is 4.

structuralMassDamping : --is-rst--:py:class:`float` | :py:obj:`None` = None[source]¶: None or a Float specifying the structural mass damping for the task region. The default value is None.

viscousMassDamping : --is-rst--:py:class:`float` | :py:obj:`None` = None[source]¶: None or a Float specifying the viscous mass damping for the task region. The default value is None.

viscousStiffnessDamping : --is-rst--:py:class:`float` | :py:obj:`None` = None[source]¶: None or a Float specifying the viscous stiffness damping for the task region. The default value is None.

class StepOption[source]¶

Bases: object

A StepOption is an object used to define step options in a design response.

Note

This object can be accessed by:

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

Note

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

Member Details:

loadCase : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'ALL'[source]¶: The SymbolicConstant ALL or a String specifying the name of the load case. loadCase is ignored when the specified step does not contain a load case. The default value is ALL.

lowerMode : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'ALL'[source]¶: The SymbolicConstant ALL or an Int specifying the lower mode in the range of modes to consider in the step. lowerMode is ignored for steps without modes. The default value is ALL.

model : --is-rst--:py:class:`str` = ''[source]¶: A string specifying the name of the model from which the steps are supposed to be used in the design response. Specify only if the steps are not from the current model.

step : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'ALL'[source]¶: The SymbolicConstant ALL or a String specifying the name of the step. The default value is ALL.

upperMode : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'ALL'[source]¶: The SymbolicConstant ALL or an Int specifying the upper mode in the range of modes to consider in the step. upperMode is ignored for steps without modes. The default value is ALL.