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

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

Notes

This object can be accessed by:

mdb.models[name]

Methods

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.

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

This method creates a BeadTask object.

Parameters:
name

A String specifying the optimization task repository key.

abaqusSensitivities

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

algorithm

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

areBCRegionsFrozen

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

beadIter

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

beadMaxMembraneStress

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

beadMinStress

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

beadPerturbation

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

beadWidth

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

curveSmooth

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

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

filterRadiusBy

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

flipNormalDir

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

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

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

modeTrackingRegion

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

nodalMoveLimit

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

nodeSmooth

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

nodeUpdateStrategy

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

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

updateShapeBasisVectors

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

Returns:
A BeadTask object.

Notes

This function can be accessed by:

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

This method creates a ShapeTask object.

Parameters:
name

A String specifying the optimization task repository key.

abaqusSensitivities

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

absoluteStepSizeControl

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

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

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

constrainedLaplacianConvergenceLevel

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

curvatureSmoothingEdgeLength

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

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

A Float specifying the equality constraint tolerance. The default value is 10–3.

featureRecognitionAngle

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

filterExponent

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

filterMaxRadius

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

filterRadiusReduction

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

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

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

frozenBoundaryConditionRegion

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

geometricRestrictionEvaluationFrequency

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

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

haltUponViolation

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

layerReferenceRegion

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

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

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

midsideInterpolation

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

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 or an Int specifying the number of layers for mesh smoothing when meshSmoothingRegionMethod is NUMBER_OF_LAYERS. The default value is None.

presumeFeasibleBCRegionAtStart

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

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

quadMinAngle

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

quadSkew

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

quadTaper

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

region

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

reportPoorQualityElements

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

reportQualityViolation

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

shrinkScaleFactor

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

smoothingRegion

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

targetMeshQuality

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

tetAspectRatio

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

tetMaxAspect

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

tetMinAspect

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

tetSkew

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

triMaxAngle

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

triMinAngle

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

updateShapeBasisVectors

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

Returns:
A ShapeTask object.

Notes

This function can be accessed by:

mdb.models[name].ShapeTask
SizingTask(name: str, abaqusSensitivities: BooleanType = True, elementThicknessDeltaStopCriteria: float = 0, freezeBoundaryConditionRegions: BooleanType = 0, freezeLoadRegions: BooleanType = 1, modeTrackingRegion: str = 'MODEL', numFulfilledStopCriteria: int = 2, numTrackedModes: int = 5, objectiveFunctionDeltaStopCriteria: float = 0, stopCriteriaDesignCycle: int = 4, thicknessMoveLimit: float = 0, thicknessUpdateStrategy: SymbolicConstantType = 'NORMAL', groupOperator: BooleanType = 0) SizingTask[source]#

This method creates a SizingTask object.

Parameters:
name

A String specifying the optimization task repository key.

abaqusSensitivities

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

elementThicknessDeltaStopCriteria

A Float specifying the stop criteria based on the change in element thickness. The default value is 0.5 × 10–2.

freezeBoundaryConditionRegions

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

freezeLoadRegions

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

modeTrackingRegion

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

numFulfilledStopCriteria

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

numTrackedModes

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

objectiveFunctionDeltaStopCriteria

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

stopCriteriaDesignCycle

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

thicknessMoveLimit

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

thicknessUpdateStrategy

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

Returns:
A SizingTask object.

Notes

This function can be accessed by:

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

This method creates a TopologyTask object.

Parameters:
name

A String specifying the optimization task repository key.

abaqusSensitivities

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

algorithm

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

densityMoveLimit

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

densityUpdateStrategy

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

A Float specifying the stop criteria based upon the change in element densities. The default value is 0.5×10–2.

filterRadius

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

firstCycleDeletedVolume

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

firstCycleDeletedVolumeTechnique

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

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

freezeLoadRegions

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

frequencySpectrumWeight

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

initialDensity

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

materialInterpolationPenalty

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

materialInterpolationTechnique

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

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

minDensity

A Float specifying the minimum density in the density update. The default value is 10–3.

modeTrackingRegion

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

numDesignCycles

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

numFulfilledStopCriteria

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

numTrackedModes

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

objectiveFunctionDeltaStopCriteria

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

region

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

softDeletionMethod

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

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

softDeletionRegion

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

softDeletionThreshold

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

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

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

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

structuralMassDamping

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

viscousMassDamping

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

viscousStiffnessDamping

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

Returns:
A TopologyTask object.

Notes

This function can be accessed by:

mdb.models[name].TopologyTask

Assign features to optimization tasks#

class OptimizationTask[source]#

Methods

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.

ObjectiveFunction(name, objectives[, target])

This method creates an ObjectiveFunction object.

OptimizationConstraint(name, designResponse, ...)

This method creates an OptimizationConstraint 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.

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

This method creates a SingleTermDesignResponse object.

SizingClusterAreas(name, regions)

This method creates a SizingClusterAreas object.

SizingCyclicSymmetry(name, region, translation)

This method creates a SizingCyclicSymmetry object.

SizingFrozenArea(name, region)

This method creates a SizingFrozenArea object.

SizingMemberSize(name, region, minWidth)

This method creates a SizingMemberSize object.

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

This method creates a SizingPlanarSymmetry object.

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

This method creates a SizingPointSymmetry object.

SizingRotationalSymmetry(name, angle, region)

This method creates a SizingRotationalSymmetry object.

SlideRegionControl(name, clientDirection, region)

This method creates a SlideRegionControl object.

StampControl(name, clientDirection, region)

This method creates a StampControl object.

TopologyCyclicSymmetry(name, region, translation)

This method creates a TopologyCyclicSymmetry object.

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

This method creates a TopologyDemoldControl object.

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

This method creates a TopologyMemberSize object.

TopologyMillingControl(name, ...[, csys, ...])

This method creates a TopologyMillingControl object.

TopologyOverhangControl(name, pullDirection, ...)

This method creates a TopologyOverhangControl object.

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

This method creates a TopologyPlanarSymmetry object.

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

This method creates a TopologyPointSymmetry object.

TopologyRotationalSymmetry(name, angle, region)

This method creates a TopologyRotationalSymmetry object.

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

This method creates a TurnControl object.

BeadFixedRegion(name: str, region: Region, csys: int | None = None, u1: BooleanType = 0, u2: BooleanType = 0, u3: BooleanType = 0) BeadFixedRegion[source]#

This method creates a BeadFixedRegion object.

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

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

u2

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

u3

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

Returns:
A BeadFixedRegion object.

Notes

This function can be accessed by:

mdb.models[name].optimizationTasks[name].BeadFixedRegion
BeadGrowth(name: str, region: Region, beadGrowth: float = 0, shrink: float = 0) BeadGrowth[source]#

This method creates a BeadGrowth object.

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

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

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.

Notes

This function can be accessed by:

mdb.models[name].optimizationTasks[name].BeadGrowth
BeadPenetrationCheck(name: str, beadPenetrationCheckRegion: Region, region: Region) BeadPenetrationCheck[source]#

This method creates a BeadPenetrationCheck object.

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.

Notes

This function can be accessed by:

mdb.models[name].optimizationTasks[name].BeadPenetrationCheck
BeadPlanarSymmetry(name: str, region: Region, axis: SymbolicConstantType = 'AXIS_1', csys: int | None = None) BeadPlanarSymmetry[source]#

This method creates a BeadPlanarSymmetry object.

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

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

Notes

This function can be accessed by:

mdb.models[name].optimizationTasks[name].BeadPlanarSymmetry
BeadPointSymmetry(name: str, region: Region, csys: int | None = None) BeadPointSymmetry[source]#

This method creates a BeadPointSymmetry object.

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

Notes

This function can be accessed by:

mdb.models[name].optimizationTasks[name].BeadPointSymmetry
BeadRotationalSymmetry(name: str, angle: float, region: Region, axis: SymbolicConstantType = 'AXIS_1', csys: int | None = None) BeadRotationalSymmetry[source]#

This method creates a BeadRotationalSymmetry object.

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

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

Notes

This function can be accessed by:

mdb.models[name].optimizationTasks[name].BeadRotationalSymmetry
DesignDirection(name: str, region: Region, csys: int | None = None, mainPoint: str | None = None, mainPointDetermination: SymbolicConstantType = 'MAXIMUM', movementRestriction: SymbolicConstantType = 'VECTOR', presumeFeasibleRegionAtStart: BooleanType = 1, u1: BooleanType = 1, u2: BooleanType = 1, u3: BooleanType = 1) DesignDirection[source]#

This method creates a DesignDirection object.

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 or a DatumCsys object specifying the local coordinate system. If *csys*=None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

masterPoint

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

masterPointDetermination

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

movementRestriction

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

presumeFeasibleRegionAtStart

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

u1

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

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

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.

Notes

This function can be accessed by:

mdb.models[name].optimizationTasks[name].DesignDirection
DrillControl(name: str, clientDirection: tuple, region: Region, csys: int | None = None, drawAngle: float = 0, mainPoint: str | None = None, mainPointDetermination: SymbolicConstantType = 'MAXIMUM', presumeFeasibleRegionAtStart: BooleanType = 1, tolerance1: float = 0, tolerance2: float = 0, tolerance3: float = 0, undercutTolerance: float = 0) DrillControl[source]#

This method creates a DrillControl object.

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

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

masterPoint

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

masterPointDetermination

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

presumeFeasibleRegionAtStart

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

tolerance1

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

tolerance2

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

tolerance3

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

undercutTolerance

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

Returns:
A DrillControl object.

Notes

This function can be accessed by:

mdb.models[name].optimizationTasks[name].DrillControl
FixedRegion(name: str, region: Region, csys: int | None = None, presumeFeasibleRegionAtStart: BooleanType = 1, u1: BooleanType = 0, u2: BooleanType = 0, u3: BooleanType = 0) FixedRegion[source]#

This method creates a FixedRegion object.

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

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

u1

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

u2

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

u3

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

Returns:
A FixedRegion object.

Notes

This function can be accessed by:

mdb.models[name].optimizationTasks[name].FixedRegion
FrozenArea(name: str, region: ~abaqus.Region.Region.Region = <abaqus.Region.Region.Region object>) FrozenArea[source]#

This method creates a FrozenArea object.

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.

Returns:
A FrozenArea object.

Notes

This function can be accessed by:

mdb.models[name].optimizationTasks[name].FrozenArea
Growth(name: str, region: Region, growth: float = 0, presumeFeasibleRegionAtStart: BooleanType = 1, shrink: float = 0) Growth[source]#

This method creates a Growth object.

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

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

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

shrink

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.

Notes

This function can be accessed by:

mdb.models[name].optimizationTasks[name].Growth
ObjectiveFunction(name: str, objectives: OptimizationObjectiveArray, target: SymbolicConstantType = 'MINIMIZE') ObjectiveFunction[source]#

This method creates an ObjectiveFunction object.

Parameters:
name

A String specifying the objective function repository key.

objectives

An OptimizationObjectiveArray object.

target

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.
Raises:
InvalidNameError
RangeError

Notes

This function can be accessed by:

mdb.models[name].optimizationTasks[name].ObjectiveFunction
OptimizationConstraint(name: str, designResponse: str, restrictionValue: float, restrictionMethod: SymbolicConstantType = 'ABSOLUTE_EQUAL') OptimizationConstraint[source]#

This method creates an OptimizationConstraint object.

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

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.
Raises:
InvalidNameError
RangeError

Notes

This function can be accessed by:

mdb.models[name].optimizationTasks[name].OptimizationConstraint
PenetrationCheck(name: str, penetrationCheckRegion: Region, region: Region, presumeFeasibleRegionAtStart: BooleanType = 1) PenetrationCheck[source]#

This method creates a PenetrationCheck object.

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

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

Returns:
A PenetrationCheck object.

Notes

This function can be accessed by:

mdb.models[name].optimizationTasks[name].PenetrationCheck
ShapeDemoldControl(name: str, pullDirection: tuple, region: Region, collisionCheckRegion: SymbolicConstantType = 'DEMOLD_REGION', csys: int | None = None, drawAngle: float = 0, mainPointDetermination: SymbolicConstantType = 'MAXIMUM', presumeFeasibleRegionAtStart: BooleanType = 1, tolerance1: float = 0, tolerance2: float = 0, tolerance3: float = 0, undercutTolerance: float = 0) ShapeDemoldControl[source]#

This method creates a ShapeDemoldControl object.

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

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

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

masterPointDetermination

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

presumeFeasibleRegionAtStart

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

tolerance1

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

tolerance2

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

tolerance3

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

undercutTolerance

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

Returns:
A ShapeDemoldControl object.

Notes

This function can be accessed by:

mdb.models[name].optimizationTasks[name].ShapeDemoldControl
ShapeMemberSize(name: str, region: Region, maxThickness: float = 0, minThickness: float = 0, sizeRestriction: SymbolicConstantType = 'MINIMUM', assignNodeGroupRegion: str = 0, nodeGroupRegion: str = '') ShapeMemberSize[source]#

This method creates a ShapeMemberSize object.

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

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

minThickness

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

sizeRestriction

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

Returns:
A ShapeMemberSize object.

Notes

This function can be accessed by:

mdb.models[name].optimizationTasks[name].ShapeMemberSize
ShapePlanarSymmetry(name: str, clientDirection: tuple, region: Region, allowNonSymmetricMesh: BooleanType = True, csys: int | None = None, mainPointDetermination: SymbolicConstantType = 'MAXIMUM', presumeFeasibleRegionAtStart: BooleanType = 1, tolerance1: float = 0, tolerance2: float = 0, tolerance3: float = 0) ShapePlanarSymmetry[source]#

This method creates a ShapePlanarSymmetry object.

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

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

csys

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

mainPointDetermination

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

presumeFeasibleRegionAtStart

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

tolerance1

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

tolerance2

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

tolerance3

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

Returns:
A ShapePlanarSymmetry object.

Notes

This function can be accessed by:

mdb.models[name].optimizationTasks[name].ShapePlanarSymmetry
ShapePointSymmetry(name: str, region: Region, csys: int | None = None, mainPointDetermination: SymbolicConstantType = 'MAXIMUM', presumeFeasibleRegionAtStart: BooleanType = 1, tolerance1: float = 0, tolerance2: float = 0, tolerance3: float = 0) ShapePointSymmetry[source]#

This method creates a ShapePointSymmetry object.

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 or a DatumCsys object specifying the symmetry point represented as the origin of a local coordinate system. If *csys*=None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

masterPointDetermination

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

presumeFeasibleRegionAtStart

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

tolerance1

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

tolerance2

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

tolerance3

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

Returns:
A ShapePointSymmetry object.

Notes

This function can be accessed by:

mdb.models[name].optimizationTasks[name].ShapePointSymmetry
ShapeRotationalSymmetry(name: str, clientDirection: tuple, region: Region, allowNonSymmetricMesh: BooleanType = True, angle: float = 0, csys: int | None = None, mainPoint: str | None = None, mainPointDetermination: SymbolicConstantType = 'MAXIMUM', presumeFeasibleRegionAtStart: BooleanType = 1, startPoint: float | None = None, tolerance1: float = 0, tolerance2: float = 0, tolerance3: float = 0) ShapeRotationalSymmetry[source]#

This method creates a ShapeRotationalSymmetry object.

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

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

angle

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 or a DatumCsys object specifying the local coordinate system. If *csys*=None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

masterPoint

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

masterPointDetermination

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

presumeFeasibleRegionAtStart

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

startPoint

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

tolerance1

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

tolerance2

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

tolerance3

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

Returns:
A ShapeRotationalSymmetry object.

Notes

This function can be accessed by:

mdb.models[name].optimizationTasks[name].ShapeRotationalSymmetry
SingleTermDesignResponse(name: str, identifier: str, csys: int | None = None, drivingRegion: str | None = None, operation: SymbolicConstantType = 'SUM', region: SymbolicConstantType = 'MODEL', shellLayer: SymbolicConstantType = 'MAXIMUM', stepOperation: SymbolicConstantType = 'SUM', stepOptions: StepOptionArray | None = None) SingleTermDesignResponse[source]#

This method creates a SingleTermDesignResponse object.

Parameters:
name

A String specifying the design response repository key.

identifier

A String specifying the name of the variable identifier.

csys

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

drivingRegion

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

operation

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

region

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

shellLayer

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

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

A StepOptionArray object.

Returns:
A SingleTermDesignResponse object.

Notes

This function can be accessed by:

mdb.models[name].optimizationTasks[name].SingleTermDesignResponse
SizingClusterAreas(name: str, regions: tuple) SizingClusterAreas[source]#

This method creates a SizingClusterAreas object.

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.

Notes

This function can be accessed by:

mdb.models[name].optimizationTasks[name].SizingClusterAreas
SizingCyclicSymmetry(name: str, region: Region, translation: float, axis: SymbolicConstantType = 'AXIS_1', csys: int | None = None, ignoreFrozenArea: BooleanType = 0) SizingCyclicSymmetry[source]#

This method creates a SizingCyclicSymmetry object.

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

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

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

Returns:
A SizingCyclicSymmetry object.

Notes

This function can be accessed by:

mdb.models[name].optimizationTasks[name].SizingCyclicSymmetry
SizingFrozenArea(name: str, region: Region) SizingFrozenArea[source]#

This method creates a SizingFrozenArea object.

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.

Notes

This function can be accessed by:

mdb.models[name].optimizationTasks[name].SizingFrozenArea
SizingMemberSize(name: str, region: Region, minWidth: float) SizingMemberSize[source]#

This method creates a SizingMemberSize object.

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.

Returns:
Raises:

Notes

This function can be accessed by:

mdb.models[name].optimizationTasks[name].SizingMemberSize
SizingPlanarSymmetry(name: str, region: Region, axis: SymbolicConstantType = 'AXIS_1', csys: int | None = None, ignoreFrozenArea: BooleanType = 0) SizingPlanarSymmetry[source]#

This method creates a SizingPlanarSymmetry object.

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

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

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

Returns:
A SizingPlanarSymmetry object.

Notes

This function can be accessed by:

mdb.models[name].optimizationTasks[name].SizingPlanarSymmetry
SizingPointSymmetry(name: str, region: Region, csys: int | None = None, ignoreFrozenArea: BooleanType = 0) SizingPointSymmetry[source]#

This method creates a SizingPointSymmetry object.

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

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

Returns:
A SizingPointSymmetry object.

Notes

This function can be accessed by:

mdb.models[name].optimizationTasks[name].SizingPointSymmetry
SizingRotationalSymmetry(name: str, angle: float, region: Region, axis: SymbolicConstantType = 'AXIS_1', csys: int | None = None, ignoreFrozenArea: BooleanType = 0) SizingRotationalSymmetry[source]#

This method creates a SizingRotationalSymmetry object.

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

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

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

Returns:
A SizingRotationalSymmetry object.

Notes

This function can be accessed by:

mdb.models[name].optimizationTasks[name].SizingRotationalSymmetry
SlideRegionControl(name: str, clientDirection: tuple, region: Region, approach: SymbolicConstantType = 'FREE_FORM', csys: int | None = None, freeFormRegion: str | None = None, presumeFeasibleRegionAtStart: BooleanType = 1, revolvedRegion: str | None = None, tolerance1: float = 0, tolerance2: float = 0, tolerance3: float = 0) SlideRegionControl[source]#

This method creates a SlideRegionControl object.

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

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 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 or a Region object specifying the free-form region. This is used when approach is FREE_FORM. The default value is None.

presumeFeasibleRegionAtStart

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

revolvedRegion

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

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

tolerance2

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

tolerance3

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.

Notes

This function can be accessed by:

mdb.models[name].optimizationTasks[name].SlideRegionControl
StampControl(name: str, clientDirection: tuple, region: Region, csys: int | None = None, drawAngle: float = 0, mainPoint: str | None = None, mainPointDetermination: SymbolicConstantType = 'MAXIMUM', presumeFeasibleRegionAtStart: BooleanType = 1, tolerance1: float = 0, tolerance2: float = 0, tolerance3: float = 0, undercutTolerance: float = 0) StampControl[source]#

This method creates a StampControl object.

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

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

masterPoint

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

masterPointDetermination

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

presumeFeasibleRegionAtStart

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

tolerance1

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

tolerance2

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

tolerance3

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

undercutTolerance

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

Returns:
A StampControl object.

Notes

This function can be accessed by:

mdb.models[name].optimizationTasks[name].StampControl
TopologyCyclicSymmetry(name: str, region: Region, translation: float, axis: SymbolicConstantType = 'AXIS_1', csys: int | None = None, ignoreFrozenArea: BooleanType = 0) TopologyCyclicSymmetry[source]#

This method creates a TopologyCyclicSymmetry object.

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

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

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

Returns:
A TopologyCyclicSymmetry object.

Notes

This function can be accessed by:

mdb.models[name].optimizationTasks[name].TopologyCyclicSymmetry
TopologyDemoldControl(name: str, region: ~abaqus.Region.Region.Region, csys: int | None = None, draftAngle: float = 0, collisionCheckRegion: ~abaqusConstants.SymbolicConstantType = 'DEMOLD_REGION', pointRegion: ~abaqus.Region.Region.Region = <abaqus.Region.Region.Region object>, pullDirection: tuple = (), technique: ~abaqusConstants.SymbolicConstantType = 'AUTO') TopologyDemoldControl[source]#

This method creates a TopologyDemoldControl object.

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

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

collisionCheckRegion

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

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

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.

Notes

This function can be accessed by:

mdb.models[name].optimizationTasks[name].TopologyDemoldControl
TopologyMemberSize(name: str, region: Region, maxThickness: float = 0, minThickness: float = 0, separation: float = 0, sizeRestriction: SymbolicConstantType = 'MINIMUM') TopologyMemberSize[source]#

This method creates a TopologyMemberSize object.

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

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

minThickness

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

separation

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

sizeRestriction

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.

Notes

This function can be accessed by:

mdb.models[name].optimizationTasks[name].TopologyMemberSize
TopologyMillingControl(name: str, millingDirections: tuple, region: Region, csys: int | None = None, millingCheckRegion: SymbolicConstantType = 'MILLING_REGION', radius: float | None = None) TopologyMillingControl[source]#

This method creates a TopologyMillingControl object.

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

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

A Float specifying the radius for the collision check during the removal of the elements for the milling criteria.

Returns:
A TopologyMillingControl object.

Notes

This function can be accessed by:

mdb.models[name].optimizationTasks[name].TopologyMillingControl
TopologyOverhangControl(name: str, pullDirection: tuple, region: ~abaqus.Region.Region.Region, csys: int | None = None, draftAngle: float = 45, overhangCheckRegion: ~abaqusConstants.SymbolicConstantType = 'OVERHANG_REGION', pointRegion: ~abaqus.Region.Region.Region = <abaqus.Region.Region.Region object>, radius: float | None = None, technique: ~abaqusConstants.SymbolicConstantType = 'AUTO') TopologyOverhangControl[source]#

This method creates a TopologyOverhangControl object.

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

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

A Float specifying the overhang angle. The default value is 45.0.

overhangCheckRegion

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

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

A Float specifying the radius to define the size of the cones that are used in the internal check for the overhang criteria.

technique

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.

Notes

This function can be accessed by:

mdb.models[name].optimizationTasks[name].TopologyOverhangControl
TopologyPlanarSymmetry(name: str, region: Region, axis: SymbolicConstantType = 'AXIS_1', csys: int | None = None, ignoreFrozenArea: BooleanType = 0) TopologyPlanarSymmetry[source]#

This method creates a TopologyPlanarSymmetry object.

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

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

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

Returns:
A TopologyPlanarSymmetry object.

Notes

This function can be accessed by:

mdb.models[name].optimizationTasks[name].TopologyPlanarSymmetry
TopologyPointSymmetry(name: str, region: Region, csys: int | None = None, ignoreFrozenArea: BooleanType = 0) TopologyPointSymmetry[source]#

This method creates a TopologyPointSymmetry object.

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

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

Returns:
A TopologyPointSymmetry object.

Notes

This function can be accessed by:

mdb.models[name].optimizationTasks[name].TopologyPointSymmetry
TopologyRotationalSymmetry(name: str, angle: float, region: Region, axis: SymbolicConstantType = 'AXIS_1', csys: int | None = None, ignoreFrozenArea: BooleanType = 0) TopologyRotationalSymmetry[source]#

This method creates a TopologyRotationalSymmetry object.

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

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

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

Returns:
A TopologyRotationalSymmetry object.

Notes

This function can be accessed by:

mdb.models[name].optimizationTasks[name].TopologyRotationalSymmetry
TurnControl(name: str, clientDirection: tuple, region: Region, csys: int | None = None, mainPoint: str | None = None, mainPointDetermination: SymbolicConstantType = 'MAXIMUM', presumeFeasibleRegionAtStart: BooleanType = 1, tolerance1: float = 0, tolerance2: float = 0, tolerance3: float = 0) TurnControl[source]#

This method creates a TurnControl object.

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 or a DatumCsys object specifying the local coordinate system. If *csys*=None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

masterPoint

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

masterPointDetermination

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

presumeFeasibleRegionAtStart

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

tolerance1

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

tolerance2

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

tolerance3

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

Returns:
A TurnControl object.

Notes

This function can be accessed by:

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

Object features#

BeadFixedRegion#

class BeadFixedRegion(name: str, region: Region, csys: int | None = None, u1: BooleanType = 0, u2: BooleanType = 0, u3: BooleanType = 0)[source]#

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

Notes

This object can be accessed by:

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

Methods

setValues([csys, u1, u2, u3])

This method modifies the BeadFixedRegion object.

setValues(csys: int | None = None, u1: BooleanType = 0, u2: BooleanType = 0, u3: BooleanType = 0)[source]#

This method modifies the BeadFixedRegion object.

Parameters:
csys

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

u1

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

u2

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

u3

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

BeadGrowth#

class BeadGrowth(name: str, region: Region, beadGrowth: float = 0, shrink: float = 0)[source]#

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

Notes

This object can be accessed by:

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

Methods

setValues([beadGrowth, shrink])

This method modifies the BeadGrowth object.

setValues(beadGrowth: float = 0, shrink: float = 0)[source]#

This method modifies the BeadGrowth object.

Parameters:
beadGrowth

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

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

BeadPenetrationCheck#

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

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

Notes

This object can be accessed by:

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

Methods

setValues()

This method modifies the BeadPenetrationCheck object.

setValues()[source]#

This method modifies the BeadPenetrationCheck object.

BeadPlanarSymmetry#

class BeadPlanarSymmetry(name: str, region: Region, axis: SymbolicConstantType = 'AXIS_1', csys: int | None = None)[source]#

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

Notes

This object can be accessed by:

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

Methods

setValues([axis, csys])

This method modifies the BeadPlanarSymmetry object.

setValues(axis: SymbolicConstantType = 'AXIS_1', csys: int | None = None)[source]#

This method modifies the BeadPlanarSymmetry object.

Parameters:
axis

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 or a DatumCsys object specifying the local coordinate system. If *csys*=None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

BeadPointSymmetry#

class BeadPointSymmetry(name: str, region: Region, csys: int | None = None)[source]#

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

Notes

This object can be accessed by:

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

Methods

setValues([csys])

This method modifies the BeadPointSymmetry object.

setValues(csys: int | None = None)[source]#

This method modifies the BeadPointSymmetry object.

Parameters:
csys

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

BeadRotationalSymmetry#

class BeadRotationalSymmetry(name: str, angle: float, region: Region, axis: SymbolicConstantType = 'AXIS_1', csys: int | None = None)[source]#

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

Notes

This object can be accessed by:

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

Methods

setValues([axis, csys])

This method modifies the BeadRotationalSymmetry object.

setValues(axis: SymbolicConstantType = 'AXIS_1', csys: int | None = None)[source]#

This method modifies the BeadRotationalSymmetry object.

Parameters:
axis

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 or a DatumCsys object specifying the local coordinate system. If *csys*=None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

BeadTask#

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

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

Notes

This object can be accessed by:

import optimization
mdb.models[name].optimizationTasks[name]
Attributes:
designResponses: dict[str, DesignResponse]

A repository of DesignResponse objects.

objectiveFunctions: dict[str, ObjectiveFunction]

A repository of ObjectiveFunction objects.

optimizationConstraints: dict[str, OptimizationConstraint]

A repository of OptimizationConstraint objects.

geometricRestrictions: dict[str, GeometricRestriction]

A repository of GeometricRestriction objects.

Methods

setValues([abaqusSensitivities, algorithm, ...])

This method modifies the BeadTask object.

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

This method modifies the BeadTask object.

Parameters:
abaqusSensitivities

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

algorithm

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

areBCRegionsFrozen

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

beadIter

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

beadMaxMembraneStress

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

beadMinStress

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

beadPerturbation

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

beadWidth

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

curveSmooth

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

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

filterRadiusBy

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

flipNormalDir

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

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

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

modeTrackingRegion

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

nodalMoveLimit

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

nodeSmooth

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

nodeUpdateStrategy

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

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

updateShapeBasisVectors

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

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.

CombinedTermDesignResponse#

class CombinedTermDesignResponse(name: str, terms: tuple, filterMaxRadius: str | None = None, filterExponent: float = 1, filterRadiusReduction: float = 0, highCutOff: str | None = None, lowCutOff: float = 0, method: SymbolicConstantType = 'ADD', weights: tuple = ())[source]#

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

Notes

This object can be accessed by:

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

Methods

setValues([filterMaxRadius, filterExponent, ...])

This method modifies the CombinedTermDesignResponse object.

setValues(filterMaxRadius: str | None = None, filterExponent: float = 1, filterRadiusReduction: float = 0, highCutOff: str | None = None, lowCutOff: float = 0, method: SymbolicConstantType = 'ADD', weights: tuple = ())[source]#

This method modifies the CombinedTermDesignResponse object.

Parameters:
filterMaxRadius

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

filterExponent

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

filterRadiusReduction

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

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

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.

DesignDirection#

class DesignDirection(name: str, region: Region, csys: int | None = None, mainPoint: str | None = None, mainPointDetermination: SymbolicConstantType = 'MAXIMUM', movementRestriction: SymbolicConstantType = 'VECTOR', presumeFeasibleRegionAtStart: BooleanType = 1, u1: BooleanType = 1, u2: BooleanType = 1, u3: BooleanType = 1)[source]#

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

Notes

This object can be accessed by:

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

Methods

setValues([csys, mainPoint, ...])

This method modifies the DesignDirection object.

setValues(csys: int | None = None, mainPoint: str | None = None, mainPointDetermination: SymbolicConstantType = 'MAXIMUM', movementRestriction: SymbolicConstantType = 'VECTOR', presumeFeasibleRegionAtStart: BooleanType = 1, u1: BooleanType = 1, u2: BooleanType = 1, u3: BooleanType = 1)[source]#

This method modifies the DesignDirection object.

Parameters:
csys

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

mainPoint

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

mainPointDetermination

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

movementRestriction

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

presumeFeasibleRegionAtStart

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

u1

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

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

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

DesignResponse#

class DesignResponse[source]#

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

Notes

This object can be accessed by:

import optimization
mdb.models[name].optimizationTasks[name].designResponses[name]
Attributes:
name: str

A String specifying the design response repository key.

DrillControl#

class DrillControl(name: str, clientDirection: tuple, region: Region, csys: int | None = None, drawAngle: float = 0, mainPoint: str | None = None, mainPointDetermination: SymbolicConstantType = 'MAXIMUM', presumeFeasibleRegionAtStart: BooleanType = 1, tolerance1: float = 0, tolerance2: float = 0, tolerance3: float = 0, undercutTolerance: float = 0)[source]#

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

Notes

This object can be accessed by:

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

Methods

setValues([csys, drawAngle, mainPoint, ...])

This method modifies the DrillControl object.

setValues(csys: int | None = None, drawAngle: float = 0, mainPoint: str | None = None, mainPointDetermination: SymbolicConstantType = 'MAXIMUM', presumeFeasibleRegionAtStart: BooleanType = 1, tolerance1: float = 0, tolerance2: float = 0, tolerance3: float = 0, undercutTolerance: float = 0)[source]#

This method modifies the DrillControl object.

Parameters:
csys

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

drawAngle

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

mainPoint

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

mainPointDetermination

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

presumeFeasibleRegionAtStart

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

tolerance1

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

tolerance2

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

tolerance3

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

undercutTolerance

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

FixedRegion#

class FixedRegion(name: str, region: Region, csys: int | None = None, presumeFeasibleRegionAtStart: BooleanType = 1, u1: BooleanType = 0, u2: BooleanType = 0, u3: BooleanType = 0)[source]#

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

Notes

This object can be accessed by:

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

Methods

setValues([csys, ...])

This method modifies the FixedRegion object.

setValues(csys: int | None = None, presumeFeasibleRegionAtStart: BooleanType = 1, u1: BooleanType = 0, u2: BooleanType = 0, u3: BooleanType = 0)[source]#

This method modifies the FixedRegion object.

Parameters:
csys

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

presumeFeasibleRegionAtStart

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

u1

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

u2

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

u3

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

FrozenArea#

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

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

Notes

This object can be accessed by:

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

Methods

setValues([region])

This method modifies the FrozenArea object.

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

This method modifies the FrozenArea object.

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

GeometricRestriction#

class GeometricRestriction[source]#

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

Notes

This object can be accessed by:

import optimization
mdb.models[name].optimizationTasks[name].geometricRestrictions[name]
Attributes:
name: str

A String specifying the geometric restriction repository key.

region: Region

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

Growth#

class Growth(name: str, region: Region, growth: float = 0, presumeFeasibleRegionAtStart: BooleanType = 1, shrink: float = 0)[source]#

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

Notes

This object can be accessed by:

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

Methods

setValues([growth, ...])

This method modifies the Growth object.

setValues(growth: float = 0, presumeFeasibleRegionAtStart: BooleanType = 1, shrink: float = 0)[source]#

This method modifies the Growth object.

Parameters:
growth

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

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

shrink

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

LocalStopCondition#

class LocalStopCondition(name: str, referenceFactor: float, comparisonOperation: SymbolicConstantType = 'LESS_THAN', identifier: SymbolicConstantType = 'MOVEMENT', identifierOperation: SymbolicConstantType = 'MAXIMUM', referenceDesignCycle: SymbolicConstantType = 'PREVIOUS', referenceOperation: SymbolicConstantType = 'ADD', region: SymbolicConstantType = 'MODEL')[source]#

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

Notes

This object can be accessed by:

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

Methods

setValues([comparisonOperation, identifier, ...])

This method modifies the LocalStopCondition object.

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

This method modifies the LocalStopCondition object.

Parameters:
comparisonOperation

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

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

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

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

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

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

ObjectiveFunction#

class ObjectiveFunction(name: str, objectives: OptimizationObjectiveArray, target: SymbolicConstantType = 'MINIMIZE')[source]#

The ObjectiveFunction object defines the objective of the optimization.

Notes

This object can be accessed by:

import optimization
mdb.models[name].optimizationTasks[name].objectiveFunctions[name]
Attributes:
objectives: OptimizationObjectiveArray

Optimization objectives

Methods

setValues([target])

This method modifies the ObjectiveFunction object.

setValues(target: SymbolicConstantType = 'MINIMIZE')[source]#

This method modifies the ObjectiveFunction object.

Parameters:
target

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

Raises:
RangeError

OptimizationConstraint#

class OptimizationConstraint(name: str, designResponse: str, restrictionValue: float, restrictionMethod: SymbolicConstantType = 'ABSOLUTE_EQUAL')[source]#

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

Notes

This object can be accessed by:

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

Methods

setValues([restrictionMethod])

This method modifies the OptimizationConstraint object.

setValues(restrictionMethod: SymbolicConstantType = 'ABSOLUTE_EQUAL')[source]#

This method modifies the OptimizationConstraint object.

Parameters:
restrictionMethod

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

Raises:
RangeError

OptimizationObjective#

class OptimizationObjective[source]#

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

Notes

This object can be accessed by:

import optimization
mdb.models[name].optimizationTasks[name].objectiveFunctions[name].objectives[i]
Attributes:
suppress: Boolean

A Boolean specifying whe:py:class:~.the`r :py:class:`~.the objective is suppressed or not. The default value is OFF.

weight: float

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

referenceValue: typing.Union[SymbolicConstant, float]

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.

designResponse: str

A String specifying the name of the design response.

OptimizationObjectiveArray#

class OptimizationObjectiveArray(iterable=(), /)[source]#

Methods

findAt

PenetrationCheck#

class PenetrationCheck(name: str, penetrationCheckRegion: Region, region: Region, presumeFeasibleRegionAtStart: BooleanType = 1)[source]#

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

Notes

This object can be accessed by:

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

Methods

setValues([presumeFeasibleRegionAtStart])

This method modifies the PenetrationCheck object.

setValues(presumeFeasibleRegionAtStart: BooleanType = 1)[source]#

This method modifies the PenetrationCheck object.

Parameters:
presumeFeasibleRegionAtStart

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

ShapeDemoldControl#

class ShapeDemoldControl(name: str, pullDirection: tuple, region: Region, collisionCheckRegion: SymbolicConstantType = 'DEMOLD_REGION', csys: int | None = None, drawAngle: float = 0, mainPointDetermination: SymbolicConstantType = 'MAXIMUM', presumeFeasibleRegionAtStart: BooleanType = 1, tolerance1: float = 0, tolerance2: float = 0, tolerance3: float = 0, undercutTolerance: float = 0)[source]#

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

Notes

This object can be accessed by:

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

Methods

setValues([collisionCheckRegion, csys, ...])

This method modifies the ShapeDemoldControl object.

setValues(collisionCheckRegion: SymbolicConstantType = 'DEMOLD_REGION', csys: int | None = None, drawAngle: float = 0, mainPointDetermination: SymbolicConstantType = 'MAXIMUM', presumeFeasibleRegionAtStart: BooleanType = 1, tolerance1: float = 0, tolerance2: float = 0, tolerance3: float = 0, undercutTolerance: float = 0)[source]#

This method modifies the ShapeDemoldControl object.

Parameters:
collisionCheckRegion

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

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

mainPointDetermination

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

presumeFeasibleRegionAtStart

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

tolerance1

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

tolerance2

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

tolerance3

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

undercutTolerance

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

ShapeMemberSize#

class ShapeMemberSize(name: str, region: Region, maxThickness: float = 0, minThickness: float = 0, sizeRestriction: SymbolicConstantType = 'MINIMUM', assignNodeGroupRegion: str = 0, nodeGroupRegion: str = '')[source]#

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

Notes

This object can be accessed by:

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

Methods

setValues([maxThickness, minThickness, ...])

This method modifies the ShapeMemberSize object.

setValues(maxThickness: float = 0, minThickness: float = 0, sizeRestriction: SymbolicConstantType = 'MINIMUM', assignNodeGroupRegion: str = 0, nodeGroupRegion: str = '')[source]#

This method modifies the ShapeMemberSize object.

Parameters:
maxThickness

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

minThickness

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

sizeRestriction

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

assignNodeGroupRegion

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

nodeGroupRegion

A Node Region object specifying the check node group.

ShapePlanarSymmetry#

class ShapePlanarSymmetry(name: str, clientDirection: tuple, region: Region, allowNonSymmetricMesh: BooleanType = True, csys: int | None = None, mainPointDetermination: SymbolicConstantType = 'MAXIMUM', presumeFeasibleRegionAtStart: BooleanType = 1, tolerance1: float = 0, tolerance2: float = 0, tolerance3: float = 0)[source]#

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

Notes

This object can be accessed by:

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

Methods

setValues([allowNonSymmetricMesh, csys, ...])

This method modifies the ShapePlanarSymmetry object.

setValues(allowNonSymmetricMesh: BooleanType = True, csys: int | None = None, mainPointDetermination: SymbolicConstantType = 'MAXIMUM', presumeFeasibleRegionAtStart: BooleanType = 1, tolerance1: float = 0, tolerance2: float = 0, tolerance3: float = 0)[source]#

This method modifies the ShapePlanarSymmetry object.

Parameters:
allowNonSymmetricMesh

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

csys

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

mainPointDetermination

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

presumeFeasibleRegionAtStart

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

tolerance1

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

tolerance2

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

tolerance3

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

ShapePointSymmetry#

class ShapePointSymmetry(name: str, region: Region, csys: int | None = None, mainPointDetermination: SymbolicConstantType = 'MAXIMUM', presumeFeasibleRegionAtStart: BooleanType = 1, tolerance1: float = 0, tolerance2: float = 0, tolerance3: float = 0)[source]#

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

Notes

This object can be accessed by:

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

Methods

setValues([csys, mainPointDetermination, ...])

This method modifies the ShapePointSymmetry object.

setValues(csys: int | None = None, mainPointDetermination: SymbolicConstantType = 'MAXIMUM', presumeFeasibleRegionAtStart: BooleanType = 1, tolerance1: float = 0, tolerance2: float = 0, tolerance3: float = 0)[source]#

This method modifies the ShapePointSymmetry object.

Parameters:
csys

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

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

presumeFeasibleRegionAtStart

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

tolerance1

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

tolerance2

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

tolerance3

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

ShapeRotationalSymmetry#

class ShapeRotationalSymmetry(name: str, clientDirection: tuple, region: Region, allowNonSymmetricMesh: BooleanType = True, angle: float = 0, csys: int | None = None, mainPoint: str | None = None, mainPointDetermination: SymbolicConstantType = 'MAXIMUM', presumeFeasibleRegionAtStart: BooleanType = 1, startPoint: float | None = None, tolerance1: float = 0, tolerance2: float = 0, tolerance3: float = 0)[source]#

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

Notes

This object can be accessed by:

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

Methods

setValues([allowNonSymmetricMesh, angle, ...])

This method modifies the ShapeRotationalSymmetry object.

setValues(allowNonSymmetricMesh: BooleanType = True, angle: float = 0, csys: int | None = None, mainPoint: str | None = None, mainPointDetermination: SymbolicConstantType = 'MAXIMUM', presumeFeasibleRegionAtStart: BooleanType = 1, startPoint: float | None = None, tolerance1: float = 0, tolerance2: float = 0, tolerance3: float = 0)[source]#

This method modifies the ShapeRotationalSymmetry object.

Parameters:
allowNonSymmetricMesh

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

angle

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 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 or a Region object specifying the main point used when mainPointDetermination is SPECIFY. The default value is None.

mainPointDetermination

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

presumeFeasibleRegionAtStart

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

startPoint

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

tolerance1

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

tolerance2

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

tolerance3

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

ShapeTask#

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

The ShapeTask object defines a shape task. The ShapeTask object is derived from the OptimizationTask object.

Notes

This object can be accessed by:

import optimization
mdb.models[name].optimizationTasks[name]
Attributes:
designResponses: dict[str, DesignResponse]

A repository of DesignResponse objects.

objectiveFunctions: dict[str, ObjectiveFunction]

A repository of ObjectiveFunction objects.

optimizationConstraints: dict[str, OptimizationConstraint]

A repository of OptimizationConstraint objects.

geometricRestrictions: dict[str, GeometricRestriction]

A repository of GeometricRestriction objects.

stopConditions: dict[str, StopCondition]

A repository of StopCondition objects.

Methods

setValues([abaqusSensitivities, ...])

This method modifies the ShapeTask object.

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

This method modifies the ShapeTask object.

Parameters:
abaqusSensitivities

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

absoluteStepSizeControl

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

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

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

constrainedLaplacianConvergenceLevel

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

curvatureSmoothingEdgeLength

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

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

A Float specifying the equality constraint tolerance. The default value is 10–3.

featureRecognitionAngle

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

filterExponent

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

filterMaxRadius

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

filterRadiusReduction

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

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

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

frozenBoundaryConditionRegion

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

geometricRestrictionEvaluationFrequency

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

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

haltUponViolation

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

layerReferenceRegion

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

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

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

midsideInterpolation

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

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 or an Int specifying the number of layers for mesh smoothing when meshSmoothingRegionMethod is NUMBER_OF_LAYERS. The default value is None.

presumeFeasibleBCRegionAtStart

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

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

quadMinAngle

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

quadSkew

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

quadTaper

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

region

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

reportPoorQualityElements

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

reportQualityViolation

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

shrinkScaleFactor

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

smoothingRegion

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

targetMeshQuality

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

tetAspectRatio

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

tetMaxAspect

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

tetMinAspect

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

tetSkew

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

triMaxAngle

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

triMinAngle

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

updateShapeBasisVectors

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

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.

SingleTermDesignResponse#

class SingleTermDesignResponse(name: str, identifier: str, csys: int | None = None, drivingRegion: str | None = None, operation: SymbolicConstantType = 'SUM', region: SymbolicConstantType = 'MODEL', shellLayer: SymbolicConstantType = 'MAXIMUM', stepOperation: SymbolicConstantType = 'SUM', stepOptions: StepOptionArray | None = None)[source]#

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

Notes

This object can be accessed by:

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

Methods

setValues([csys, drivingRegion, operation, ...])

This method modifies the SingleTermDesignResponse object.

setValues(csys: int | None = None, drivingRegion: str | None = None, operation: SymbolicConstantType = 'SUM', region: SymbolicConstantType = 'MODEL', shellLayer: SymbolicConstantType = 'MAXIMUM', stepOperation: SymbolicConstantType = 'SUM', stepOptions: StepOptionArray | None = None)[source]#

This method modifies the SingleTermDesignResponse object.

Parameters:
csys

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

drivingRegion

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

operation

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

region

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

shellLayer

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

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

A StepOptionArray object.

SizingClusterAreas#

class SizingClusterAreas(name: str, regions: tuple)[source]#

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

Notes

This object can be accessed by:

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

Methods

setValues()

This method modifies the SizingClusterAreas object.

setValues()[source]#

This method modifies the SizingClusterAreas object.

SizingCyclicSymmetry#

class SizingCyclicSymmetry(name: str, region: Region, translation: float, axis: SymbolicConstantType = 'AXIS_1', csys: int | None = None, ignoreFrozenArea: BooleanType = 0)[source]#

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

Notes

This object can be accessed by:

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

Methods

setValues([axis, csys, ignoreFrozenArea])

This method modifies the SizingCyclicSymmetry object.

setValues(axis: SymbolicConstantType = 'AXIS_1', csys: int | None = None, ignoreFrozenArea: BooleanType = 0)[source]#

This method modifies the SizingCyclicSymmetry object.

Parameters:
axis

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

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

SizingFrozenArea#

class SizingFrozenArea(name: str, region: Region)[source]#

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

Notes

This object can be accessed by:

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

Methods

setValues()

This method modifies the SizingFrozenArea object.

setValues()[source]#

This method modifies the SizingFrozenArea object.

SizingMemberSize#

class SizingMemberSize(name: str, region: Region, minWidth: float)[source]#

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

Notes

This object can be accessed by:

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

Methods

setValues()

This method modifies the sizingMemberSize object.

setValues()[source]#

This method modifies the sizingMemberSize object.

SizingPlanarSymmetry#

class SizingPlanarSymmetry(name: str, region: Region, axis: SymbolicConstantType = 'AXIS_1', csys: int | None = None, ignoreFrozenArea: BooleanType = 0)[source]#

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

Notes

This object can be accessed by:

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

Methods

setValues()

This method modifies the sizingPlanarSymmetry object.

setValues()[source]#

This method modifies the sizingPlanarSymmetry object.

SizingPointSymmetry#

class SizingPointSymmetry(name: str, region: Region, csys: int | None = None, ignoreFrozenArea: BooleanType = 0)[source]#

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

Notes

This object can be accessed by:

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

Methods

setValues([csys, ignoreFrozenArea])

This method modifies the SizingPointSymmetry object.

setValues(csys: int | None = None, ignoreFrozenArea: BooleanType = 0)[source]#

This method modifies the SizingPointSymmetry object.

Parameters:
csys

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

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

SizingRotationalSymmetry#

class SizingRotationalSymmetry(name: str, angle: float, region: Region, axis: SymbolicConstantType = 'AXIS_1', csys: int | None = None, ignoreFrozenArea: BooleanType = 0)[source]#

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

Notes

This object can be accessed by:

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

Methods

setValues([axis, csys, ignoreFrozenArea])

This method modifies the SizingRotationalSymmetry object.

setValues(axis: SymbolicConstantType = 'AXIS_1', csys: int | None = None, ignoreFrozenArea: BooleanType = 0)[source]#

This method modifies the SizingRotationalSymmetry object.

Parameters:
axis

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

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

SizingTask#

class SizingTask(name: str, abaqusSensitivities: BooleanType = True, elementThicknessDeltaStopCriteria: float = 0, freezeBoundaryConditionRegions: BooleanType = 0, freezeLoadRegions: BooleanType = 1, modeTrackingRegion: str = 'MODEL', numFulfilledStopCriteria: int = 2, numTrackedModes: int = 5, objectiveFunctionDeltaStopCriteria: float = 0, stopCriteriaDesignCycle: int = 4, thicknessMoveLimit: float = 0, thicknessUpdateStrategy: SymbolicConstantType = 'NORMAL', groupOperator: BooleanType = 0)[source]#

The SizingTask object defines a Sizing task. The SizingTask object is derived from the OptimizationTask object.

Notes

This object can be accessed by:

import optimization
mdb.models[name].optimizationTasks[name]
Attributes:
designResponses: dict[str, DesignResponse]

A repository of DesignResponse objects.

objectiveFunctions: dict[str, ObjectiveFunction]

A repository of ObjectiveFunction objects.

optimizationConstraints: dict[str, OptimizationConstraint]

A repository of OptimizationConstraint objects.

geometricRestrictions: dict[str, GeometricRestriction]

A repository of GeometricRestriction objects.

stopConditions: dict[str, StopCondition]

A repository of StopCondition objects.

Methods

setValues([abaqusSensitivities, ...])

This method modifies the SizingTask object.

setValues(abaqusSensitivities: BooleanType = True, elementThicknessDeltaStopCriteria: float = 0, freezeBoundaryConditionRegions: BooleanType = 0, freezeLoadRegions: BooleanType = 1, modeTrackingRegion: str = 'MODEL', numFulfilledStopCriteria: int = 2, numTrackedModes: int = 5, objectiveFunctionDeltaStopCriteria: float = 0, stopCriteriaDesignCycle: int = 4, thicknessMoveLimit: float = 0, thicknessUpdateStrategy: SymbolicConstantType = 'NORMAL', groupOperator: BooleanType = 0)[source]#

This method modifies the SizingTask object.

Parameters:
abaqusSensitivities

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

elementThicknessDeltaStopCriteria

A Float specifying the stop criteria based on the change in element thickness. The default value is 0.5 × 10–2.

freezeBoundaryConditionRegions

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

freezeLoadRegions

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

modeTrackingRegion

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

numFulfilledStopCriteria

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

numTrackedModes

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

objectiveFunctionDeltaStopCriteria

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

stopCriteriaDesignCycle

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

thicknessMoveLimit

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

thicknessUpdateStrategy

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

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.

SlideRegionControl#

class SlideRegionControl(name: str, clientDirection: tuple, region: Region, approach: SymbolicConstantType = 'FREE_FORM', csys: int | None = None, freeFormRegion: str | None = None, presumeFeasibleRegionAtStart: BooleanType = 1, revolvedRegion: str | None = None, tolerance1: float = 0, tolerance2: float = 0, tolerance3: float = 0)[source]#

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

Notes

This object can be accessed by:

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

Methods

setValues([approach, csys, freeFormRegion, ...])

This method modifies the SlideRegionControl object.

setValues(approach: SymbolicConstantType = 'FREE_FORM', csys: int | None = None, freeFormRegion: str | None = None, presumeFeasibleRegionAtStart: BooleanType = 1, revolvedRegion: str | None = None, tolerance1: float = 0, tolerance2: float = 0, tolerance3: float = 0)[source]#

This method modifies the SlideRegionControl object.

Parameters:
approach

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 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 or a Region object specifying the free-form region. This is used when approach is FREE_FORM. The default value is None.

presumeFeasibleRegionAtStart

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

revolvedRegion

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

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

tolerance2

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

tolerance3

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

StampControl#

class StampControl(name: str, clientDirection: tuple, region: Region, csys: int | None = None, drawAngle: float = 0, mainPoint: str | None = None, mainPointDetermination: SymbolicConstantType = 'MAXIMUM', presumeFeasibleRegionAtStart: BooleanType = 1, tolerance1: float = 0, tolerance2: float = 0, tolerance3: float = 0, undercutTolerance: float = 0)[source]#

The StampControl object defines a stamp control geometric restriction. The StampControl object is derived from the GeometricRestriction object.

Notes

This object can be accessed by:

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

Methods

setValues([csys, drawAngle, mainPoint, ...])

This method modifies the StampControl object.

setValues(csys: int | None = None, drawAngle: float = 0, mainPoint: str | None = None, mainPointDetermination: SymbolicConstantType = 'MAXIMUM', presumeFeasibleRegionAtStart: BooleanType = 1, tolerance1: float = 0, tolerance2: float = 0, tolerance3: float = 0, undercutTolerance: float = 0)[source]#

This method modifies the StampControl object.

Parameters:
csys

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

drawAngle

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

mainPoint

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

mainPointDetermination

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

presumeFeasibleRegionAtStart

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

tolerance1

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

tolerance2

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

tolerance3

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

undercutTolerance

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

StepOption#

class StepOption[source]#

A StepOption is an object used to define step options in a design response.

Notes

This object can be accessed by:

import optimization
mdb.models[name].optimizationTasks[name].designResponses[name].stepOptions[i]
Attributes:
lowerMode: SymbolicConstant

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.

upperMode: SymbolicConstant

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.

loadCase: SymbolicConstant

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.

step: SymbolicConstant

The SymbolicConstant ALL or a String specifying the name of the step. The default value is ALL.

model: str

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.

StepOptionArray#

class StepOptionArray(iterable=(), /)[source]#

Methods

findAt

StopCondition#

class StopCondition[source]#

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

Notes

This object can be accessed by:

import optimization
mdb.models[name].optimizationTasks[name].stopConditions[name]
Attributes:
name: str

A String specifying the stop condition repository key.

region: SymbolicConstant

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

TopologyCyclicSymmetry#

class TopologyCyclicSymmetry(name: str, region: Region, translation: float, axis: SymbolicConstantType = 'AXIS_1', csys: int | None = None, ignoreFrozenArea: BooleanType = 0)[source]#

The TopologyCyclicSymmetry object defines a topology cyclic symmetry geometric restriction. The TopologyCyclicSymmetry object is derived from the GeometricRestriction object.

Notes

This object can be accessed by:

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

Methods

setValues([axis, csys, ignoreFrozenArea])

This method modifies the TopologyCyclicSymmetry object.

setValues(axis: SymbolicConstantType = 'AXIS_1', csys: int | None = None, ignoreFrozenArea: BooleanType = 0)[source]#

This method modifies the TopologyCyclicSymmetry object.

Parameters:
axis

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

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

TopologyDemoldControl#

class TopologyDemoldControl(name: str, region: ~abaqus.Region.Region.Region, csys: int | None = None, draftAngle: float = 0, collisionCheckRegion: ~abaqusConstants.SymbolicConstantType = 'DEMOLD_REGION', pointRegion: ~abaqus.Region.Region.Region = <abaqus.Region.Region.Region object>, pullDirection: tuple = (), technique: ~abaqusConstants.SymbolicConstantType = 'AUTO')[source]#

The TopologyDemoldControl object defines a topology demold control geometric restriction. The TopologyDemoldControl object is derived from the GeometricRestriction object.

Notes

This object can be accessed by:

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

Methods

setValues([csys, draftAngle, ...])

This method modifies the TopologyDemoldControl object.

setValues(csys: int | None = None, draftAngle: float = 0, collisionCheckRegion: ~abaqusConstants.SymbolicConstantType = 'DEMOLD_REGION', pointRegion: ~abaqus.Region.Region.Region = <abaqus.Region.Region.Region object>, pullDirection: tuple = (), technique: ~abaqusConstants.SymbolicConstantType = 'AUTO')[source]#

This method modifies the TopologyDemoldControl object.

Parameters:
csys

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

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

collisionCheckRegion

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

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

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

TopologyMemberSize#

class TopologyMemberSize(name: str, region: Region, maxThickness: float = 0, minThickness: float = 0, separation: float = 0, sizeRestriction: SymbolicConstantType = 'MINIMUM')[source]#

The TopologyMemberSize object defines a topology member size geometric restriction. The TopologyMemberSize object is derived from the GeometricRestriction object.

Notes

This object can be accessed by:

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

Methods

setValues([maxThickness, minThickness, ...])

This method modifies the TopologyMemberSize object.

setValues(maxThickness: float = 0, minThickness: float = 0, separation: float = 0, sizeRestriction: SymbolicConstantType = 'MINIMUM')[source]#

This method modifies the TopologyMemberSize object.

Parameters:
maxThickness

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

minThickness

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

separation

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

sizeRestriction

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

TopologyMillingControl#

class TopologyMillingControl(name: str, millingDirections: tuple, region: Region, csys: int | None = None, millingCheckRegion: SymbolicConstantType = 'MILLING_REGION', radius: float | None = None)[source]#

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

Notes

This object can be accessed by:

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

Methods

setValues([csys, millingCheckRegion, radius])

This method modifies the TopologyMillingControl object.

setValues(csys: int | None = None, millingCheckRegion: SymbolicConstantType = 'MILLING_REGION', radius: float | None = None)[source]#

This method modifies the TopologyMillingControl object.

Parameters:
csys

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

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

A Float specifying the radius for the collision check during the removal of the elements for the milling criteria.

TopologyOverhangControl#

class TopologyOverhangControl(name: str, pullDirection: tuple, region: ~abaqus.Region.Region.Region, csys: int | None = None, draftAngle: float = 45, overhangCheckRegion: ~abaqusConstants.SymbolicConstantType = 'OVERHANG_REGION', pointRegion: ~abaqus.Region.Region.Region = <abaqus.Region.Region.Region object>, radius: float | None = None, technique: ~abaqusConstants.SymbolicConstantType = 'AUTO')[source]#

The TopologyOverhangControl object defines a topology overhang control geometric restriction. The TopologyOverhangControl object is derived from the GeometricRestriction object.

Notes

This object can be accessed by:

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

Methods

setValues([csys, draftAngle, ...])

This method modifies the TopologyOverhangControl object.

setValues(csys: int | None = None, draftAngle: float = 45, overhangCheckRegion: ~abaqusConstants.SymbolicConstantType = 'OVERHANG_REGION', pointRegion: ~abaqus.Region.Region.Region = <abaqus.Region.Region.Region object>, radius: float | None = None, technique: ~abaqusConstants.SymbolicConstantType = 'AUTO')[source]#

This method modifies the TopologyOverhangControl object.

Parameters:
csys

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

A Float specifying the overhang angle. The default value is 45.0.

overhangCheckRegion

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

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

A Float specifying the radius to define the size of the cones that are used in the internal check for the overhang criteria.

technique

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.

TopologyPlanarSymmetry#

class TopologyPlanarSymmetry(name: str, region: Region, axis: SymbolicConstantType = 'AXIS_1', csys: int | None = None, ignoreFrozenArea: BooleanType = 0)[source]#

The TopologyPlanarSymmetry object defines a topology planar symmetry geometric restriction. The TopologyPlanarSymmetry object is derived from the GeometricRestriction object.

Notes

This object can be accessed by:

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

Methods

setValues([axis, csys, ignoreFrozenArea])

This method modifies the TopologyPlanarSymmetry object.

setValues(axis: SymbolicConstantType = 'AXIS_1', csys: int | None = None, ignoreFrozenArea: BooleanType = 0)[source]#

This method modifies the TopologyPlanarSymmetry object.

Parameters:
axis

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

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

TopologyPointSymmetry#

class TopologyPointSymmetry(name: str, region: Region, csys: int | None = None, ignoreFrozenArea: BooleanType = 0)[source]#

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

Notes

This object can be accessed by:

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

Methods

setValues([csys, ignoreFrozenArea])

This method modifies the TopologyPointSymmetry object.

setValues(csys: int | None = None, ignoreFrozenArea: BooleanType = 0)[source]#

This method modifies the TopologyPointSymmetry object.

Parameters:
csys

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

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

TopologyRotationalSymmetry#

class TopologyRotationalSymmetry(name: str, angle: float, region: Region, axis: SymbolicConstantType = 'AXIS_1', csys: int | None = None, ignoreFrozenArea: BooleanType = 0)[source]#

The TopologyRotationalSymmetry object defines a topology rotational symmetry geometric restriction. The TopologyRotationalSymmetry object is derived from the GeometricRestriction object.

Notes

This object can be accessed by:

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

Methods

setValues([axis, csys, ignoreFrozenArea])

This method modifies the TopologyRotationalSymmetry object.

setValues(axis: SymbolicConstantType = 'AXIS_1', csys: int | None = None, ignoreFrozenArea: BooleanType = 0)[source]#

This method modifies the TopologyRotationalSymmetry object.

Parameters:
axis

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

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

TopologyTask#

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

The TopologyTask object defines a topology task. The TopologyTask object is derived from the OptimizationTask object.

Notes

This object can be accessed by:

import optimization
mdb.models[name].optimizationTasks[name]
Attributes:
designResponses: dict[str, DesignResponse]

A repository of DesignResponse objects.

objectiveFunctions: dict[str, ObjectiveFunction]

A repository of ObjectiveFunction objects.

optimizationConstraints: dict[str, OptimizationConstraint]

A repository of OptimizationConstraint objects.

geometricRestrictions: dict[str, GeometricRestriction]

A repository of GeometricRestriction objects.

stopConditions: dict[str, StopCondition]

A repository of StopCondition objects.

Methods

setValues([abaqusSensitivities, algorithm, ...])

This method modifies the TopologyTask object.

setValues(abaqusSensitivities: BooleanType = True, algorithm: SymbolicConstantType = 'GENERAL_OPTIMIZATION', densityMoveLimit: float = 0, densityUpdateStrategy: SymbolicConstantType = 'NORMAL', elementDensityDeltaStopCriteria: float = 0, filterRadius: float | None = None, firstCycleDeletedVolume: float = 5, firstCycleDeletedVolumeTechnique: SymbolicConstantType = 0, freezeBoundaryConditionRegions: BooleanType = 0, freezeLoadRegions: BooleanType = 1, frequencySpectrumWeight: float = 6, initialDensity: SymbolicConstantType = 'DEFAULT', materialInterpolationPenalty: float = 3, materialInterpolationTechnique: SymbolicConstantType = 'DEFAULT', maxDensity: float = 1, minDensity: float | None = None, modeTrackingRegion: SymbolicConstantType = 'MODEL', numDesignCycles: int = 15, numFulfilledStopCriteria: int = 2, numTrackedModes: int = 5, objectiveFunctionDeltaStopCriteria: float | None = None, region: SymbolicConstantType = 'MODEL', softDeletionMethod: SymbolicConstantType = 'STANDARD', softDeletionRadius: float = 0, softDeletionRegion: str | None = None, softDeletionThreshold: float | None = None, stepSize: SymbolicConstantType = 'MEDIUM', stiffnessMassDamping: SymbolicConstantType | float = 'AVERAGE_EDGE_LENGTH', stopCriteriaDesignCycle: int = 4, structuralMassDamping: float | None = None, viscousMassDamping: float | None = None, viscousStiffnessDamping: float | None = None, groupOperator: BooleanType = 0)[source]#

This method modifies the TopologyTask object.

Parameters:
abaqusSensitivities

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

algorithm

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

densityMoveLimit

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

densityUpdateStrategy

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

A Float specifying the stop criteria based upon the change in element densities. The default value is 0.5×10–2.

filterRadius

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

firstCycleDeletedVolume

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

firstCycleDeletedVolumeTechnique

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

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

freezeLoadRegions

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

frequencySpectrumWeight

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

initialDensity

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

materialInterpolationPenalty

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

materialInterpolationTechnique

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

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

minDensity

A Float specifying the minimum density in the density update. The default value is 10–3.

modeTrackingRegion

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

numDesignCycles

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

numFulfilledStopCriteria

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

numTrackedModes

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

objectiveFunctionDeltaStopCriteria

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

region

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

softDeletionMethod

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

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

softDeletionRegion

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

softDeletionThreshold

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

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

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

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

structuralMassDamping

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

viscousMassDamping

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

viscousStiffnessDamping

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

groupOperator

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

TurnControl#

class TurnControl(name: str, clientDirection: tuple, region: Region, csys: int | None = None, mainPoint: str | None = None, mainPointDetermination: SymbolicConstantType = 'MAXIMUM', presumeFeasibleRegionAtStart: BooleanType = 1, tolerance1: float = 0, tolerance2: float = 0, tolerance3: float = 0)[source]#

The TurnControl object defines a turn control geometric restriction. The TurnControl object is derived from the GeometricRestriction object.

Notes

This object can be accessed by:

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

Methods

setValues([csys, mainPoint, ...])

This method modifies the TurnControl object.

setValues(csys: int | None = None, mainPoint: str | None = None, mainPointDetermination: SymbolicConstantType = 'MAXIMUM', presumeFeasibleRegionAtStart: BooleanType = 1, tolerance1: float = 0, tolerance2: float = 0, tolerance3: float = 0)[source]#

This method modifies the TurnControl object.

Parameters:
csys

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

mainPoint

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

mainPointDetermination

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

presumeFeasibleRegionAtStart

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

tolerance1

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

tolerance2

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

tolerance3

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