Interaction¶
A specific type of interaction object and a specific type of interaction state object are designed for each type of interaction. An interaction object stores the non-propagating data of an interaction as well as a number of instances of the corresponding interaction state object, each of which stores the propagating data of the interaction in a single step. Instances of the interaction state object are created and deleted internally by its corresponding interaction object.
Create interactions¶
- class InteractionModel(
- name,
- description=
''
, - stefanBoltzmann=
None
, - absoluteZero=
None
, - waveFormulation=
NOT_SET
, - modelType=
STANDARD_EXPLICIT
, - universalGas=
None
, - copyConstraints=
1
, - copyConnectors=
1
, - copyInteractions=
1
, Bases:
InteractionContactControlModel
,InteractionContactInitializationModel
,InteractionContactStabilizationModel
,InteractionPropertyModel
Abaqus creates a Model object named Model-1 when a session is started.
Note
This object can be accessed by:
mdb.models[name]
Note
Public Data Attributes:
Inherited from
ModelBase
A String specifying the repository key.
None or a Float specifying the Stefan-Boltzmann constant.
None or a Float specifying the absolute zero constant.
A SymbolicConstant specifying the type of incident wave formulation to be used in acoustic problems.
None or a Float specifying the universal gas constant.
A Boolean specifying whether an input file should be written without parts and assemblies.
A Boolean specifying that the step specified by restartStep should be terminated at the increment specified by restartIncrement.
A Boolean specifying that a shell global model drives a solid submodel.
A Float specifying the time stamp that indicates when the model was last changed.
A String specifying the purpose and contents of the Model object.
A String specifying the name of the job that generated the restart data.
A String specifying the name of the step where the restart analysis will start.
A String specifying the name of the job that generated the results for the global model.
A boolean specifying the status of constraints created in a model, in the model which instances this model.
A boolean specifying the status of connectors created in a model, in the model which instances this model.
A boolean specifying the status of interactions created in a model, in the model which instances this model.
A KeywordBlock object.
A repository of Amplitude objects.
A repository of Profile objects.
A repository of BoundaryCondition objects.
A repository of ConstrainedSketchConstraint objects.
A repository of AnalyticalField objects.
A repository of DiscreteField objects.
A repository of PredefinedField objects.
A repository of Interaction objects.
A repository of InteractionProperty objects.
A repository of ContactControl objects.
A repository of ContactInitialization objects.
A repository of ContactStabilization objects.
A tuple of tuples of Strings specifying the linked child PartInstance name in the current model to the corresponding parent PartInstance name in a different model.
A tuple of tuples of Strings specifying the linked child Part name in the current model to the corresponding parent Part name in a different model.
A repository of Load objects.
A repository of Material objects.
A repository of Calibration objects.
A repository of Section objects.
A repository of RemeshingRule objects.
A repository of ConstrainedSketch objects.
A repository of Part objects.
A repository of Step objects.
A FeatureOptions object.
A repository of AdaptiveMeshConstraint objects.
A repository of AdaptiveMeshControl objects.
A repository of TimePoint objects.
A repository of Filter objects.
A repository of IntegratedOutputSection objects.
A repository of FieldOutputRequest objects.
A repository of HistoryOutputRequest objects.
A repository of OptimizationTask objects.
A repository of TableCollection objects.
A repository of EventSeriesType objects.
A repository of EventSeriesData objects.
An Int specifying the increment, interval, iteration or cycle where the restart analysis will start.
An Assembly object.
Public Methods:
contactDetection
([name, createStepName, ...])This method uses contact detection to create SurfaceToSurfaceContactStd, SurfaceToSurfaceContactExp, and Tie objects.
This method returns a list of all possible contacts that can be created using the ContactDetection method.
AcousticImpedance
(name, createStepName, surface)This method creates an AcousticImpedance object.
ActuatorSensor
(name, createStepName, point, ...)This method creates an ActuatorSensor object.
CavityRadiation
(name, createStepName, surfaces)This method creates a CavityRadiation object.
ConcentratedFilmCondition
(name, ...[, ...])This method creates a ConcentratedFilmCondition object.
ConcentratedRadiationToAmbient
(name, ...[, ...])This method creates a ConcentratedRadiationToAmbient object.
ContactExp
(name, createStepName[, ...])This method creates a ContactExp object.
ContactStd
(name, createStepName[, ...])This method creates a ContactStd object.
CyclicSymmetry
(name, createStepName, main, ...)This method creates a CyclicSymmetry object.
ElasticFoundation
(name, createStepName, ...)This method creates an ElasticFoundation object.
FilmCondition
(name, createStepName, surface, ...)This method creates a FilmCondition object.
FluidCavity
(name, createStepName, ...[, ...])This method creates an FluidCavity object.
FluidExchange
(name, createStepName, ...[, ...])This method creates an FluidExchange object.
FluidInflator
(name, createStepName, cavity, ...)This method creates a FluidInflator object.
IncidentWave
(name, createStepName, ...[, ...])This method creates an IncidentWave object.
ModelChange
(name, createStepName[, ...])This method creates a ModelChange object.
PressurePenetration
(name, createStepName, ...)This method creates a PressurePenetration object.
RadiationToAmbient
(name, createStepName, ...)This method creates a RadiationToAmbient object.
SelfContactExp
(name, createStepName, ...[, ...])This method creates a SelfContactExp object.
SelfContactStd
(name, createStepName, ...[, ...])This method creates a SelfContactStd object.
StdXplCosimulation
(name, createStepName, region)This method creates a StdXplCosimulation object.
SurfaceToSurfaceContactExp
(name, ...[, ...])This method creates a SurfaceToSurfaceContactExp object.
SurfaceToSurfaceContactStd
(name, ...[, ...])This method creates a SurfaceToSurfaceContactStd object.
XFEMCrackGrowth
(name, createStepName, crackName)This method creates an XFEMCrackGrowth object.
Inherited from
InteractionContactControlModel
ExpContactControl
(name[, globTrkChoice, ...])This method creates an ExpContactControl object.
StdContactControl
(name[, ...])This method creates an StdContactControl object.
Inherited from
InteractionContactInitializationModel
ExpInitialization
(name[, overclosureType, ...])This method creates an ExpInitialization object.
StdInitialization
(name[, overclosureType, ...])This method creates a StdInitialization object.
Inherited from
InteractionContactStabilizationModel
StdStabilization
(name[, zeroDistance, ...])This method creates a StdStabilization object.
Inherited from
InteractionPropertyModel
AcousticImpedanceProp
(name, tableType, table)This method creates an AcousticImpedanceProp object.
ActuatorSensorProp
(name[, realProperties, ...])This method creates an ActuatorSensorProp object.
CavityRadiationProp
(name[, ...])This method creates a CavityRadiationProp object.
ContactProperty
(name)This method creates a ContactProperty object.
FilmConditionProp
(name[, ...])This method creates a FilmConditionProp object.
FluidCavityProperty
(name[, definition, ...])This method creates a FluidCavityProperty object.
FluidExchangeProperty
(name, dataTable[, ...])This method creates a FluidExchangeProperty object.
FluidInflatorProperty
(name, definition, ...)This method creates a FluidInflatorProperty object.
IncidentWaveProperty
(name[, definition, ...])This method creates an IncidentWaveProperty object.
Inherited from
ModelBase
__init__
(name[, description, ...])This method creates a Model object.
ModelFromInputFile
(name, inputFileName)This method creates a Model object by reading the keywords in an input file and creating the corresponding Abaqus/CAE objects.
ModelFromOdbFile
(name, odbFileName)This method creates a Model object by reading an output database and creating any corresponding Abaqus/CAE objects.
ModelFromNastranFile
(modelName, inputFileName)This method creates a Model object by reading the keywords in a Nastran bulk data file or Nastran input file and creating any corresponding Abaqus/CAE objects.
setValues
([description, noPartsInputFile, ...])This method modifies the Model object.
Member Details:
- AcousticImpedance(
- name,
- createStepName,
- surface,
- definition=
TABULAR
, - interactionProperty=
''
, - nonreflectingType=
PLANE
, - radius=
1
, - semimajorAxis=
1
, - eccentricity=
0
, - centerCoordinates=
()
, - directionCosine=
()
, This method creates an AcousticImpedance object.
Note
This function can be accessed by:
mdb.models[name].AcousticImpedance
Note
- Parameters:¶
- name¶
A String specifying the repository key.
- createStepName¶
A String specifying the name of the step in which the AcousticImpedance object is created.
- surface¶
A Region object specifying the acoustic boundary surface.
- definition=
TABULAR
¶ A SymbolicConstant specifying the type of acoustic impedance to be defined. Possible values are TABULAR and NONREFLECTING. The default value is TABULAR.
- interactionProperty=
''
¶ A String specifying the AcousticImpedanceProp object associated with this interaction.
- nonreflectingType=
PLANE
¶ A SymbolicConstant specifying the type of nonreflecting geometry to be defined. Possible values are PLANE, IMPROVED, CIRCULAR, SPHERICAL, ELLIPTICAL, and PROLATE. The default value is PLANE.This argument is valid only when definition = NONREFLECTING.
- radius=
1
¶ A Float specifying the radius of the circle or sphere defining the boundary surface. The default value is 1.0.This argument is valid only when definition = NONREFLECTING, and nonreflectingType = CIRCULAR or SPHERICAL.
- semimajorAxis=
1
¶ A Float specifying the semimajor axis length of the ellipse or prolate spheroid defining the boundary surface. The default value is 1.0.This argument is valid only when definition = NONREFLECTING, and nonreflectingType = ELLIPTICAL or PROLATE.
- eccentricity=
0
¶ A Float specifying the eccentricity of the ellipse or prolate spheroid defining the boundary surface. The default value is 0.0.This argument is valid only when definition = NONREFLECTING, and nonreflectingType = ELLIPTICAL or PROLATE.
- centerCoordinates=
()
¶ A sequence of three Floats specifying the X, Y, and Z coordinates of the center of the ellipse or prolate spheroid defining the boundary surface. The default value is (0, 0, 0).This argument is valid only when definition = NONREFLECTING, and nonreflectingType = ELLIPTICAL or PROLATE.
- directionCosine=
()
¶ A sequence of three Floats specifying the X, Y, and Z components of the direction cosine of the major axis of the ellipse or prolate spheroid defining the boundary surface. The default value is (0, 0, 1).This argument is valid only when definition = NONREFLECTING, and nonreflectingType = ELLIPTICAL or PROLATE.
- Returns:¶
An AcousticImpedance object.
- Return type:¶
- ActuatorSensor(
- name,
- createStepName,
- point,
- interactionProperty,
- noCoordComponents,
- unsymm,
- noSolutionDepVar,
- userSubUel,
- dof,
- solutionDepVars,
This method creates an ActuatorSensor object.
Note
This function can be accessed by:
mdb.models[name].ActuatorSensor
Note
- Parameters:¶
- name¶
A String specifying the repository key.
- createStepName¶
A String specifying the name of the step in which the actuator/sensor interaction is created. createStepName must be set to ‘Initial’.
- point¶
A Region object specifying the point at which the constraint is applied.
- interactionProperty¶
A String specifying the ActuatorSensorProp object associated with this interaction.
- noCoordComponents¶
An Int specifying the number of coordinate components supplied to the user subroutine (UEL).
- unsymm¶
A Boolean specifying whether the element matrices are symmetric (ON) or unsymmetric (OFF). The default value is OFF.
- noSolutionDepVar¶
An Int specifying the number of solution-dependent variables. The default value is 0.
- userSubUel¶
A String specifying the name of the user subroutine (UEL) that defines the user element.
- dof¶
A String specifying the degrees of freedom, separated by commas.
- solutionDepVars¶
A sequence of Floats specifying the initial values of the solution-dependent variables.
- Returns:¶
An ActuatorSensor object.
- Return type:¶
- CavityRadiation(
- name,
- createStepName,
- surfaces,
- surfaceEmissivities=
()
, - ambientTemp=
None
, - blocking=
BLOCKING_ALL
, - blockingSurfaces=
None
, - rangeOfView=
None
, - surfaceReflection=
1
, - viewfactorAccurTol=
0
, - minInfinitesimalRatio=
64
, - numPointsPerEdge=
3
, - minLumpedAreaDS=
5
, - cyclicSymmetry=
0
, - cyclicImages=
2
, - cyclicRotPt=
None
, - cyclicRotEndPt=
None
, - cyclicSymPt=
None
, - periodicSymmetries=
0
, - periodicImages_1=
2
, - periodicImages_2=
2
, - periodicImages_3=
2
, - periodicSymAxis_1=
''
, - periodicSymAxis_2=
''
, - periodicSymPlane_1=
''
, - periodicSymPlane_2=
''
, - periodicSymPlane_3=
''
, - periodicDistance_1=
()
, - periodicDistance_2=
()
, - periodicDistance_3=
()
, - periodicSymZ=
None
, - periodicDistZ=
None
, - reflectionSymmetries=
0
, - reflectionSymAxis_1=
''
, - reflectionSymAxis_2=
''
, - reflectionSymPlane_1=
''
, - reflectionSymPlane_2=
''
, - reflectionSymPlane_3=
''
, - reflectionSymZ=
None
, This method creates a CavityRadiation object.
Note
This function can be accessed by:
mdb.models[name].CavityRadiation
Note
- Parameters:¶
- name¶
A String specifying the repository key.
- createStepName¶
A String specifying the name of the step in which the cavity radiation interaction should be created.
- surfaces¶
A RegionArray object specifying the surfaces for which radiation viewfactor control is being specified.
- surfaceEmissivities=
()
¶ A sequence of Strings specifying the names of the Cavity Radiation properties containing the surface emissivity data. One name per specified surface. The emissivity data is ignored when surfaceReflection = OFF.
- ambientTemp=
None
¶ None or a Float specifying the reference ambient temperature value, θ0θ0. Specifying a value indicates an open cavity. The default value is None.
- blocking=
BLOCKING_ALL
¶ A SymbolicConstant specifying the blocking checks to be performed in the viewfactor calculations. Possible values are BLOCKING_ALL, NO_BLOCKING, and PARTIAL_BLOCKING. The default value is BLOCKING_ALL.
- blockingSurfaces=
None
¶ A RegionArray object specifying the surfaces that provide blocking inside the cavity. This argument applies only when blocking = PARTIAL_BLOCKING.
- rangeOfView=
None
¶ None or a Float specifying the maximum distance between surface facets at which viewfactors are calculated. More distant facets are deemed too far apart to exchange significant amounts of heat through radiation effects, and the viewfactors between these facets are assumed to be zero. If rangeOfView = None, there is no upper limit. The default value is None.
- surfaceReflection=
1
¶ A Boolean specifying whether heat reflections are to be included in the cavity radiation calculations. The default value is ON.
- viewfactorAccurTol=
0
¶ A Float specifying the acceptable tolerance for the viewfactor calculations. The default value is 0.05.
- minInfinitesimalRatio=
64
¶ A Float specifying the facet area ratio above which the infinitesimal-to-finite area approximation is used for viewfactor calculations. The default value is 64.0.
- numPointsPerEdge=
3
¶ An Int specifying the number of Gauss integration points to be used along each edge when the numerical integration of contour integrals is used for viewfactor calculations. One to five integration points are allowed. The default value is 3.
- minLumpedAreaDS=
5
¶ A Float specifying the nondimensional distance-square value above which the lumped area approximation is used for viewfactor calculations. The default value is 5.0.
- cyclicSymmetry=
0
¶ A Boolean specifying whether cyclic symmetry will be applied. This argument cannot be specified for axisymmetric models. The default value is OFF.
- cyclicImages=
2
¶ An Int specifying the number of cyclically similar images that compose the cavity formed as a result of this symmetry. This argument applies only when cyclicSymmetry = ON. The default value is 2.
- cyclicRotPt=
None
¶ A ModelDot object specifying the rotation axis point. This argument applies only when cyclicSymmetry = ON.
- cyclicRotEndPt=
None
¶ A ModelDot object specifying the rotation axis end point. This argument applies only for three-dimensional models, and only when cyclicSymmetry = ON.
- cyclicSymPt=
None
¶ A ModelDot object specifying the symmetry axis end point. This argument applies only when cyclicSymmetry = ON.
- periodicSymmetries=
0
¶ An Int specifying the number of periodic symmetries that will be applied. The default value is 0.
- periodicImages_1=
2
¶ An Int specifying the number of repetitions used in the numerical calculation of the cavity viewfactors resulting from the first periodic symmetry. The result of this symmetry is a cavity composed of the cavity surface defined in the model plus twice the value of periodicImages_1. This argument applies only when periodicSymmetries is greater than zero. The default value is 2.
- periodicImages_2=
2
¶ An Int specifying the number of repetitions used in the numerical calculation of the cavity viewfactors resulting from the second periodic symmetry. The result of this symmetry is a cavity composed of the cavity surface defined in the model plus twice the value of periodicImages_2. This argument applies only when periodicSymmetries is greater than one. The default value is 2.
- periodicImages_3=
2
¶ An Int specifying the number of repetitions used in the numerical calculation of the cavity viewfactors resulting from the third periodic symmetry. The result of this symmetry is a cavity composed of the cavity surface defined in the model plus twice the value of periodicImages_3. This argument applies only when periodicSymmetries = 3. The default value is 2.
- periodicSymAxis_1=
''
¶ A straight Edge, a Datum object representing a datum axis, or an ElementEdge object indicating the first line of symmetry in two-dimensional models. This argument applies only for 2D models, and when periodicSymmetries is greater than zero.
- periodicSymAxis_2=
''
¶ A straight Edge, a Datum object representing a datum axis, or an ElementEdge object indicating the second line of symmetry in two-dimensional models. This argument applies only for two-dimensional models, and when periodicSymmetries = 2.
- periodicSymPlane_1=
''
¶ A planar Face, an ElementFace, or a Datum object representing a datum plane; indicating the first plane of symmetry in three-dimensional models. This argument applies only for three-dimensional models, and when periodicSymmetries is greater than zero.
- periodicSymPlane_2=
''
¶ A planar Face, an ElementFace, or a Datum object representing a datum plane; indicating the second plane of symmetry in three-dimensional models. This argument applies only for three-dimensional models, and when periodicSymmetries is greater than one.
- periodicSymPlane_3=
''
¶ A planar Face, an ElementFace, or a Datum object representing a datum plane; indicating the third plane of symmetry in three-dimensional models. This argument applies only for three-dimensional models, and when periodicSymmetries = 3.
- periodicDistance_1=
()
¶ A sequence of sequences of Floats specifying the two points of the vector that describes the periodic distance for the first periodic symmetry. Each point is defined by a tuple of three coordinates indicating its position. This argument applies only when periodicSymmetries is greater than zero. The default value is an empty sequence.
- periodicDistance_2=
()
¶ A sequence of sequences of Floats specifying the two points of the vector that describes the periodic distance for the second periodic symmetry. Each point is defined by a tuple of three coordinates indicating its position. This argument applies only when periodicSymmetries is greater than one. The default value is an empty sequence.
- periodicDistance_3=
()
¶ A sequence of sequences of Floats specifying the two points of the vector that describes the periodic distance for the third periodic symmetry. Each point is defined by a tuple of three coordinates indicating its position. This argument applies only when periodicSymmetries = 3. The default value is an empty sequence.
- periodicSymZ=
None
¶ None or a Float specifying the Z value indicating the symmetry reference line in axisymmetric models. This argument applies only for axisymmetric models, and when periodicSymmetries = 1. The default value is None.
- periodicDistZ=
None
¶ None or a Float specifying the Z value indicating the periodic distance in axisymmetric models. This argument applies only for axisymmetric models, and when periodicSymmetries = 1. The default value is None.
- reflectionSymmetries=
0
¶ An Int specifying the number of reflection symmetries will be applied. The default value is 0.
- reflectionSymAxis_1=
''
¶ A straight Edge, a Datum object representing a datum axis, or an ElementEdge object indicating the first line of symmetry in two-dimensional models. This argument applies only for two-dimensional models, and when reflectionSymmetries is greater than zero.
- reflectionSymAxis_2=
''
¶ A straight Edge, a Datum object representing a datum axis, or an ElementEdge object indicating the second line of symmetry in two-dimensional models. This argument applies only for two-dimensional models, and when reflectionSymmetries = 2.
- reflectionSymPlane_1=
''
¶ A planar Face, an ElementFace, or a Datum object representing a datum plane; indicating the first plane of symmetry in three-dimensional models. This argument applies only for three-dimensional models, and when reflectionSymmetries is greater than zero.
- reflectionSymPlane_2=
''
¶ A planar Face, an ElementFace, or a Datum object representing a datum plane; indicating the second plane of symmetry in three-dimensional models. This argument applies only for three-dimensional models, and when reflectionSymmetries is greater than one.
- reflectionSymPlane_3=
''
¶ A planar Face, an ElementFace, or a Datum object representing a datum plane; indicating the third plane of symmetry in three-dimensional models. This argument applies only for three-dimensional models, and when reflectionSymmetries = 3.
- reflectionSymZ=
None
¶ None or a Float specifying the Z value indicating the symmetry reference line in axisymmetric models. This argument applies only for axisymmetric models, and when reflectionSymmetries = 1. The default value is None.
- Returns:¶
A CavityRadiation object.
- Return type:¶
- ConcentratedFilmCondition(
- name,
- createStepName,
- region,
- definition,
- nodalArea=
1
, - explicitRegionType=
LAGRANGIAN
, - interactionProperty=
''
, - field=
''
, - sinkTemperature=
0
, - sinkAmplitude=
''
, - filmCoeff=
0
, - filmCoeffAmplitude=
''
, - sinkFieldName=
''
, - sinkDistributionType=
UNIFORM
, This method creates a ConcentratedFilmCondition object.
Note
This function can be accessed by:
mdb.models[name].ConcentratedFilmCondition
Note
- Parameters:¶
- name¶
A String specifying the repository key.
- createStepName¶
A String specifying the name of the step in which the ConcentratedFilmCondition object is created.
- region¶
A Region object specifying the region to which the concentrated film condition interaction is applied. The interaction is applied to each node in the region.
- definition¶
A SymbolicConstant specifying how the concentrated film condition is defined. Possible values are EMBEDDED_COEFF, PROPERTY_REF, USER_SUB, and FIELD.
- nodalArea=
1
¶ A Float specifying the area associated with the node where the concentrated film condition is applied. The default value is 1.0.
- explicitRegionType=
LAGRANGIAN
¶ A SymbolicConstant specifying how the concentrated film condition is applied to the boundary of an adaptive mesh domain. Possible values are LAGRANGIAN, SLIDING, and EULERIAN. The default value is LAGRANGIAN. This argument applies only during an Abaqus/Explicit analysis.
- interactionProperty=
''
¶ A String specifying the name of the FilmConditionProp object associated with this interaction. The interactionProperty argument applies only when definition = PROPERTY_REF. The default value is an empty string.
- field=
''
¶ A String specifying the name of the AnalyticalField object associated with this interaction. The field argument applies only when definition = FIELD. The default value is an empty string.
- sinkTemperature=
0
¶ A Float specifying the reference sink temperature, θ0θ0. The default value is 0.0.
- sinkAmplitude=
''
¶ A String specifying the name of the Amplitude object that gives the variation of the sink temperature, θ0θ0, with time. The default value is an empty string. Note: Use None in an Abaqus/Standard analysis to specify that the reference sink temperature is applied immediately at the beginning of the step or linearly over the step. Use None in an Abaqus/Explicit analysis to specify that the reference sink temperature is applied throughout the step.
- filmCoeff=
0
¶ A Float specifying the reference film coefficient value, hh. The filmCoeff argument applies when definition = EMBEDDED_COEFF, definition = USER_SUB, or definition = FIELD. The default value is 0.0.
- filmCoeffAmplitude=
''
¶ A String specifying the name of the Amplitude object that gives the variation of the film coefficient, hh, with time. The default value is an empty string. Note: Use None in an Abaqus/Standard analysis to specify that the reference film coefficient is applied immediately at the beginning of the step or linearly over the step. Use None in an Abaqus/Explicit analysis to specify that the reference film coefficient is applied throughout the step.
- sinkFieldName=
''
¶ A String specifying the name of the AnalyticalField or DiscreteField object associated with the sink temperature. The sinkFieldName argument applies only when sinkDistributionType = ANALYTICAL_FIELD or sinkDistributionType = DISCRETE_FIELD. The default value is an empty string.
- sinkDistributionType=
UNIFORM
¶ A SymbolicConstant specifying how the sink temperature is distributed. Possible values are UNIFORM, ANALYTICAL_FIELD, and DISCRETE_FIELD. The default value is UNIFORM.
- Returns:¶
A ConcentratedFilmCondition object.
- Return type:¶
- ConcentratedRadiationToAmbient(
- name,
- createStepName,
- region,
- ambientTemperature,
- ambientTemperatureAmp,
- emissivity,
- nodalArea=
1
, - explicitRegionType=
LAGRANGIAN
, - field=
''
, - distributionType=
UNIFORM
, This method creates a ConcentratedRadiationToAmbient object.
Note
This function can be accessed by:
mdb.models[name].ConcentratedRadiationToAmbient
- Parameters:¶
- name¶
A String specifying the repository key.
- createStepName¶
A String specifying the name of the step in which the ConcentratedRadiationToAmbient object is created.
- region¶
A Region object specifying the region to which the concentrated radiation interaction is applied. The interaction is applied to each node in the region.
- ambientTemperature¶
A Float specifying the reference ambient temperature, θ0θ0.
- ambientTemperatureAmp¶
A String specifying the name of the Amplitude object that gives the variation of the ambient temperature with time. Note: Use None in an Abaqus/Standard analysis to specify that the reference ambient temperature is applied immediately at the beginning of the step or linearly over the step. Use None in an Abaqus/Explicit analysis to specify that the reference ambient temperature is applied throughout the step.
- emissivity¶
A Float specifying the emissivity, ϵϵ.
- nodalArea=
1
¶ A Float specifying the area associated with the node where the concentrated radiation interaction is applied. The default value is 1.0.
- explicitRegionType=
LAGRANGIAN
¶ A SymbolicConstant specifying how the concentrated radiation is applied to the boundary of an adaptive mesh domain. Possible values are LAGRANGIAN, SLIDING, and EULERIAN. The default value is LAGRANGIAN. Note: explicitRegionType applies only during an Abaqus/Explicit analysis.
- field=
''
¶ A String specifying the name of the AnalyticalField object associated with this interaction. The field argument applies only when distributionType = ANALYTICAL_FIELD. The default value is an empty string.
- distributionType=
UNIFORM
¶ A SymbolicConstant specifying how the radiation is defined. Possible values are UNIFORM and ANALYTICAL_FIELD. The default value is UNIFORM.
- Returns:¶
A ConcentratedRadiationToAmbient object.
- Return type:¶
- ContactExp(
- name,
- createStepName,
- useAllstar=0,
- globalSmoothing=1,
- includedPairs=None,
- excludedPairs=None,
- contactPropertyAssignments=None,
- surfaceThicknessAssignments=None,
- surfaceOffsetAssignments=None,
- surfaceFeatureAssignments=None,
- smoothingAssignments=None,
- surfaceCrushTriggerAssignments=<abaqus.Interaction.SurfaceCrushTriggerAssignment.SurfaceCrushTriggerAssignment object>,
- surfaceFrictionAssignments=<abaqus.Interaction.SurfaceFrictionAssignment.SurfaceFrictionAssignment object>,
- mainSecondaryAssignments=None,
- polarityAssignments=<abaqus.Interaction.PolarityAssignments.PolarityAssignments object>,
This method creates a ContactExp object.
Note
This function can be accessed by:
mdb.models[name].ContactExp
Note
- Parameters:¶
- name¶
A String specifying the repository key.
- createStepName¶
A String specifying the name of the step in which this contact interaction is created.
- useAllstar :
Union
[AbaqusBoolean
,bool
], default:0
A Boolean specifying whether the contacting surface pair consists of all exterior faces, shell edges, beam segments, analytical rigid surfaces, and, when applicable, Eulerian material surfaces.
- globalSmoothing :
Union
[AbaqusBoolean
,bool
], default:1
A Boolean specifying whether surface smoothing (geometric correction) is automatically applied to all eligible surfaces. The default value is ON.
- includedPairs :
RegionPairs
|None
, default:None
A RegionPairs object specifying the domain pairs included in contact.
- excludedPairs :
RegionPairs
|None
, default:None
A RegionPairs object specifying the domain pairs excluded from contact.
- contactPropertyAssignments :
ContactPropertyAssignment
|None
, default:None
A ContactPropertyAssignment object specifying the contact property assignments in the contact domain.
- surfaceThicknessAssignments :
SurfaceThicknessAssignment
|None
, default:None
A SurfaceThicknessAssignment object specifying the surface thickness assignments in the contact domain.
- surfaceOffsetAssignments :
SurfaceOffsetAssignment
|None
, default:None
A SurfaceOffsetAssignment object specifying the surface offset fraction assignments in the contact domain.
- surfaceFeatureAssignments :
SurfaceFeatureAssignment
|None
, default:None
A SurfaceFeatureAssignment object specifying the surface feature angle assignments in the contact domain.
- smoothingAssignments :
SmoothingAssignment
|None
, default:None
A SmoothingAssignment object specifying the surface smoothing assignments in the contact domain.
- surfaceCrushTriggerAssignments :
SurfaceCrushTriggerAssignment
, default:<abaqus.Interaction.SurfaceCrushTriggerAssignment.SurfaceCrushTriggerAssignment object at 0x7ff713597a50>
A SurfaceCrushTriggerAssignment object specifying the surface crush trigger assignments in the contact domain.
Added in version 2021: The
surfaceCrushTriggerAssignments
argument was added.- surfaceFrictionAssignments :
SurfaceFrictionAssignment
, default:<abaqus.Interaction.SurfaceFrictionAssignment.SurfaceFrictionAssignment object at 0x7ff7133aa390>
A SurfaceFrictionAssignment object specifying the surface friction assignments in the contact domain.
Added in version 2021: The
surfaceFrictionAssignments
argument was added.- mainSecondaryAssignments :
MainSecondaryAssignment
|None
, default:None
A MainSecondaryAssignment object specifying the main-secondary assignments in the contact domain.
Changed in version 2022: The argument
masterSlaveAssignments
was renamed tomainSecondaryAssignments
.- polarityAssignments :
PolarityAssignments
, default:<abaqus.Interaction.PolarityAssignments.PolarityAssignments object at 0x7ff7133a8f50>
A PolarityAssignments object specifying the polarity assignments in the contact domain.
Added in version 2020: The
polarityAssignments
argument was added.
- Returns:¶
A ContactExp object.
- Return type:¶
- ContactStd(
- name,
- createStepName,
- useAllstar=0,
- globalSmoothing=1,
- includedPairs=None,
- excludedPairs=None,
- contactPropertyAssignments=None,
- surfaceThicknessAssignments=None,
- surfaceOffsetAssignments=None,
- surfaceFeatureAssignments=None,
- surfaceBeamSmoothingAssignments=<abaqus.Interaction.SurfaceBeamSmoothingAssignment.SurfaceBeamSmoothingAssignment object>,
- surfaceVertexCriteriaAssignments=<abaqus.Interaction.SurfaceVertexCriteriaAssignment.SurfaceVertexCriteriaAssignment object>,
- slidingFormulationAssignments=None,
- mainSecondaryAssignments=None,
- initializationAssignments=None,
- stabilizationAssignments=None,
- smoothingAssignments=None,
- slidingTransitionAssignments=None,
This method creates a ContactStd object.
Note
This function can be accessed by:
mdb.models[name].ContactStd
Note
- Parameters:¶
- name¶
A String specifying the repository key.
- createStepName¶
A String specifying the name of the step in which this contact interaction is created.
- useAllstar :
Union
[AbaqusBoolean
,bool
], default:0
A Boolean specifying whether the contacting surface pairs consist of all exterior faces in the model.
- globalSmoothing :
Union
[AbaqusBoolean
,bool
], default:1
A Boolean specifying whether surface smoothing (geometric correction) is automatically applied to all eligible surfaces. The default value is ON.
- includedPairs :
RegionPairs
|None
, default:None
A RegionPairs object specifying the domain pairs included in contact.
- excludedPairs :
RegionPairs
|None
, default:None
A RegionPairs object specifying the domain pairs excluded from contact.
- contactPropertyAssignments :
ContactPropertyAssignment
|None
, default:None
A ContactPropertyAssignment object specifying the contact property assignments in the contact domain.
- surfaceThicknessAssignments :
SurfaceThicknessAssignment
|None
, default:None
A SurfaceThicknessAssignment object specifying the surface thickness assignments in the contact domain.
- surfaceOffsetAssignments :
SurfaceOffsetAssignment
|None
, default:None
A SurfaceOffsetAssignment object specifying the surface offset fraction assignments in the contact domain.
- surfaceFeatureAssignments :
SurfaceFeatureAssignment
|None
, default:None
A SurfaceFeatureAssignment object specifying the surface feature angle assignments in the contact domain.
- surfaceBeamSmoothingAssignments :
SurfaceBeamSmoothingAssignment
, default:<abaqus.Interaction.SurfaceBeamSmoothingAssignment.SurfaceBeamSmoothingAssignment object at 0x7ff7133a92d0>
A SurfaceBeamSmoothingAssignment object specifying the surface beam smoothing assignments in the contact domain.
Added in version 2021: The
surfaceBeamSmoothingAssignments
argument was added.- surfaceVertexCriteriaAssignments :
SurfaceVertexCriteriaAssignment
, default:<abaqus.Interaction.SurfaceVertexCriteriaAssignment.SurfaceVertexCriteriaAssignment object at 0x7ff7133a15d0>
A SurfaceVertexCriteriaAssignment object specifying the surface vertex criteria assignments in the contact domain.
Added in version 2021: The
surfaceVertexCriteriaAssignments
argument was added.- slidingFormulationAssignments :
Optional
[Sequence
[SlidingFormulationAssignment
]], default:None
A sequence of tuples of SlidingFormulationAssignment specifying the sliding formulation assignments. Each tuple contains two entries:
A region object or the SymbolicConstant GLOBAL specifying the surface to which the sliding formulation attribute is assigned.
A SymbolicConstant specifying the overriding the smoothness value to be used for the first surface. Possible values of the SymbolicConstant are NONE and SMALL_SLIDING.
Added in version 2021: The
slidingFormulationAssignments
argument was added.- mainSecondaryAssignments :
MainSecondaryAssignment
|None
, default:None
A MainSecondaryAssignment object specifying the main-secondary assignments in the contact domain.
Changed in version 2022: The argument
masterSlaveAssignments
was renamed tomainSecondaryAssignments
.- initializationAssignments :
InitializationAssignment
|None
, default:None
An InitializationAssignment object specifying the contact initialization assignments in the contact domain.
- stabilizationAssignments :
StabilizationAssignment
|None
, default:None
A StabilizationAssignment object specifying the contact stabilization assignments in the contact domain.
- smoothingAssignments :
SmoothingAssignment
|None
, default:None
A SmoothingAssignment object specifying the surface smoothing assignments in the contact domain.
- slidingTransitionAssignments :
SlidingTransitionAssignment
|None
, default:None
A SlidingTransitionAssignments object specifying the sliding transition assignments in the contact domain.
- Returns:¶
A ContactStd object.
- Return type:¶
- CyclicSymmetry(
- name,
- createStepName,
- main,
- secondary,
- repetitiveSectors,
- axisPoint1,
- axisPoint2,
- extractedNodalDiameter=
ALL_NODAL_DIAMETER
, - lowestNodalDiameter=
0
, - highestNodalDiameter=
0
, - excitationNodalDiameter=
0
, - adjustTie=
1
, - positionTolerance=
0
, - positionToleranceMethod=
COMPUTED_TOLERANCE
, This method creates a CyclicSymmetry object.
Note
This function can be accessed by:
mdb.models[name].CyclicSymmetry
Note
- Parameters:¶
- name¶
A String specifying the repository key.
- createStepName¶
A String specifying the name of the step in which the cyclic symmetry interaction should be created.
- main¶
A Region object specifying the main surface.
Changed in version 2022: The argument
master
was renamed tomain
.- secondary¶
A Region object specifying the secondary surface.
Changed in version 2022: The argument
slave
was renamed tosecondary
.- repetitiveSectors¶
An Int specifying the total number of sectors in the cyclic symmetric model.
- axisPoint1¶
A Region object specifying the first point of the axis of symmetry. The region should contain exactly one mesh node, vertex, interesting point, reference point, or datum point. In a two-dimensional model axisPoint1 is the only point used to define the axis of symmetry.
- axisPoint2¶
A Region object specifying the second point of the axis of symmetry. The region should contain exactly one mesh node, vertex, interesting point, reference point, or datum point. This point is ignored in a two-dimensional model.
- extractedNodalDiameter=
ALL_NODAL_DIAMETER
¶ A SymbolicConstant specifying whether Abaqus should extract all possible nodal diameters or the nodal diameters between the user-specified values for lowestNodalDiameter and highestNodalDiameter. Possible values are ALL_NODAL_DIAMETER and SPECIFIED_NODAL_DIAMETER. The default value is ALL_NODAL_DIAMETER.
- lowestNodalDiameter=
0
¶ An Int specifying the lowest nodal diameter to be used in the eigenfrequency analysis. The default value is 0.
- highestNodalDiameter=
0
¶ An Int specifying the highest nodal diameter to be used in the eigenfrequency analysis. This argument value should be less than or equal to the half of the total number of sectors (as specified in the repetitiveSectors parameter). The default value is 0.
- excitationNodalDiameter=
0
¶ An Int specifying the nodal diameter for which the modal-based steady-state dynamic analysis will be performed. This value should be greater than or equal to the lowest nodal diameter (specified in the lowestNodalDiameter parameter), and less than or equal to the highest nodal diameter (specified in the highestNodalDiameter parameter). The default value is 0.
- adjustTie=
1
¶ A Boolean specifying whether or not to adjust the secondary surface of the cyclic symmetry to tie it to the main surface. The default value is ON.
- positionTolerance=
0
¶ A Float specifying the position tolerance. The*positionTolerance* argument applies only when positionToleranceMethod = SPECIFY_TOLERANCE. The default value is 0.0.
- positionToleranceMethod=
COMPUTED_TOLERANCE
¶ A SymbolicConstant specifying the method used to determine the position tolerance. Possible values are COMPUTED_TOLERANCE and SPECIFY_TOLERANCE. The default value is COMPUTED_TOLERANCE.
- Returns:¶
A CyclicSymmetry object.
- Return type:¶
- ElasticFoundation(name, createStepName, surface, stiffness)[source]¶
This method creates an ElasticFoundation object.
Note
This function can be accessed by:
mdb.models[name].ElasticFoundation
Note
- Parameters:¶
- name¶
A String specifying the repository key.
- createStepName¶
A String specifying the name of the step in which the ElasticFoundation object is created. createStepName must be set to ‘Initial’.
- surface¶
A Region object specifying the surface to which the foundation applies.
- stiffness¶
A Float specifying the foundation stiffness per area (or per length for beams).
- Returns:¶
An ElasticFoundation object.
- Return type:¶
- FilmCondition(
- name,
- createStepName,
- surface,
- definition,
- interactionProperty=
''
, - sinkTemperature=
0
, - sinkAmplitude=
''
, - filmCoeff=
0
, - filmCoeffAmplitude=
''
, - field=
''
, - sinkFieldName=
''
, - sinkDistributionType=
UNIFORM
, This method creates a FilmCondition object.
Note
This function can be accessed by:
mdb.models[name].FilmCondition
Note
- Parameters:¶
- name¶
A String specifying the repository key.
- createStepName¶
A String specifying the name of the step in which the FilmCondition object is created.
- surface¶
A Region object specifying the name of the surface to which the film condition interaction is applied.
- definition¶
A SymbolicConstant specifying how the film condition is defined. Possible values are EMBEDDED_COEFF, PROPERTY_REF, USER_SUB, and FIELD.
- interactionProperty=
''
¶ A String specifying the name of the FilmConditionProp object associated with this interaction. The interactionProperty argument applies only when definition = PROPERTY_REF. The default value is an empty string.
- sinkTemperature=
0
¶ A Float specifying the reference sink temperature, θ0θ0. The default value is 0.0.
- sinkAmplitude=
''
¶ A String specifying the name of the Amplitude object that gives the variation of the sink temperature, θ0θ0, with time. The default value is an empty string. Note: Use empty string in an Abaqus/Standard analysis to specify that the reference sink temperature is applied immediately at the beginning of the step or linearly over the step. Use empty string in an Abaqus/Explicit analysis to specify that the reference sink temperature is applied throughout the step.
- filmCoeff=
0
¶ A Float specifying the reference film coefficient value, hh. The filmCoeff argument applies when definition = EMBEDDED_COEFF, definition = USER_SUB, or definition = FIELD. The default value is 0.0.
- filmCoeffAmplitude=
''
¶ A String specifying the name of the Amplitude object that gives the variation of the film coefficient, hh, with time. The default value is an empty string. Note: Use empty string in an Abaqus/Standard analysis to specify that the reference film coefficient is applied immediately at the beginning of the step or linearly over the step. Use empty string in an Abaqus/Explicit analysis to specify that the reference film coefficient is applied throughout the step.
- field=
''
¶ A String specifying the name of the AnalyticalField object associated with this interaction. The field argument applies only when definition = FIELD. The default value is an empty string.
- sinkFieldName=
''
¶ A String specifying the name of the AnalyticalField or DiscreteField object associated with the sink temperature. The sinkFieldName argument applies only when sinkDistributionType = ANALYTICAL_FIELD or sinkDistributionType = DISCRETE_FIELD. The default value is an empty string.
- sinkDistributionType=
UNIFORM
¶ A SymbolicConstant specifying how the sink temperature is distributed. Possible values are UNIFORM, ANALYTICAL_FIELD, and DISCRETE_FIELD. The default value is UNIFORM.
- Returns:¶
A FilmCondition object.
- Return type:¶
- FluidCavity(
- name,
- createStepName,
- cavityPoint,
- cavitySurface,
- interactionProperty,
- ambientPressure=
0
, - thickness=
1
, - useAdiabatic=
0
, - checkNormals=
1
, This method creates an FluidCavity object.
Note
This function can be accessed by:
mdb.models[name].FluidCavity
Note
- Parameters:¶
- name¶
A String specifying the repository key.
- createStepName¶
A String specifying the name of the step in which the FluidCavity object is created.
- cavityPoint¶
A Region object specifying the fluid cavity reference point.
- cavitySurface¶
A Region object specifying the surface forming the boundary of the fluid cavity.
- interactionProperty¶
A String specifying the FluidCavityProperty object associated with this interaction.
- ambientPressure=
0
¶ A Float specifying the magnitude of the ambient pressure. The default value is 0.0.
- thickness=
1
¶ A Float specifying the out-of-plane thickness of the surface for two-dimensional models. This argument is valid only when using two-dimensional models. The default value is 1.0.
- useAdiabatic=
0
¶ A Boolean specifying whether adiabatic behavior is assumed for the ideal gas. This argument is valid only when interactionProperty specifies a pneumatic definition. The default value is OFF.
- checkNormals=
1
¶ A Boolean specifying whether the analysis will check the consistency of the surface normals. The default value is ON.
- Returns:¶
A FluidCavity object.
- Return type:¶
- FluidExchange(
- name,
- createStepName,
- firstCavity,
- interactionProperty,
- definition=
TO_ENVIRONMENT
, - secondCavity=
''
, - exchangeArea=
1
, This method creates an FluidExchange object.
Note
This function can be accessed by:
mdb.models[name].FluidExchange
Note
- Parameters:¶
- name¶
A String specifying the repository key.
- createStepName¶
A String specifying the name of the step in which the FluidExchange object is created.
- firstCavity¶
A String specifying the first FluidCavity object associated with this interaction. This will be the only cavity specified if definition = TO_ENVIRONMENT.
- interactionProperty¶
A String specifying the FluidExchangeProperty object associated with this interaction.
- definition=
TO_ENVIRONMENT
¶ A SymbolicConstant specifying the type of fluid exchange to be defined. Possible values are TO_ENVIRONMENT and BETWEEN_CAVITIES. The default value is TO_ENVIRONMENT.
- secondCavity=
''
¶ A String specifying the second FluidCavity object associated with this interaction. This argument is applicable only when definition = BETWEEN_CAVITIES.
- exchangeArea=
1
¶ A Float specifying the effective exchange area. The default value is 1.0.
- Returns:¶
A FluidExchange object.
- Return type:¶
- FluidInflator( )[source]¶
This method creates a FluidInflator object.
Note
This function can be accessed by:
mdb.models[name].FluidInflator
Added in version 2019: The
FluidInflator
method was added.Note
- Parameters:¶
- name¶
A String specifying the repository key.
- createStepName¶
A String specifying the name of the step in which the FluidInflator object is created.
- cavity¶
A String specifying the first FluidCavity object associated with this interaction.
- interactionProperty¶
A String specifying the FluidInflatorProperty object associated with this interaction.
- inflationTimeAmplitude=
''
¶ A string specifying the name of the amplitude curve defining a mapping between the inflation time and the actual time.
- massFlowAmplitude=
''
¶ A string specifying the name of the amplitude curve by which to modify the mass flow rate.
- Returns:¶
A FluidInflator object.
- IncidentWave(
- name,
- createStepName,
- sourcePoint,
- standoffPoint,
- surface,
- interactionProperty,
- definition=
PRESSURE
, - amplitude=
''
, - imaginaryAmplitude=
''
, - surfaceNormal=
()
, - initialDepth=
None
, - referenceMagnitude=
None
, - detonationTime=
None
, - magnitudeFactor=
1
, This method creates an IncidentWave object.
Note
This function can be accessed by:
mdb.models[name].IncidentWave
Note
- Parameters:¶
- name¶
A String specifying the repository key.
- createStepName¶
A String specifying the name of the step in which the IncidentWave object is created.
- sourcePoint¶
A Region object specifying the incident wave source point.
- standoffPoint¶
A Region object specifying the incident wave standoff point.This argument is not valid when definition = CONWEP.
- surface¶
A Region object specifying the surface defining the incident wave interaction. In problems involving fluid/surface boundaries, both the fluid surface and the solid surface comprising the boundary must have an incident wave interaction specified.
- interactionProperty¶
A String specifying the IncidentWaveProperty object associated with this interaction.
- definition=
PRESSURE
¶ A SymbolicConstant specifying the type of incident wave to be defined. The value must be PRESSURE for linear perturbation steps. An Explicit step is required when the value is set to CONWEP. Possible values are PRESSURE, ACCELERATION, UNDEX, and CONWEP. The default value is PRESSURE.
- amplitude=
''
¶ A String specifying the name of the Amplitude object that defines the fluid pressure time history at the standoff point, if definition = PRESSURE. If definition = ACCELERATION, then this string specifies the name of the Amplitude object that defines the fluid particle acceleration time history at the standoff point. This member can be specified only if definition = PRESSURE or ACCELERATION. The default value is an empty string.
- imaginaryAmplitude=
''
¶ A String specifying the name of the Amplitude object that defines the imaginary component of the fluid pressure time history at the standoff point. This member is applicable only for linear perturbation steps and if definition = PRESSURE. The default value is an empty string.
- surfaceNormal=
()
¶ A sequence of three Floats specifying the X, Y, and Z components of the direction cosine of the fluid surface normal.This argument is valid only when definition = UNDEX.
- initialDepth=
None
¶ None or a Float specifying the initial depth of the UNDEX bubble. The default value is None.This argument is valid only when definition = UNDEX.
- referenceMagnitude=
None
¶ A Float specifying the reference magnitude.This argument is not valid when definition = CONWEP.
- detonationTime=
None
¶ A Float specifying the time of detonation, given in total time.This argument is valid only when definition = CONWEP.
- magnitudeFactor=
1
¶ A Float specifying the magnitude scale factor. The default value is 1.0.This argument is valid only when definition = CONWEP.
- Returns:¶
An IncidentWave object.
- Return type:¶
- ModelChange(
- name,
- createStepName,
- isRestart=
0
, - regionType=
GEOMETRY
, - region=
None
, - activeInStep=
0
, - includeStrain=
0
, This method creates a ModelChange object.
Note
This function can be accessed by:
mdb.models[name].ModelChange
Note
- Parameters:¶
- name¶
A String specifying the repository key.
- createStepName¶
A String specifying the name of the step in which the ModelChange object is created.
- isRestart=
0
¶ A Boolean specifying whether this interaction is being used solely to indicate that model change may be required in a subsequent restart analysis (either for elements or contact pairs). The default value is OFF.
- regionType=
GEOMETRY
¶ A SymbolicConstant specifying the region selection type. This argument is valid only when isRestart = False. Possible values are GEOMETRY, SKINS, STRINGERS, and ELEMENTS. The default value is GEOMETRY.
- region=
None
¶ A Region object specifying the elements to be removed or reactivated. This argument is valid only when isRestart = False.
- activeInStep=
0
¶ A Boolean specifying whether elements are being removed or reactivated. This argument is valid only when isRestart = False. The default value is OFF.
- includeStrain=
0
¶ A Boolean specifying whether stress/displacement elements are reactivated with strain. This argument is valid only when isRestart = False and when activeInStep = True. The default value is OFF.
- Returns:¶
A ModelChange object.
- Return type:¶
- PressurePenetration(
- name,
- createStepName,
- contactInteraction,
- mainPoints,
- secondaryPoints,
- penetrationPressure,
- criticalPressure,
- amplitude=
UNSET
, - penetrationTime=
0
, This method creates a PressurePenetration object.
Note
This function can be accessed by:
mdb.models[name].PressurePenetration
Note
- Parameters:¶
- name¶
A String specifying the repository key.
- createStepName¶
A String specifying the name of the step in which the PressurePenetration object is created.
- contactInteraction¶
A String specifying the name of the Surface-to-surface contact (Standard) interaction.
- mainPoints¶
A RegionArray object specifying the points on the main surface that are exposed to the fluid.
Changed in version 2022: The argument
masterPoints
was renamed tomainPoints
.- secondaryPoints¶
A RegionArray object specifying the points on the secondary surface that are exposed to the fluid.
Changed in version 2022: The argument
slavePoints
was renamed tosecondaryPoints
.- penetrationPressure¶
A tuple of Floats specifying the fluid pressure magnitude. For steady state dynamic analyses, a tuple of Complexes specifying the fluid pressure magnitude.
- criticalPressure¶
A tuple of Floats specifying the critical contact pressure below which fluid penetration starts to occur.
- amplitude=
UNSET
¶ A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.
- penetrationTime=
0
¶ A Float specifying the fraction of the current step time over which the fluid pressure on newly penetrated contact surface segments is ramped up to the current magnitude. The default value is 0.001.
- Returns:¶
A PressurePenetration object.
- Return type:¶
- RadiationToAmbient(
- name,
- createStepName,
- surface,
- emissivity,
- field=
''
, - distributionType=
UNIFORM
, - radiationType=
AMBIENT
, - ambientTemperature=
0
, - ambientTemperatureAmp=
''
, This method creates a RadiationToAmbient object.
Note
This function can be accessed by:
mdb.models[name].RadiationToAmbient
Note
- Parameters:¶
- name¶
A String specifying the repository key.
- createStepName¶
A String specifying the name of the step in which the RadiationToAmbient object is created.
- surface¶
A Region object specifying the surface to which the radiation interaction is applied.
- emissivity¶
A Float specifying the emissivity, ϵϵ.
- field=
''
¶ A String specifying the name of the AnalyticalField object associated with this interaction. The field argument applies only when distributionType = ANALYTICAL_FIELD. The default value is an empty string.
- distributionType=
UNIFORM
¶ A SymbolicConstant specifying how the radiation is distributed. This argument applies only when radiationType = AMBIENT. Possible values are UNIFORM and ANALYTICAL_FIELD. The default value is UNIFORM.
- radiationType=
AMBIENT
¶ A SymbolicConstant specifying whether to use the default surface radiation behavior, or the cavity radiation approximation. Possible values are AMBIENT and CAVITY. The default value is AMBIENT.
- ambientTemperature=
0
¶ A Float specifying the reference ambient temperature, θ0θ0. This argument applies only when radiationType = AMBIENT. The default value is 0.0.
- ambientTemperatureAmp=
''
¶ A String specifying the name of the Amplitude object that gives the variation of the ambient temperature with time. Note: Use None in an Abaqus/Standard analysis to specify that the reference ambient temperature is applied immediately at the beginning of the step or linearly over the step. Use None in an Abaqus/Explicit analysis to specify that the reference ambient temperature is applied throughout the step. This argument applies only when radiationType = AMBIENT.
- Returns:¶
A RadiationToAmbient object.
- Return type:¶
- SelfContactExp(
- name,
- createStepName,
- surface,
- interactionProperty,
- mechanicalConstraint=
KINEMATIC
, - contactControls=
''
, This method creates a SelfContactExp object.
Note
This function can be accessed by:
mdb.models[name].SelfContactExp
Note
- Parameters:¶
- name¶
A String specifying the repository key.
- createStepName¶
A String specifying the name of the step in which the SelfContactExp object is created.
- surface¶
A Region object specifying the surface where self-contact is defined.
- interactionProperty¶
A String specifying the name of the ContactProperty object associated with this interaction.
- mechanicalConstraint=
KINEMATIC
¶ A SymbolicConstant specifying the mechanical constraint formulation. Possible values are KINEMATIC and PENALTY. The default value is KINEMATIC.
- contactControls=
''
¶ A String specifying the name of the ContactControl object associated with this interaction. An empty string indicates that the default contact controls will be used. The default value is an empty string.
- Returns:¶
A SelfContactExp object.
- Return type:¶
- SelfContactStd(
- name,
- createStepName,
- surface,
- interactionProperty,
- enforcement=
SURFACE_TO_SURFACE
, - thickness=
1
, - smooth=
0
, - contactControls=
''
, This method creates a SelfContactStd object.
Note
This function can be accessed by:
mdb.models[name].SelfContactStd
Note
- Parameters:¶
- name¶
A String specifying the repository key.
- createStepName¶
A String specifying the name of the step in which the SelfContactStd object is created.
- surface¶
A Region object specifying the surface where self-contact is defined.
- interactionProperty¶
A String specifying the name of the ContactProperty object associated with this interaction.
- enforcement=
SURFACE_TO_SURFACE
¶ A SymbolicConstant specifying the discretization method. Possible values are NODE_TO_SURFACE and SURFACE_TO_SURFACE. The default value is SURFACE_TO_SURFACE.
- thickness=
1
¶ A Boolean specifying whether shell/membrane element thickness is considered. The default value is ON.This argument in valid only when enforcement = SURFACE_TO_SURFACE.
- smooth=
0
¶ A Float specifying the degree of smoothing used for deformable or rigid main surfaces involved when enforcement = NODE_TO_SURFACE. The value given must lie between 0.0 and 0.5. The default value is 0.2.
Changed in version 2022: Rigid master surfaces was changed to rigid main surfaces.
- contactControls=
''
¶ A String specifying the name of the ContactControl object associated with this interaction. An empty string indicates that the default contact controls will be used. The default value is an empty string.
- Returns:¶
A SelfContactStd object.
- Return type:¶
- StdXplCosimulation(
- name,
- createStepName,
- region,
- incrementation=
ALLOW_SUBCYCLING
, - stepSize=
0
, - stepSizeDefinition=
DEFAULT
, This method creates a StdXplCosimulation object.
Note
This function can be accessed by:
mdb.models[name].StdXplCosimulation
Note
- Parameters:¶
- name¶
A String specifying the repository key.
- createStepName¶
A String specifying the name of the step in which the StdXplCosimulation object is created.
- region¶
A Region object specifying the import and export region upon which the co-simulation exchanges data with the coupled analysis program.
- incrementation=
ALLOW_SUBCYCLING
¶ A SymbolicConstant specifying whether the analysis programs use the same time increments or one is allowed to use more time increments than the other before exchanging data. Possible values are ALLOW_SUBCYCLING and LOCKSTEP. The default value is ALLOW_SUBCYCLING.
- stepSize=
0
¶ A Float specifying the size of the increments to be used by Abaqus/Standard and Abaqus/Explicit. The default value is 0.0.
- stepSizeDefinition=
DEFAULT
¶ A SymbolicConstant specifying whether the increment size is the analysis default or a supplied variable. Possible values are DEFAULT and SPECIFIED. The default value is DEFAULT.
- Returns:¶
A StdXplCosimulation object.
- Return type:¶
- SurfaceToSurfaceContactExp(
- name,
- createStepName,
- main,
- secondary,
- sliding,
- interactionProperty,
- mechanicalConstraint=
KINEMATIC
, - weightingFactorType=
DEFAULT
, - weightingFactor=
0
, - contactControls=
''
, - initialClearance=
OMIT
, - halfThreadAngle=
None
, - pitch=
None
, - majorBoltDiameter=
COMPUTED
, - meanBoltDiameter=
COMPUTED
, - datumAxis=
None
, - useReverseDatumAxis=
0
, - clearanceRegion=
None
, This method creates a SurfaceToSurfaceContactExp object.
Note
This function can be accessed by:
mdb.models[name].SurfaceToSurfaceContactExp
Note
- Parameters:¶
- name¶
A String specifying the repository key.
- createStepName¶
A String specifying the name of the step in which the SurfaceToSurfaceContactExp object is created.
- main¶
A Region object specifying the main surface.
Changed in version 2022: The argument
master
was renamed tomain
.- secondary¶
A Region object specifying the secondary surface.
Changed in version 2022: The argument
slave
was renamed tosecondary
.- sliding¶
A SymbolicConstant specifying the contact formulation. Possible values are FINITE and SMALL.
- interactionProperty¶
A String specifying the name of the ContactProperty object associated with this interaction.
- mechanicalConstraint=
KINEMATIC
¶ A SymbolicConstant specifying the mechanical constraint formulation. Possible values are KINEMATIC and PENALTY. The default value is KINEMATIC.
- weightingFactorType=
DEFAULT
¶ A SymbolicConstant specifying the weighting for node-to-face contact. Possible values are DEFAULT and SPECIFIED. The default value is DEFAULT.
- weightingFactor=
0
¶ A Float specifying the weighting factor for the contact surfaces when weightingFactorType = SPECIFIED. The default value is 0.0.
- contactControls=
''
¶ A String specifying the name of the ContactControl object associated with this interaction. An empty string indicates that the default contact controls will be used. The default value is an empty string.
- initialClearance=
OMIT
¶ A SymbolicConstant or a Float specifying the initial clearance at regions of contact. Possible values are OMIT and COMPUTED. The default value is OMIT.
- halfThreadAngle=
None
¶ None or a sequence of Floats specifying the half thread angle used for bolt clearance. The default value is None.
- pitch=
None
¶ None or a sequence of Floats specifying the pitch used for bolt clearance. The default value is None.
- majorBoltDiameter=
COMPUTED
¶ The SymbolicConstant COMPUTED or a Float specifying the major diameter of the bolt used for bolt clearance. The default value is COMPUTED.
- meanBoltDiameter=
COMPUTED
¶ The SymbolicConstant COMPUTED or a Float specifying the mean diameter of the bolt used for bolt clearance. The default value is COMPUTED.
- datumAxis=
None
¶ A DatumAxis object specifying the orientation of the bolt hole when specifying bolt clearance.
- useReverseDatumAxis=
0
¶ A Boolean specifying whether to reverse the bolt clearance direction given by the datum axis. The default value is OFF.
- clearanceRegion=
None
¶ A Region object specifying the contact region for which clearance is specified.
- Returns:¶
A SurfaceToSurfaceContactExp object.
- Return type:¶
- SurfaceToSurfaceContactStd(
- name,
- createStepName,
- main,
- secondary,
- sliding,
- interactionProperty,
- interferenceType=
NONE
, - overclosure=
0
, - interferenceDirectionType=
COMPUTED
, - direction=
()
, - amplitude=
''
, - smooth=
0
, - hcrit=
0
, - extensionZone=
0
, - adjustMethod=
NONE
, - adjustTolerance=
0
, - adjustSet=
None
, - enforcement=
SURFACE_TO_SURFACE
, - thickness=
1
, - contactControls=
''
, - tied=
0
, - initialClearance=
OMIT
, - halfThreadAngle=
None
, - pitch=
None
, - majorBoltDiameter=
COMPUTED
, - meanBoltDiameter=
COMPUTED
, - datumAxis=
None
, - useReverseDatumAxis=
0
, - clearanceRegion=
None
, - surfaceSmoothing=
NONE
, - bondingSet=
None
, - handedness=
RIGHT
, - normalAdjustment=
None
, This method creates a SurfaceToSurfaceContactStd object.
Note
This function can be accessed by:
mdb.models[name].SurfaceToSurfaceContactStd
Note
- Parameters:¶
- name¶
A String specifying the repository key.
- createStepName¶
A String specifying the name of the step in which the SurfaceToSurfaceContactStd object is created.
- main¶
A Region object specifying the name of the main surface.
Changed in version 2022: The
master
argument was renamed tomain
.- secondary¶
A Region object specifying the name of the secondary surface.
Changed in version 2022: The
slave
argument was renamed tosecondary
.- sliding¶
A SymbolicConstant specifying the contact formulation. Possible values are FINITE and SMALL.
- interactionProperty¶
A String specifying the name of the ContactProperty object associated with this interaction.
- interferenceType=
NONE
¶ A SymbolicConstant specifying the type of time-dependent allowable interference for contact pairs and contact elements. Possible values are:
NONE, specifying no allowable contact interference.
SHRINK_FIT.
UNIFORM.
The default value is NONE.
- overclosure=
0
¶ A Float specifying the maximum overclosure distance allowed. This argument applies only when interferenceType = UNIFORM. The default value is 0.0.
- interferenceDirectionType=
COMPUTED
¶ A SymbolicConstant specifying the method used to determine the interference direction. Possible values are COMPUTED and DIRECTION_COSINE. The default value is COMPUTED.
- direction=
()
¶ A sequence of three Floats specifying the following:
XX-direction cosine of the interference direction vector.
YY-direction cosine of the interference direction vector.
ZZ-direction cosine of the interference direction vector.
This argument is required only when interferenceDirectionType = DIRECTION_COSINE.
- amplitude=
''
¶ A String specifying the name of the amplitude curve that defines the magnitude of the prescribed interference during the step. Use None to specify that the prescribed interference is applied immediately at the beginning of the step and ramped down to zero linearly over the step.
- smooth=
0
¶ A Float specifying the degree of smoothing used for deformable or rigid main surfaces involved when enforcement = NODE_TO_SURFACE. The value given must lie between 0.0 and 0.5. The default value is 0.2.
- hcrit=
0
¶ A Float specifying the distance by which a secondary node must penetrate the main surface before Abaqus/Standard abandons the current increment and tries again with a smaller increment. The default value is 0.0.
- extensionZone=
0
¶ A Float specifying a fraction of the end segment or facet edge length by which the main surface is to be extended to avoid numerical round-off errors associated with contact modeling. The value given must lie between 0.0 and 0.2. The default value is 0.1.
- adjustMethod=
NONE
¶ A SymbolicConstant specifying the adjust method. Possible values are NONE, OVERCLOSED, TOLERANCE, and SET. The default value is NONE.
- adjustTolerance=
0
¶ A Float specifying the adjust tolerance. The default value is 0.0.
- adjustSet=
None
¶ A Region object specifying the Set object to which the adjustment is to be applied.
- enforcement=
SURFACE_TO_SURFACE
¶ A SymbolicConstant specifying the discretization method. Possible values are NODE_TO_SURFACE and SURFACE_TO_SURFACE. The default value is SURFACE_TO_SURFACE.
- thickness=
1
¶ A Boolean specifying whether shell/membrane element thickness is considered. The default value is ON.This argument is not valid when sliding = FINITE and enforcement = NODE_TO_SURFACE.
- contactControls=
''
¶ A String specifying the name of the ContactControl object associated with this interaction. The empty string indicates that the default contact controls will be used. The default value is an empty string.
- tied=
0
¶ A Boolean specifying whether the surfaces are to be “tied” together for the duration of the simulation. The default value is OFF.
- initialClearance=
OMIT
¶ A SymbolicConstant or a Float specifying the initial clearance at regions of contact. Possible values are OMIT and COMPUTED. The default value is OMIT.
- halfThreadAngle=
None
¶ None or a sequence of Floats specifying the half thread angle used for bolt clearance. The default value is None.
- pitch=
None
¶ None or a sequence of Floats specifying the pitch used for bolt clearance. The default value is None.
- majorBoltDiameter=
COMPUTED
¶ The SymbolicConstant COMPUTED or a Float specifying the major diameter of the bolt used for bolt clearance. The default value is COMPUTED.
- meanBoltDiameter=
COMPUTED
¶ The SymbolicConstant COMPUTED or a Float specifying the mean diameter of the bolt used for bolt clearance. The default value is COMPUTED.
- datumAxis=
None
¶ A DatumAxis object specifying the orientation of the bolt hole when specifying bolt clearance.
- useReverseDatumAxis=
0
¶ A Boolean specifying whether to reverse the bolt clearance direction given by the datum axis. The default value is OFF.
- clearanceRegion=
None
¶ A Region object specifying the contact region for which clearance is specified.
- surfaceSmoothing=
NONE
¶ A SymbolicConstant specifying whether to use surface smoothing for geometric surfaces in SurfaceToSurfaceContactStd interactions. Possible values are AUTOMATIC and NONE. The default value is NONE.
- bondingSet=
None
¶ A Region object specifying the secondary node sub-set for bonding, used only when the contact property CohesiveBehavior option specifies use.
- handedness=
RIGHT
¶ A SymbolicConstant specifying the bolt handedness formulation. Possible values are RIGHT and LEFT. The default value is RIGHT.
Added in version 2019: The
normalAdjustment
argument was added.- normalAdjustment=
None
¶ A SymbolicConstant specifying the bolt normal adjustment formulation for all secondary nodes. Possible values are UNIFORM AXIAL COMPONENT and LOCATION DEPENDENT. The default value is UNIFORM AXIAL COMPONENT.
Added in version 2019: The
normalAdjustment
argument was added.
- Returns:¶
A SurfaceToSurfaceContactStd object.
- Return type:¶
-
XFEMCrackGrowth(name, createStepName, crackName, allowGrowth=
1
)[source]¶ This method creates an XFEMCrackGrowth object.
Note
This function can be accessed by:
mdb.models[name].XFEMCrackGrowth
Note
- Parameters:¶
- name¶
A String specifying the repository key.
- createStepName¶
A String specifying the name of the step in which the XFEMCrackGrowth object is created.
- crackName¶
A String specifying the XFEMCrack object associated with this interaction.
- allowGrowth=
1
¶ A Boolean specifying whether the crack is allowed to grow (propagate) during this analysis step. The default value is ON.
- Returns:¶
A XFEMCrackGrowth object.
- Return type:¶
- contactDetection(
- name=
''
, - createStepName=
''
, - searchDomain=
MODEL
, - defaultType=
CONTACT
, - interactionProperty=
''
, - separationTolerance=
None
, - extendByAngle=
20
, - mergeWithinAngle=
20
, - searchSingleInstances=
0
, - nameEachSurfaceFound=
1
, - createUnionOfMainSurfaces=
0
, - createUnionOfSecondarySurfaces=
0
, - createUnionOfMainSecondarySurfaces=
0
, - includePlanar=
1
, - includeCylindricalSphericalToric=
1
, - includeSplineBased=
1
, - includeMeshSolid=
1
, - includeMeshShell=
1
, - includeMeshMembrane=
0
, - includeOverclosed=
1
, - includeNonOverlapping=
0
, - meshedGeometrySearchTechnique=
USE_GEOMETRY
, - useShellThickness=
1
, - surfaceSmoothing=
None
, This method uses contact detection to create SurfaceToSurfaceContactStd, SurfaceToSurfaceContactExp, and Tie objects.
- Parameters:¶
- name=
''
¶ A String specifying the prefix used to generate repository keys. The default value is “CP-”
- createStepName=
''
¶ A String specifying the name of the step in which the SurfaceToSurfaceContactStd, SurfaceToSurfaceContactExp, and Tie objects are created. The default value is “Initial.”
- searchDomain=
MODEL
¶ A SymbolicConstant MODEL or a sequence of Strings specifying the names of instances to search. MODEL indicates the whole model is searched. The default value is MODEL.
- defaultType=
CONTACT
¶ A SymbolicConstant specifying the default type of object to create. Possible values are CONTACT, CONTACT_STANDARD, CONTACT_EXPLICIT, and TIE. If CONTACT is used, the behavior is determined by the type of Step in the model. If an ExplicitDynamicsStep or TempDisplacementDynamicsStep exists, then SurfaceToSurfaceContactExp is created by default. Otherwise SurfaceToSurfaceContactStd is created by default. The default value is CONTACT.
- interactionProperty=
''
¶ A String specifying the name of the ContactProperty object associated with any interactions created.
- separationTolerance=
None
¶ A Float specifying the maximum separation for considering two surfaces to be candidates for contact, where separation is the maximum distance between the points of closest approach on the two surfaces. The default value is a function of the model.
- extendByAngle=
20
¶ None or a Float specifying the angle for extending surface definitions to include adjacent faces. The default value is 20.
- mergeWithinAngle=
20
¶ None or a Float specifying the angle for merging adjacent contact pairs that lie within the angle. The default value is 20.
- searchSingleInstances=
0
¶ A Boolean specifying whether to include surface pairs within a single instance. The default value is OFF.
- nameEachSurfaceFound=
1
¶ A Boolean specifying whether to assign a name to each surface found. The default value is ON.
- createUnionOfMainSurfaces=
0
¶ A Boolean specifying whether to create a surface that is the union of all main surfaces found. The default value is OFF.
Changed in version 2022: The argument
createUnionOfMasterSurfaces
was renamed tocreateUnionOfMainSurfaces
.- createUnionOfSecondarySurfaces=
0
¶ A Boolean specifying whether to create a surface that is the union of all secondary surfaces found. The default value is OFF.
Changed in version 2022: The argument
createUnionOfSlaveSurfaces
was renamed tocreateUnionOfSecondarySurfaces
.- createUnionOfMainSecondarySurfaces=
0
¶ A Boolean specifying whether to create a surface that is the union of all main and secondary surfaces found. The default value is OFF.
Changed in version 2022: The argument
createUnionOfMasterSlaveSurfaces
was renamed tocreateUnionOfMainSecondarySurfaces
.- includePlanar=
1
¶ A Boolean specifying whether to include planar geometry. The default value is ON.
- includeCylindricalSphericalToric=
1
¶ A Boolean specifying whether to include cylindrical, spherical, and toric geometry. The default value is ON.
- includeSplineBased=
1
¶ A Boolean specifying whether to include spline-based geometry. The default value is ON.
- includeMeshSolid=
1
¶ A Boolean specifying whether to include solid mesh entities. The default value is ON.
- includeMeshShell=
1
¶ A Boolean specifying whether to include shell mesh entities. The default value is ON.
- includeMeshMembrane=
0
¶ A Boolean specifying whether to include mesh membrane entities. The default value is OFF.
- includeOverclosed=
1
¶ A Boolean specifying whether to include overclosed pairs. The default value is ON.
- includeNonOverlapping=
0
¶ A Boolean specifying whether to include opposing geometry surfaces that do not overlap. The default value is OFF.
- meshedGeometrySearchTechnique=
USE_GEOMETRY
¶ A SymbolicConstant USE_GEOMETRY or USE_MESH specifying whether to locate pairs in meshed geometry using the geometric entities or mesh entities. The default value is USE_GEOMETRY.
- useShellThickness=
1
¶ A Boolean specifying whether to account for shell thickness and offset during contact detection. The default value is ON.
- surfaceSmoothing=
None
¶ A SymbolicConstant specifying whether to use surface smoothing for geometric surfaces in SurfaceToSurfaceContactStd interactions. Possible values are NONE and AUTOMATIC. The default value isAUTOMATIC.
- name=
- Return type:¶
None.
- getSurfaceSeparation()[source]¶
This method returns a list of all possible contacts that can be created using the ContactDetection method.
- Returns:¶
Tuple of tuples, where each tuple holds information, to be used in contact creation as follows:
A string specifying the name of the main surface used in contact.
A string specifying the name of the secondary surface used in contact.
A float specifying the separation distance between the main surface and the secondary surface.
A boolean specifying whether or not contact surfaces are overclosed.
- Return type:¶
- class InteractionContactControlModel(
- name,
- description=
''
, - stefanBoltzmann=
None
, - absoluteZero=
None
, - waveFormulation=
NOT_SET
, - modelType=
STANDARD_EXPLICIT
, - universalGas=
None
, - copyConstraints=
1
, - copyConnectors=
1
, - copyInteractions=
1
, Bases:
ModelBase
Public Data Attributes:
Inherited from
ModelBase
A String specifying the repository key.
None or a Float specifying the Stefan-Boltzmann constant.
None or a Float specifying the absolute zero constant.
A SymbolicConstant specifying the type of incident wave formulation to be used in acoustic problems.
None or a Float specifying the universal gas constant.
A Boolean specifying whether an input file should be written without parts and assemblies.
A Boolean specifying that the step specified by restartStep should be terminated at the increment specified by restartIncrement.
A Boolean specifying that a shell global model drives a solid submodel.
A Float specifying the time stamp that indicates when the model was last changed.
A String specifying the purpose and contents of the Model object.
A String specifying the name of the job that generated the restart data.
A String specifying the name of the step where the restart analysis will start.
A String specifying the name of the job that generated the results for the global model.
A boolean specifying the status of constraints created in a model, in the model which instances this model.
A boolean specifying the status of connectors created in a model, in the model which instances this model.
A boolean specifying the status of interactions created in a model, in the model which instances this model.
A KeywordBlock object.
A repository of Amplitude objects.
A repository of Profile objects.
A repository of BoundaryCondition objects.
A repository of ConstrainedSketchConstraint objects.
A repository of AnalyticalField objects.
A repository of DiscreteField objects.
A repository of PredefinedField objects.
A repository of Interaction objects.
A repository of InteractionProperty objects.
A repository of ContactControl objects.
A repository of ContactInitialization objects.
A repository of ContactStabilization objects.
A tuple of tuples of Strings specifying the linked child PartInstance name in the current model to the corresponding parent PartInstance name in a different model.
A tuple of tuples of Strings specifying the linked child Part name in the current model to the corresponding parent Part name in a different model.
A repository of Load objects.
A repository of Material objects.
A repository of Calibration objects.
A repository of Section objects.
A repository of RemeshingRule objects.
A repository of ConstrainedSketch objects.
A repository of Part objects.
A repository of Step objects.
A FeatureOptions object.
A repository of AdaptiveMeshConstraint objects.
A repository of AdaptiveMeshControl objects.
A repository of TimePoint objects.
A repository of Filter objects.
A repository of IntegratedOutputSection objects.
A repository of FieldOutputRequest objects.
A repository of HistoryOutputRequest objects.
A repository of OptimizationTask objects.
A repository of TableCollection objects.
A repository of EventSeriesType objects.
A repository of EventSeriesData objects.
An Int specifying the increment, interval, iteration or cycle where the restart analysis will start.
An Assembly object.
Public Methods:
ExpContactControl
(name[, globTrkChoice, ...])This method creates an ExpContactControl object.
StdContactControl
(name[, ...])This method creates an StdContactControl object.
Inherited from
ModelBase
__init__
(name[, description, ...])This method creates a Model object.
ModelFromInputFile
(name, inputFileName)This method creates a Model object by reading the keywords in an input file and creating the corresponding Abaqus/CAE objects.
ModelFromOdbFile
(name, odbFileName)This method creates a Model object by reading an output database and creating any corresponding Abaqus/CAE objects.
ModelFromNastranFile
(modelName, inputFileName)This method creates a Model object by reading the keywords in a Nastran bulk data file or Nastran input file and creating any corresponding Abaqus/CAE objects.
setValues
([description, noPartsInputFile, ...])This method modifies the Model object.
Member Details:
- ExpContactControl(
- name,
- globTrkChoice=
DEFAULT
, - globTrkInc=
None
, - fastLocalTrk=
1
, - scalePenalty=
1
, - warpCheckPeriod=
20
, - warpCutoff=
20
, This method creates an ExpContactControl object.
Note
This function can be accessed by:
mdb.models[name].ExpContactControl
Note
- Parameters:¶
- name¶
A String specifying the contact controls repository key.
- globTrkChoice=
DEFAULT
¶ A SymbolicConstant specifying whether or not the default value will be used for the maximum number of increments between global contact searches. Possible values are DEFAULT and SPECIFY. The default value is DEFAULT.
- globTrkInc=
None
¶ An Int specifying the maximum number of increments between global contact searches. The globTrkInc argument applies only when globTrkChoice = SPECIFY. The default value is 100 for surface-to-surface contact and 4 for self-contact.
- fastLocalTrk=
1
¶ A Boolean specifying whether to use the more computationally efficient local tracking method. The default value is ON.
- scalePenalty=
1
¶ A Float specifying the factor by which Abaqus/Explicit will scale the default penalty stiffness to obtain the stiffnesses used for the penalty contact pairs. The default value is 1.0.
- warpCheckPeriod=
20
¶ An Int specifying the number of increments between checks for highly warped facets on main surfaces. The default value is 20.
- warpCutoff=
20
¶ A Float specifying the out-of-plane warping angle (in degrees), at which a facet will be considered to be highly warped. The default value is 20.0.
- Returns:¶
An ExpContactControl object.
- Return type:¶
- Raises:¶
RangeError –
- StdContactControl(
- name,
- stiffnessScaleFactor=
1
, - penetrationTolChoice=
RELATIVE
, - relativePenetrationTolerance=
None
, - absolutePenetrationTolerance=
None
, - frictionOnset=
None
, - automaticTolerances=
0
, - maxchp=
0
, - perrmx=
0
, - uerrmx=
0
, - stabilizeChoice=
NONE
, - dampFactor=
1
, - dampCoef=
0
, - tangFraction=
1
, - eosFraction=
0
, - zeroDampingChoice=
COMPUTE
, - zeroDamping=
None
, - enforceWithLagrangeMultipliers=
DEFAULT
, This method creates an StdContactControl object.
Note
This function can be accessed by:
mdb.models[name].StdContactControl
Note
- Parameters:¶
- name¶
A String specifying the contact controls repository key.
- stiffnessScaleFactor=
1
¶ A Float specifying the factor by which Abaqus/Standard will scale the default penalty stiffness to obtain the stiffnesses used for the contact pairs. Only contact interactions defined with augmented Lagrangian surface behavior will be affected by this argument. The default value is 1.0.
- penetrationTolChoice=
RELATIVE
¶ A SymbolicConstant specifying whether the allowable penetration is an absolute value or a value relative to the characteristic contact surface face dimension. Only contact interactions defined with augmented Lagrangian surface behavior will be affected by this argument. Possible values are RELATIVE and ABSOLUTE. The default value is RELATIVE.
- relativePenetrationTolerance=
None
¶ A Float specifying the ratio of the allowable penetration to the characteristic contact surface face dimension. The float values represent percentages (e.g.: 0.001=0.1%). Only contact interactions defined with augmented Lagrangian surface behavior will be affected by this argument. The default value is 10⁻³.The relativePenetrationTolerance argument applies only when penetrationTolChoice = RELATIVE. The relativePenetrationTolerance and absolutePenetrationTolerance arguments are mutually exclusive.
- absolutePenetrationTolerance=
None
¶ None or a Float specifying the allowable penetration. Only contact interactions defined with augmented Lagrangian surface behavior will be affected by this argument. The absolutePenetrationTolerance argument applies only when penetrationTolChoice = ABSOLUTE. The relativePenetrationTolerance and absolutePenetrationTolerance arguments are mutually exclusive. The default value is None.
- frictionOnset=
None
¶ A SymbolicConstant specifying when the application of friction occurs. Possible values are:
IMMEDIATE, specifying the friction is included in the increment when contact occurs.
DELAYED, specifying the application of friction is delayed until the increment after contact occurs.
- automaticTolerances=
0
¶ A Boolean specifying whether Abaqus/Standard should automatically compute an overclosure tolerance and a separation tolerance to prevent chattering in contact. The default value is OFF.The automaticTolerances argument cannot be used with the maxchp, perrmx, and uerrmx arguments.
- maxchp=
0
¶ An Int specifying the maximum number of points that are permitted to violate contact conditions in any increment. The default value is 0.Either the perrmx or the uerrmx argument must be specified in conjunction with the maxchp argument.
- perrmx=
0
¶ A Float specifying the maximum value of tensile stress (tensile force in GAP- or ITT-type contact elements) allowed to be transmitted at a contact point. The default value is 0.0.The perrmx argument must be specified in conjunction with the maxchp argument.
- uerrmx=
0
¶ A Float specifying the maximum overclosure distance allowed at a secondary node that is considered to be open. The default value is 0.0.The uerrmx argument must be specified in conjunction with the maxchp argument.
Changed in version 2022: Slave node was changed to secondary node.
- stabilizeChoice=
NONE
¶ A SymbolicConstant specifying whether or not viscous damping will be specified, and if so, how it will be specified. Possible values are NONE, AUTOMATIC, and COEFFICIENT. The default value is NONE.
- dampFactor=
1
¶ A Float specifying the value of the damping factor. This value is multiplied by the calculated damping coefficient. The default value is 1.0.This argument is only valid when stabilizeChoice = AUTOMATIC.
- dampCoef=
0
¶ A Float specifying the damping coefficient. The default value is 0.0.This argument is only valid when stabilizeChoice = COEFFICIENT.
- tangFraction=
1
¶ A Float specifying the tangential stabilization as a fraction of the normal stabilization (damping). The default value is 1.0.This argument is valid only if stabilizeChoice = AUTOMATIC or COEFFICIENT.
- eosFraction=
0
¶ A Float specifying the fraction of the damping that remains at the end of the step. The default value is 0.0.This argument is valid only if stabilizeChoice = AUTOMATIC or COEFFICIENT.
- zeroDampingChoice=
COMPUTE
¶ A SymbolicConstant specifying how the zero-damping clearance will be specified. Possible values are COMPUTE and SPECIFY. The default value is COMPUTE.This argument is valid only if stabilizeChoice = AUTOMATIC or COEFFICIENT.
- zeroDamping=
None
¶ None or a Float specifying the clearance at which damping becomes zero. This argument is valid only when zeroDampingChoice = SPECIFY. This argument is valid only if stabilizeChoice = AUTOMATIC or COEFFICIENT. The default value is None.
- enforceWithLagrangeMultipliers=
DEFAULT
¶ A SymbolicConstant specifying whether to enforce the contact constraints with Lagrange multipliers. Possible values are DEFAULT, ENFORCEMENT_OFF, and ENFORCEMENT_ON. The default value is DEFAULT.
- Returns:¶
A StdContactControl object.
- Return type:¶
- Raises:¶
RangeError –
- class InteractionContactInitializationModel(
- name,
- description=
''
, - stefanBoltzmann=
None
, - absoluteZero=
None
, - waveFormulation=
NOT_SET
, - modelType=
STANDARD_EXPLICIT
, - universalGas=
None
, - copyConstraints=
1
, - copyConnectors=
1
, - copyInteractions=
1
, Bases:
ModelBase
Public Data Attributes:
Inherited from
ModelBase
A String specifying the repository key.
None or a Float specifying the Stefan-Boltzmann constant.
None or a Float specifying the absolute zero constant.
A SymbolicConstant specifying the type of incident wave formulation to be used in acoustic problems.
None or a Float specifying the universal gas constant.
A Boolean specifying whether an input file should be written without parts and assemblies.
A Boolean specifying that the step specified by restartStep should be terminated at the increment specified by restartIncrement.
A Boolean specifying that a shell global model drives a solid submodel.
A Float specifying the time stamp that indicates when the model was last changed.
A String specifying the purpose and contents of the Model object.
A String specifying the name of the job that generated the restart data.
A String specifying the name of the step where the restart analysis will start.
A String specifying the name of the job that generated the results for the global model.
A boolean specifying the status of constraints created in a model, in the model which instances this model.
A boolean specifying the status of connectors created in a model, in the model which instances this model.
A boolean specifying the status of interactions created in a model, in the model which instances this model.
A KeywordBlock object.
A repository of Amplitude objects.
A repository of Profile objects.
A repository of BoundaryCondition objects.
A repository of ConstrainedSketchConstraint objects.
A repository of AnalyticalField objects.
A repository of DiscreteField objects.
A repository of PredefinedField objects.
A repository of Interaction objects.
A repository of InteractionProperty objects.
A repository of ContactControl objects.
A repository of ContactInitialization objects.
A repository of ContactStabilization objects.
A tuple of tuples of Strings specifying the linked child PartInstance name in the current model to the corresponding parent PartInstance name in a different model.
A tuple of tuples of Strings specifying the linked child Part name in the current model to the corresponding parent Part name in a different model.
A repository of Load objects.
A repository of Material objects.
A repository of Calibration objects.
A repository of Section objects.
A repository of RemeshingRule objects.
A repository of ConstrainedSketch objects.
A repository of Part objects.
A repository of Step objects.
A FeatureOptions object.
A repository of AdaptiveMeshConstraint objects.
A repository of AdaptiveMeshControl objects.
A repository of TimePoint objects.
A repository of Filter objects.
A repository of IntegratedOutputSection objects.
A repository of FieldOutputRequest objects.
A repository of HistoryOutputRequest objects.
A repository of OptimizationTask objects.
A repository of TableCollection objects.
A repository of EventSeriesType objects.
A repository of EventSeriesData objects.
An Int specifying the increment, interval, iteration or cycle where the restart analysis will start.
An Assembly object.
Public Methods:
ExpInitialization
(name[, overclosureType, ...])This method creates an ExpInitialization object.
StdInitialization
(name[, overclosureType, ...])This method creates a StdInitialization object.
Inherited from
ModelBase
__init__
(name[, description, ...])This method creates a Model object.
ModelFromInputFile
(name, inputFileName)This method creates a Model object by reading the keywords in an input file and creating the corresponding Abaqus/CAE objects.
ModelFromOdbFile
(name, odbFileName)This method creates a Model object by reading an output database and creating any corresponding Abaqus/CAE objects.
ModelFromNastranFile
(modelName, inputFileName)This method creates a Model object by reading the keywords in a Nastran bulk data file or Nastran input file and creating any corresponding Abaqus/CAE objects.
setValues
([description, noPartsInputFile, ...])This method modifies the Model object.
Member Details:
- ExpInitialization(
- name,
- overclosureType=
ADJUST
, - interferenceDistance=
None
, - clearanceDistance=
None
, - openingTolerance=
None
, - overclosureTolerance=
None
, - adjustNodalCoords=
True
, - secondaryNodesetName=
None
, - stepFraction=
1
, This method creates an ExpInitialization object.
Note
This function can be accessed by:
mdb.models[name].ExpInitialization
Note
- Parameters:¶
- name¶
A String specifying the contact initialization repository key.
- overclosureType=
ADJUST
¶ A SymbolicConstant specifying the type of overclosure to be defined. Possible values are ADJUST, INTERFERENCE, and CLEARANCE. The default value is ADJUST.
- interferenceDistance=
None
¶ None or a Float specifying the interference distance. This argument is valid only when overclosureType = INTERFERENCE. The default value is None.
- clearanceDistance=
None
¶ None or a Float specifying the initial clearance distance. This argument is valid only when overclosureType = CLEARANCE and must be specified in that case. The default value is None.
- openingTolerance=
None
¶ None or a Float specifying the distance tolerance within which initial openings will undergo strain-free adjustments. This argument is not valid when overclosureType = INTERFERENCE unless a value has been specified for interferenceDistance. The default value is None.
- overclosureTolerance=
None
¶ None or a Float specifying the distance tolerance within which initial overclosures will undergo strain-free adjustments. The default value is None.
- adjustNodalCoords=
True
¶ A Boolean specifying whether to resolve clearances/overclosures by adjusting the nodal coordinates without creating strain in the model. adjustNodalCoords = True can be used only for clearances/overclosures defined in the first step of an analysis. The default value is True.
- secondaryNodesetName=
None
¶ A String specifying the name of the node set containing the secondary nodes to be included in the initial clearance specification. This argument is not valid when overclosureType = INTERFERENCE and if openingTolerance or overclosureTolerance is specified. The default value is None.
Changed in version 2022: The argument
slaveNodesetName
was renamed tosecondaryNodesetName
.- stepFraction=
1
¶ A Float specifying the fraction of the step time (between 0.0 and 1.0) in which the interference fit has to be solved. The default value is 1.0. This argument is valid only when overclosureType = INTERFERENCE.
- Returns:¶
An ExpInitialization object.
- Return type:¶
- Raises:¶
RangeError –
- StdInitialization(
- name,
- overclosureType=
ADJUST
, - interferenceDistance=
None
, - clearanceDistance=
None
, - openingTolerance=
None
, - overclosureTolerance=
None
, This method creates a StdInitialization object.
Note
This function can be accessed by:
mdb.models[name].StdInitialization
Added in version 2020: The
ExpInitialization
method was added.Note
- Parameters:¶
- name¶
A String specifying the contact initialization repository key.
- overclosureType=
ADJUST
¶ A SymbolicConstant specifying the type of overclosure to be defined. Possible values are ADJUST, INTERFERENCE, and CLEARANCE. The default value is ADJUST.
- interferenceDistance=
None
¶ None or a Float specifying the interference distance. This argument is valid only when overclosureType = INTERFERENCE. The default value is None.
- clearanceDistance=
None
¶ None or a Float specifying the initial clearance distance. This argument is valid only when overclosureType = CLEARANCE, and must be specified in that case. The default value is None.
- openingTolerance=
None
¶ None or a Float specifying the distance tolerance within which initial openings will undergo strain-free adjustments. This argument is not valid when overclosureType = INTERFERENCE unless a value has been specified for interferenceDistance. The default value is None.
- overclosureTolerance=
None
¶ None or a Float specifying the distance tolerance within which initial overclosures will undergo strain-free adjustments.. The default value is None.
- Returns:¶
A StdInitialization object.
- Return type:¶
- Raises:¶
RangeError –
- class InteractionContactStabilizationModel(
- name,
- description=
''
, - stefanBoltzmann=
None
, - absoluteZero=
None
, - waveFormulation=
NOT_SET
, - modelType=
STANDARD_EXPLICIT
, - universalGas=
None
, - copyConstraints=
1
, - copyConnectors=
1
, - copyInteractions=
1
, Bases:
ModelBase
Public Data Attributes:
Inherited from
ModelBase
A String specifying the repository key.
None or a Float specifying the Stefan-Boltzmann constant.
None or a Float specifying the absolute zero constant.
A SymbolicConstant specifying the type of incident wave formulation to be used in acoustic problems.
None or a Float specifying the universal gas constant.
A Boolean specifying whether an input file should be written without parts and assemblies.
A Boolean specifying that the step specified by restartStep should be terminated at the increment specified by restartIncrement.
A Boolean specifying that a shell global model drives a solid submodel.
A Float specifying the time stamp that indicates when the model was last changed.
A String specifying the purpose and contents of the Model object.
A String specifying the name of the job that generated the restart data.
A String specifying the name of the step where the restart analysis will start.
A String specifying the name of the job that generated the results for the global model.
A boolean specifying the status of constraints created in a model, in the model which instances this model.
A boolean specifying the status of connectors created in a model, in the model which instances this model.
A boolean specifying the status of interactions created in a model, in the model which instances this model.
A KeywordBlock object.
A repository of Amplitude objects.
A repository of Profile objects.
A repository of BoundaryCondition objects.
A repository of ConstrainedSketchConstraint objects.
A repository of AnalyticalField objects.
A repository of DiscreteField objects.
A repository of PredefinedField objects.
A repository of Interaction objects.
A repository of InteractionProperty objects.
A repository of ContactControl objects.
A repository of ContactInitialization objects.
A repository of ContactStabilization objects.
A tuple of tuples of Strings specifying the linked child PartInstance name in the current model to the corresponding parent PartInstance name in a different model.
A tuple of tuples of Strings specifying the linked child Part name in the current model to the corresponding parent Part name in a different model.
A repository of Load objects.
A repository of Material objects.
A repository of Calibration objects.
A repository of Section objects.
A repository of RemeshingRule objects.
A repository of ConstrainedSketch objects.
A repository of Part objects.
A repository of Step objects.
A FeatureOptions object.
A repository of AdaptiveMeshConstraint objects.
A repository of AdaptiveMeshControl objects.
A repository of TimePoint objects.
A repository of Filter objects.
A repository of IntegratedOutputSection objects.
A repository of FieldOutputRequest objects.
A repository of HistoryOutputRequest objects.
A repository of OptimizationTask objects.
A repository of TableCollection objects.
A repository of EventSeriesType objects.
A repository of EventSeriesData objects.
An Int specifying the increment, interval, iteration or cycle where the restart analysis will start.
An Assembly object.
Public Methods:
StdStabilization
(name[, zeroDistance, ...])This method creates a StdStabilization object.
Inherited from
ModelBase
__init__
(name[, description, ...])This method creates a Model object.
ModelFromInputFile
(name, inputFileName)This method creates a Model object by reading the keywords in an input file and creating the corresponding Abaqus/CAE objects.
ModelFromOdbFile
(name, odbFileName)This method creates a Model object by reading an output database and creating any corresponding Abaqus/CAE objects.
ModelFromNastranFile
(modelName, inputFileName)This method creates a Model object by reading the keywords in a Nastran bulk data file or Nastran input file and creating any corresponding Abaqus/CAE objects.
setValues
([description, noPartsInputFile, ...])This method modifies the Model object.
Member Details:
- StdStabilization(
- name,
- zeroDistance=
None
, - reductionFactor=
0
, - scaleFactor=
1
, - tangentialFactor=
0
, - amplitude=
''
, - reset=
0
, This method creates a StdStabilization object.
Note
This function can be accessed by:
mdb.models[name].StdStabilization
Note
- Parameters:¶
- name¶
A String specifying the contact stabilization repository key.
- zeroDistance=
None
¶ None or a Float specifying the clearance distance at which the stabilization becomes zero. The default value is None.
- reductionFactor=
0
¶ A Float specifying the factor by which the analysis will reduce the contact stabilization coefficient per increment. The default value is 0.1.
- scaleFactor=
1
¶ A Float specifying the factor by which the analysis will scale the contact stabilization coefficient. The default value is 1.0.
- tangentialFactor=
0
¶ A Float specifying the factor that scales the contact stabilization coefficient in the tangential direction. The default value is 0.0.
- amplitude=
''
¶ A String specifying the name of the Amplitude object that defines a time-dependent scale factor for contact stabilization over the step. The default value is an empty string.
- reset=
0
¶ A Boolean specifying whether to cancel carryover effects from contact stabilization specifications involving nondefault amplitudes that appeared in previous steps. The default value is OFF.
- Returns:¶
A StdStabilization object.
- Return type:¶
- Raises:¶
RangeError –
- class InteractionPropertyModel(
- name,
- description=
''
, - stefanBoltzmann=
None
, - absoluteZero=
None
, - waveFormulation=
NOT_SET
, - modelType=
STANDARD_EXPLICIT
, - universalGas=
None
, - copyConstraints=
1
, - copyConnectors=
1
, - copyInteractions=
1
, Bases:
ModelBase
Public Data Attributes:
Inherited from
ModelBase
A String specifying the repository key.
None or a Float specifying the Stefan-Boltzmann constant.
None or a Float specifying the absolute zero constant.
A SymbolicConstant specifying the type of incident wave formulation to be used in acoustic problems.
None or a Float specifying the universal gas constant.
A Boolean specifying whether an input file should be written without parts and assemblies.
A Boolean specifying that the step specified by restartStep should be terminated at the increment specified by restartIncrement.
A Boolean specifying that a shell global model drives a solid submodel.
A Float specifying the time stamp that indicates when the model was last changed.
A String specifying the purpose and contents of the Model object.
A String specifying the name of the job that generated the restart data.
A String specifying the name of the step where the restart analysis will start.
A String specifying the name of the job that generated the results for the global model.
A boolean specifying the status of constraints created in a model, in the model which instances this model.
A boolean specifying the status of connectors created in a model, in the model which instances this model.
A boolean specifying the status of interactions created in a model, in the model which instances this model.
A KeywordBlock object.
A repository of Amplitude objects.
A repository of Profile objects.
A repository of BoundaryCondition objects.
A repository of ConstrainedSketchConstraint objects.
A repository of AnalyticalField objects.
A repository of DiscreteField objects.
A repository of PredefinedField objects.
A repository of Interaction objects.
A repository of InteractionProperty objects.
A repository of ContactControl objects.
A repository of ContactInitialization objects.
A repository of ContactStabilization objects.
A tuple of tuples of Strings specifying the linked child PartInstance name in the current model to the corresponding parent PartInstance name in a different model.
A tuple of tuples of Strings specifying the linked child Part name in the current model to the corresponding parent Part name in a different model.
A repository of Load objects.
A repository of Material objects.
A repository of Calibration objects.
A repository of Section objects.
A repository of RemeshingRule objects.
A repository of ConstrainedSketch objects.
A repository of Part objects.
A repository of Step objects.
A FeatureOptions object.
A repository of AdaptiveMeshConstraint objects.
A repository of AdaptiveMeshControl objects.
A repository of TimePoint objects.
A repository of Filter objects.
A repository of IntegratedOutputSection objects.
A repository of FieldOutputRequest objects.
A repository of HistoryOutputRequest objects.
A repository of OptimizationTask objects.
A repository of TableCollection objects.
A repository of EventSeriesType objects.
A repository of EventSeriesData objects.
An Int specifying the increment, interval, iteration or cycle where the restart analysis will start.
An Assembly object.
Public Methods:
AcousticImpedanceProp
(name, tableType, table)This method creates an AcousticImpedanceProp object.
ActuatorSensorProp
(name[, realProperties, ...])This method creates an ActuatorSensorProp object.
CavityRadiationProp
(name[, ...])This method creates a CavityRadiationProp object.
ContactProperty
(name)This method creates a ContactProperty object.
FilmConditionProp
(name[, ...])This method creates a FilmConditionProp object.
FluidCavityProperty
(name[, definition, ...])This method creates a FluidCavityProperty object.
FluidExchangeProperty
(name, dataTable[, ...])This method creates a FluidExchangeProperty object.
FluidInflatorProperty
(name, definition, ...)This method creates a FluidInflatorProperty object.
IncidentWaveProperty
(name[, definition, ...])This method creates an IncidentWaveProperty object.
Inherited from
ModelBase
__init__
(name[, description, ...])This method creates a Model object.
ModelFromInputFile
(name, inputFileName)This method creates a Model object by reading the keywords in an input file and creating the corresponding Abaqus/CAE objects.
ModelFromOdbFile
(name, odbFileName)This method creates a Model object by reading an output database and creating any corresponding Abaqus/CAE objects.
ModelFromNastranFile
(modelName, inputFileName)This method creates a Model object by reading the keywords in a Nastran bulk data file or Nastran input file and creating any corresponding Abaqus/CAE objects.
setValues
([description, noPartsInputFile, ...])This method modifies the Model object.
Member Details:
- AcousticImpedanceProp( )[source]¶
This method creates an AcousticImpedanceProp object.
Note
This function can be accessed by:
mdb.models[name].AcousticImpedanceProp
Note
- Parameters:¶
- name¶
A String specifying the interaction property repository key.
- tableType¶
A SymbolicConstant specifying the type of tabular data to be defined. Possible values are IMPEDANCE and ADMITTANCE.
- table¶
A sequence of sequences of Floats specifying acoustic impedance properties.If tableType = IMPEDANCE, each sequence of the table data specifies:The real part of the complex impedance.The imaginary part of the complex impedance.Frequency, if the data depend on frequency.If tableType = ADMITTANCE, each sequence of the table data specifies:The real part of the complex admittance.The imaginary part of the complex admittance.Frequency, if the data depend on frequency.
- frequencyDependency=
0
¶ A Boolean specifying whether the table data depend on frequency. The default value is OFF.
- Returns:¶
An AcousticImpedanceProp object.
- Return type:¶
-
ActuatorSensorProp(name, realProperties=
()
, integerProperties=()
)[source]¶ This method creates an ActuatorSensorProp object.
Note
This function can be accessed by:
mdb.models[name].ActuatorSensorProp
Note
- Parameters:¶
- name¶
A String specifying the interaction property repository key.
- realProperties=
()
¶ A sequence of Floats specifying the PROPS array used by user subroutine UEL. The default value is an empty sequence.
- integerProperties=
()
¶ A sequence of Ints specifying the JPROPS array used by user subroutine UEL. The default value is an empty sequence.
- Returns:¶
An ActuatorSensorProp object.
- Return type:¶
- CavityRadiationProp(
- name,
- temperatureDependency=
0
, - dependencies=
0
, - property=
()
, This method creates a CavityRadiationProp object.
Note
This function can be accessed by:
mdb.models[name].CavityRadiationProp
Note
- Parameters:¶
- name¶
A String specifying the interaction property repository key.
- temperatureDependency=
0
¶ A Boolean specifying whether the data depend on temperature. The default value is OFF.
- dependencies=
0
¶ An Int specifying the number of field variable dependencies. The default value is 0.
- property=
()
¶ A sequence of sequences of Floats specifying the following:The emissivity, ϵϵ.Temperature, if the data depend on temperature.Value of the first field variable, if the data depend on field variables.Value of the second field variable.Etc.
- Returns:¶
A CavityRadiationProp object.
- Return type:¶
- ContactProperty(name)[source]¶
This method creates a ContactProperty object.
Note
This function can be accessed by:
mdb.models[name].ContactProperty
Note
- FilmConditionProp(
- name,
- temperatureDependency=
0
, - dependencies=
0
, - property=
()
, This method creates a FilmConditionProp object.
Note
This function can be accessed by:
mdb.models[name].FilmConditionProp
Note
- Parameters:¶
- name¶
A String specifying the interaction property repository key.
- temperatureDependency=
0
¶ A Boolean specifying whether the data depend on temperature. The default value is OFF.
- dependencies=
0
¶ An Int specifying the number of field variable dependencies. The default value is 0.
- property=
()
¶ A sequence of sequences of Floats specifying the following:
The film coefficient, hh.
Temperature, if the data depend on temperature.
Value of the first field variable, if the data depend on field variables.
Value of the second field variable.
Etc.
- Returns:¶
A FilmConditionProp object.
- Return type:¶
- FluidCavityProperty(
- name,
- definition=
HYDRAULIC
, - fluidDensity=
None
, - molecularWeight=
None
, - useExpansion=
0
, - expansionTempDep=
0
, - expansionDependencies=
0
, - referenceTemperature=
0
, - expansionTable=
()
, - useBulkModulus=
0
, - bulkModulusTempDep=
0
, - bulkModulusDependencies=
0
, - bulkModulusTable=
()
, - useCapacity=
0
, - capacityType=
POLYNOMIAL
, - capacityTempDep=
0
, - capacityDependencies=
0
, - capacityTable=
()
, This method creates a FluidCavityProperty object.
Note
This function can be accessed by:
mdb.models[name].FluidCavityProperty
Note
- Parameters:¶
- name¶
A String specifying the interaction property repository key.
- definition=
HYDRAULIC
¶ A SymbolicConstant specifying the type of fluid cavity property to be defined. Possible values are HYDRAULIC and PNEUMATIC. The default value is HYDRAULIC.
- fluidDensity=
None
¶ None or a Float specifying the reference fluid density. This argument is applicable only when definition = HYDRAULIC, and is required in that case. The default value is None.
- molecularWeight=
None
¶ None or a Float specifying the molecular weight of the ideal gas species. This argument is applicable only when definition = PNEUMATIC, and is required in that case. The default value is None.
- useExpansion=
0
¶ A Boolean specifying whether thermal expansion coefficients will be defined. This argument is applicable only when definition = HYDRAULIC. The default value is OFF.
- expansionTempDep=
0
¶ A Boolean specifying whether the thermal fluid expansion data will have temperature dependency. This argument is applicable only when definition = HYDRAULIC and when useExpansion = True. The default value is OFF.
- expansionDependencies=
0
¶ An Int specifying the number of field variable dependencies in the thermal fluid expansion data. This argument is applicable only when definition = HYDRAULIC and when useExpansion = True. The default value is 0.
- referenceTemperature=
0
¶ A Float specifying the reference temperature for the coefficient of thermal expansion. This argument is applicable only when definition = HYDRAULIC, when useExpansion = True, and when either expansionTempDep = True or when expansionDependencies is greater than 0. The default value is 0.0.
- expansionTable=
()
¶ A sequence of sequences of Floats specifying the thermal expansion coefficients. This argument is applicable only when definition = HYDRAULIC and when useExpansion = True. Each sequence contains the following data:
The mean coefficient of thermal expansion.
Temperature, if the data depend on temperature.
Value of the first field variable, if the data depend on field variables.
Value of the second field variable.
Etc.
- useBulkModulus=
0
¶ A Boolean specifying whether fluid bulk modulus values will be defined. This argument is applicable only when definition = HYDRAULIC. The default value is OFF.
- bulkModulusTempDep=
0
¶ A Boolean specifying whether the fluid bulk modulus data will have temperature dependency. This argument is applicable only when definition = HYDRAULIC and when useBulkModulus = True. The default value is OFF.
- bulkModulusDependencies=
0
¶ An Int specifying the number of field variable dependencies in the fluid bulk modulus data. This argument is applicable only when definition = HYDRAULIC and when useBulkModulus = True. The default value is 0.
- bulkModulusTable=
()
¶ A sequence of sequences of Floats specifying the fluid bulk modulus values. This argument is applicable only when definition = HYDRAULIC and when useBulkModulus = True. Each sequence contains the following data:
The fluid bulk modulus.
Temperature, if the data depend on temperature.
Value of the first field variable, if the data depend on field variables.
Value of the second field variable.
Etc.
- useCapacity=
0
¶ A Boolean specifying whether molar heat capacity values will be defined. This argument is applicable only when definition = PNEUMATIC. The default value is OFF.
- capacityType=
POLYNOMIAL
¶ A SymbolicConstant specifying the method to define the molar heat capacity. Possible values are POLYNOMIAL and TABULAR. The default value is POLYNOMIAL.
- capacityTempDep=
0
¶ A Boolean specifying whether the molar heat capacity data will have temperature dependency. This argument is applicable only when definition = PNEUMATIC, when useCapacity = True, and when capacityType = TABULAR. The default value is OFF.
- capacityDependencies=
0
¶ An Int specifying the number of field variable dependencies in the molar heat capacity data. This argument is applicable only when definition = PNEUMATIC, when useCapacity = True, and when capacityType = TABULAR. The default value is 0.
- capacityTable=
()
¶ A sequence of sequences of Floats specifying the molar heat capacity values in the form of a polynomial expression. This argument is applicable only when definition = PNEUMATIC, when useCapacity = True, and when capacityType = POLYNOMIAL. In this form, only one sequence is specified and that sequence contains the following data:
The first molar heat capacity coefficient.
The second molar heat capacity coefficient.
The third molar heat capacity coefficient.
The fourth molar heat capacity coefficient.
The fifth molar heat capacity coefficient.
Alternatively, the sequence data may specify the molar heat capacity values at constant pressure for an ideal gas species. This argument is applicable only when definition = PNEUMATIC, when useCapacity = True, and when capacityType = TABULAR. Each sequence contains the following data:
The molar heat capacity at constant pressure.
Temperature, if the data depend on temperature.
Value of the first field variable, if the data depend on field variables.
Value of the second field variable.
Etc.
- Returns:¶
A FluidCavityProperty object.
- Return type:¶
- FluidExchangeProperty(
- name,
- dataTable,
- definition=
BULK_VISCOSITY
, - pressureDependency=
0
, - temperatureDependency=
0
, - fieldDependencies=
0
, This method creates a FluidExchangeProperty object.
Note
This function can be accessed by:
mdb.models[name].FluidExchangeProperty
Note
- Parameters:¶
- name¶
A String specifying the interaction property repository key.
- dataTable¶
A sequence of sequences of Floats specifying the viscous and hydrodynamic resistance coefficients when definition = BULK_VISCOSITY. Each sequence contains the following data:
The viscous resistance coefficient.
The hydrodynamic resistance coefficient.
The average absolute pressure, if the data depend on pressure.
The average temperature, if the data depend on temperature.
The value of the first field variable, if the data depend on field variables.
The value of the second field variable.
Etc.
Alternatively, the sequence data may specify the mass flow rate. This is applicable only when definition = MASS_FLUX. In this form, only one sequence is specified and that sequence contains the following data:
The mass flow rate per unit area.
Alternatively, the sequence data may specify the mass rate leakage. This is applicable only when definition = MASS_RATE_LEAK. Each sequence contains the following data:
The absolute value of the mass flow rate per unit area. (The first tabular value entered must always be zero.)
The absolute value of the pressure difference. (The first tabular value entered must always be zero.)
The average absolute pressure, if the data depend on pressure.
The average temperature, if the data depend on temperature.
The value of the first field variable, if the data depend on field variables.
The value of the second field variable.
Etc.
Alternatively, the sequence data may specify the volume flow rate. This is applicable only when definition = VOL_FLUX. In this form, only one sequence is specified and that sequence contains the following data:
The volumetric flow rate per unit area.
Alternatively, the sequence data may specify the volume rate leakage. This is applicable only when definition = VOL_RATE_LEAK. Each sequence contains the following data:
The absolute value of the volumetric flow rate per unit area. (The first tabular value entered must always be zero.)
The absolute value of the pressure difference. (The first tabular value entered must always be zero.)
The average absolute pressure, if the data depend on pressure.
The average temperature, if the data depend on temperature.
The value of the first field variable, if the data depend on field variables.
The value of the second field variable.
Etc.
- definition=
BULK_VISCOSITY
¶ A SymbolicConstant specifying the type of fluid exchange property to be defined. Possible values are BULK_VISCOSITY, MASS_FLUX, MASS_RATE_LEAK, VOL_FLUX, and VOL_RATE_LEAK. The default value is BULK_VISCOSITY.
- pressureDependency=
0
¶ A Boolean specifying whether the data will have pressure dependency. This argument is applicable only when definition = BULK_VISCOSITY, or when definition = MASS_RATE_LEAK, or when definition = VOL_RATE_LEAK. The default value is OFF.
- temperatureDependency=
0
¶ A Boolean specifying whether the data will have temperature dependency. This argument is applicable only when definition = BULK_VISCOSITY, or when definition = MASS_RATE_LEAK, or when definition = VOL_RATE_LEAK. The default value is OFF.
- fieldDependencies=
0
¶ An Int specifying the number of field variable dependencies in the data. This argument is applicable only when definition = BULK_VISCOSITY, or when definition = MASS_RATE_LEAK, or when definition = VOL_RATE_LEAK. The default value is 0.
- Returns:¶
A FluidExchangeProperty object.
- Return type:¶
- FluidInflatorProperty(
- name,
- definition,
- effectiveArea,
- tankVolume,
- dischargeCoefficient=
None
, - dataTable=
()
, - numFluids=
None
, - mixtureType=
''
, - inflationTime=
()
, - fluidbehaviorName=
()
, - massFraction=
()
, This method creates a FluidInflatorProperty object.
Note
This function can be accessed by:
mdb.models[name].FluidInflatorProperty
Added in version 2019: The
FluidInflatorProperty
method was added.Note
- Parameters:¶
- name¶
A String specifying the interaction property repository key.
- definition¶
A Symbolic constant specifying the method used for modeling the flow characteristics of inflators. The default value is definition = DUAL PRESSURE. The possible values are DUAL PRESSURE, PRESSURE AND MASS, TANK TEST, and TEMPERATURE AND MASS.
- effectiveArea¶
A Float specifying the total inflator orifice area. This argument is applicable only if definition = DUAL PRESSURE or definition = PRESSURE AND MASS.
- tankVolume¶
A Float specifying the tank volume. This argument is applicable only if definition = DUAL PRESSURE or definition = TANK TEST.
- dischargeCoefficient=
None
¶ A Float specifying the discharge coefficient. This argument is applicable only if definition = DUAL PRESSURE or definition = PRESSURE AND MASS.
- dataTable=
()
¶ A sequence of sequences of Floats specifying the items described in the “Table data” section below.
- numFluids=
None
¶ An Int specifying the number of gas species used for this inflator.
- mixtureType=
''
¶ A Symbolic constant specifying whether to use mass fraction or the molar fraction for a mixture of ideal gases. The default value is MASS FRACTION. The possible values are MASS FRACTION or MOLAR FRACTION.
- inflationTime=
()
¶ A sequence of sequences of Floats specifying the inflation time.
- fluidbehaviorName=
()
¶ A sequence of sequences of Strings specifying fluid behavior names.
- massFraction=
()
¶ A sequence of sequences of Floats specifying the mass fraction or the molar fraction corresponding to entered fluid behavior.
- Returns:¶
A FluidInflatorProperty object.
- IncidentWaveProperty(
- name,
- definition=
PLANAR
, - propagationModel=
ACOUSTIC
, - soundSpeed=
None
, - fluidDensity=
None
, - specificHeatRatio=
None
, - gravity=
None
, - atmosphericPressure=
None
, - dragCoefficient=
None
, - dragExponent=
2
, - waveEffects=
1
, - chargeDensity=
None
, - chargeMass=
None
, - constantK1=
None
, - constantK2=
None
, - constantA=
None
, - constantB=
None
, - constantKc=
None
, - duration=
None
, - maximumSteps=
1500
, - relativeStepControl=
None
, - absoluteStepControl=
None
, - stepControlExponent=
0
, - genDecayA=
0
, - genDecayB=
0
, - genDecayC=
0
, - seedNumber=
None
, - massTNT=
None
, - massFactor=
1
, - lengthFactor=
1
, - timeFactor=
1
, - pressureFactor=
1
, This method creates an IncidentWaveProperty object.
Note
This function can be accessed by:
mdb.models[name].IncidentWaveProperty
Note
- Parameters:¶
- name¶
A String specifying the interaction property repository key.
- definition=
PLANAR
¶ A SymbolicConstant specifying the type of wave to be defined. Possible values are PLANAR, SPHERICAL, DIFFUSE, AIR_BLAST, and SURFACE_BLAST. The default value is PLANAR.
- propagationModel=
ACOUSTIC
¶ A SymbolicConstant specifying the spherical propagation model. Possible values are ACOUSTIC, UNDEX_CHARGE, and GENERALIZED_DECAY. The default value is ACOUSTIC.This argument is valid only when definition = SPHERICAL.
- soundSpeed=
None
¶ A Float specifying the speed of sound in the fluid.This argument is not valid when definition = AIR_BLAST or when definition = SURFACE_BLAST.
- fluidDensity=
None
¶ A Float specifying the fluid mass density.This argument is not valid when definition = AIR_BLAST or when definition = SURFACE_BLAST.
- specificHeatRatio=
None
¶ None or a Float specifying the ratio of specific heats for gas. The default value is None.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.
- gravity=
None
¶ None or a Float specifying the acceleration due to gravity. The default value is None.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.
- atmosphericPressure=
None
¶ None or a Float specifying the atmospheric pressure. The default value is None.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.
- dragCoefficient=
None
¶ None or a Float specifying the fluid drag coefficient. The default value is None.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.
- dragExponent=
2
¶ A Float specifying the fluid drag exponent. The default value is 2.0.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.
- waveEffects=
1
¶ A Boolean specifying whether or not to include wave effects in the fluid and gas. The default value is ON.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.
- chargeDensity=
None
¶ None or a Float specifying the density of the charge material. The default value is None.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.
- chargeMass=
None
¶ None or a Float specifying the mass of the charge material. The default value is None.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.
- constantK1=
None
¶ None or a Float specifying the charge material constant K. The default value is None.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.
- constantK2=
None
¶ None or a Float specifying the charge material constant k. The default value is None.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.
- constantA=
None
¶ None or a Float specifying the charge material constant A. The default value is None.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.
- constantB=
None
¶ None or a Float specifying the charge material constant B. The default value is None.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.
- constantKc=
None
¶ None or a Float specifying the charge material constant Kc. The default value is None.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.
- duration=
None
¶ None or a Float specifying the time duration for the bubble simulation. The default value is None.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.
- maximumSteps=
1500
¶ An Int specifying the maximum number of time steps for the bubble simulation. The default value is 1500.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.
- relativeStepControl=
None
¶ A Float specifying the relative step size control parameter. The default value is 1x10⁻¹¹.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.
- absoluteStepControl=
None
¶ A Float specifying the absolute step size control parameter. The default value is 1x10⁻¹¹.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.
- stepControlExponent=
0
¶ A Float specifying the step size control exponent. The default value is 0.2.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.
- genDecayA=
0
¶ A Float specifying the constant A associated with the generalized decay propagation model. The default value is 0.0.This argument is valid only when definition = SPHERICAL and propagationModel = GENERALIZED_DECAY.
- genDecayB=
0
¶ A Float specifying the constant B associated with the generalized decay propagation model. The default value is 0.0.This argument is valid only when definition = SPHERICAL and propagationModel = GENERALIZED_DECAY.
- genDecayC=
0
¶ A Float specifying the constant C associated with the generalized decay propagation model. The default value is 0.0.This argument is valid only when definition = SPHERICAL and propagationModel = GENERALIZED_DECAY.
- seedNumber=
None
¶ An Int specifying the seed number (N) for the diffuse source calculation. N2 sources will be used in the simulation.This argument is valid only when definition = DIFFUSE.
- massTNT=
None
¶ A Float specifying the equivalent mass of TNT, in any preferred mass unit.This argument is valid only when definition = AIR_BLAST or definition = SURFACE_BLAST.
- massFactor=
1
¶ A Float specifying the multiplication factor to convert from the preferred mass unit to kilograms. The default value is 1.0.This argument is valid only when definition = AIR_BLAST or definition = SURFACE_BLAST.
- lengthFactor=
1
¶ A Float specifying the multiplication factor to convert from the analysis length unit to meters. The default value is 1.0.This argument is valid only when definition = AIR_BLAST or definition = SURFACE_BLAST.
- timeFactor=
1
¶ A Float specifying the multiplication factor to convert from the analysis time unit to seconds. The default value is 1.0.This argument is valid only when definition = AIR_BLAST or definition = SURFACE_BLAST.
- pressureFactor=
1
¶ A Float specifying the multiplication factor to convert from the analysis pressure unit to pascals. The default value is 1.0.This argument is valid only when definition = AIR_BLAST or definition = SURFACE_BLAST.
- Returns:¶
An IncidentWaveProperty object.
- Return type:¶
Other Classes¶
- class AcousticImpedance(
- name,
- createStepName,
- surface,
- definition=
TABULAR
, - interactionProperty=
''
, - nonreflectingType=
PLANE
, - radius=
1
, - semimajorAxis=
1
, - eccentricity=
0
, - centerCoordinates=
()
, - directionCosine=
()
, Bases:
Interaction
The AcousticImpedance object defines surface impedance information or nonreflecting boundaries for acoustic and coupled acoustic-structural analyses. The AcousticImpedance object is derived from the Interaction object.
Note
This object can be accessed by:
import interaction mdb.models[name].interactions[name]
The corresponding analysis keywords are:
SIMPEDANCE
Note
Member Details:
-
centerCoordinates : --is-rst--:py:class:`tuple` =
()
[source]¶ A sequence of three Floats specifying the X, Y, and Z coordinates of the center of the ellipse or prolate spheroid defining the boundary surface. The default value is (0, 0, 0).This argument is valid only when definition = NONREFLECTING, and nonreflectingType = ELLIPTICAL or PROLATE.
- createStepName : --is-rst--:py:class:`str`[source]¶
A String specifying the name of the step in which the AcousticImpedance object is created.
-
definition : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` =
'TABULAR'
[source]¶ A SymbolicConstant specifying the type of acoustic impedance to be defined. Possible values are TABULAR and NONREFLECTING. The default value is TABULAR.
-
directionCosine : --is-rst--:py:class:`tuple` =
()
[source]¶ A sequence of three Floats specifying the X, Y, and Z components of the direction cosine of the major axis of the ellipse or prolate spheroid defining the boundary surface. The default value is (0, 0, 1).This argument is valid only when definition = NONREFLECTING, and nonreflectingType = ELLIPTICAL or PROLATE.
-
eccentricity : --is-rst--:py:class:`float` =
0
[source]¶ A Float specifying the eccentricity of the ellipse or prolate spheroid defining the boundary surface. The default value is 0.0.This argument is valid only when definition = NONREFLECTING, and nonreflectingType = ELLIPTICAL or PROLATE.
-
interactionProperty : --is-rst--:py:class:`str` =
''
[source]¶ A String specifying the AcousticImpedanceProp object associated with this interaction.
-
nonreflectingType : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` =
'PLANE'
[source]¶ A SymbolicConstant specifying the type of nonreflecting geometry to be defined. Possible values are PLANE, IMPROVED, CIRCULAR, SPHERICAL, ELLIPTICAL, and PROLATE. The default value is PLANE.This argument is valid only when definition = NONREFLECTING.
-
radius : --is-rst--:py:class:`float` =
1
[source]¶ A Float specifying the radius of the circle or sphere defining the boundary surface. The default value is 1.0.This argument is valid only when definition = NONREFLECTING, and nonreflectingType = CIRCULAR or SPHERICAL.
-
semimajorAxis : --is-rst--:py:class:`float` =
1
[source]¶ A Float specifying the semimajor axis length of the ellipse or prolate spheroid defining the boundary surface. The default value is 1.0.This argument is valid only when definition = NONREFLECTING, and nonreflectingType = ELLIPTICAL or PROLATE.
- setValues(
- definition=
TABULAR
, - interactionProperty=
''
, - nonreflectingType=
PLANE
, - radius=
1
, - semimajorAxis=
1
, - eccentricity=
0
, - centerCoordinates=
()
, - directionCosine=
()
, This method modifies the data for an existing AcousticImpedance object in the step where it is created.
Note
- Parameters:¶
- definition=
TABULAR
¶ A SymbolicConstant specifying the type of acoustic impedance to be defined. Possible values are TABULAR and NONREFLECTING. The default value is TABULAR.
- interactionProperty=
''
¶ A String specifying the AcousticImpedanceProp object associated with this interaction.
- nonreflectingType=
PLANE
¶ A SymbolicConstant specifying the type of nonreflecting geometry to be defined. Possible values are PLANE, IMPROVED, CIRCULAR, SPHERICAL, ELLIPTICAL, and PROLATE. The default value is PLANE.This argument is valid only when definition = NONREFLECTING.
- radius=
1
¶ A Float specifying the radius of the circle or sphere defining the boundary surface. The default value is 1.0.This argument is valid only when definition = NONREFLECTING, and nonreflectingType = CIRCULAR or SPHERICAL.
- semimajorAxis=
1
¶ A Float specifying the semimajor axis length of the ellipse or prolate spheroid defining the boundary surface. The default value is 1.0.This argument is valid only when definition = NONREFLECTING, and nonreflectingType = ELLIPTICAL or PROLATE.
- eccentricity=
0
¶ A Float specifying the eccentricity of the ellipse or prolate spheroid defining the boundary surface. The default value is 0.0.This argument is valid only when definition = NONREFLECTING, and nonreflectingType = ELLIPTICAL or PROLATE.
- centerCoordinates=
()
¶ A sequence of three Floats specifying the X, Y, and Z coordinates of the center of the ellipse or prolate spheroid defining the boundary surface. The default value is (0, 0, 0).This argument is valid only when definition = NONREFLECTING, and nonreflectingType = ELLIPTICAL or PROLATE.
- directionCosine=
()
¶ A sequence of three Floats specifying the X, Y, and Z components of the direction cosine of the major axis of the ellipse or prolate spheroid defining the boundary surface. The default value is (0, 0, 1).This argument is valid only when definition = NONREFLECTING, and nonreflectingType = ELLIPTICAL or PROLATE.
- definition=
-
setValuesInStep(stepName, interactionProperty=
''
)[source]¶ This method modifies the propagating data for an existing AcousticImpedance object in the specified step.
- class Interaction[source]¶
Bases:
object
The Interaction object is the abstract base type for other Interaction objects. The Interaction object has no explicit constructor. Each of the Interaction objects has the.
following methods: - deactivate - move - reset - resume - suppress - delete The methods are described below.
Note
This object can be accessed by:
import interaction mdb.models[name].interactions[name]
Note
Member Details:
- deactivate(stepName)[source]¶
This method deactivates the interaction in the specified step and all its subsequent steps.
Note
- move(fromStepName, toStepName)[source]¶
This method moves an interaction from one step to another.
Note
-
class AcousticImpedanceProp(name, tableType, table, frequencyDependency=
0
)[source]¶ Bases:
ContactProperty
The AcousticImpedanceProp object is an interaction property that defines the properties referred to by an AcousticImpedance object. The AcousticImpedanceProp object is derived from the InteractionProperty object.
Note
This object can be accessed by:
import interaction mdb.models[name].interactionProperties[name]
The corresponding analysis keywords are:
IMPEDANCE PROPERTY
Note
Member Details:
-
frequencyDependency : --is-rst--Boolean =
0
[source]¶ A Boolean specifying whether the table data depend on frequency. The default value is OFF.
-
setValues(frequencyDependency=
0
)[source]¶ This method modifies the AcousticImpedanceProp object.
-
table : --is-rst--tuple[tuple[float, ...], ...] =
()
[source]¶ A sequence of sequences of Floats specifying acoustic impedance properties.If tableType = IMPEDANCE, each sequence of the table data specifies:The real part of the complex impedance.The imaginary part of the complex impedance.Frequency, if the data depend on frequency.If tableType = ADMITTANCE, each sequence of the table data specifies:The real part of the complex admittance.The imaginary part of the complex admittance.Frequency, if the data depend on frequency.
- class ContactProperty(name)[source]¶
Bases:
InteractionProperty
The ContactProperty object defines a contact interaction property. The ContactProperty object is derived from the InteractionProperty object.
Note
This object can be accessed by:
import interaction mdb.models[name].interactionProperties[name]
The corresponding analysis keywords are:
SURFACE INTERACTION
Note
Member Details:
- CohesiveBehavior(
- repeatedContacts=
0
, - eligibility=
ALL_NODES
, - defaultPenalties=
1
, - coupling=
UNCOUPLED
, - temperatureDependency=
0
, - dependencies=
0
, - table=
()
, This method creates a CohesiveBehavior object.
Note
This function can be accessed by:
mdb.models[name].ContactProperty
Note
- Parameters:¶
- repeatedContacts=
0
¶ A Boolean specifying whether to enforce cohesive behavior for recurrent contacts at nodes on the secondary surface subsequent to ultimate failure. The default value is OFF.
- eligibility=
ALL_NODES
¶ A SymbolicConstant specifying the eligible secondary nodes. Possible values are ALL_NODES, INITIAL_NODES, and SPECIFIED. The default value is ALL_NODES.
- defaultPenalties=
1
¶ A Boolean specifying whether to use the default contact penalties. The default value is ON.
- coupling=
UNCOUPLED
¶ A SymbolicConstant specifying whether the traction-separation coefficients are coupled or uncoupled. This argument is valid only for defaultPenalties = OFF. Possible values are UNCOUPLED and COUPLED. The default value is UNCOUPLED.
- temperatureDependency=
0
¶ A Boolean specifying whether the coefficient data depend on temperature. This argument is valid only for defaultPenalties = OFF. The default value is OFF.
- dependencies=
0
¶ An Int specifying the number of field variables. This argument is valid only for defaultPenalties = OFF. The default value is 0.
- table=
()
¶ A sequence of sequences of Floats specifying the traction-separation coefficients. The items in the table data are described below. This argument is valid only for defaultPenalties = OFF.
- repeatedContacts=
- Returns:¶
A CohesiveBehavior object.
- Return type:¶
- Damage(
- initTable,
- criterion=
MAX_STRESS
, - initTempDep=
0
, - initDependencies=
0
, - useEvolution=
0
, - evolutionType=
DISPLACEMENT
, - softening=
LINEAR
, - useMixedMode=
0
, - mixedModeType=
TABULAR
, - modeMixRatio=
ENERGY
, - exponent=
None
, - evolTempDep=
0
, - evolDependencies=
0
, - evolTable=
()
, - useStabilization=
0
, - viscosityCoef=
None
, This method creates a ContactDamage object.
Note
This function can be accessed by:
mdb.models[name].ContactProperty
Note
Check Damage on help.3ds.com/2023.
- Parameters:¶
- initTable¶
A sequence of sequences of Floats specifying the values defining the damage initiation. The items in the table data are described below.
- criterion=
MAX_STRESS
¶ A SymbolicConstant specifying the type of data used to define the initiation of damage. Possible values are MAX_STRESS, MAX_SEPARATION, QUAD_TRACTION, and QUAD_SEPARATION. The default value is MAX_STRESS.
- initTempDep=
0
¶ A Boolean specifying whether the initiation data depend on temperature. The default value is OFF.
- initDependencies=
0
¶ An Int specifying the number of initiation data field variables. The default value is 0.
- useEvolution=
0
¶ A Boolean specifying whether evolution data will be defined. The default value is OFF.
- evolutionType=
DISPLACEMENT
¶ A SymbolicConstant specifying the type of data used to define the evolution of damage. This argument is valid only when useEvolution = ON. Possible values are DISPLACEMENT and ENERGY. The default value is DISPLACEMENT.
- softening=
LINEAR
¶ A SymbolicConstant specifying the type of data used to define the evolution softening response. This argument is valid only when useEvolution = ON. The TABULAR value can be used only when evolutionType = DISPLACEMENT. Possible values are LINEAR, EXPONENTIAL, and TABULAR. The default value is LINEAR.
- useMixedMode=
0
¶ A Boolean specifying whether evolution data be defined using dependent behavior modes. This argument is valid only when useEvolution = ON. The default value is OFF.
- mixedModeType=
TABULAR
¶ A SymbolicConstant specifying the mode mix fracture criterion. This argument is valid only when useEvolution = ON and when useMixedMode = ON. The POWER_LAW and BK values can be used only when evolutionType = ENERGY. Possible values are TABULAR, POWER_LAW, and BK. The default value is TABULAR.
- modeMixRatio=
ENERGY
¶ A SymbolicConstant specifying the mode mix ratio type. This argument is valid only when useEvolution = ON and when useMixedMode = ON. The TRACTION value can be used only when mixedModeType = TABULAR. Possible values are ENERGY and TRACTION. The default value is ENERGY.
- exponent=
None
¶ None or a Float specifying the exponent in the power-law or BK criterion that defines the variation of fracture energy with mode mix. This argument is valid only when useEvolution = ON and when mixedModeType = POWER_LAW or BK. The default value is None.
- evolTempDep=
0
¶ A Boolean specifying whether the evolution data depend on temperature. This argument is valid only when useEvolution = ON. The default value is OFF.
- evolDependencies=
0
¶ An Int specifying the number of evolution data field variables. This argument is valid only when useEvolution = ON. The default value is 0.
- evolTable=
()
¶ A sequence of sequences of Floats specifying the values defining the damage evolution. The items in the table data are described below. This argument is valid only when useEvolution = ON.
- useStabilization=
0
¶ A Boolean specifying whether stabilization data will be defined. This argument is valid only when useEvolution = ON. The default value is OFF.
- viscosityCoef=
None
¶ None or a Float specifying the viscosity coefficient. This argument is valid only when useStabilization = ON. The default value is None.
- Returns:¶
A ContactDamage object.
- Return type:¶
ContactDamage
- Damping(
- definition=
DAMPING_COEFFICIENT
, - tangentFraction=
DEFAULT
, - clearanceDependence=
STEP
, - table=
()
, This method creates a ContactDamping object.
Note
This function can be accessed by:
mdb.models[name].ContactProperty
Note
Check Damping on help.3ds.com/2023.
- Parameters:¶
- definition=
DAMPING_COEFFICIENT
¶ A SymbolicConstant specifying the method used to define the damping. Possible values are DAMPING_COEFFICIENT and CRITICAL_DAMPING_FRACTION. The default value is DAMPING_COEFFICIENT.
- tangentFraction=
DEFAULT
¶ The SymbolicConstant DEFAULT or a Float specifying the tangential damping coefficient divided by the normal damping coefficient. The default value is DEFAULT.
- clearanceDependence=
STEP
¶ A SymbolicConstant specifying the variation of the damping coefficient or fraction with respect to clearance. Possible values are STEP, LINEAR, and BILINEAR. The default value is STEP.If definition = CRITICAL_DAMPING_FRACTION, the only possible value is STEP.
- table=
()
¶ A sequence of pairs of Floats specifying the damping properties. The items in the table data are described below.
- definition=
- Returns:¶
A ContactDamping object.
- Return type:¶
ContactDamping
- ElectricalConductance(
- definition=
TABULAR
, - clearanceDependency=
1
, - pressureDependency=
0
, - temperatureDependencyC=
0
, - dependenciesC=
0
, - clearanceDepTable=
()
, - temperatureDependencyP=
0
, - dependenciesP=
0
, - pressureDepTable=
()
, This method creates a GapElectricalConductance object.
Note
This function can be accessed by:
mdb.models[name].ContactProperty
Note
- Parameters:¶
- definition=
TABULAR
¶ A SymbolicConstant specifying how the electrical conductance is defined. Possible values are TABULAR and USER_DEFINED. The default value is TABULAR.
- clearanceDependency=
1
¶ A Boolean specifying whether to use clearance-dependent data. The default value is ON.
- pressureDependency=
0
¶ A Boolean specifying whether to use pressure-dependent data. The default value is OFF.
- temperatureDependencyC=
0
¶ A Boolean specifying whether to use temperature-dependent data with clearance dependency. The default value is OFF.
- dependenciesC=
0
¶ An Int specifying the number of field variables to use with clearance dependency. The default value is 0.
- clearanceDepTable=
()
¶ A sequence of sequences of Floats specifying clearance dependency data. The items in the table data are described below.
- temperatureDependencyP=
0
¶ A Boolean specifying whether to use temperature-dependent data with pressure dependency. The default value is OFF.
- dependenciesP=
0
¶ An Int specifying the number of field variables to use with pressure dependency. The default value is 0.
- pressureDepTable=
()
¶ A sequence of sequences of Floats specifying pressure dependency data. The items in the table data are described below.
- definition=
- Returns:¶
A GapElectricalConductance object.
- Return type:¶
GapElectricalConductance
- FractureCriterion(
- initTable,
- type=
VCCT
, - mixedModeBehavior=
BK
, - temperatureDependency=
0
, - dependencies=
0
, - tolerance=
0
, - specifyUnstableCrackProp=
0
, - unstableTolerance=
DEFAULT
, This method creates a FractureCriterion object.
Note
This function can be accessed by:
mdb.models[name].ContactProperty
Note
- Parameters:¶
- initTable¶
A sequence of sequences of Floats specifying the value defining the fracture criterion. The items in the table data are described below.
- type=
VCCT
¶ A SymbolicConstant specifying the type of data used to define the fracture criterion. Possible values are VCCT and ENHANCED VCCT. The default value is VCCT.
- mixedModeBehavior=
BK
¶ A SymbolicConstant specifying the mixed mode behavior type used to define fracture criterion. Possible values are BK, POWER, and REEDER. The default value is BK.
- temperatureDependency=
0
¶ A Boolean specifying whether the fracture criterion data depend on temperature. The default value is OFF.
- dependencies=
0
¶ An Int specifying the number of fracture criterion data field variables. The default value is 0.
- tolerance=
0
¶ A Float specifying the tolerance for VCCT Enhanced VCCT type. The default value is 0.2.
- specifyUnstableCrackProp=
0
¶ A SymbolicConstant specifying whether to include unstable crack growth tolerance in fracture criterion. Possible values are ON and OFF. The default value is OFF.
- unstableTolerance=
DEFAULT
¶ The SymbolicConstant DEFAULT or a Float specifying the tolerance for unstable crack propagation. This parameter specified only if specifyUnstableCrackProp = ON. The default value is DEFAULT.
- Returns:¶
A FractureCriterion object.
- Return type:¶
- GeometricProperties(
- contactArea=
1
, - padThickness=
None
, - trackingThickness=
None
, - dependentVariables=
0
, - numProperties=
0
, - useUnsymmetricEqunProcedure=
0
, - modelType=
None
, This method creates a GeometricProperties object.
Note
This function can be accessed by:
mdb.models[name].ContactProperty
Note
- Parameters:¶
- contactArea=
1
¶ A Float specifying the out-of-plane thickness of the surface for a two-dimensional model or cross-sectional area for every node in the node-based surface. The default value is 1.0.
- padThickness=
None
¶ None or a Float specifying the thickness of an interfacial layer between the contacting surfaces. If padThickness = None, there is no interfacial layer. The default value is None.
- trackingThickness=
None
¶ None or a Float specifying the thickness that determines the contacting surfaces to be tracked. The input value for this parameter cannot be negative. An internal default value is used if a zero value is input or if the parameter is omitted.
- dependentVariables=
0
¶ An Int specifying the number of state-dependent variables. The default value is 0. This argument is applicable only if modelType = MODELTYPE_USER or modelType = MODELTYPE_USER_INTERACTION.
- numProperties=
0
¶ An Int specifying the number of property values required. The default value is 0. This argument is applicable only if modelType = MODELTYPE_USER or modelType = MODELTYPE_USER_INTERACTION.
- useUnsymmetricEqunProcedure=
0
¶ A Boolean specifying whether to use unsymmetric equation solution procedures. This argument is applicable only if modelType = MODELTYPE_USER or modelType = MODELTYPE_USER_INTERACTION.
- modelType=
None
¶ A SymbolicConstant specifying the surface interaction model type.
- contactArea=
- Returns:¶
A GeometricProperties object.
- Return type:¶
-
HeatGeneration(conversionFraction=
1
, secondaryFraction=0
)[source]¶ This method creates a GapHeatGeneration object.
Note
This function can be accessed by:
mdb.models[name].ContactProperty
Note
- Parameters:¶
- conversionFraction=
1
¶ A Float specifying the fraction of dissipated energy caused by friction or electric currents that is converted to heat. The default value is 1.0.
- secondaryFraction=
0
¶ A Float specifying the fraction of converted heat distributed to the secondary surface. The default value is 0.5.
Changed in version 2022: The argument
slaveFraction
was renamed tosecondaryFraction
.
- conversionFraction=
- Returns:¶
A GapHeatGeneration object.
- Return type:¶
GapHeatGeneration
- NormalBehavior(
- contactStiffness=
DEFAULT
, - pressureOverclosure=
HARD
, - allowSeparation=
1
, - maxStiffness=
None
, - table=
()
, - constraintEnforcementMethod=
DEFAULT
, - overclosureFactor=
0
, - overclosureMeasure=
0
, - contactStiffnessScaleFactor=
1
, - initialStiffnessScaleFactor=
1
, - clearanceAtZeroContactPressure=
0
, - stiffnessBehavior=
LINEAR
, - stiffnessRatio=
0
, - upperQuadraticFactor=
0
, - lowerQuadraticRatio=
0
, This method creates a NormalBehavior object.
Note
This function can be accessed by:
mdb.models[name].ContactProperty
Note
- Parameters:¶
- contactStiffness=
DEFAULT
¶ The SymbolicConstant DEFAULT or a Float specifying the contact stiffness. This argument is valid for pressureOverclosure = LINEAR. This argument is also valid for pressureOverclosure = HARD when constraintEnforcementMethod = AUGMENTED_LAGRANGE or PENALTY. A value of DEFAULT is valid only when the later conditions are met. A value of zero is equivalent to specifying DEFAULT. The default value is DEFAULT.
- pressureOverclosure=
HARD
¶ A SymbolicConstant specifying the pressure-overclosure relationship to be used. Possible values are HARD, EXPONENTIAL, LINEAR, TABULAR, and SCALE_FACTOR. The default value is HARD.
- allowSeparation=
1
¶ A Boolean specifying whether to allow separation after contact. The default value is ON.
- maxStiffness=
None
¶ None or a Float specifying the maximum stiffness. If maxStiffness = None, there is no upper limit. The default value is None.
- table=
()
¶ A sequence of sequences of Floats specifying the normal behavior properties. This argument is valid only for pressureOverclosure = EXPONENTIAL or TABULAR. The items in the table data are described below.
- constraintEnforcementMethod=
DEFAULT
¶ A SymbolicConstant specifying the method for enforcement of the contact constraint. Possible values are DEFAULT, AUGMENTED_LAGRANGE, PENALTY, and DIRECT. The default value is DEFAULT.
- overclosureFactor=
0
¶ A Float specifying the overclosure measure (used to delineate the segments of the pressure-overclosure curve) as a percentage of the minimum element size in the contact region. The default value is 0.0.
- overclosureMeasure=
0
¶ A Float specifying the overclosure measure (used to delineate the segments of the pressure-overclosure curve) directly. The default value is 0.0.
- contactStiffnessScaleFactor=
1
¶ A Float specifying scale factor for the penalty stiffness or the geometric scaling of the “base” stiffness. The default value is 1.0.
- initialStiffnessScaleFactor=
1
¶ A Float specifying an additional scale factor for the “base” default contact stiffness. The default value is 1.0.
- clearanceAtZeroContactPressure=
0
¶ A Float specifying the clearance at which the contact pressure is zero. The default value is 0.0.
- stiffnessBehavior=
LINEAR
¶ A SymbolicConstant specifying the type of penalty stiffness to be defined. This argument is valid only when constraintEnforcementMethod = PENALTY. Possible values are LINEAR and NONLINEAR. The default value is LINEAR.
- stiffnessRatio=
0
¶ A Float specifying the ratio of the initial stiffness divided by the final stiffness. This argument is valid only when stiffnessBehavior = NONLINEAR. Possible values are 0 ≤ stiffnessRatio < 1. The default value is 0.01.
- upperQuadraticFactor=
0
¶ A Float specifying the ratio of the overclosure at the maximum stiffness divided by the characteristic facet length. This argument is valid only when stiffnessBehavior = NONLINEAR. The default value is 0.03.
- lowerQuadraticRatio=
0
¶ A Float specifying the ratio of the overclosure at the initial stiffness divided by the overclosure at the maximum stiffness, both relative to the clearance at which the contact pressure is zero. This argument is valid only when stiffnessBehavior = NONLINEAR. Possible values are 0 ≤ stiffnessRatio < 1. The default value is 0.33333.
- contactStiffness=
- Returns:¶
A NormalBehavior object.
- Return type:¶
- Radiation(mainEmissivity, secondaryEmissivity, table)[source]¶
This method creates a Radiation object.
Note
This function can be accessed by:
mdb.models[name].ContactProperty
Note
- Parameters:¶
- mainEmissivity¶
A Float specifying the emissivity of the main surface.
Changed in version 2022: The argument
masterEmissivity
was renamed tomainEmissivity
.- secondaryEmissivity¶
A Float specifying the emissivity of the secondary surface.
Changed in version 2022: The argument
slaveEmissivity
was renamed tosecondaryEmissivity
.- table¶
A sequence of sequences of Floats specifying the following:Effective viewfactor, FF.Gap clearance, dd.
- Returns:¶
A Radiation object.
- Return type:¶
- TangentialBehavior(
- formulation=
FRICTIONLESS
, - directionality=
ISOTROPIC
, - slipRateDependency=
0
, - pressureDependency=
0
, - temperatureDependency=
0
, - dependencies=
0
, - exponentialDecayDefinition=
COEFFICIENTS
, - table=
()
, - shearStressLimit=
None
, - maximumElasticSlip=
FRACTION
, - fraction=
0
, - absoluteDistance=
0
, - elasticSlipStiffness=
None
, - nStateDependentVars=
0
, - useProperties=
0
, This method creates a ContactTangentialBehavior object.
Note
This function can be accessed by:
mdb.models[name].ContactProperty
Note
- Parameters:¶
- formulation=
FRICTIONLESS
¶ A SymbolicConstant specifying the friction formulation. Possible values are FRICTIONLESS, PENALTY, EXPONENTIAL_DECAY, ROUGH, LAGRANGE, and USER_DEFINED. The default value is FRICTIONLESS.
- directionality=
ISOTROPIC
¶ A SymbolicConstant specifying the directionality of the friction. Possible values are ISOTROPIC and ANISOTROPIC. The default value is ISOTROPIC.
- slipRateDependency=
0
¶ A Boolean specifying whether the data depend on slip rate. The default value is OFF.
- pressureDependency=
0
¶ A Boolean specifying whether the data depend on contact pressure. The default value is OFF.
- temperatureDependency=
0
¶ A Boolean specifying whether the data depend on temperature. The default value is OFF.
- dependencies=
0
¶ An Int specifying the number of field variables. The default value is 0.
- exponentialDecayDefinition=
COEFFICIENTS
¶ A SymbolicConstant specifying the exponential decay definition. Possible values are COEFFICIENTS and TEST_DATA. The default value is COEFFICIENTS.
- table=
()
¶ A sequence of sequences of Floats specifying tangential behavior. The items in the table data are described below.
- shearStressLimit=
None
¶ None or a Float specifying the shear stress limit. If shearStressLimit = None, there is no upper limit. The default value is None.
- maximumElasticSlip=
FRACTION
¶ A SymbolicConstant specifying what the maximum elastic slip will be. Possible values are FRACTION and ABSOLUTE_DISTANCE. The default value is FRACTION.
- fraction=
0
¶ A Float specifying the fraction of a characteristic surface dimension. The default value is 0.0.
- absoluteDistance=
0
¶ A Float specifying the absolute distance. The default value is 0.0.
- elasticSlipStiffness=
None
¶ None or a Float specifying the elastic slip stiffness. If elasticSlipStiffness = None, there is no upper limit. The default value is None.
- nStateDependentVars=
0
¶ An Int specifying the number of state-dependent variables. The default value is 0.
- useProperties=
0
¶ A Boolean specifying whether property values will be used. The default value is OFF.
- formulation=
- Returns:¶
A ContactTangentialBehavior object.
- Return type:¶
ContactTangentialBehavior
- ThermalConductance(
- definition=
TABULAR
, - clearanceDependency=
1
, - pressureDependency=
0
, - temperatureDependencyC=
0
, - massFlowRateDependencyC=
0
, - dependenciesC=
0
, - clearanceDepTable=
()
, - temperatureDependencyP=
0
, - massFlowRateDependencyP=
0
, - dependenciesP=
0
, - pressureDepTable=
()
, This method creates a ThermalConductance object.
Note
This function can be accessed by:
mdb.models[name].ContactProperty
Note
- Parameters:¶
- definition=
TABULAR
¶ A SymbolicConstant specifying how the thermal conductance is defined. Possible values are TABULAR and USER_DEFINED. The default value is TABULAR.
- clearanceDependency=
1
¶ A Boolean specifying whether to use clearance-dependent data. The default value is ON.
- pressureDependency=
0
¶ A Boolean specifying whether to use pressure-dependent data. The default value is OFF.
- temperatureDependencyC=
0
¶ A Boolean specifying whether to use temperature-dependent data with clearance dependency. The default value is OFF.
- massFlowRateDependencyC=
0
¶ A Boolean specifying whether to use mass-flow-rate-dependent data with clearance dependency. The default value is OFF.
- dependenciesC=
0
¶ An Int specifying the number of field variables to use with clearance dependency. The default value is 0.
- clearanceDepTable=
()
¶ A sequence of sequences of Floats specifying clearance dependency data. The items in the table data are described below.
- temperatureDependencyP=
0
¶ A Boolean specifying whether to use temperature-dependent data with pressure dependency. The default value is OFF.
- massFlowRateDependencyP=
0
¶ A Boolean specifying whether to use mass-flow-rate-dependent data with pressure dependency. The default value is OFF.
- dependenciesP=
0
¶ An Int specifying the number of field variables to use with pressure dependency. The default value is 0.
- pressureDepTable=
()
¶ A sequence of sequences of Floats specifying pressure dependency data. The items in the table data are described below.
- definition=
- Returns:¶
A ThermalConductance object.
- Return type:¶
-
cohesiveBehavior : --is-rst--:py:class:`~abaqus.Interaction.CohesiveBehavior.CohesiveBehavior` =
<abaqus.Interaction.CohesiveBehavior.CohesiveBehavior object>
[source]¶ A CohesiveBehavior object.
-
damage : --is-rst--:py:class:`~abaqus.Interaction.ContactDamage.ContactDamage` =
<abaqus.Interaction.ContactDamage.ContactDamage object>
[source]¶ A ContactDamage object.
-
damping : --is-rst--:py:class:`~abaqus.Interaction.ContactDamping.ContactDamping` =
<abaqus.Interaction.ContactDamping.ContactDamping object>
[source]¶ A ContactDamping object.
-
electricalConductance : --is-rst--:py:class:`~abaqus.Interaction.GapElectricalConductance.GapElectricalConductance` =
<abaqus.Interaction.GapElectricalConductance.GapElectricalConductance object>
[source]¶ A GapElectricalConductance object.
-
fractureCriterion : --is-rst--:py:class:`~abaqus.Interaction.FractureCriterion.FractureCriterion` =
<abaqus.Interaction.FractureCriterion.FractureCriterion object>
[source]¶ A FractureCriterion object.
-
geometricProperties : --is-rst--:py:class:`~abaqus.Interaction.GeometricProperties.GeometricProperties` =
<abaqus.Interaction.GeometricProperties.GeometricProperties object>
[source]¶ A GeometricProperties object.
-
heatGeneration : --is-rst--:py:class:`~abaqus.Interaction.GapHeatGeneration.GapHeatGeneration` =
<abaqus.Interaction.GapHeatGeneration.GapHeatGeneration object>
[source]¶ A GapHeatGeneration object.
-
normalBehavior : --is-rst--:py:class:`~abaqus.Interaction.NormalBehavior.NormalBehavior` =
<abaqus.Interaction.NormalBehavior.NormalBehavior object>
[source]¶ A NormalBehavior object.
-
radiation : --is-rst--:py:class:`~abaqus.Interaction.Radiation.Radiation` | :py:obj:`None` =
None
[source]¶ A Radiation object.
- class AcousticImpedanceState[source]¶
Bases:
InteractionState
The AcousticImpedanceState object stores the propagating data of an AcousticImpedance object in a step. One instance of this object is created internally by the AcousticImpedance object for each step. The instance is also deleted internally by the AcousticImpedance object. The AcousticImpedanceState object has no constructor or methods. The AcousticImpedanceState object is derived from the InteractionState object.
Note
This object can be accessed by:
import interaction mdb.models[name].steps[name].interactionStates[name]
The corresponding analysis keywords are:
SIMPEDANCE
Note
Member Details:
-
interactionProperty : --is-rst--:py:class:`str` =
''
[source]¶ A String specifying the name of the AcousticImpedanceProp object associated with this interaction.
- interactionPropertyState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶
A SymbolicConstant specifying the propagation state of the interactionProperty member. Possible values are UNSET, SET, UNCHANGED, and FREED.
- status : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶
A SymbolicConstant specifying the propagation state of the InteractionState object. Possible values are:
NOT_YET_ACTIVE
CREATED
PROPAGATED
MODIFIED
DEACTIVATED
NO_LONGER_ACTIVE
TYPE_NOT_APPLICABLE
INSTANCE_NOT_APPLICABLE
BUILT_INTO_BASE_STATE
- class InteractionState[source]¶
Bases:
object
The InteractionState object is the abstract base type for other InteractionState objects. The InteractionState object has no explicit constructor. The members of the InteractionState object are common to all objects derived from InteractionState.
Note
This object can be accessed by:
import interaction mdb.models[name].steps[name].interactionStates[name]
Note
Member Details:
- status : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶
A SymbolicConstant specifying the propagation state of the InteractionState object. Possible values are:
NOT_YET_ACTIVE
CREATED
PROPAGATED
MODIFIED
DEACTIVATED
NO_LONGER_ACTIVE
TYPE_NOT_APPLICABLE
INSTANCE_NOT_APPLICABLE
BUILT_INTO_BASE_STATE
- class ActuatorSensor(
- name,
- createStepName,
- point,
- interactionProperty,
- noCoordComponents,
- unsymm,
- noSolutionDepVar,
- userSubUel,
- dof,
- solutionDepVars,
Bases:
Interaction
The ActuatorSensor object defines a single point actuator where the actuation is determined by a user subroutine (UEL). The subroutine senses the data at the same point as the actuator. The ActuatorSensor object is derived from the Interaction object.
Note
This object can be accessed by:
import interaction mdb.models[name].interactions[name]
The corresponding analysis keywords are:
ELEMENT
USER ELEMENT
INITIAL CONDITIONS
Note
Member Details:
- createStepName : --is-rst--:py:class:`str`[source]¶
A String specifying the name of the step in which the actuator/sensor interaction is created. createStepName must be set to ‘Initial’.
- dof : --is-rst--:py:class:`str`[source]¶
A String specifying the degrees of freedom, separated by commas.
- interactionProperty : --is-rst--:py:class:`str`[source]¶
A String specifying the ActuatorSensorProp object associated with this interaction.
- noCoordComponents : --is-rst--:py:class:`int`[source]¶
An Int specifying the number of coordinate components supplied to the user subroutine (UEL).
- noSolutionDepVar : --is-rst--:py:class:`int`[source]¶
An Int specifying the number of solution-dependent variables. The default value is 0.
- point : --is-rst--:py:class:`~abaqus.Region.Region.Region`[source]¶
A Region object specifying the point at which the constraint is applied.
-
solutionDepVars : --is-rst--:py:class:`tuple`\ \[:py:class:`float`, :py:data:`...<Ellipsis>`] =
()
[source]¶ A sequence of Floats specifying the initial values of the solution-dependent variables.
-
class ActuatorSensorProp(name, realProperties=
()
, integerProperties=()
)[source]¶ Bases:
ContactProperty
The ActuatorSensorProp object is an interaction property that defines the properties referred to by an ActuatorSensor object. The ActuatorSensorProp object is derived from the InteractionProperty object.
Note
This object can be accessed by:
import interaction mdb.models[name].interactionProperties[name]
The corresponding analysis keywords are:
UEL PROPERTY
Note
Member Details:
-
integerProperties : --is-rst--tuple[int, ...] =
()
[source]¶ A sequence of Ints specifying the JPROPS array used by user subroutine UEL. The default value is an empty sequence.
-
realProperties : --is-rst--tuple[float, ...] =
()
[source]¶ A sequence of Floats specifying the PROPS array used by user subroutine UEL. The default value is an empty sequence.
-
setValues(realProperties=
()
, integerProperties=()
)[source]¶ This method modifies the ActuatorSensorProp object.
- class ActuatorSensorState[source]¶
Bases:
InteractionState
The ActuatorSensorState object stores the propagating data of an actuator sensor in a step. One instance of this object is created internally by the ActuatorSensor object for each step. The instance is also deleted internally by the ActuatorSensor object. The ActuatorSensorState object has no constructor, methods, or members. The ActuatorSensorState object is derived from the InteractionState object.
Note
This object can be accessed by:
import interaction mdb.models[name].steps[name].interactionStates[name]
Note
Member Details:
- status : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶
A SymbolicConstant specifying the propagation state of the InteractionState object. Possible values are:
NOT_YET_ACTIVE
CREATED
PROPAGATED
MODIFIED
DEACTIVATED
NO_LONGER_ACTIVE
TYPE_NOT_APPLICABLE
INSTANCE_NOT_APPLICABLE
BUILT_INTO_BASE_STATE
- class CavityRadiation(
- name,
- createStepName,
- surfaces,
- surfaceEmissivities,
- ambientTemp=
None
, - blocking=
BLOCKING_ALL
, - blockingSurfaces=
None
, - rangeOfView=
None
, - surfaceReflection=
1
, - viewfactorAccurTol=
0
, - minInfinitesimalRatio=
64
, - numPointsPerEdge=
3
, - minLumpedAreaDS=
5
, - cyclicSymmetry=
0
, - cyclicImages=
2
, - cyclicRotPt=
None
, - cyclicRotEndPt=
None
, - cyclicSymPt=
None
, - periodicSymmetries=
0
, - periodicImages_1=
2
, - periodicImages_2=
2
, - periodicImages_3=
2
, - periodicSymAxis_1=
''
, - periodicSymAxis_2=
''
, - periodicSymPlane_1=
''
, - periodicSymPlane_2=
''
, - periodicSymPlane_3=
''
, - periodicDistance_1=
()
, - periodicDistance_2=
()
, - periodicDistance_3=
()
, - periodicSymZ=
None
, - periodicDistZ=
None
, - reflectionSymmetries=
0
, - reflectionSymAxis_1=
''
, - reflectionSymAxis_2=
''
, - reflectionSymPlane_1=
''
, - reflectionSymPlane_2=
''
, - reflectionSymPlane_3=
''
, - reflectionSymZ=
None
, Bases:
Interaction
The CavityRadiation object defines cavities for thermal radiation heat transfer and controls the calculation of viewfactors. The CavityRadiation object is derived from the Interaction object.
Note
This object can be accessed by:
import interaction mdb.models[name].interactions[name]
The corresponding analysis keywords are:
CAVITY DEFINITION
CYCLIC
EMISSIVITY
PERIODIC
RADIATION SYMMETRY
RADIATION VIEWFACTOR
REFLECTION
Note
Member Details:
-
ambientTemp : --is-rst--:py:class:`float` | :py:obj:`None` =
None
[source]¶ None or a Float specifying the reference ambient temperature value, θ0θ0. Specifying a value indicates an open cavity. The default value is None.
-
createStepName : --is-rst--:py:class:`str` =
''
[source]¶ A String specifying the name of the step in which the cavity radiation interaction should be created.
-
cyclicImages : --is-rst--:py:class:`int` =
2
[source]¶ An Int specifying the number of cyclically similar images that compose the cavity formed as a result of this symmetry. This argument applies only when cyclicSymmetry = ON. The default value is 2.
-
cyclicRotEndPt : --is-rst--:py:class:`~abaqus.BasicGeometry.ModelDot.ModelDot` =
<abaqus.BasicGeometry.ModelDot.ModelDot object>
[source]¶ A ModelDot object specifying the rotation axis end point. This argument applies only for three-dimensional models, and only when cyclicSymmetry = ON.
-
cyclicRotPt : --is-rst--:py:class:`~abaqus.BasicGeometry.ModelDot.ModelDot` =
<abaqus.BasicGeometry.ModelDot.ModelDot object>
[source]¶ A ModelDot object specifying the rotation axis point. This argument applies only when cyclicSymmetry = ON.
-
cyclicSymPt : --is-rst--:py:class:`~abaqus.BasicGeometry.ModelDot.ModelDot` =
<abaqus.BasicGeometry.ModelDot.ModelDot object>
[source]¶ A ModelDot object specifying the symmetry axis end point. This argument applies only when cyclicSymmetry = ON.
-
cyclicSymmetry : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] =
0
[source]¶ A Boolean specifying whether cyclic symmetry will be applied. This argument cannot be specified for axisymmetric models. The default value is OFF.
-
minInfinitesimalRatio : --is-rst--:py:class:`float` =
64
[source]¶ A Float specifying the facet area ratio above which the infinitesimal-to-finite area approximation is used for viewfactor calculations. The default value is 64.0.
-
minLumpedAreaDS : --is-rst--:py:class:`float` =
5
[source]¶ A Float specifying the nondimensional distance-square value above which the lumped area approximation is used for viewfactor calculations. The default value is 5.0.
-
numPointsPerEdge : --is-rst--:py:class:`int` =
3
[source]¶ An Int specifying the number of Gauss integration points to be used along each edge when the numerical integration of contour integrals is used for viewfactor calculations. One to five integration points are allowed. The default value is 3.
-
periodicDistZ : --is-rst--:py:class:`float` | :py:obj:`None` =
None
[source]¶ None or a Float specifying the Z value indicating the periodic distance in axisymmetric models. This argument applies only for axisymmetric models, and when periodicSymmetries = 1. The default value is None.
-
periodicDistance_1 : --is-rst--:py:class:`tuple`\ \[:py:class:`tuple`\ \[:py:class:`float`, :py:data:`...<Ellipsis>`], :py:data:`...<Ellipsis>`] =
()
[source]¶ A tuple of tuples of Floats specifying the two points of the vector that describes the periodic distance for the first periodic symmetry. Each point is defined by a tuple of three coordinates indicating its position. This argument applies only when periodicSymmetries is greater than zero. The default value is an empty sequence.
-
periodicDistance_2 : --is-rst--:py:class:`tuple`\ \[:py:class:`tuple`\ \[:py:class:`float`, :py:data:`...<Ellipsis>`], :py:data:`...<Ellipsis>`] =
()
[source]¶ A tuple of tuples of Floats specifying the two points of the vector that describes the periodic distance for the second periodic symmetry. Each point is defined by a tuple of three coordinates indicating its position. This argument applies only when periodicSymmetries is greater than one. The default value is an empty sequence.
-
periodicDistance_3 : --is-rst--:py:class:`tuple`\ \[:py:class:`tuple`\ \[:py:class:`float`, :py:data:`...<Ellipsis>`], :py:data:`...<Ellipsis>`] =
()
[source]¶ A tuple of tuples of Floats specifying the two points of the vector that describes the periodic distance for the third periodic symmetry. Each point is defined by a tuple of three coordinates indicating its position. This argument applies only when periodicSymmetries = 3. The default value is an empty sequence.
-
periodicImages_1 : --is-rst--:py:class:`int` =
2
[source]¶ An Int specifying the number of repetitions used in the numerical calculation of the cavity viewfactors resulting from the first periodic symmetry. The result of this symmetry is a cavity composed of the cavity surface defined in the model plus twice the value of periodicImages_1. This argument applies only when periodicSymmetries is greater than zero. The default value is 2.
-
periodicImages_2 : --is-rst--:py:class:`int` =
2
[source]¶ An Int specifying the number of repetitions used in the numerical calculation of the cavity viewfactors resulting from the second periodic symmetry. The result of this symmetry is a cavity composed of the cavity surface defined in the model plus twice the value of periodicImages_2. This argument applies only when periodicSymmetries is greater than one. The default value is 2.
-
periodicImages_3 : --is-rst--:py:class:`int` =
2
[source]¶ An Int specifying the number of repetitions used in the numerical calculation of the cavity viewfactors resulting from the third periodic symmetry. The result of this symmetry is a cavity composed of the cavity surface defined in the model plus twice the value of periodicImages_3. This argument applies only when periodicSymmetries = 3. The default value is 2.
-
periodicSymZ : --is-rst--:py:class:`float` | :py:obj:`None` =
None
[source]¶ None or a Float specifying the Z value indicating the symmetry reference line in axisymmetric models. This argument applies only for axisymmetric models, and when periodicSymmetries = 1. The default value is None.
-
periodicSymmetries : --is-rst--:py:class:`int` =
0
[source]¶ An Int specifying the number of periodic symmetries that will be applied. The default value is 0.
-
reflectionSymZ : --is-rst--:py:class:`float` | :py:obj:`None` =
None
[source]¶ None or a Float specifying the Z value indicating the symmetry reference line in axisymmetric models. This argument applies only for axisymmetric models, and when reflectionSymmetries = 1. The default value is None.
-
reflectionSymmetries : --is-rst--:py:class:`int` =
0
[source]¶ An Int specifying the number of reflection symmetries will be applied. The default value is 0.
- setValues(
- surfaceEmissivities=
()
, - ambientTemp=
None
, - blocking=
BLOCKING_ALL
, - blockingSurfaces=
None
, - rangeOfView=
None
, - surfaceReflection=
1
, - viewfactorAccurTol=
0
, - minInfinitesimalRatio=
64
, - numPointsPerEdge=
3
, - minLumpedAreaDS=
5
, - cyclicSymmetry=
0
, - cyclicImages=
2
, - cyclicRotPt=
None
, - cyclicRotEndPt=
None
, - cyclicSymPt=
None
, - periodicSymmetries=
0
, - periodicImages_1=
2
, - periodicImages_2=
2
, - periodicImages_3=
2
, - periodicSymAxis_1=
''
, - periodicSymAxis_2=
''
, - periodicSymPlane_1=
''
, - periodicSymPlane_2=
''
, - periodicSymPlane_3=
''
, - periodicDistance_1=
()
, - periodicDistance_2=
()
, - periodicDistance_3=
()
, - periodicSymZ=
None
, - periodicDistZ=
None
, - reflectionSymmetries=
0
, - reflectionSymAxis_1=
''
, - reflectionSymAxis_2=
''
, - reflectionSymPlane_1=
''
, - reflectionSymPlane_2=
''
, - reflectionSymPlane_3=
''
, - reflectionSymZ=
None
, This method modifies the data for an existing CavityRadiation object in the step where it is created.
Note
- Parameters:¶
- surfaceEmissivities=
()
¶ A sequence of Strings specifying the names of the Cavity Radiation properties containing the surface emissivity data. One name per specified surface. The emissivity data is ignored when surfaceReflection = OFF.
- ambientTemp=
None
¶ None or a Float specifying the reference ambient temperature value, θ0θ0. Specifying a value indicates an open cavity. The default value is None.
- blocking=
BLOCKING_ALL
¶ A SymbolicConstant specifying the blocking checks to be performed in the viewfactor calculations. Possible values are BLOCKING_ALL, NO_BLOCKING, and PARTIAL_BLOCKING. The default value is BLOCKING_ALL.
- blockingSurfaces=
None
¶ A RegionArray object specifying the surfaces that provide blocking inside the cavity. This argument applies only when blocking = PARTIAL_BLOCKING.
- rangeOfView=
None
¶ None or a Float specifying the maximum distance between surface facets at which viewfactors are calculated. More distant facets are deemed too far apart to exchange significant amounts of heat through radiation effects, and the viewfactors between these facets are assumed to be zero. If rangeOfView = None, there is no upper limit. The default value is None.
- surfaceReflection=
1
¶ A Boolean specifying whether heat reflections are to be included in the cavity radiation calculations. The default value is ON.
- viewfactorAccurTol=
0
¶ A Float specifying the acceptable tolerance for the viewfactor calculations. The default value is 0.05.
- minInfinitesimalRatio=
64
¶ A Float specifying the facet area ratio above which the infinitesimal-to-finite area approximation is used for viewfactor calculations. The default value is 64.0.
- numPointsPerEdge=
3
¶ An Int specifying the number of Gauss integration points to be used along each edge when the numerical integration of contour integrals is used for viewfactor calculations. One to five integration points are allowed. The default value is 3.
- minLumpedAreaDS=
5
¶ A Float specifying the nondimensional distance-square value above which the lumped area approximation is used for viewfactor calculations. The default value is 5.0.
- cyclicSymmetry=
0
¶ A Boolean specifying whether cyclic symmetry will be applied. This argument cannot be specified for axisymmetric models. The default value is OFF.
- cyclicImages=
2
¶ An Int specifying the number of cyclically similar images that compose the cavity formed as a result of this symmetry. This argument applies only when cyclicSymmetry = ON. The default value is 2.
- cyclicRotPt=
None
¶ A ModelDot object specifying the rotation axis point. This argument applies only when cyclicSymmetry = ON.
- cyclicRotEndPt=
None
¶ A ModelDot object specifying the rotation axis end point. This argument applies only for three-dimensional models, and only when cyclicSymmetry = ON.
- cyclicSymPt=
None
¶ A ModelDot object specifying the symmetry axis end point. This argument applies only when cyclicSymmetry = ON.
- periodicSymmetries=
0
¶ An Int specifying the number of periodic symmetries that will be applied. The default value is 0.
- periodicImages_1=
2
¶ An Int specifying the number of repetitions used in the numerical calculation of the cavity viewfactors resulting from the first periodic symmetry. The result of this symmetry is a cavity composed of the cavity surface defined in the model plus twice the value of periodicImages_1. This argument applies only when periodicSymmetries is greater than zero. The default value is 2.
- periodicImages_2=
2
¶ An Int specifying the number of repetitions used in the numerical calculation of the cavity viewfactors resulting from the second periodic symmetry. The result of this symmetry is a cavity composed of the cavity surface defined in the model plus twice the value of periodicImages_2. This argument applies only when periodicSymmetries is greater than one. The default value is 2.
- periodicImages_3=
2
¶ An Int specifying the number of repetitions used in the numerical calculation of the cavity viewfactors resulting from the third periodic symmetry. The result of this symmetry is a cavity composed of the cavity surface defined in the model plus twice the value of periodicImages_3. This argument applies only when periodicSymmetries = 3. The default value is 2.
- periodicSymAxis_1=
''
¶ A straight Edge, a Datum object representing a datum axis, or an ElementEdge object indicating the first line of symmetry in two-dimensional models. This argument applies only for 2D models, and when periodicSymmetries is greater than zero.
- periodicSymAxis_2=
''
¶ A straight Edge, a Datum object representing a datum axis, or an ElementEdge object indicating the second line of symmetry in two-dimensional models. This argument applies only for two-dimensional models, and when periodicSymmetries = 2.
- periodicSymPlane_1=
''
¶ A planar Face, an ElementFace, or a Datum object representing a datum plane; indicating the first plane of symmetry in three-dimensional models. This argument applies only for three-dimensional models, and when periodicSymmetries is greater than zero.
- periodicSymPlane_2=
''
¶ A planar Face, an ElementFace, or a Datum object representing a datum plane; indicating the second plane of symmetry in three-dimensional models. This argument applies only for three-dimensional models, and when periodicSymmetries is greater than one.
- periodicSymPlane_3=
''
¶ A planar Face, an ElementFace, or a Datum object representing a datum plane; indicating the third plane of symmetry in three-dimensional models. This argument applies only for three-dimensional models, and when periodicSymmetries = 3.
- periodicDistance_1=
()
¶ A sequence of sequences of Floats specifying the two points of the vector that describes the periodic distance for the first periodic symmetry. Each point is defined by a tuple of three coordinates indicating its position. This argument applies only when periodicSymmetries is greater than zero. The default value is an empty sequence.
- periodicDistance_2=
()
¶ A sequence of sequences of Floats specifying the two points of the vector that describes the periodic distance for the second periodic symmetry. Each point is defined by a tuple of three coordinates indicating its position. This argument applies only when periodicSymmetries is greater than one. The default value is an empty sequence.
- periodicDistance_3=
()
¶ A sequence of sequences of Floats specifying the two points of the vector that describes the periodic distance for the third periodic symmetry. Each point is defined by a tuple of three coordinates indicating its position. This argument applies only when periodicSymmetries = 3. The default value is an empty sequence.
- periodicSymZ=
None
¶ None or a Float specifying the Z value indicating the symmetry reference line in axisymmetric models. This argument applies only for axisymmetric models, and when periodicSymmetries = 1. The default value is None.
- periodicDistZ=
None
¶ None or a Float specifying the Z value indicating the periodic distance in axisymmetric models. This argument applies only for axisymmetric models, and when periodicSymmetries = 1. The default value is None.
- reflectionSymmetries=
0
¶ An Int specifying the number of reflection symmetries will be applied. The default value is 0.
- reflectionSymAxis_1=
''
¶ A straight Edge, a Datum object representing a datum axis, or an ElementEdge object indicating the first line of symmetry in two-dimensional models. This argument applies only for two-dimensional models, and when reflectionSymmetries is greater than zero.
- reflectionSymAxis_2=
''
¶ A straight Edge, a Datum object representing a datum axis, or an ElementEdge object indicating the second line of symmetry in two-dimensional models. This argument applies only for two-dimensional models, and when reflectionSymmetries = 2.
- reflectionSymPlane_1=
''
¶ A planar Face, an ElementFace, or a Datum object representing a datum plane; indicating the first plane of symmetry in three-dimensional models. This argument applies only for three-dimensional models, and when reflectionSymmetries is greater than zero.
- reflectionSymPlane_2=
''
¶ A planar Face, an ElementFace, or a Datum object representing a datum plane; indicating the second plane of symmetry in three-dimensional models. This argument applies only for three-dimensional models, and when reflectionSymmetries is greater than one.
- reflectionSymPlane_3=
''
¶ A planar Face, an ElementFace, or a Datum object representing a datum plane; indicating the third plane of symmetry in three-dimensional models. This argument applies only for three-dimensional models, and when reflectionSymmetries = 3.
- reflectionSymZ=
None
¶ None or a Float specifying the Z value indicating the symmetry reference line in axisymmetric models. This argument applies only for axisymmetric models, and when reflectionSymmetries = 1. The default value is None.
- surfaceEmissivities=
- setValuesInStep(
- stepName,
- blocking=
BLOCKING_ALL
, - blockingSurfaces=
None
, - rangeOfView=
None
, - surfaceReflection=
1
, - viewfactorAccurTol=
0
, This method modifies the propagating data of an existing CavityRadiation object in the specified step.
- Parameters:¶
- stepName¶
A String specifying the name of the step in which the interaction is modified.
- blocking=
BLOCKING_ALL
¶ A SymbolicConstant specifying the blocking checks to be performed in the viewfactor calculations. Possible values are BLOCKING_ALL, NO_BLOCKING, and PARTIAL_BLOCKING. The default value is BLOCKING_ALL.
- blockingSurfaces=
None
¶ A RegionArray object specifying the surfaces that provide blocking inside the cavity. This argument applies only when blocking = PARTIAL_BLOCKING.
- rangeOfView=
None
¶ None or a Float specifying the maximum distance between surface facets at which viewfactors are calculated. More distant facets are deemed too far apart to exchange significant amounts of heat through radiation effects, and the viewfactors between these facets are assumed to be zero. If rangeOfView = None, there is no upper limit. The default value is None.
- surfaceReflection=
1
¶ A Boolean specifying whether heat reflections are to be included in the cavity radiation calculations. The default value is ON.
- viewfactorAccurTol=
0
¶ A Float specifying the acceptable tolerance for the viewfactor calculations. The default value is 0.05.
-
surfaceEmissivities : --is-rst--:py:class:`tuple`\ \[:py:class:`str`, :py:data:`...<Ellipsis>`] =
()
[source]¶ A tuple of Strings specifying the names of the Cavity Radiation properties containing the surface emissivity data. One name per specified surface. The emissivity data is ignored when surfaceReflection = OFF.
-
class CavityRadiationProp(name, temperatureDependency=
0
, dependencies=0
, property=()
)[source]¶ Bases:
ContactProperty
The CavityRadiationProp object is an interaction property that defines emissivity as a function of temperature and field variables. The CavityRadiationProp object is derived from the InteractionProperty object.
Note
This object can be accessed by:
import interaction mdb.models[name].interactionProperties[name]
The corresponding analysis keywords are:
EMISSIVITY
Note
Member Details:
-
dependencies : --is-rst--int =
0
[source]¶ An Int specifying the number of field variable dependencies. The default value is 0.
-
property : --is-rst--tuple[tuple[float, ...], ...] =
()
[source]¶ The emissivity, ϵϵ.Temperature, if the data depend on temperature.Value of the first field variable, if the data depend on field variables.Value of the second field variable.Etc.
- Type:¶
A sequence of sequences of Floats specifying the following
-
setValues(temperatureDependency=
0
, dependencies=0
, property=()
)[source]¶ This method modifies the CavityRadiationProp object.
- Parameters:¶
- temperatureDependency=
0
¶ A Boolean specifying whether the data depend on temperature. The default value is OFF.
- dependencies=
0
¶ An Int specifying the number of field variable dependencies. The default value is 0.
- property=
()
¶ A sequence of sequences of Floats specifying the following:The emissivity, ϵϵ.Temperature, if the data depend on temperature.Value of the first field variable, if the data depend on field variables.Value of the second field variable.Etc.
- temperatureDependency=
- class CavityRadiationState[source]¶
Bases:
InteractionState
The CavityRadiationState object stores the propagating data for a CavityRadiation object. One instance of this object is created internally by the CavityRadiation object for each step. The instance is also deleted internally by the CavityRadiation object. The CavityRadiationState object has no constructor or methods. The CavityRadiationState object is derived from the InteractionState object.
Note
This object can be accessed by:
import interaction mdb.models[name].steps[name].interactionStates[name]
The corresponding analysis keywords are:
RADIATION VIEWFACTOR
Note
Member Details:
- blocking : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶
A SymbolicConstant specifying the blocking checks to be performed in the viewfactor calculations. Possible values are BLOCKING_ALL, NO_BLOCKING, and PARTIAL_BLOCKING.
- blockingState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶
A SymbolicConstant specifying the propagation state of the blocking member. Possible values are UNSET, SET, UNCHANGED, and FREED.
-
blockingSurfaces : --is-rst--:py:class:`tuple`\ \[:py:class:`str`, :py:data:`...<Ellipsis>`] =
()
[source]¶ A tuple of Strings specifying the surfaces that provide blocking inside the cavity.
- blockingSurfacesState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶
A SymbolicConstant specifying the propagation state of the blockingSurfaces member. Possible values are UNSET, SET, UNCHANGED, and FREED.
-
rangeOfView : --is-rst--:py:class:`float` | :py:obj:`None` =
None
[source]¶ A Float specifying the distance beyond which factors need not be calculated because surfaces are judged to be too far apart to “see” each other (due to blocking by other surfaces).
- rangeOfViewState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶
A SymbolicConstant specifying the propagation state of the rangeOfView member. Possible values are UNSET, SET, UNCHANGED, and FREED.
- status : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶
A SymbolicConstant specifying the propagation state of the InteractionState object. Possible values are:NOT_YET_ACTIVECREATEDPROPAGATEDMODIFIEDDEACTIVATEDNO_LONGER_ACTIVETYPE_NOT_APPLICABLEINSTANCE_NOT_APPLICABLEBUILT_INTO_BASE_STATE
-
surfaceReflection : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] =
1
[source]¶ A Boolean specifying whether reflection must be included in the cavity radiation calculations. The default value is ON.
- surfaceReflectionState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶
A SymbolicConstant specifying the propagation state of the surfaceReflection member. Possible values are UNSET, SET, UNCHANGED, and FREED.
- class CohesiveBehavior(
- repeatedContacts=
0
, - eligibility=
ALL_NODES
, - defaultPenalties=
1
, - coupling=
UNCOUPLED
, - temperatureDependency=
0
, - dependencies=
0
, - table=
()
, Bases:
object
The CohesiveBehaviour.
Note
This object can be accessed by:
import interaction mdb.models[name].interactionProperties[name].cohesiveBehavior
The table data for this object are:
If coupling = UNCOUPLED, the table data specify the following:
Stiffness coefficient in the normal direction, Knn.
Stiffness coefficient in the first shear direction, Kss.
Stiffness coefficient in the second shear direction, Ktt.
Temperature, if the data depend on temperature.
Value of the first field variable, if the data depend on field variables.
Value of the second field variable.
Etc.
If coupling = COUPLED, the table data specify the following:
Stiffness coefficient in the normal direction, Knn.
Stiffness coefficient in the first shear direction, Kss.
Stiffness coefficient in the second shear direction, Ktt.
Coupled stiffness coefficient, Kns.
Coupled stiffness coefficient, Knt.
Coupled stiffness coefficient, Kst.
Temperature, if the data depend on temperature.
Value of the first field variable, if the data depend on field variables.
Value of the second field variable.
Etc.
The corresponding analysis keywords are:
COHESIVE BEHAVIOR
Note
Member Details:
-
coupling : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` =
'UNCOUPLED'
[source]¶ A SymbolicConstant specifying whether the traction-separation coefficients are coupled or uncoupled. This argument is valid only for defaultPenalties = OFF. Possible values are UNCOUPLED and COUPLED. The default value is UNCOUPLED.
-
defaultPenalties : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] =
1
[source]¶ A Boolean specifying whether to use the default contact penalties. The default value is ON.
-
dependencies : --is-rst--:py:class:`int` =
0
[source]¶ An Int specifying the number of field variables. This argument is valid only for defaultPenalties = OFF. The default value is 0.
-
eligibility : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` =
'ALL_NODES'
[source]¶ A SymbolicConstant specifying the eligible secondary nodes. Possible values are ALL_NODES, INITIAL_NODES, and SPECIFIED. The default value is ALL_NODES.
-
repeatedContacts : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] =
0
[source]¶ A Boolean specifying whether to enforce cohesive behavior for recurrent contacts at nodes on the secondary surface subsequent to ultimate failure. The default value is OFF.
-
table : --is-rst--:py:class:`tuple`\ \[:py:class:`tuple`\ \[:py:class:`float`, :py:data:`...<Ellipsis>`], :py:data:`...<Ellipsis>`] =
()
[source]¶ A sequence of sequences of Floats specifying the traction-separation coefficients. The items in the table data are described below. This argument is valid only for defaultPenalties = OFF.
-
temperatureDependency : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] =
0
[source]¶ A Boolean specifying whether the coefficient data depend on temperature. This argument is valid only for defaultPenalties = OFF. The default value is OFF.
- class ConcentratedFilmCondition(
- name,
- createStepName,
- region,
- definition,
- nodalArea=
1
, - explicitRegionType=
LAGRANGIAN
, - interactionProperty=
''
, - field=
''
, - sinkTemperature=
0
, - sinkAmplitude=
''
, - filmCoeff=
0
, - filmCoeffAmplitude=
''
, - sinkFieldName=
''
, - sinkDistributionType=
UNIFORM
, Bases:
Interaction
The ConcentratedFilmCondition object defines concentrated film coefficients and associated sink temperatures. The ConcentratedFilmCondition object is derived from the Interaction object.
Note
This object can be accessed by:
import interaction mdb.models[name].interactions[name]
Note
Member Details:
- createStepName : --is-rst--:py:class:`str`[source]¶
A String specifying the name of the step in which the ConcentratedFilmCondition object is created.
- definition : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶
A SymbolicConstant specifying how the concentrated film condition is defined. Possible values are EMBEDDED_COEFF, PROPERTY_REF, USER_SUB, and FIELD.
-
explicitRegionType : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` =
'LAGRANGIAN'
[source]¶ A SymbolicConstant specifying how the concentrated film condition is applied to the boundary of an adaptive mesh domain. Possible values are LAGRANGIAN, SLIDING, and EULERIAN. The default value is LAGRANGIAN. This argument applies only during an Abaqus/Explicit analysis.
-
field : --is-rst--:py:class:`str` =
''
[source]¶ A String specifying the name of the AnalyticalField object associated with this interaction. The field argument applies only when definition = FIELD. The default value is an empty string.
-
filmCoeff : --is-rst--:py:class:`float` =
0
[source]¶ A Float specifying the reference film coefficient value, hh. The filmCoeff argument applies when definition = EMBEDDED_COEFF, definition = USER_SUB, or definition = FIELD. The default value is 0.0.
-
filmCoeffAmplitude : --is-rst--:py:class:`str` =
''
[source]¶ A String specifying the name of the Amplitude object that gives the variation of the film coefficient, hh, with time. The default value is an empty string. Note: Use None in an Abaqus/Standard analysis to specify that the reference film coefficient is applied immediately at the beginning of the step or linearly over the step. Use None in an Abaqus/Explicit analysis to specify that the reference film coefficient is applied throughout the step.
-
interactionProperty : --is-rst--:py:class:`str` =
''
[source]¶ A String specifying the name of the FilmConditionProp object associated with this interaction. The interactionProperty argument applies only when definition = PROPERTY_REF. The default value is an empty string.
-
nodalArea : --is-rst--:py:class:`float` =
1
[source]¶ A Float specifying the area associated with the node where the concentrated film condition is applied. The default value is 1.0.
- region : --is-rst--:py:class:`~abaqus.Region.Region.Region`[source]¶
A Region object specifying the region to which the concentrated film condition interaction is applied. The interaction is applied to each node in the region.
- setValues(
- nodalArea=
1
, - explicitRegionType=
LAGRANGIAN
, - interactionProperty=
''
, - field=
''
, - sinkTemperature=
0
, - sinkAmplitude=
''
, - filmCoeff=
0
, - filmCoeffAmplitude=
''
, - sinkFieldName=
''
, - sinkDistributionType=
UNIFORM
, This method modifies the data for an existing ConcentratedFilmCondition object in the step where it is created.
- Parameters:¶
- nodalArea=
1
¶ A Float specifying the area associated with the node where the concentrated film condition is applied. The default value is 1.0.
- explicitRegionType=
LAGRANGIAN
¶ A SymbolicConstant specifying how the concentrated film condition is applied to the boundary of an adaptive mesh domain. Possible values are LAGRANGIAN, SLIDING, and EULERIAN. The default value is LAGRANGIAN. This argument applies only during an Abaqus/Explicit analysis.
- interactionProperty=
''
¶ A String specifying the name of the FilmConditionProp object associated with this interaction. The interactionProperty argument applies only when definition = PROPERTY_REF. The default value is an empty string.
- field=
''
¶ A String specifying the name of the AnalyticalField object associated with this interaction. The field argument applies only when definition = FIELD. The default value is an empty string.
- sinkTemperature=
0
¶ A Float specifying the reference sink temperature, θ0θ0. The default value is 0.0.
- sinkAmplitude=
''
¶ A String specifying the name of the Amplitude object that gives the variation of the sink temperature, θ0θ0, with time. The default value is an empty string. Note: Use None in an Abaqus/Standard analysis to specify that the reference sink temperature is applied immediately at the beginning of the step or linearly over the step. Use None in an Abaqus/Explicit analysis to specify that the reference sink temperature is applied throughout the step.
- filmCoeff=
0
¶ A Float specifying the reference film coefficient value, hh. The filmCoeff argument applies when definition = EMBEDDED_COEFF, definition = USER_SUB, or definition = FIELD. The default value is 0.0.
- filmCoeffAmplitude=
''
¶ A String specifying the name of the Amplitude object that gives the variation of the film coefficient, hh, with time. The default value is an empty string. Note: Use None in an Abaqus/Standard analysis to specify that the reference film coefficient is applied immediately at the beginning of the step or linearly over the step. Use None in an Abaqus/Explicit analysis to specify that the reference film coefficient is applied throughout the step.
- sinkFieldName=
''
¶ A String specifying the name of the AnalyticalField or DiscreteField object associated with the sink temperature. The sinkFieldName argument applies only when sinkDistributionType = ANALYTICAL_FIELD or sinkDistributionType = DISCRETE_FIELD. The default value is an empty string.
- sinkDistributionType=
UNIFORM
¶ A SymbolicConstant specifying how the sink temperature is distributed. Possible values are UNIFORM, ANALYTICAL_FIELD, and DISCRETE_FIELD. The default value is UNIFORM.
- nodalArea=
- setValuesInStep(stepName)[source]¶
This method modifies the propagating data of an existing ConcentratedFilmCondition object in the specified step.
-
sinkAmplitude : --is-rst--:py:class:`str` =
''
[source]¶ A String specifying the name of the Amplitude object that gives the variation of the sink temperature, θ0θ0, with time. The default value is an empty string. Note: Use None in an Abaqus/Standard analysis to specify that the reference sink temperature is applied immediately at the beginning of the step or linearly over the step. Use None in an Abaqus/Explicit analysis to specify that the reference sink temperature is applied throughout the step.
-
sinkDistributionType : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` =
'UNIFORM'
[source]¶ A SymbolicConstant specifying how the sink temperature is distributed. Possible values are UNIFORM, ANALYTICAL_FIELD, and DISCRETE_FIELD. The default value is UNIFORM.
-
sinkFieldName : --is-rst--:py:class:`str` =
''
[source]¶ A String specifying the name of the AnalyticalField or DiscreteField object associated with the sink temperature. The sinkFieldName argument applies only when sinkDistributionType = ANALYTICAL_FIELD or sinkDistributionType = DISCRETE_FIELD. The default value is an empty string.
- class ConcentratedFilmConditionState[source]¶
Bases:
InteractionState
The ConcentratedFilmConditionState object stores the propagating data for a ConcentratedFilmCondition object. One instance of this object is created internally by the ConcentratedFilmCondition object for each step. The instance is also deleted internally by the ConcentratedFilmCondition object. The ConcentratedFilmConditionState object has no constructor or methods. The ConcentratedFilmConditionState object is derived from the InteractionState object.
Note
This object can be accessed by:
import interaction mdb.models[name].steps[name].interactionStates[name]
The corresponding analysis keywords are:
CFILM
Member Details:
-
filmCoeff : --is-rst--:py:class:`float` | :py:obj:`None` =
None
[source]¶ A Float specifying the film coefficient.
-
filmCoeffAmplitude : --is-rst--:py:class:`str` =
''
[source]¶ A String specifying the name of the Amplitude object that gives the variation of the film coefficient.
- filmCoeffAmplitudeState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶
A SymbolicConstant specifying the propagation state of the filmCoeffAmplitude member. Possible values are UNSET, SET, UNCHANGED, and FREED.
- filmCoeffState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶
A SymbolicConstant specifying the propagation state of the filmCoeff member. Possible values are UNSET, SET, UNCHANGED, and FREED.
-
interactionProperty : --is-rst--:py:class:`str` =
''
[source]¶ A String specifying the FilmConditionProp object associated with this interaction.
- interactionPropertyState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶
A SymbolicConstant specifying the propagation state of the interactionProperty member. Possible values are UNSET, SET, UNCHANGED, and FREED.
-
nodalArea : --is-rst--:py:class:`float` | :py:obj:`None` =
None
[source]¶ A Float specifying the area associated with the node where the concentrated film condition is applied.
- nodalAreaState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶
A SymbolicConstant specifying the propagation state of the nodalArea member. Possible values are UNSET, SET, UNCHANGED, and FREED.
-
sinkAmplitude : --is-rst--:py:class:`str` =
''
[source]¶ A String specifying the name of the Amplitude object that gives the variation of the sink temperature.
- sinkAmplitudeState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶
A SymbolicConstant specifying the propagation state of the sinkAmplitude member. Possible values are UNSET, SET, UNCHANGED, and FREED.
-
sinkTemperature : --is-rst--:py:class:`float` | :py:obj:`None` =
None
[source]¶ A Float specifying the sink temperature.
- sinkTemperatureState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶
A SymbolicConstant specifying the propagation state of the sinkTemperature member. Possible values are UNSET, SET, UNCHANGED, and FREED.
- status : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶
A SymbolicConstant specifying the propagation state of the InteractionState object. Possible values are:
NOT_YET_ACTIVE
CREATED
PROPAGATED
MODIFIED
DEACTIVATED
NO_LONGER_ACTIVE
TYPE_NOT_APPLICABLE
INSTANCE_NOT_APPLICABLE
BUILT_INTO_BASE_STATE
- class ConcentratedRadiationToAmbient(
- name,
- createStepName,
- region,
- ambientTemperature,
- ambientTemperatureAmp,
- emissivity,
- nodalArea=
1
, - explicitRegionType=
LAGRANGIAN
, - field=
''
, - distributionType=
UNIFORM
, Bases:
Interaction
The ConcentratedRadiationToAmbient object defines radiant heat transfer between a point and its nonreflecting environment. The ConcentratedRadiationToAmbient object is derived from the Interaction object.
Note
This object can be accessed by:
import interaction mdb.models[name].interactions[name]
Member Details:
- ambientTemperature : --is-rst--:py:class:`float`[source]¶
A Float specifying the reference ambient temperature, θ0θ0.
- ambientTemperatureAmp : --is-rst--:py:class:`str`[source]¶
A String specifying the name of the Amplitude object that gives the variation of the ambient temperature with time. Note: Use None in an Abaqus/Standard analysis to specify that the reference ambient temperature is applied immediately at the beginning of the step or linearly over the step. Use None in an Abaqus/Explicit analysis to specify that the reference ambient temperature is applied throughout the step.
- createStepName : --is-rst--:py:class:`str`[source]¶
A String specifying the name of the step in which the ConcentratedRadiationToAmbient object is created.
-
distributionType : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` =
'UNIFORM'
[source]¶ A SymbolicConstant specifying how the radiation is defined. Possible values are UNIFORM and ANALYTICAL_FIELD. The default value is UNIFORM.
-
explicitRegionType : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` =
'LAGRANGIAN'
[source]¶ A SymbolicConstant specifying how the concentrated radiation is applied to the boundary of an adaptive mesh domain. Possible values are LAGRANGIAN, SLIDING, and EULERIAN. The default value is LAGRANGIAN. Note: explicitRegionType applies only during an Abaqus/Explicit analysis.
-
field : --is-rst--:py:class:`str` =
''
[source]¶ A String specifying the name of the AnalyticalField object associated with this interaction. The field argument applies only when distributionType = ANALYTICAL_FIELD. The default value is an empty string.
-
nodalArea : --is-rst--:py:class:`float` =
1
[source]¶ A Float specifying the area associated with the node where the concentrated radiation interaction is applied. The default value is 1.0.
- region : --is-rst--:py:class:`~abaqus.Region.Region.Region`[source]¶
A Region object specifying the region to which the concentrated radiation interaction is applied. The interaction is applied to each node in the region.
- setValues(
- nodalArea=
1
, - explicitRegionType=
LAGRANGIAN
, - field=
''
, - distributionType=
UNIFORM
, This method modifies the data for an existing ConcentratedRadiationToAmbient object in the step where it is created.
- Parameters:¶
- nodalArea=
1
¶ A Float specifying the area associated with the node where the concentrated radiation interaction is applied. The default value is 1.0.
- explicitRegionType=
LAGRANGIAN
¶ A SymbolicConstant specifying how the concentrated radiation is applied to the boundary of an adaptive mesh domain. Possible values are LAGRANGIAN, SLIDING, and EULERIAN. The default value is LAGRANGIAN. Note: explicitRegionType applies only during an Abaqus/Explicit analysis.
- field=
''
¶ A String specifying the name of the AnalyticalField object associated with this interaction. The field argument applies only when distributionType = ANALYTICAL_FIELD. The default value is an empty string.
- distributionType=
UNIFORM
¶ A SymbolicConstant specifying how the radiation is defined. Possible values are UNIFORM and ANALYTICAL_FIELD. The default value is UNIFORM.
- nodalArea=
- setValuesInStep(
- stepName,
- nodalArea=
1
, - field=
''
, - distributionType=
UNIFORM
, This method modifies the propagating data of an existing ConcentratedRadiationToAmbient object in the specified step.
- Parameters:¶
- stepName¶
A String specifying the name of the step in which the interaction is modified.
- nodalArea=
1
¶ A Float specifying the area associated with the node where the concentrated radiation interaction is applied. The default value is 1.0.
- field=
''
¶ A String specifying the name of the AnalyticalField object associated with this interaction. The field argument applies only when distributionType = ANALYTICAL_FIELD. The default value is an empty string.
- distributionType=
UNIFORM
¶ A SymbolicConstant specifying how the radiation is defined. Possible values are UNIFORM and ANALYTICAL_FIELD. The default value is UNIFORM.
- class ConcentratedRadiationToAmbientState[source]¶
Bases:
InteractionState
The ConcentratedRadiationToAmbientState object stores the propagating data for a ConcentratedRadiationToAmbient object. One instance of this object is created internally by the ConcentratedRadiationToAmbient object for each step. The instance is also deleted internally by the ConcentratedRadiationToAmbient object. The ConcentratedRadiationToAmbientState object has no constructor or methods. The ConcentratedRadiationToAmbientState object is derived from the InteractionState object.
Note
This object can be accessed by:
import interaction mdb.models[name].steps[name].interactionStates[name]
The corresponding analysis keywords are:
CRADIATE
Member Details:
-
ambientTemperature : --is-rst--:py:class:`float` | :py:obj:`None` =
None
[source]¶ A Float specifying the ambient temperature.
-
ambientTemperatureAmp : --is-rst--:py:class:`str` =
''
[source]¶ A String specifying the name of the Amplitude object that gives the variation of the ambient temperature with time.
- ambientTemperatureAmpState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶
A SymbolicConstant specifying the propagation state of the ambientTemperatureAmp member. Possible values are UNSET, SET, UNCHANGED, and FREED.
- ambientTemperatureState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶
A SymbolicConstant specifying the propagation state of the ambientTemperature member. Possible values are UNSET, SET, UNCHANGED, and FREED.
-
emissivity : --is-rst--:py:class:`float` | :py:obj:`None` =
None
[source]¶ A Float specifying the emissivity.
- emissivityState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶
A SymbolicConstant specifying the propagation state of the emissivity member. Possible values are UNSET, SET, UNCHANGED, and FREED.
-
nodalArea : --is-rst--:py:class:`float` | :py:obj:`None` =
None
[source]¶ A Float specifying the area associated with the node where the concentrated radiation is applied.
- nodalAreaState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶
A SymbolicConstant specifying the propagation state of the nodalArea member. Possible values are UNSET, SET, UNCHANGED, and FREED.
- status : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶
A SymbolicConstant specifying the propagation state of the InteractionState object. Possible values are:
NOT_YET_ACTIVE
CREATED
PROPAGATED
MODIFIED
DEACTIVATED
NO_LONGER_ACTIVE
TYPE_NOT_APPLICABLE
INSTANCE_NOT_APPLICABLE
BUILT_INTO_BASE_STATE
- class ContactControl[source]¶
Bases:
object
The ContactControl object is the abstract base type for other ContactControl objects. The ContactControl object has no explicit constructor, members, or methods.
Note
This object can be accessed by:
import interaction mdb.models[name].contactControls[name]
Note
Member Details:
- class ContactDamage(
- initTable,
- criterion=
MAX_STRESS
, - initTempDep=
0
, - initDependencies=
0
, - useEvolution=
0
, - evolutionType=
DISPLACEMENT
, - softening=
LINEAR
, - useMixedMode=
0
, - mixedModeType=
TABULAR
, - modeMixRatio=
ENERGY
, - exponent=
None
, - evolTempDep=
0
, - evolDependencies=
0
, - evolTable=
()
, - useStabilization=
0
, - viscosityCoef=
None
, Bases:
object
The ContactDamage object specifies damage options for a contact interaction property.
Note
This object can be accessed by:
import interaction mdb.models[name].interactionProperties[name].damage
The table data for this object are:
Table data for initTable:
If criterion = MAX_STRESS or QUAD_TRACTION, the table data specify the following:
Maximum nominal stress in the normal-only mode.
Maximum nominal stress in the first shear direction (for a mode that involves separation only in this direction).
Maximum nominal stress in the second shear direction (for a mode that involves separation only in this direction).
Temperature, if the data depend on temperature.
Value of the first field variable, if the data depend on field variables.
Value of the second field variable.
Etc.
If criterion = MAX_SEPARATION or QUAD_SEPARATION, the table data specify the following:
Separation at damage initiation in a normal-only mode.
Separation at damage initiation in a shear-only mode that involves separation only along the first shear direction.
Separation at damage initiation in a shear-only mode that involves separation only along the second shear direction.
Temperature, if the data depend on temperature.
Value of the first field variable, if the data depend on field variables.
Value of the second field variable.
Etc.
Table data for evolTable:
If evolutionType = DISPLACEMENT, softening = LINEAR, and useMixedMode = OFF, the table data specify the following:
Effective total or Plastic displacement at failure, measured from the time of damage initiation.
Temperature, if the data depend on temperature.
Value of the first field variable, if the data depend on field variables.
Value of the second field variable.
Etc.
If evolutionType = ENERGY, softening = LINEAR or EXPONENTIAL, and useMixedMode = OFF, the table data specify the following:
Fracture energy.
Temperature, if the data depend on temperature.
Value of the first field variable, if the data depend on field variables.
Value of the second field variable.
Etc.
If evolutionType = DISPLACEMENT, softening = LINEAR, useMixedMode = ON, mixedModeType = TABULAR, and modeMixRatio = ENERGY or TRACTION, the table data specify the following:
Total displacement at failure, measured from the time of damage initiation.
Appropriate mode mix ratio.
Appropriate mode mix ratio (if relevant, for three dimensional problems with anisotropic shear behavior).
Temperature, if the data depend on temperature.
Value of the first field variable, if the data depend on field variables.
Value of the second field variable.
Etc.
If evolutionType = ENERGY, softening = LINEAR or EXPONENTIAL, useMixedMode = ON, mixedModeType = TABULAR, and modeMixRatio = ENERGY or TRACTION, the table data specify the following:
Fracture energy.
Appropriate mode mix ratio.
Appropriate mode mix ratio (if relevant, for three dimensional problems with anisotropic shear behavior).
Temperature, if the data depend on temperature.
Value of the first field variable, if the data depend on field variables.
Value of the second field variable.
Etc.
If evolutionType = DISPLACEMENT, softening = EXPONENTIAL, and useMixedMode = OFF, the table data specify the following:
Effective total or Plastic displacement at failure, measured from the time of damage initiation.
Exponential law parameter.
Temperature, if the data depend on temperature.
Value of the first field variable, if the data depend on field variables.
Value of the second field variable.
Etc.
If evolutionType = DISPLACEMENT, softening = EXPONENTIAL, useMixedMode = ON, mixedModeType = TABULAR, and modeMixRatio = ENERGY or TRACTION, the table data specify the following:
Total displacement at failure, measured from the time of damage initiation.
Exponential law parameter.
Appropriate mode mix ratio.
Appropriate mode mix ratio (if relevant, for three dimensional problems with anisotropic shear behavior).
Temperature, if the data depend on temperature.
Value of the first field variable, if the data depend on field variables.
Value of the second field variable.
Etc.
If evolutionType = DISPLACEMENT, softening = TABULAR, and useMixedMode = OFF, the table data specify the following:
Damage variable.
Effective total or Plastic displacement at failure, measured from the time of damage initiation.
Temperature, if the data depend on temperature.
Value of the first field variable, if the data depend on field variables.
Value of the second field variable.
Etc.
If evolutionType = DISPLACEMENT, softening = TABULAR, useMixedMode = ON, mixedModeType = TABULAR, and modeMixRatio = ENERGY or TRACTION, the table data specify the following:
Damage variable.
Effective total displacement, measured from the time of damage initiation.
Appropriate mode mix ratio.
Appropriate mode mix ratio (if relevant, for three dimensional problems with anisotropic shear behavior).
Temperature, if the data depend on temperature.
Value of the first field variable, if the data depend on field variables.
Value of the second field variable.
Etc.
If evolutionType = ENERGY, softening = LINEAR or EXPONENTIAL, useMixedMode = ON, mixedModeType = POWER_LAW or BK, and modeMixRatio = ENERGY, the table data specify the following:
Normal mode fracture energy.
Shear mode fracture energy for failure in the first shear direction.
Shear mode fracture energy for failure in the second shear direction.
Temperature, if the data depend on temperature.
Value of the first field variable, if the data depend on field variables.
Value of the second field variable.
Etc.
The corresponding analysis keywords are:
DAMAGE INITIATION
DAMAGE EVOLUTION
DAMAGE STABILIZATION
Note
Member Details:
-
criterion : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` =
'MAX_STRESS'
[source]¶ A SymbolicConstant specifying the type of data used to define the initiation of damage. Possible values are MAX_STRESS, MAX_SEPARATION, QUAD_TRACTION, and QUAD_SEPARATION. The default value is MAX_STRESS.
-
evolDependencies : --is-rst--:py:class:`int` =
0
[source]¶ An Int specifying the number of evolution data field variables. This argument is valid only when useEvolution = ON. The default value is 0.
-
evolTable : --is-rst--:py:class:`tuple`\ \[:py:class:`tuple`\ \[:py:class:`float`, :py:data:`...<Ellipsis>`], :py:data:`...<Ellipsis>`] =
()
[source]¶ A tuple of tuples of Floats specifying the values defining the damage evolution. The items in the table data are described below. This argument is valid only when useEvolution = ON.
-
evolTempDep : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] =
0
[source]¶ A Boolean specifying whether the evolution data depend on temperature. This argument is valid only when useEvolution = ON. The default value is OFF.
-
evolutionType : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` =
'DISPLACEMENT'
[source]¶ A SymbolicConstant specifying the type of data used to define the evolution of damage. This argument is valid only when useEvolution = ON. Possible values are DISPLACEMENT and ENERGY. The default value is DISPLACEMENT.
-
exponent : --is-rst--:py:class:`float` | :py:obj:`None` =
None
[source]¶ None or a Float specifying the exponent in the power-law or BK criterion that defines the variation of fracture energy with mode mix. This argument is valid only when useEvolution = ON and when mixedModeType = POWER_LAW or BK. The default value is None.
-
initDependencies : --is-rst--:py:class:`int` =
0
[source]¶ An Int specifying the number of initiation data field variables. The default value is 0.
-
initTable : --is-rst--:py:class:`tuple`\ \[:py:class:`tuple`\ \[:py:class:`float`, :py:data:`...<Ellipsis>`], :py:data:`...<Ellipsis>`] =
()
[source]¶ A tuple of tuples of Floats specifying the values defining the damage initiation. The items in the table data are described below.
-
initTempDep : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] =
0
[source]¶ A Boolean specifying whether the initiation data depend on temperature. The default value is OFF.
-
mixedModeType : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` =
'TABULAR'
[source]¶ A SymbolicConstant specifying the mode mix fracture criterion. This argument is valid only when useEvolution = ON and when useMixedMode = ON. The POWER_LAW and BK values can be used only when evolutionType = ENERGY. Possible values are TABULAR, POWER_LAW, and BK. The default value is TABULAR.
-
modeMixRatio : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` =
'ENERGY'
[source]¶ A SymbolicConstant specifying the mode mix ratio type. This argument is valid only when useEvolution = ON and when useMixedMode = ON. The TRACTION value can be used only when mixedModeType = TABULAR. Possible values are ENERGY and TRACTION. The default value is ENERGY.
-
softening : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` =
'LINEAR'
[source]¶ A SymbolicConstant specifying the type of data used to define the evolution softening response. This argument is valid only when useEvolution = ON. The TABULAR value can be used only when evolutionType = DISPLACEMENT. Possible values are LINEAR, EXPONENTIAL, and TABULAR. The default value is LINEAR.
-
useEvolution : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] =
0
[source]¶ A Boolean specifying whether evolution data will be defined. The default value is OFF.
-
useMixedMode : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] =
0
[source]¶ A Boolean specifying whether evolution data be defined using dependent behavior modes. This argument is valid only when useEvolution = ON. The default value is OFF.
- class ContactDamping(
- definition=
DAMPING_COEFFICIENT
, - tangentFraction=
DEFAULT
, - clearanceDependence=
STEP
, - table=
()
, Bases:
object
The ContactDamping object specifies damping for a contact interaction property.
Note
This object can be accessed by:
import interaction mdb.models[name].interactionProperties[name].damping
The table data for this object are:
If definition = DAMPING_COEFFICIENT and clearanceDependence = STEP, the table data specify the following:
Damping coefficient.
If definition = DAMPING_COEFFICIENT and clearanceDependence = LINEAR or BILINEAR, the table data specify the following:
Damping coefficient.
Clearance.
Two pairs must be given for clearanceDependence = LINEAR and three pairs for clearanceDependence = BILINEAR. The first pair must have clearance = 0.0, and the last pair must have coefficient = 0.0.
If definition = CRITICAL_DAMPING_FRACTION, the table data specify the following:
Critical damping fraction.
The corresponding analysis keywords are:
CONTACT DAMPING
Note
Member Details:
-
clearanceDependence : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` =
'STEP'
[source]¶ A SymbolicConstant specifying the variation of the damping coefficient or fraction with respect to clearance. Possible values are STEP, LINEAR, and BILINEAR. The default value is STEP.If definition = CRITICAL_DAMPING_FRACTION, the only possible value is STEP.
-
definition : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` =
'DAMPING_COEFFICIENT'
[source]¶ A SymbolicConstant specifying the method used to define the damping. Possible values are DAMPING_COEFFICIENT and CRITICAL_DAMPING_FRACTION. The default value is DAMPING_COEFFICIENT.
-
table : --is-rst--:py:class:`float` | :py:obj:`None` =
None
[source]¶ A tuple of pairs of Floats specifying the damping properties. The items in the table data are described below.
-
tangentFraction : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`, :py:class:`float`] =
'DEFAULT'
[source]¶ The SymbolicConstant DEFAULT or a Float specifying the tangential damping coefficient divided by the normal damping coefficient. The default value is DEFAULT.
- class ContactExp(
- name: str,
- createStepName: str,
- useAllstar: AbaqusBoolean | bool =
OFF
, - globalSmoothing: AbaqusBoolean | bool =
ON
, - includedPairs: RegionPairs | None =
None
, - excludedPairs: RegionPairs | None =
None
, - contactPropertyAssignments: ContactPropertyAssignment | None =
None
, - surfaceThicknessAssignments: SurfaceThicknessAssignment | None =
None
, - surfaceOffsetAssignments: SurfaceOffsetAssignment | None =
None
, - surfaceFeatureAssignments: SurfaceFeatureAssignment | None =
None
, - smoothingAssignments: SmoothingAssignment | None =
None
, - surfaceCrushTriggerAssignments: SurfaceCrushTriggerAssignment =
SurfaceCrushTriggerAssignment()
, - surfaceFrictionAssignments: SurfaceFrictionAssignment =
SurfaceFrictionAssignment()
, - mainSecondaryAssignments: MainSecondaryAssignment | None =
None
, - polarityAssignments: PolarityAssignments =
PolarityAssignments()
, - class ContactExp(
- name: str,
- createStepName: str,
- globalSmoothing: AbaqusBoolean | bool =
ON
, - surfaceCrushTriggerAssignments: SurfaceCrushTriggerAssignment =
SurfaceCrushTriggerAssignment()
, - surfaceFrictionAssignments: SurfaceFrictionAssignment =
SurfaceFrictionAssignment()
, - useAllstar: AbaqusBoolean | bool =
OFF
, - includedPairs: SymbolicConstant | None =
None
, - excludedPairs: SymbolicConstant | None =
None
, - contactPropertyAssignments: SymbolicConstant | None =
None
, - surfaceThicknessAssignments: SymbolicConstant | float =
ORIGINAL
, - surfaceOffsetAssignments: SymbolicConstant | float =
GLOBAL
, - surfaceFeatureAssignments: SymbolicConstant | float =
PERIMETER
, - smoothingAssignments: SymbolicConstant | None =
None
, - mainSecondaryAssignments: SymbolicConstant | None =
None
, - polarityAssignments: SymbolicConstant | None =
None
, Bases:
Interaction
The ContactExp object defines the contact domain and associated properties during contact in an Abaqus/Explicit analysis. The ContactExp object is derived from the Interaction object.
Note
This object can be accessed by:
import interaction mdb.models[name].interactions[name]
The corresponding analysis keywords are:
CONTACT
Note
Member Details:
-
contactPropertyAssignments : --is-rst--:py:class:`~abaqus.Interaction.ContactPropertyAssignment.ContactPropertyAssignment` =
<abaqus.Interaction.ContactPropertyAssignment.ContactPropertyAssignment object>
[source]¶ A ContactPropertyAssignment object specifying the contact property assignments in the contact domain.
-
excludedPairs : --is-rst--:py:class:`~abaqus.Interaction.RegionPairs.RegionPairs` =
<abaqus.Interaction.RegionPairs.RegionPairs object>
[source]¶ A RegionPairs object specifying the domain pairs excluded from contact.
-
globalSmoothing : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] =
1
[source]¶ A Boolean specifying whether surface smoothing (geometric correction) is automatically applied to all eligible surfaces. The default value is ON.
-
includedPairs : --is-rst--:py:class:`~abaqus.Interaction.RegionPairs.RegionPairs` =
<abaqus.Interaction.RegionPairs.RegionPairs object>
[source]¶ A RegionPairs object specifying the domain pairs included in contact.
-
mainSecondaryAssignments : --is-rst--:py:class:`~abaqus.Interaction.MainSecondaryAssignment.MainSecondaryAssignment` =
<abaqus.Interaction.MainSecondaryAssignment.MainSecondaryAssignment object>
[source]¶ A MainSecondaryAssignment object specifying the main-secondary assignments in the contact domain.
Changed in version 2022: The attribute
masterSlaveAssignments
was renamed tomainSecondaryAssignments
.
-
polarityAssignments : --is-rst--:py:class:`~abaqus.Interaction.PolarityAssignments.PolarityAssignments` =
<abaqus.Interaction.PolarityAssignments.PolarityAssignments object>
[source]¶ A PolarityAssignments object specifying the polarity assignments in the contact domain.
Added in version 2020: The
polarityAssignments
attribute was added.
-
smoothingAssignments : --is-rst--:py:class:`~abaqus.Interaction.SmoothingAssignment.SmoothingAssignment` =
<abaqus.Interaction.SmoothingAssignment.SmoothingAssignment object>
[source]¶ A SmoothingAssignment object specifying the surface smoothing assignments in the contact domain.
-
surfaceFeatureAssignments : --is-rst--:py:class:`~abaqus.Interaction.SurfaceFeatureAssignment.SurfaceFeatureAssignment` =
<abaqus.Interaction.SurfaceFeatureAssignment.SurfaceFeatureAssignment object>
[source]¶ A SurfaceFeatureAssignment object specifying the surface feature angle assignments in the contact domain.
-
surfaceOffsetAssignments : --is-rst--:py:class:`~abaqus.Interaction.SurfaceOffsetAssignment.SurfaceOffsetAssignment` =
<abaqus.Interaction.SurfaceOffsetAssignment.SurfaceOffsetAssignment object>
[source]¶ A SurfaceOffsetAssignment object specifying the surface offset fraction assignments in the contact domain.
-
surfaceThicknessAssignments : --is-rst--:py:class:`~abaqus.Interaction.SurfaceThicknessAssignment.SurfaceThicknessAssignment` =
<abaqus.Interaction.SurfaceThicknessAssignment.SurfaceThicknessAssignment object>
[source]¶ A SurfaceThicknessAssignment object specifying the surface thickness assignments in the contact domain.
- class ContactPropertyAssignment[source]¶
Bases:
object
The ContactPropertyAssignment object stores the contact property assignment definition for domain pairs in ContactExp and ContactStd objects. The ContactPropertyAssignment object has no constructor or members.
Note
This object can be accessed by:
import interaction mdb.models[name].interactions[name].contactPropertyAssignments
The corresponding analysis keywords are:
CONTACT PROPERTY ASSIGNMENT
Note
Member Details:
- appendInStep(stepName, assignments)[source]¶
This method allows addition of contact property assignments to new domain pairs in a given step.
- Parameters:¶
- stepName¶
A String specifying the name of the step in which new contact property assignments are to be defined.
- assignments¶
A sequence of tuples specifying the properties assigned to each surface pair. Each tuple contains three entries:
A region or a material object or the SymbolicConstant GLOBAL.
A region or a material object or the SymbolicConstant SELF. When used with a ContactExp object, this parameter can also be a string that references an Eulerian material surface.
A String specifying a ContactProperty object associated with this pair of regions.
Changed in version 2021: Update descriptions of the three entries in the tuple.
- changeValuesInStep(stepName, index, value)[source]¶
This method allows modification of contact property assignments to domain pairs already defined in a given step.
- Parameters:¶
- stepName¶
A String specifying the name of the step in which the contact property assignments are to be modified.
- index¶
An Int specifying the position of the contact property assignment whose value is to be modified.
- value¶
A String specifying the value of the contact property to be assigned to the domain pair whose index is referenced.
- delete(indices, surfPair)[source]¶
The delete method allows you to delete existing contact property assignments.
- Parameters:¶
- indices¶
A sequence of Ints specifying the index of each contact property assignment to delete. The indices and surfPair arguments are mutually exclusive.
- surfPair¶
A sequence of tuples specifying the surface pair of each contact property assignment to delete. Each tuple contains two entries:
A region or a material object or the SymbolicConstant GLOBAL.
A region or a material object or the SymbolicConstant SELF. When used with a ContactExp object, this parameter can also be a string that references an Eulerian material surface.
surfPair and indices arguments are mutually exclusive.
Changed in version 2021: Update descriptions of the two entries in the tuple.
- class MainSecondaryAssignment[source]¶
Bases:
object
The MainSecondaryAssignment object stores the main-secondary assignment definition for surfaces in ContactExp and ContactStd objects. The MainSecondaryAssignment object has no constructor or members.
Note
This object can be accessed by:
import interaction mdb.models[name].interactions[name].mainSecondaryAssignments
The corresponding analysis keywords are:
CONTACT FORMULATION
Changed in version 2022: The MasterSlaveAssignment class was renamed to MainSecondaryAssignment.
Note
Member Details:
- appendInStep(stepName, assignments)[source]¶
This method allows addition of main-secondary assignments to new surface pairs in a given step.
- Parameters:¶
- stepName¶
A String specifying the name of the step in which the main-secondary assignments are to be defined.
- assignments¶
A sequence of tuples specifying the main-secondary assignments. Each tuple contains two entries:
A region object or the SymbolicConstant GLOBAL specifying the surface to which the main-secondary attribute is assigned.
A SymbolicConstant specifying the overriding main-secondary value to be used for the first surface. Possible values of the SymbolicConstant are MAIN, SECONDARY, and BALANCED. The SymbolicConstant BALANCED can be specified only in an Abaqus/Standard analysis.
- changeValuesInStep(stepName, index, value)[source]¶
This method allows modification of main-secondary assignments already defined on surface pairs in a given step.
- Parameters:¶
- stepName¶
A String specifying the name of the step in which the main-secondary assignments are to be modified.
- index¶
An Int specifying the position of the main-secondary assignment whose value is to be modified.
- value¶
A SymbolicConstant specifying the value of the main-secondary role to be assigned to the surface whose index is referenced. Possible values are MAIN, SECONDARY, and BALANCED. The SymbolicConstant BALANCED can be specified only in an Abaqus/Standard analysis.
- class PolarityAssignments[source]¶
Bases:
object
The PolarityAssignments object stores the polarity assignment definition for surfaces in ContactExp objects. The PolarityAssignments object has no constructor or members.
Note
This object can be accessed by:
import interaction mdb.models[name].interactions[name].polarityAssignments
The corresponding analysis keywords are:
CONTACT FORMULATION
Note
Member Details:
- appendInStep(stepName, assignments)[source]¶
This method allows you to add polarity assignments to new surface pairs in a given step.
- Parameters:¶
- stepName¶
A String specifying the name of the step in which the polarity assignments are to be defined.
- assignments¶
A sequence of tuples specifying the polarity assignments. Each tuple contains two entries:
A region object or the SymbolicConstant GLOBAL specifying the surface to which the polarity attribute is assigned.
A SymbolicConstant specifying the overriding polarity value to be used for the first surface. Possible values of the SymbolicConstant are SPOS, SNEG, and TWO_SIDED.
- changeValuesInStep(stepName, index, value)[source]¶
This method allows you to modify polarity assignments already defined on surface pairs in a given step.
- Parameters:¶
- stepName¶
A String specifying the name of the step in which the main-secondary assignments are to be modified.
Changed in version 2022: Master-slave was changed to main-secondary.
- index¶
An Int specifying the position of the polarity assignment whose value is to be modified.
- value¶
A SymbolicConstant specifying the value of the polarity to be assigned to the surface whose index is referenced. Possible values are SPOS, SNEG, and TWO_SIDED.
- class RegionPairs[source]¶
Bases:
object
The RegionPairs object stores the domain pair definition for ContactExp and ContactStd objects. The RegionPairs object has no constructor or members.
Note
This object can be accessed by:
import interaction mdb.models[name].interactions[name].excludedPairs mdb.models[name].interactions[name].includedPairs
The corresponding analysis keywords are:
CONTACT INCLUSIONS
CONTACT EXCLUSIONS
Note
Member Details:
-
setValuesInStep(stepName, useAllstar=
0
, addPairs=None
, removePairs=None
)[source]¶ This method allows addition and removal of domain pairs in a given step.
Note
- Parameters:¶
- stepName¶
A String specifying the name of the step in which the region pair assignments are to be modified.
- useAllstar=
0
¶ A Boolean specifying whether the contacting surface pair consists of all exterior faces and – in an Abaqus/Explicit analysis – analytical rigid surfaces, shell edges, and beam segments in the model.
- addPairs=
None
¶ A sequence of pairs of region objects or SymbolicConstants that specify the surface pairs to add to the included pairs of the ContactExp or ContactStd object in the given step. Possible values of the SymbolicConstants are GLOBAL and SELF. When used with a ContactExp object, the second parameter of each pair can also be a string that references an Eulerian material surface.
- removePairs=
None
¶ A sequence of pairs of region objects or SymbolicConstants that specify the surface pairs to remove from the included pairs of the ContactExp or ContactStd object in the given step. Possible values of the SymbolicConstants are GLOBAL and SELF. When used with a ContactExp object, the second parameter of each pair can also be a string that references an Eulerian material surface.
- class SmoothingAssignment[source]¶
Bases:
object
The SmoothingAssignment object stores the surface smoothing assignment definition for surfaces in ContactExp and ContactStd objects. The SmoothingAssignment object has no constructor or members.
Note
This object can be accessed by:
import interaction mdb.models[name].interactions[name].smoothingAssignments
The corresponding analysis keywords are:
SURFACE PROPERTY ASSIGNMENT
Note
Member Details:
- appendInStep(stepName, assignments)[source]¶
This method allows addition of surface smoothing assignments to new surfaces in a given step.
- Parameters:¶
- stepName¶
A String specifying the name of the step in which new surface smoothing assignments are to be defined.
- assignments¶
A sequence of tuples specifying the surface smoothing assignments. Each tuple contains two entries:
A region object specifying the surface to which the smoothing is assigned.
A SymbolicConstant specifying the surface smoothing value to be used for the surface. Possible values of the SymbolicConstant are NONE, REVOLUTION, SPHERICAL, and TOROIDAL.
- changeValuesInStep(stepName, index, value)[source]¶
This method allows modification of surface smoothing assignments already defined on surfaces in a given step.
- Parameters:¶
- stepName¶
A String specifying the name of the step in which the surface smoothing assignments are to be modified.
- index¶
An Int specifying the position of the surface smoothing assignment whose value is to be modified.
- value¶
A tuple specifying the value of the surface smoothing assignments for the surface whose index is referenced. Each tuple contains one entry:A SymbolicConstant specifying the surface smoothing value to be used for the surface. Possible values of the SymbolicConstant are NONE, REVOLUTION, SPHERICAL, and TOROIDAL.
- class SurfaceCrushTriggerAssignment[source]¶
Bases:
object
The SurfaceCrushTriggerAssignment object stores the surface crush trigger assignment definition for surfaces in ContactExp objects. The SurfaceCrushTriggerAssignment object has no constructor or members.
Note
This object can be accessed by:
import interaction mdb.models[name].interactions[name].surfaceCrushTriggerAssignments
The corresponding analysis keywords are:
SURFACE PROPERTY ASSIGNMENT
Added in version 2021: The
SurfaceCrushTriggerAssignment
class was added.Member Details:
- appendInStep(stepName, assignments)[source]¶
This method allows addition of surface crush trigger assignments to new surfaces in a given step.
- Parameters:¶
- stepName¶
A String specifying the name of the step in which new surface crush trigger assignments are to be defined.
- assignments¶
A sequence of tuples specifying the surface crush trigger assignments. Each tuple contains four entries:
A region or a material object or the SymbolicConstant GLOBAL specifying the surface to which the feature angle is assigned.
A SymbolicConstant specifying the trigger option to be used for the surface. Possible values of the SymbolicConstant are TRIGGER, NO_TRIGGER, or NO_CRUSH.
A Float specifying the crush stress value to be used for the surface.
A Float specifying the crush initiation angle value to be used for the surface.
A Float specifying the crush continuation angle value to be used for the surface.
- changeValuesInStep(stepName, index, value)[source]¶
This method allows modification of surface crush trigger assignments already defined on surfaces in a given step.
- Parameters:¶
- stepName¶
A String specifying the name of the step in which the surface crush trigger assignments are to be modified.
- index¶
An Int specifying the position of the surface crush trigger assignment whose value is to be modified.
- value¶
A tuple specifying the value of the surface crush trigger assignments for the surface whose index is referenced. Each tuple contains three entries: - A SymbolicConstant specifying the trigger option to be used for the surface. Possible values of the SymbolicConstant are TRIGGER, NO_TRIGGER, or NO_CRUSH. - A Float specifying the crush stress value to be used for the surface. - A Float specifying the crush initiation angle value to be used for the surface. - A Float specifying the crush continuation angle value to be used for the surface.
- class SurfaceFeatureAssignment[source]¶
Bases:
object
The SurfaceFeatureAssignment object stores the surface feature angle assignment definition for surfaces in ContactExp or ContactStd objects. The SurfaceFeatureAssignment object has no constructor or members.
Note
This object can be accessed by:
import interaction mdb.models[name].interactions[name].surfaceFeatureAssignments
The corresponding analysis keywords are:
SURFACE PROPERTY ASSIGNMENT
Note
Member Details:
-
appendInStep(stepName, assignments, useDynFeatEdge=
1
)[source]¶ This method allows addition of surface feature angle assignments to new surfaces in a given step.
- Parameters:¶
- stepName¶
A String specifying the name of the step in which new surface feature angle assignments are to be defined.
- assignments¶
A sequence of tuples specifying the surface feature angle assignments. Each tuple contains three entries for Abaqus/Standard and four entries for Abaqus/Explicit:
A region or a material object or the SymbolicConstant GLOBAL specifying the surface to which the feature angle is assigned.
A Float or a SymbolicConstant specifying the overriding surface primary feature angle value to be used for the surface. Possible values of the SymbolicConstant are PERIMETER, ALL, PICKED, or NONE. The ALL and PICKED values cannot be specified with the GLOBAL region constant and can be used only in the Abaqus/Explicit version of general contact.
A Float or a SymbolicConstant specifying the overriding surface slave feature angle value to be used for the surface. Possible values of the SymbolicConstant are PERIMETER, ALL, PICKED, or NONE. The ALL and PICKED values cannot be specified with the GLOBAL region constant and can be used only in the Abaqus/Explicit version of general contact.
A SymbolicConstant ORIGINAL or CURRENT specifying the configuration.
- useDynFeatEdge=
1
¶ A Boolean specifying whether the dynamic feature edge criterion should be activated for the contact surface in an Abaqus/Explicit analysis. This argument can be set to ON (default) or OFF.
Added in version 2023: The
useDynFeatEdge
argument was added.
-
changeValuesInStep(stepName, index, value, useDynFeatEdge=
1
)[source]¶ This method allows modification of surface feature angle assignments already defined on surfaces in a given step.
- Parameters:¶
- stepName¶
A String specifying the name of the step in which the surface feature assignments are to be modified.
- index¶
An Int specifying the position of the surface feature angle assignment whose value is to be modified.
- value¶
A tuple specifying the value of the surface feature assignments for the surface whose index is referenced. Each tuple contains two entries for Abaqus/Standard and three entries for Abaqus/Explicit:
A Float or a SymbolicConstant specifying the overriding surface primary feature angle value to be used for the surface. Possible values of the SymbolicConstant are PERIMETER, ALL, PICKED, or NONE. The ALL and PICKED values cannot be specified with the GLOBAL region constant and can be used only in the Abaqus/Explicit version of general contact.
A Float or a SymbolicConstant specifying the overriding surface secondary feature angle value to be used for the surface. Possible values of the SymbolicConstant are PERIMETER, ALL, PICKED, or NONE. The ALL and PICKED values cannot be specified with the GLOBAL region constant and can be used only in the Abaqus/Explicit version of general contact.
A SymbolicConstant ORIGINAL or CURRENT specifying the configuration.
- useDynFeatEdge=
1
¶ A Boolean specifying whether the dynamic feature edge criterion should be activated for the contact surface in an Abaqus/Explicit analysis. This argument can be set to ON (default) or OFF.
Added in version 2023: The
useDynFeatEdge
argument was added.
- class SurfaceFrictionAssignment[source]¶
Bases:
object
The SurfaceFrictionAssignment object stores the surface friction assignment definition for surfaces in ContactExp objects. The SurfaceFrictionAssignment object has no constructor or members.
Note
This object can be accessed by:
import interaction mdb.models[name].interactions[name].surfaceFrictionAssignments
The corresponding analysis keywords are:
SURFACE PROPERTY ASSIGNMENT
Added in version 2021: The
SurfaceFrictionAssignment
class was added.Note
Member Details:
- appendInStep(stepName, assignments)[source]¶
This method allows addition of surface friction assignments to new surfaces in a given step.
- Parameters:¶
- stepName¶
A String specifying the name of the step in which new surface friction assignments are to be defined.
- assignments¶
A sequence of tuples specifying the surface friction assignments. Each tuple contains two entries:
A region or a material object or the SymbolicConstant GLOBAL specifying the surface to which the friction coefficient is assigned.
A Float specifying the overriding friction coefficient to be used in the contact definition.
- changeValuesInStep(stepName, index, value)[source]¶
This method allows modification of surface friction assignments already defined on surfaces in a given step.
- Parameters:¶
- stepName¶
A String specifying the name of the step in which the surface friction assignments are to be modified.
- index¶
An Int specifying the position of the surface friction assignment whose value is to be modified.
- value¶
A tuple specifying the value of the surface friction assignments for the surface whose index is referenced. Each tuple contains: - A Float specifying the overriding friction coefficient value to be used in the contact definition.
- class SurfaceOffsetAssignment[source]¶
Bases:
object
The SurfaceOffsetAssignment object stores the surface offset fraction assignment definition for surfaces in ContactExp and ContactStd objects. The SurfaceOffsetAssignment object has no constructor or members.
Note
This object can be accessed by:
import interaction mdb.models[name].interactions[name].surfaceOffsetAssignments
The corresponding analysis keywords are:
SURFACE PROPERTY ASSIGNMENT
Note
Member Details:
- appendInStep(stepName, assignments)[source]¶
This method allows addition of surface offset fraction assignments to new surfaces in a given step.
- Parameters:¶
- stepName¶
A String specifying the name of the step in which new surface offset fraction assignments are to be defined.
- assignments¶
A sequence of tuples specifying the surface offset fraction assignments. Each tuple contains two entries:
A region or a material object or the SymbolicConstant GLOBAL specifying the surface to which the offset fraction is assigned.
A Float or a SymbolicConstant specifying the surface offset fraction value to be used for the surface. Possible values of the SymbolicConstant are ORIGINAL, SPOS, and SNEG.
Changed in version 2021: The first entry in the tuple can be a material object now.
- changeValuesInStep(stepName, index, value)[source]¶
This method allows modification of surface offset fraction assignments already defined on surfaces in a given step.
- Parameters:¶
- stepName¶
A String specifying the name of the step in which the surface offset assignments are to be modified.
- index¶
An Int specifying the position of the surface offset fraction assignment whose value is to be modified.
- value¶
A tuple specifying the value of the surface offset assignments for the surface whose index is referenced. Each tuple contains one entry:
A Float or a SymbolicConstant specifying the surface offset fraction value to be used for the surface. Possible values of the SymbolicConstant are ORIGINAL, SPOS, and SNEG.
- class SurfaceThicknessAssignment[source]¶
Bases:
object
The SurfaceThicknessAssignment object stores the surface thickness assignment definition for surfaces in ContactExp and ContactStd objects. The SurfaceThicknessAssignment object has no constructor or members.
Note
This object can be accessed by:
import interaction mdb.models[name].interactions[name].surfaceThicknessAssignments
The corresponding analysis keywords are:
SURFACE PROPERTY ASSIGNMENT
Note
Member Details:
- appendInStep(stepName, assignments)[source]¶
This method allows addition of surface thickness assignments to new surfaces in a given step.
- Parameters:¶
- stepName¶
A String specifying the name of the step in which new surface thickness assignments are to be defined.
- assignments¶
A sequence of tuples specifying the surface thickness assignments. Each tuple contains three entries:
A region or a material object or the SymbolicConstant GLOBAL specifying the surface to which the thickness is assigned.
A Float or a SymbolicConstant specifying the overriding thickness value to be used in the contact definition. Possible values of the SymbolicConstant are ORIGINAL and THINNING. The SymbolicConstant THINNING can be specified only in an Abaqus/Explicit analysis.
A Float specifying a scale factor that multiplies the thickness value specified in the second entry.
Changed in version 2021: The first entry in the tuple can be a material object now.
- changeValuesInStep(stepName, index, value)[source]¶
This method allows modification of surface thickness assignments already defined on surfaces in a given step.
- Parameters:¶
- stepName¶
A String specifying the name of the step in which the surface thickness assignments are to be modified.
- index¶
An Int specifying the position of the surface thickness assignment whose value is to be modified.
- value¶
A tuple specifying the value of the surface thickness assignments for the surface whose index is referenced. Each tuple contains two entries:
A Float or a SymbolicConstant specifying the overriding thickness value to be used in the contact definition. Possible values of the SymbolicConstant are ORIGINAL and THINNING. The SymbolicConstant THINNING can be specified only in an Abaqus/Explicit analysis.
A Float specifying a scale factor that multiplies the thickness value specified in the second entry.
- class ContactInitialization[source]¶
Bases:
object
The ContactInitialization object is the abstract base type for other ContactInitialization objects. The ContactInitialization object has no explicit constructor, members, or methods.
Note
This object can be accessed by:
import interaction mdb.models[name].contactInitializations[name]
Note
Member Details:
- class ContactTangentialBehavior(
- formulation=
FRICTIONLESS
, - directionality=
ISOTROPIC
, - slipRateDependency=
0
, - pressureDependency=
0
, - temperatureDependency=
0
, - dependencies=
0
, - exponentialDecayDefinition=
COEFFICIENTS
, - table=
()
, - shearStressLimit=
None
, - maximumElasticSlip=
FRACTION
, - fraction=
0
, - absoluteDistance=
0
, - elasticSlipStiffness=
None
, - nStateDependentVars=
0
, - useProperties=
0
, Bases:
object
The ContactTangentialBehavior object specifies tangential behavior for a contact interaction property.
Note
This object can be accessed by:
import interaction mdb.models[name].interactionProperties[name].tangentialBehavior
The table data for this object are:
If formulation = PENALTY or LAGRANGE, the table data specify the following:
Friction coefficient in the first slip direction, μ1μ1.
Friction coefficient in the second slip direction, μ2μ2 (if directionality = ANISOTROPIC).
Slip rate, if the data depend on slip rate.
Contact pressure, if the data depend on contact pressure.
Temperature, if the data depend on temperature.
Value of the first field variable, if the data depend on field variables.
Value of the second field variable.
Etc.
If formulation = EXPONENTIAL_DECAY and exponentialDecayDefinition = COEFFICIENTS, the table data specify the following:
Static friction coefficient.
Kinetic friction coefficient.
Decay coefficient.
If formulation = EXPONENTIAL_DECAY and exponentialDecayDefinition = TEST_DATA, the table data specify the following:
Friction coefficient.
Slip rate.
If formulation = USER_DEFINED, the table data specify the following:
Friction property.
The corresponding analysis keywords are:
FRICTION
CHANGE FRICTION
Note
Member Details:
-
absoluteDistance : --is-rst--:py:class:`float` =
0
[source]¶ A Float specifying the absolute distance. The default value is 0.0.
-
dependencies : --is-rst--:py:class:`int` =
0
[source]¶ An Int specifying the number of field variables. The default value is 0.
-
directionality : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` =
'ISOTROPIC'
[source]¶ A SymbolicConstant specifying the directionality of the friction. Possible values are ISOTROPIC and ANISOTROPIC. The default value is ISOTROPIC.
-
elasticSlipStiffness : --is-rst--:py:class:`float` | :py:obj:`None` =
None
[source]¶ None or a Float specifying the elastic slip stiffness. If elasticSlipStiffness = None, there is no upper limit. The default value is None.
-
exponentialDecayDefinition : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` =
'COEFFICIENTS'
[source]¶ A SymbolicConstant specifying the exponential decay definition. Possible values are COEFFICIENTS and TEST_DATA. The default value is COEFFICIENTS.
-
formulation : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` =
'FRICTIONLESS'
[source]¶ A SymbolicConstant specifying the friction formulation. Possible values are FRICTIONLESS, PENALTY, EXPONENTIAL_DECAY, ROUGH, LAGRANGE, and USER_DEFINED. The default value is FRICTIONLESS.
-
fraction : --is-rst--:py:class:`float` =
0
[source]¶ A Float specifying the fraction of a characteristic surface dimension. The default value is 0.0.
-
maximumElasticSlip : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` =
'FRACTION'
[source]¶ A SymbolicConstant specifying what the maximum elastic slip will be. Possible values are FRACTION and ABSOLUTE_DISTANCE. The default value is FRACTION.
-
nStateDependentVars : --is-rst--:py:class:`int` =
0
[source]¶ An Int specifying the number of state-dependent variables. The default value is 0.
-
pressureDependency : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] =
0
[source]¶ A Boolean specifying whether the data depend on contact pressure. The default value is OFF.
-
shearStressLimit : --is-rst--:py:class:`float` | :py:obj:`None` =
None
[source]¶ None or a Float specifying the shear stress limit. If shearStressLimit = None, there is no upper limit. The default value is None.
-
slipRateDependency : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] =
0
[source]¶ A Boolean specifying whether the data depend on slip rate. The default value is OFF.
-
table : --is-rst--:py:class:`tuple`\ \[:py:class:`tuple`\ \[:py:class:`float`, :py:data:`...<Ellipsis>`], :py:data:`...<Ellipsis>`] =
()
[source]¶ A tuple of tuples of Floats specifying tangential behavior. The items in the table data are described below.
- class FractureCriterion(
- initTable,
- type=
VCCT
, - mixedModeBehavior=
BK
, - temperatureDependency=
0
, - dependencies=
0
, - tolerance=
0
, - specifyUnstableCrackProp=
0
, - unstableTolerance=
DEFAULT
, Bases:
object
The FractureCriterion object specifies fractureCriterion options for a contact interaction property.
Note
This object can be accessed by:
import interaction mdb.models[name].interactionProperties[name].fractureCriterion
The table data for this object are:
Table data for initTable:
If type = VCCT for mixedModeBehavior = BK or REEDER, the table data specify the following:
Mode I critical energy release rate, \(G_{I C}\).
Mode II critical energy release rate, \(G_{I I C}\).
Mode III critical energy release rate, \(G_{I I I C}\).
Exponent, \(\eta\).
Temperature, if the data depend on temperature.
Value of the first field variable, if the data depend on field variables.
Value of the second field variable.
Etc.
If type = VCCT for mixedModeBehavior = POWER, the table data specify the following:
Mode I critical energy release rate, \(G_{I C}\).
Mode II critical energy release rate, \(G_{I I C}\).
Mode III critical energy release rate, \(G_{I I I C}\).
Exponent, \(am\).
Exponent, \(an\).
Exponent, \(ao\).
Value of the first field variable, if the data depend on field variables.
Value of the second field variable.
Etc.
If type = ENHANCED VCCT for mixedModeBehavior = BK or REEDER, the table data specify the following:
Mode I critical energy release rate for onset crack, \(G_{I C}\).
Mode II critical energy release rate for onset crack, \(G_{I I C}\).
Mode III critical energy release rate for onset crack, \(G_{I I I C}\).
Mode I critical energy release rate for crack propagation, \(G_{I C}\).
Mode II critical energy release rate for crack propagation, \(G_{I I C}\).
Mode III critical energy release rate for crack propagation, \(G_{I I I C}\).
Exponent, \(\eta\)
Temperature, if the data depend on temperature.
Value of the first field variable, if the data depend on field variables.
Value of the second field variable.
Etc.
If type = ENHANCED VCCT for mixedModeBehavior = POWER, the table data specify the following:
Mode I critical energy release rate for onset crack, \(G_{I C}\).
Mode II critical energy release rate for onset crack, \(G_{I I C}\).
Mode III critical energy release rate for onset crack, \(G_{I I I C}\).
Mode I critical energy release rate for crack propagation, \(G_{I C}\).
Mode II critical energy release rate for crack propagation, \(G_{I I C}\).
Mode III critical energy release rate for crack propagation, \(G_{I I I C}\).
Exponent, \(am\).
Exponent, \(an\).
Exponent, \(ao\).
Value of the first field variable, if the data depend on field variables.
Value of the second field variable.
Etc.
The corresponding analysis keywords are:
FRACTURE CRITERION
Note
Member Details:
-
dependencies : --is-rst--:py:class:`int` =
0
[source]¶ An Int specifying the number of fracture criterion data field variables. The default value is 0.
-
initTable : --is-rst--:py:class:`tuple`\ \[:py:class:`tuple`\ \[:py:class:`float`, :py:data:`...<Ellipsis>`], :py:data:`...<Ellipsis>`] =
()
[source]¶ A sequence of sequences of Floats specifying the value defining the fracture criterion. The items in the table data are described below.
-
mixedModeBehavior : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` =
'BK'
[source]¶ A SymbolicConstant specifying the mixed mode behavior type used to define fracture criterion. Possible values are BK, POWER, and REEDER. The default value is BK.
-
specifyUnstableCrackProp : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`, :py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] =
0
[source]¶ A SymbolicConstant specifying whether to include unstable crack growth tolerance in fracture criterion. Possible values are ON and OFF. The default value is OFF.
-
temperatureDependency : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] =
0
[source]¶ A Boolean specifying whether the fracture criterion data depend on temperature. The default value is OFF.
-
tolerance : --is-rst--:py:class:`float` =
0
[source]¶ A Float specifying the tolerance for VCCTEnhanced VCCT type. The default value is 0.2.
-
type : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` =
'VCCT'
[source]¶ A SymbolicConstant specifying the type of data used to define the fracture criterion. Possible values are VCCT and ENHANCED VCCT. The default value is VCCT.
-
unstableTolerance : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`, :py:class:`float`] =
'DEFAULT'
[source]¶ The SymbolicConstant DEFAULT or a Float specifying the tolerance for unstable crack propagation. This parameter specified only if specifyUnstableCrackProp = ON. The default value is DEFAULT.
- class GapElectricalConductance(
- definition=
TABULAR
, - clearanceDependency=
1
, - pressureDependency=
0
, - temperatureDependencyC=
0
, - dependenciesC=
0
, - clearanceDepTable=
()
, - temperatureDependencyP=
0
, - dependenciesP=
0
, - pressureDepTable=
()
, Bases:
object
The GapElectricalConductance object specifies electrical conductance for a contact interaction property.
Note
This object can be accessed by:
import interaction mdb.models[name].interactionProperties[name].electricalConductance
The table data for this object are:
The clearanceDepTable data specify the following:
Conductivity.
Clearance.
Temperature, if the data depend on temperature.
Value of the first field variable, if the data depend on field variables.
Value of the second field variable.
Etc.
The pressureDepTable data specify the following:
Conductivity.
Pressure.
Temperature, if the data depend on temperature.
Value of the first field variable, if the data depend on field variables.
Value of the second field variable.
Etc.
The corresponding analysis keywords are:
GAP ELECTRICAL CONDUCTANCE
Note
Member Details:
-
clearanceDepTable : --is-rst--:py:class:`tuple`\ \[:py:class:`tuple`\ \[:py:class:`float`, :py:data:`...<Ellipsis>`], :py:data:`...<Ellipsis>`] =
()
[source]¶ A sequence of sequences of Floats specifying clearance dependency data. The items in the table data are described below.
-
clearanceDependency : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] =
1
[source]¶ A Boolean specifying whether to use clearance-dependent data. The default value is ON.
-
definition : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` =
'TABULAR'
[source]¶ A SymbolicConstant specifying how the electrical conductance is defined. Possible values are TABULAR and USER_DEFINED. The default value is TABULAR.
-
dependenciesC : --is-rst--:py:class:`int` =
0
[source]¶ An Int specifying the number of field variables to use with clearance dependency. The default value is 0.
-
dependenciesP : --is-rst--:py:class:`int` =
0
[source]¶ An Int specifying the number of field variables to use with pressure dependency. The default value is 0.
-
pressureDepTable : --is-rst--:py:class:`tuple`\ \[:py:class:`tuple`\ \[:py:class:`float`, :py:data:`...<Ellipsis>`], :py:data:`...<Ellipsis>`] =
()
[source]¶ A sequence of sequences of Floats specifying pressure dependency data. The items in the table data are described below.
-
pressureDependency : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] =
0
[source]¶ A Boolean specifying whether to use pressure-dependent data. The default value is OFF.
-
class GapHeatGeneration(conversionFraction=
1
, secondaryFraction=0
)[source]¶ Bases:
object
The GapHeatGeneration object specifies heat generation for a contact interaction property.
Note
This object can be accessed by:
import interaction mdb.models[name].interactionProperties[name].heatGeneration
The corresponding analysis keywords are:
GAP HEAT GENERATION
Note
Member Details:
-
conversionFraction : --is-rst--:py:class:`float` =
1
[source]¶ A Float specifying the fraction of dissipated energy caused by friction or electric currents that is converted to heat. The default value is 1.0.
- class GeometricProperties(
- contactArea=
1
, - padThickness=
None
, - trackingThickness=
None
, - dependentVariables=
0
, - numProperties=
0
, - useUnsymmetricEqunProcedure=
0
, - modelType=
None
, Bases:
object
The GeometricProperties object specifies surface interaction properties.
Note
This object can be accessed by:
import interaction mdb.models[name].interactionProperties[name].geometricProperties
The corresponding analysis keywords are:
SURFACE INTERACTION
Note
Member Details:
-
contactArea : --is-rst--:py:class:`float` =
1
[source]¶ A Float specifying the out-of-plane thickness of the surface for a two-dimensional model or cross-sectional area for every node in the node-based surface. The default value is 1.0.
-
dependentVariables : --is-rst--:py:class:`int` =
0
[source]¶ An Int specifying the number of state-dependent variables. The default value is 0. This argument is applicable only if modelType = MODELTYPE_USER or modelType = MODELTYPE_USER_INTERACTION.
- modelType : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶
A SymbolicConstant specifying the surface interaction model type.
-
numProperties : --is-rst--:py:class:`int` =
0
[source]¶ An Int specifying the number of property values required. The default value is 0. This argument is applicable only if modelType = MODELTYPE_USER or modelType = MODELTYPE_USER_INTERACTION.
-
padThickness : --is-rst--:py:class:`float` | :py:obj:`None` =
None
[source]¶ None or a Float specifying the thickness of an interfacial layer between the contacting surfaces. If padThickness = None, there is no interfacial layer. The default value is None.
-
trackingThickness : --is-rst--:py:class:`float` | :py:obj:`None` =
None
[source]¶ None or a Float specifying the thickness that determines the contacting surfaces to be tracked. The input value for this parameter cannot be negative. An internal default value is used if a zero value is input or if the parameter is omitted.
-
useUnsymmetricEqunProcedure : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] =
0
[source]¶ A Boolean specifying whether to use unsymmetric equation solution procedures. This argument is applicable only if modelType = MODELTYPE_USER or modelType = MODELTYPE_USER_INTERACTION.
- class InteractionProperty[source]¶
Bases:
object
The InteractionProperty object is the abstract base type for other InteractionProperty objects. The InteractionProperty object has no explicit constructor, members, or methods.
Note
This object can be accessed by:
import interaction mdb.models[name].interactionProperties[name]
Note
Member Details:
- class NormalBehavior(
- contactStiffness=
DEFAULT
, - pressureOverclosure=
HARD
, - allowSeparation=
1
, - maxStiffness=
None
, - table=
()
, - constraintEnforcementMethod=
DEFAULT
, - overclosureFactor=
0
, - overclosureMeasure=
0
, - contactStiffnessScaleFactor=
1
, - initialStiffnessScaleFactor=
1
, - clearanceAtZeroContactPressure=
0
, - stiffnessBehavior=
LINEAR
, - stiffnessRatio=
0
, - upperQuadraticFactor=
0
, - lowerQuadraticRatio=
0
, Bases:
object
The NormalBehavior object specifies normal behavior for a contact interaction property.
Note
This object can be accessed by:
import interaction mdb.models[name].interactionProperties[name].normalBehavior
The table data for this object are:
If pressureOverclosure = EXPONENTIAL, the table data specify the following:
Pressure at zero clearance, p0p0.
Clearance at which the contact pressure is zero, c0c0.
If pressureOverclosure = TABULAR, the table data specify the following:
Pressure.
Overclosure.
The corresponding analysis keywords are:
SURFACE BEHAVIOR
Note
Member Details:
-
allowSeparation : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] =
1
[source]¶ A Boolean specifying whether to allow separation after contact. The default value is ON.
-
clearanceAtZeroContactPressure : --is-rst--:py:class:`float` =
0
[source]¶ A Float specifying the clearance at which the contact pressure is zero. The default value is 0.0.
-
constraintEnforcementMethod : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` =
'DEFAULT'
[source]¶ A SymbolicConstant specifying the method for enforcement of the contact constraint. Possible values are DEFAULT, AUGMENTED_LAGRANGE, PENALTY, and DIRECT. The default value is DEFAULT.
-
contactStiffness : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`, :py:class:`float`] =
'DEFAULT'
[source]¶ The SymbolicConstant DEFAULT or a Float specifying the contact stiffness. This argument is valid for pressureOverclosure = LINEAR. This argument is also valid for pressureOverclosure = HARD when constraintEnforcementMethod = AUGMENTED_LAGRANGE or PENALTY. A value of DEFAULT is valid only when the later conditions are met. A value of zero is equivalent to specifying DEFAULT. The default value is DEFAULT.
-
contactStiffnessScaleFactor : --is-rst--:py:class:`float` =
1
[source]¶ A Float specifying scale factor for the penalty stiffness or the geometric scaling of the “base” stiffness. The default value is 1.0.
-
initialStiffnessScaleFactor : --is-rst--:py:class:`float` =
1
[source]¶ A Float specifying an additional scale factor for the “base” default contact stiffness. The default value is 1.0.
-
lowerQuadraticRatio : --is-rst--:py:class:`float` =
0
[source]¶ A Float specifying the ratio of the overclosure at the initial stiffness divided by the overclosure at the maximum stiffness, both relative to the clearance at which the contact pressure is zero. This argument is valid only when stiffnessBehavior = NONLINEAR. Possible values are 0 ≤ stiffnessRatio < 1. The default value is 0.33333.
-
maxStiffness : --is-rst--:py:class:`float` | :py:obj:`None` =
None
[source]¶ None or a Float specifying the maximum stiffness. If maxStiffness = None, there is no upper limit. The default value is None.
-
overclosureFactor : --is-rst--:py:class:`float` =
0
[source]¶ A Float specifying the overclosure measure (used to delineate the segments of the pressure-overclosure curve) as a percentage of the minimum element size in the contact region. The default value is 0.0.
-
overclosureMeasure : --is-rst--:py:class:`float` =
0
[source]¶ A Float specifying the overclosure measure (used to delineate the segments of the pressure-overclosure curve) directly. The default value is 0.0.
-
pressureOverclosure : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` =
'HARD'
[source]¶ A SymbolicConstant specifying the pressure-overclosure relationship to be used. Possible values are HARD, EXPONENTIAL, LINEAR, TABULAR, and SCALE_FACTOR. The default value is HARD.
-
stiffnessBehavior : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` =
'LINEAR'
[source]¶ A SymbolicConstant specifying the type of penalty stiffness to be defined. This argument is valid only when constraintEnforcementMethod = PENALTY. Possible values are LINEAR and NONLINEAR. The default value is LINEAR.
-
stiffnessRatio : --is-rst--:py:class:`float` =
0
[source]¶ A Float specifying the ratio of the initial stiffness divided by the final stiffness. This argument is valid only when stiffnessBehavior = NONLINEAR. Possible values are 0 ≤ stiffnessRatio < 1. The default value is 0.01.
-
table : --is-rst--:py:class:`tuple`\ \[:py:class:`tuple`\ \[:py:class:`float`, :py:data:`...<Ellipsis>`], :py:data:`...<Ellipsis>`] =
()
[source]¶ A sequence of sequences of Floats specifying the normal behavior properties. This argument is valid only for pressureOverclosure = EXPONENTIAL or TABULAR. The items in the table data are described below.
- class Radiation(mainEmissivity, secondaryEmissivity, table)[source]¶
Bases:
object
The Radiation object specifies radiation for a contact interaction property.
Note
This object can be accessed by:
import interaction mdb.models[name].interactionProperties[name].radiation
The corresponding analysis keywords are:
GAP RADIATION
Note
Member Details:
- mainEmissivity : --is-rst--:py:class:`float`[source]¶
A Float specifying the emissivity of the main surface.
Changed in version 2022: The attribute
masterEmissivity
was renamed tomainEmissivity
.
- class ThermalConductance(
- definition=
TABULAR
, - clearanceDependency=
1
, - pressureDependency=
0
, - temperatureDependencyC=
0
, - massFlowRateDependencyC=
0
, - dependenciesC=
0
, - clearanceDepTable=
()
, - temperatureDependencyP=
0
, - massFlowRateDependencyP=
0
, - dependenciesP=
0
, - pressureDepTable=
()
, Bases:
object
The ThermalConductance object specifies thermal conductance for a contact interaction property.
Note
This object can be accessed by:
import interaction mdb.models[name].interactionProperties[name].thermalConductance
The table data for this object are:
The clearanceDepTable data specify the following:
Conductivity.
Clearance.
Temperature, if the data depend on temperature.
Mass flow rate, if the data depend on mass flow rate.
Value of the first field variable, if the data depend on field variables.
Value of the second field variable.
Etc.
The pressureDepTable data specify the following:
Conductivity.
Pressure.
Temperature, if the data depend on temperature.
Mass flow rate, if the data depend on mass flow rate.
Value of the first field variable, if the data depend on field variables.
Value of the second field variable.
Etc.
The corresponding analysis keywords are:
GAP CONDUCTANCE
Note
Member Details:
-
clearanceDepTable : --is-rst--:py:class:`tuple`\ \[:py:class:`tuple`\ \[:py:class:`float`, :py:data:`...<Ellipsis>`], :py:data:`...<Ellipsis>`] =
()
[source]¶ A sequence of sequences of Floats specifying clearance dependency data. The items in the table data are described below.
-
clearanceDependency : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] =
1
[source]¶ A Boolean specifying whether to use clearance-dependent data. The default value is ON.
-
definition : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` =
'TABULAR'
[source]¶ A SymbolicConstant specifying how the thermal conductance is defined. Possible values are TABULAR and USER_DEFINED. The default value is TABULAR.
-
dependenciesC : --is-rst--:py:class:`int` =
0
[source]¶ An Int specifying the number of field variables to use with clearance dependency. The default value is 0.
-
dependenciesP : --is-rst--:py:class:`int` =
0
[source]¶ An Int specifying the number of field variables to use with pressure dependency. The default value is 0.
-
massFlowRateDependencyC : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] =
0
[source]¶ A Boolean specifying whether to use mass-flow-rate-dependent data with clearance dependency. The default value is OFF.
-
massFlowRateDependencyP : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] =
0
[source]¶ A Boolean specifying whether to use mass-flow-rate-dependent data with pressure dependency. The default value is OFF.
-
pressureDepTable : --is-rst--:py:class:`tuple`\ \[:py:class:`tuple`\ \[:py:class:`float`, :py:data:`...<Ellipsis>`], :py:data:`...<Ellipsis>`] =
()
[source]¶ A sequence of sequences of Floats specifying pressure dependency data. The items in the table data are described below.
-
pressureDependency : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] =
0
[source]¶ A Boolean specifying whether to use pressure-dependent data. The default value is OFF.
- class ContactStabilization[source]¶
Bases:
object
The ContactStabilization object is the abstract base type for other ContactStabilization objects. The ContactStabilization object has no explicit constructor, members, or methods.
Note
This object can be accessed by:
import interaction mdb.models[name].contactStabilizations[name]
Note
Member Details:
- class ContactStd(
- name: str,
- createStepName: str,
- useAllstar: AbaqusBoolean | bool =
OFF
, - globalSmoothing: AbaqusBoolean | bool =
ON
, - includedPairs: RegionPairs | None =
None
, - excludedPairs: RegionPairs | None =
None
, - contactPropertyAssignments: ContactPropertyAssignment | None =
None
, - surfaceThicknessAssignments: SurfaceThicknessAssignment | None =
None
, - surfaceOffsetAssignments: SurfaceOffsetAssignment | None =
None
, - surfaceFeatureAssignments: SurfaceFeatureAssignment | None =
None
, - surfaceBeamSmoothingAssignments: SurfaceBeamSmoothingAssignment =
SurfaceBeamSmoothingAssignment()
, - surfaceVertexCriteriaAssignments: SurfaceVertexCriteriaAssignment =
SurfaceVertexCriteriaAssignment()
, - slidingFormulationAssignments: Sequence[SlidingFormulationAssignment] | None =
None
, - mainSecondaryAssignments: MainSecondaryAssignment | None =
None
, - initializationAssignments: InitializationAssignment | None =
None
, - stabilizationAssignments: StabilizationAssignment | None =
None
, - smoothingAssignments: SmoothingAssignment | None =
None
, - slidingTransitionAssignments: SlidingTransitionAssignment | None =
None
, - class ContactStd(
- name: str,
- createStepName: str,
- globalSmoothing: AbaqusBoolean | bool =
ON
, - surfaceBeamSmoothingAssignments: SurfaceBeamSmoothingAssignment =
SurfaceBeamSmoothingAssignment()
, - surfaceVertexCriteriaAssignments: SurfaceVertexCriteriaAssignment =
SurfaceVertexCriteriaAssignment()
, - slidingFormulationAssignments: Sequence[SlidingFormulationAssignment] | None =
None
, - useAllstar: AbaqusBoolean | bool =
OFF
, - includedPairs: SymbolicConstant | None =
None
, - excludedPairs: SymbolicConstant | None =
None
, - contactPropertyAssignments: SymbolicConstant | None =
None
, - surfaceFeatureAssignments: SymbolicConstant | float =
GLOBAL
, - surfaceThicknessAssignments: SymbolicConstant | float =
GLOBAL
, - surfaceOffsetAssignments: SymbolicConstant | float =
GLOBAL
, - mainSecondaryAssignments: SymbolicConstant | None =
None
, - initializationAssignments: SymbolicConstant | None =
None
, - stabilizationAssignments: SymbolicConstant | None =
None
, - smoothingAssignments: SymbolicConstant | None =
None
, - slidingTransitionAssignments: SymbolicConstant | None =
None
, Bases:
Interaction
The ContactStd object defines the contact domain and associated properties during contact in an Abaqus/Standard analysis. The ContactStd object is derived from the Interaction object.
Note
This object can be accessed by:
import interaction mdb.models[name].interactions[name]
The corresponding analysis keywords are:
CONTACT
Note
Member Details:
-
assignEdgeToEdgeformulation : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] =
False
[source]¶ A Boolean specifying whether to assign the edge-to-edge formulation. The default value is False.
-
contactPropertyAssignments : --is-rst--:py:class:`~abaqus.Interaction.ContactPropertyAssignment.ContactPropertyAssignment` =
<abaqus.Interaction.ContactPropertyAssignment.ContactPropertyAssignment object>
[source]¶ A ContactPropertyAssignment object specifying the contact property assignments in the contact domain.
-
edgeToEdgeFormulation : --is-rst--:py:class:`str` =
'NO'
[source]¶ A symbolic constant specifying edge-to-edge formulation. The default value is NO.
-
excludedPairs : --is-rst--:py:class:`~abaqus.Interaction.RegionPairs.RegionPairs` =
<abaqus.Interaction.RegionPairs.RegionPairs object>
[source]¶ A RegionPairs object specifying the domain pairs excluded from contact.
-
globalSmoothing : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] =
1
[source]¶ A Boolean specifying whether surface smoothing (geometric correction) is automatically applied to all eligible surfaces. The default value is ON.
-
includedPairs : --is-rst--:py:class:`~abaqus.Interaction.RegionPairs.RegionPairs` =
<abaqus.Interaction.RegionPairs.RegionPairs object>
[source]¶ A RegionPairs object specifying the domain pairs included in contact.
-
initializationAssignments : --is-rst--:py:class:`~abaqus.Interaction.InitializationAssignment.InitializationAssignment` =
<abaqus.Interaction.InitializationAssignment.InitializationAssignment object>
[source]¶ An InitializationAssignment object specifying the contact initialization assignments in the contact domain.
-
mainSecondaryAssignments : --is-rst--:py:class:`~abaqus.Interaction.MainSecondaryAssignment.MainSecondaryAssignment` =
<abaqus.Interaction.MainSecondaryAssignment.MainSecondaryAssignment object>
[source]¶ A MainSecondaryAssignment object specifying the main-secondary assignments in the contact domain.
Changed in version 2022: The attribute
masterSlaveAssignments
was renamed tomainSecondaryAssignments
.
-
slidingTransitionAssignments : --is-rst--:py:class:`~abaqus.Interaction.SlidingTransitionAssignment.SlidingTransitionAssignment` =
<abaqus.Interaction.SlidingTransitionAssignment.SlidingTransitionAssignment object>
[source]¶ A SlidingTransitionAssignments object specifying the sliding transition assignments in the contact domain.
-
smoothingAssignments : --is-rst--:py:class:`~abaqus.Interaction.SmoothingAssignment.SmoothingAssignment` =
<abaqus.Interaction.SmoothingAssignment.SmoothingAssignment object>
[source]¶ A SmoothingAssignment object specifying the surface smoothing assignments in the contact domain.
-
stabilizationAssignments : --is-rst--:py:class:`~abaqus.Interaction.StabilizationAssignment.StabilizationAssignment` =
<abaqus.Interaction.StabilizationAssignment.StabilizationAssignment object>
[source]¶ A StabilizationAssignment object specifying the contact stabilization assignments in the contact domain.
-
surfaceFeatureAssignments : --is-rst--:py:class:`~abaqus.Interaction.SurfaceFeatureAssignment.SurfaceFeatureAssignment` =
<abaqus.Interaction.SurfaceFeatureAssignment.SurfaceFeatureAssignment object>
[source]¶ A SurfaceFeatureAssignment object specifying the surface feature angle assignments in the contact domain.
-
surfaceOffsetAssignments : --is-rst--:py:class:`~abaqus.Interaction.SurfaceOffsetAssignment.SurfaceOffsetAssignment` =
<abaqus.Interaction.SurfaceOffsetAssignment.SurfaceOffsetAssignment object>
[source]¶ A SurfaceOffsetAssignment object specifying the surface offset fraction assignments in the contact domain.
-
surfaceThicknessAssignments : --is-rst--:py:class:`~abaqus.Interaction.SurfaceThicknessAssignment.SurfaceThicknessAssignment` =
<abaqus.Interaction.SurfaceThicknessAssignment.SurfaceThicknessAssignment object>
[source]¶ A SurfaceThicknessAssignment object specifying the surface thickness assignments in the contact domain.
- class InitializationAssignment[source]¶
Bases:
object
The InitializationAssignment object stores the contact initialization assignment definition for domain pairs in a ContactStd or ContactExp object. The InitializationAssignment object has no constructor or members.
Note
This object can be accessed by:
import interaction mdb.models[name].interactions[name].initializationAssignments
The corresponding analysis keywords are:
CONTACT INITIALIZATION ASSIGNMENT
Note
Member Details:
- appendInStep(stepName, assignments)[source]¶
This method allows addition of contact initialization assignments to new domain pairs in a given step.
- Parameters:¶
- stepName¶
A String specifying the name of the step in which new contact initialization assignments are to be defined.
- assignments¶
A sequence of tuples specifying the initializations assigned to each surface pair. Each tuple contains four entries (fourth entry is for Abaqus/Explicit and is optional):
A region object or the SymbolicConstant GLOBAL (for Abaqus/Standard only).
A region object or the SymbolicConstant SELF (for Abaqus/Standard only).
A String specifying a StdInitialization or ExpInitializationobject associated with this pair of regions.
A String specifying a secondary surface type. This entry is applicable only if the ExpInitialization object is defined with overclosureType = CLEARANCE and adjustNodalCoords = True.
- changeValuesInStep(stepName, index, value)[source]¶
This method allows modification of contact initialization assignments to domain pairs already defined in a given step.
- Parameters:¶
- stepName¶
A String specifying the name of the step in which the contact initialization assignments are to be modified.
- index¶
An Int specifying the position of the contact initialization assignment whose value is to be modified.
- value¶
A String specifying the value of the contact initialization to be assigned to the domain pair whose index is referenced.
- class SlidingFormulationAssignment[source]¶
Bases:
object
The SlidingFormulationAssignment object stores the sliding formulation assignment definition for surfaces in ContactStd objects. The SlidingFormulationAssignment object has no constructor or members.
Note
This object can be accessed by:
import interaction mdb.models[name].interactions[name].slidingFormulationAssignments
The corresponding analysis keywords are:
CONTACT FORMULATION
Added in version 2021: The
SlidingFormulationAssignment
class was added.Member Details:
- appendInStep(stepName, assignments)[source]¶
This method allows you to add sliding formulation assignments to new surface pairs in a given step.
- Parameters:¶
- stepName¶
A String specifying the name of the step in which the sliding formulation assignments are to be defined.
- assignments¶
A sequence of tuples specifying the sliding formulation assignments. Each tuple contains two entries:
A region object or the SymbolicConstant GLOBAL specifying the surface to which the sliding formulation attribute is assigned.
A SymbolicConstant specifying the overriding the smoothness value to be used for the first surface. Possible values of the SymbolicConstant are NONE and SMALL_SLIDING.
- changeValuesInStep(stepName, index, value)[source]¶
This method allows you to modify sliding formulation assignments already defined on surface pairs in a given step.
- Parameters:¶
- stepName¶
A String specifying the name of the step in which the sliding formulation assignments are to be modified.
- index¶
An Int specifying the position of the sliding formulation assignment whose value is to be modified.
- value¶
A SymbolicConstant specifying the value of the smoothness of the surface-to-surface formulation on sliding to be assigned to the surface whose index is referenced. Possible values are NONE and SMALL_SLIDING.
- class SlidingTransitionAssignment[source]¶
Bases:
object
The SlidingTransitionAssignment object stores the sliding transition assignment definition for surfaces in ContactStd objects. The SlidingTransitionAssignment object has no constructor or members.
Note
This object can be accessed by:
import interaction mdb.models[name].interactions[name].slidingTransitionAssignments
The corresponding analysis keywords are:
CONTACT FORMULATION
Note
Member Details:
- appendInStep(stepName, assignments)[source]¶
This method allows you to add sliding transition assignments to new surface pairs in a given step.
- Parameters:¶
- stepName¶
A String specifying the name of the step in which the sliding transition assignments are to be defined.
- assignments¶
A sequence of tuples specifying the sliding transition assignments. Each tuple contains two entries:
A region object or the SymbolicConstant GLOBAL specifying the surface to which the sliding transition attribute is assigned.
A SymbolicConstant specifying the overriding the smoothness value to be used for the first surface. Possible values of the SymbolicConstant are ELEMENT_ORDER_SMOOTHING, LINEAR_SMOOTHING, and QUADRATIC_SMOOTHING.
- changeValuesInStep(stepName, index, value)[source]¶
This method allows you to modify sliding transition assignments already defined on surface pairs in a given step.
- Parameters:¶
- stepName¶
A String specifying the name of the step in which the sliding transition assignments are to be modified.
- index¶
An Int specifying the position of the sliding transition assignment whose value is to be modified.
- value¶
A SymbolicConstant specifying the value of the smoothness of the surface-to-surface formulation on sliding to be assigned to the surface whose index is referenced. Possible values are ELEMENT_ORDER_SMOOTHING, LINEAR_SMOOTHING, and QUADRATIC_SMOOTHING.
- class StabilizationAssignment[source]¶
Bases:
object
The StabilizationAssignment object stores the contact stabilization assignment definition for domain pairs in a ContactStd object. The StabilizationAssignment object has no constructor or members.
Note
This object can be accessed by:
import interaction mdb.models[name].interactions[name].stabilizationAssignments
The corresponding analysis keywords are:
CONTACT STABILIZATION
Note
Member Details:
- appendInStep(stepName, assignments)[source]¶
This method allows addition of contact stabilization assignments to new domain pairs in a given step.
- Parameters:¶
- stepName¶
A String specifying the name of the step in which new contact stabilization assignments are to be defined.
- assignments¶
A sequence of tuples specifying the stabilizations assigned to each surface pair. Each tuple contains three entries:
A region object or the SymbolicConstant GLOBAL.
A region object or the SymbolicConstant SELF.
A String specifying a StdStabilization object associated with this pair of regions.
- changeValuesInStep(stepName, index, value)[source]¶
This method allows modification of contact stabilization assignments to domain pairs already defined in a given step.
- Parameters:¶
- stepName¶
A String specifying the name of the step in which the contact stabilization assignments are to be modified.
- index¶
An Int specifying the position of the contact stabilization assignment whose value is to be modified.
- value¶
A String specifying the value of the contact stabilization to be assigned to the domain pair whose index is referenced.
- class SurfaceBeamSmoothingAssignment[source]¶
Bases:
object
The SurfaceBeamSmoothingAssignment object stores the surface beam smoothing assignment definition for surfaces in ContactStd objects. The SurfaceBeamSmoothingAssignment object has no constructor or members.
Note
This object can be accessed by:
import interaction mdb.models[name].interactions[name].surfaceBeamSmoothingAssignments
The corresponding analysis keywords are:
SURFACE PROPERTY ASSIGNMENT
Added in version 2021: The
SurfaceBeamSmoothingAssignment
class was added.Member Details:
- appendInStep(stepName, assignments)[source]¶
This method allows addition of surface beam smoothing assignments to new surfaces in a given step.
- Parameters:¶
- stepName¶
A String specifying the name of the step in which new surface beam smoothing assignments are to be defined.
- assignments¶
A sequence of tuples specifying the surface beam smoothing assignments. Each tuple contains two entries:
A region object specifying the surface to which the smoothing is assigned.
A Float specifying the surface smoothing value to be used for the surface.
- changeValuesInStep(stepName, index, value)[source]¶
This method allows modification of surface beam smoothing assignments already defined on surfaces in a given step.
- Parameters:¶
- stepName¶
A String specifying the name of the step in which the surface beam smoothing assignments are to be modified.
- index¶
An Int specifying the position of the surface beam smoothing assignment whose value is to be modified.
- value¶
A tuple specifying the value of the surface beam smoothing assignments for the surface whose index is referenced. Each tuple contains one entry:A Float specifying the surface beam smoothing value to be used for the surface.
- class SurfaceVertexCriteriaAssignment[source]¶
Bases:
object
The SurfaceVertexCriteriaAssignment object stores the surface vertex criteria assignment definition for surfaces in ContactStd objects. The SurfaceVertexCriteriaAssignment object has no constructor or members.
Note
This object can be accessed by:
import interaction mdb.models[name].interactions[name].surfacevertexCriteriaAssignments
The corresponding analysis keywords are:
SURFACE PROPERTY ASSIGNMENT
Added in version 2021: The
SurfaceVertexCriteriaAssignment
class was added.Member Details:
- appendInStep(stepName, assignments)[source]¶
This method allows addition of surface vertex criteria assignments to new surfaces in a given step.
- Parameters:¶
- stepName¶
A String specifying the name of the step in which new surface vertex criteria assignments are to be defined.
- assignments¶
A sequence of tuples specifying the surface vertex criteria assignments. Each tuple contains two entries:
A region or a material object or the SymbolicConstant GLOBAL specifying the surface to which the vertex criteria is assigned.
A Float or a SymbolicConstant specifying the vertex criteria value to be used for the surface. Possible values of the SymbolicConstant are ALL_VERTICES or NO_VERTICES.
- changeValuesInStep(stepName, index, value)[source]¶
This method allows modification of surface vertex criteria assignments already defined on surfaces in a given step.
- Parameters:¶
- stepName¶
A String specifying the name of the step in which the surface vertex criteria assignments are to be modified.
- index¶
An Int specifying the position of the surface vertex criteria assignment whose value is to be modified.
- value¶
A tuple specifying the value of the surface vertex criteria assignments for the surface whose index is referenced. Each tuple contains: - A Float or a SymbolicConstant specifying the vertex criteria value to be used for the surface. Possible values of the SymbolicConstant are ALL_VERTICES or NO_VERTICES.
- class CyclicSymmetry(
- name,
- createStepName,
- main,
- secondary,
- repetitiveSectors,
- axisPoint1,
- axisPoint2,
- extractedNodalDiameter=
ALL_NODAL_DIAMETER
, - lowestNodalDiameter=
0
, - highestNodalDiameter=
0
, - excitationNodalDiameter=
0
, - adjustTie=
1
, - positionTolerance=
0
, - positionToleranceMethod=
COMPUTED_TOLERANCE
, Bases:
Interaction
The CyclicSymmetry object defines a cyclic symmetry analysis. The CyclicSymmetry object is derived from the Interaction object.
Note
This object can be accessed by:
import interaction mdb.models[name].interactions[name]
The corresponding analysis keywords are:
CLOAD
CYCLIC SYMMETRY MODEL
DLOAD - CLOAD - CYCLIC SYMMETRY MODEL
DLOAD - SELECT CYCLIC SYMMETRY MODES
TIE
Note
Member Details:
-
adjustTie : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] =
1
[source]¶ A Boolean specifying whether or not to adjust the secondary surface of the cyclic symmetry to tie it to the main surface. The default value is ON.
- axisPoint1 : --is-rst--:py:class:`~abaqus.Region.Region.Region`[source]¶
A Region object specifying the first point of the axis of symmetry. The region should contain exactly one mesh node, vertex, interesting point, reference point, or datum point. In a two-dimensional model axisPoint1 is the only point used to define the axis of symmetry.
- axisPoint2 : --is-rst--:py:class:`~abaqus.Region.Region.Region`[source]¶
A Region object specifying the second point of the axis of symmetry. The region should contain exactly one mesh node, vertex, interesting point, reference point, or datum point. This point is ignored in a two-dimensional model.
- createStepName : --is-rst--:py:class:`str`[source]¶
A String specifying the name of the step in which the cyclic symmetry interaction should be created.
-
excitationNodalDiameter : --is-rst--:py:class:`int` =
0
[source]¶ An Int specifying the nodal diameter for which the modal-based steady-state dynamic analysis will be performed. This value should be greater than or equal to the lowest nodal diameter (specified in the lowestNodalDiameter parameter), and less than or equal to the highest nodal diameter (specified in the highestNodalDiameter parameter). The default value is 0.
-
extractedNodalDiameter : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` =
'ALL_NODAL_DIAMETER'
[source]¶ A SymbolicConstant specifying whether Abaqus should extract all possible nodal diameters or the nodal diameters between the user-specified values for lowestNodalDiameter and highestNodalDiameter. Possible values are ALL_NODAL_DIAMETER and SPECIFIED_NODAL_DIAMETER. The default value is ALL_NODAL_DIAMETER.
-
highestNodalDiameter : --is-rst--:py:class:`int` =
0
[source]¶ An Int specifying the highest nodal diameter to be used in the eigenfrequency analysis. This argument value should be less than or equal to the half of the total number of sectors (as specified in the repetitiveSectors parameter). The default value is 0.
-
lowestNodalDiameter : --is-rst--:py:class:`int` =
0
[source]¶ An Int specifying the lowest nodal diameter to be used in the eigenfrequency analysis. The default value is 0.
- main : --is-rst--:py:class:`~abaqus.Region.Region.Region`[source]¶
A Region object specifying the main surface.
Changed in version 2022: The attribute
master
was renamed tomain
.
-
positionTolerance : --is-rst--:py:class:`float` =
0
[source]¶ A Float specifying the position tolerance. The*positionTolerance* argument applies only when positionToleranceMethod = SPECIFY_TOLERANCE. The default value is 0.0.
-
positionToleranceMethod : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` =
'COMPUTED_TOLERANCE'
[source]¶ A SymbolicConstant specifying the method used to determine the position tolerance. Possible values are COMPUTED_TOLERANCE and SPECIFY_TOLERANCE. The default value is COMPUTED_TOLERANCE.
- repetitiveSectors : --is-rst--:py:class:`int`[source]¶
An Int specifying the total number of sectors in the cyclic symmetric model.
- secondary : --is-rst--:py:class:`~abaqus.Region.Region.Region`[source]¶
A Region object specifying the secondary surface.
Changed in version 2022: The attribute
slave
was renamed tosecondary
.
- setValues(
- extractedNodalDiameter=
ALL_NODAL_DIAMETER
, - lowestNodalDiameter=
0
, - highestNodalDiameter=
0
, - excitationNodalDiameter=
0
, - adjustTie=
1
, - positionTolerance=
0
, - positionToleranceMethod=
COMPUTED_TOLERANCE
, This method modifies the data for an existing CyclicSymmetry object in the step where it is created.
Note
- Parameters:¶
- extractedNodalDiameter=
ALL_NODAL_DIAMETER
¶ A SymbolicConstant specifying whether Abaqus should extract all possible nodal diameters or the nodal diameters between the user-specified values for lowestNodalDiameter and highestNodalDiameter. Possible values are ALL_NODAL_DIAMETER and SPECIFIED_NODAL_DIAMETER. The default value is ALL_NODAL_DIAMETER.
- lowestNodalDiameter=
0
¶ An Int specifying the lowest nodal diameter to be used in the eigenfrequency analysis. The default value is 0.
- highestNodalDiameter=
0
¶ An Int specifying the highest nodal diameter to be used in the eigenfrequency analysis. This argument value should be less than or equal to the half of the total number of sectors (as specified in the repetitiveSectors parameter). The default value is 0.
- excitationNodalDiameter=
0
¶ An Int specifying the nodal diameter for which the modal-based steady-state dynamic analysis will be performed. This value should be greater than or equal to the lowest nodal diameter (specified in the lowestNodalDiameter parameter), and less than or equal to the highest nodal diameter (specified in the highestNodalDiameter parameter). The default value is 0.
- adjustTie=
1
¶ A Boolean specifying whether or not to adjust the secondary surface of the cyclic symmetry to tie it to the main surface. The default value is ON.
- positionTolerance=
0
¶ A Float specifying the position tolerance. The*positionTolerance* argument applies only when positionToleranceMethod = SPECIFY_TOLERANCE. The default value is 0.0.
- positionToleranceMethod=
COMPUTED_TOLERANCE
¶ A SymbolicConstant specifying the method used to determine the position tolerance. Possible values are COMPUTED_TOLERANCE and SPECIFY_TOLERANCE. The default value is COMPUTED_TOLERANCE.
- extractedNodalDiameter=
- setValuesInStep(
- stepName,
- extractedNodalDiameter=
ALL_NODAL_DIAMETER
, - lowestNodalDiameter=
0
, - highestNodalDiameter=
0
, - excitationNodalDiameter=
0
, This method modifies the propagating data of an existing CyclicSymmetry object in the specified step.
- Parameters:¶
- stepName¶
A String specifying the name of the step in which the interaction is modified.
- extractedNodalDiameter=
ALL_NODAL_DIAMETER
¶ A SymbolicConstant specifying whether Abaqus should extract all possible nodal diameters or the nodal diameters between the user-specified values for lowestNodalDiameter and highestNodalDiameter. Possible values are ALL_NODAL_DIAMETER and SPECIFIED_NODAL_DIAMETER. The default value is ALL_NODAL_DIAMETER.
- lowestNodalDiameter=
0
¶ An Int specifying the lowest nodal diameter to be used in the eigenfrequency analysis. The default value is 0.
- highestNodalDiameter=
0
¶ An Int specifying the highest nodal diameter to be used in the eigenfrequency analysis. This argument value should be less than or equal to the half of the total number of sectors (as specified in the repetitiveSectors parameter). The default value is 0.
- excitationNodalDiameter=
0
¶ An Int specifying the nodal diameter for which the modal-based steady-state dynamic analysis will be performed. This value should be greater than or equal to the lowest nodal diameter (specified in the lowestNodalDiameter parameter), and less than or equal to the highest nodal diameter (specified in the highestNodalDiameter parameter). The default value is 0.
- class CyclicSymmetryState[source]¶
Bases:
InteractionState
The CyclicSymmetryState object stores the propagating data for a CyclicSymmetry object. One instance of this object is created internally by the CyclicSymmetry object for each step. The instance is also deleted internally by the CyclicSymmetry object. The CyclicSymmetryState object has no constructor or methods. The CyclicSymmetryState object is derived from the InteractionState object.
Note
This object can be accessed by:
import interaction mdb.models[name].steps[name].interactionStates[name]
The corresponding analysis keywords are:
CLOAD
DLOAD
DSLOAD
SELECT CYCLIC SYMMETRY MODES
Note
Member Details:
-
excitiationNodalDiameter : --is-rst--:py:class:`int` =
0
[source]¶ An Int specifying the nodal diameter for which the modal-based steady-state dynamic analysis will be performed. This value should be greater than or equal to the lowest nodal diameter (specified in the lowestNodalDiameter parameter), and less than or equal to the highest nodal diameter (specified in the highestNodalDiameter parameter). The default value is 0.
- excitiationNodalDiameterState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶
A SymbolicConstant specifying the propagation state of the excitiationNodalDiameter member. Possible values are UNSET, SET, UNCHANGED, and FREED.
-
extractedNodalDiameter : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` =
'ALL_NODAL_DIAMETER'
[source]¶ A SymbolicConstant specifying whether Abaqus should extract all possible nodal diameters or the nodal diameters between the user-specified values for lowestNodalDiameter and highestNodalDiameter. Possible values are ALL_NODAL_DIAMETER and SPECIFIED_NODAL_DIAMETER. The default value is ALL_NODAL_DIAMETER.
- extractedNodalDiameterState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶
A SymbolicConstant specifying the propagation state of the extractedNodalDiameter member. Possible values are UNSET, SET, UNCHANGED, and FREED.
-
highestNodalDiameter : --is-rst--:py:class:`int` =
0
[source]¶ An Int specifying the highest nodal diameter to be used in the eigenfrequency analysis. This argument value should be less than or equal to the half of the total number of sectors. The default value is 0.
- highestNodalDiameterState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶
A SymbolicConstant specifying the propagation state of the highestNodalDiameter member. Possible values are UNSET, SET, UNCHANGED, and FREED.
-
lowestNodalDiameter : --is-rst--:py:class:`int` =
0
[source]¶ An Int specifying the lowest nodal diameter to be used in the eigenfrequency analysis. The default value is 0.
- lowestNodalDiameterState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶
A SymbolicConstant specifying the propagation state of the lowestNodalDiameter member. Possible values are UNSET, SET, UNCHANGED, and FREED.
- status : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶
A SymbolicConstant specifying the propagation state of the InteractionState object. Possible values are:
NOT_YET_ACTIVE
CREATED
PROPAGATED
MODIFIED
DEACTIVATED
NO_LONGER_ACTIVE
TYPE_NOT_APPLICABLE
INSTANCE_NOT_APPLICABLE
BUILT_INTO_BASE_STATE
- class ElasticFoundation(name, createStepName, surface, stiffness)[source]¶
Bases:
Interaction
The ElasticFoundation object defines a mechanical foundation. The ElasticFoundation object is derived from the Interaction object.
Note
This object can be accessed by:
import interaction mdb.models[name].interactions[name]
The corresponding analysis keywords are:
FOUNDATION
Note
Member Details:
- createStepName : --is-rst--:py:class:`str`[source]¶
A String specifying the name of the step in which the ElasticFoundation object is created. createStepName must be set to ‘Initial’.
- setValues(*args, **kwargs)[source]¶
This method modifies the data for an existing ElasticFoundation object in the step where it is created.
-
setValuesInStep(stepName, stiffness=
None
)[source]¶ This method modifies the propagating data of an existing ElasticFoundation object in the specified step.
- class ElasticFoundationState[source]¶
Bases:
InteractionState
The ElasticFoundationState object stores the propagating data for an ElasticFoundation object. One instance of this object is created internally by the ElasticFoundation object for each step. The instance is also deleted internally by the ElasticFoundation object. The ElasticFoundationState object has no constructor or methods. The ElasticFoundationState object is derived from the InteractionState object.
Note
This object can be accessed by:
import interaction mdb.models[name].steps[name].interactionStates[name]
Note
Member Details:
- status : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶
A SymbolicConstant specifying the propagation state of the InteractionState object. Possible values are:
NOT_YET_ACTIVE
CREATED
PROPAGATED
MODIFIED
DEACTIVATED
NO_LONGER_ACTIVE
TYPE_NOT_APPLICABLE
INSTANCE_NOT_APPLICABLE
BUILT_INTO_BASE_STATE
- class ExpContactControl(
- name,
- globTrkChoice=
DEFAULT
, - globTrkInc=
None
, - fastLocalTrk=
1
, - scalePenalty=
1
, - warpCheckPeriod=
20
, - warpCutoff=
20
, Bases:
ContactControl
The ExpContactControl object is used in Abaqus/Explicit analyses to specify optional solution controls for problems involving contact between bodies. The ExpContactControl object is derived from the ContactControl object.
Note
This object can be accessed by:
import interaction mdb.models[name].contactControls[name]
The corresponding analysis keywords are:
CONTACT CONTROLS
Note
Member Details:
-
fastLocalTrk : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] =
1
[source]¶ A Boolean specifying whether to use the more computationally efficient local tracking method. The default value is ON.
-
globTrkChoice : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` =
'DEFAULT'
[source]¶ A SymbolicConstant specifying whether or not the default value will be used for the maximum number of increments between global contact searches. Possible values are DEFAULT and SPECIFY. The default value is DEFAULT.
-
globTrkInc : --is-rst--:py:class:`int` | :py:obj:`None` =
None
[source]¶ An Int specifying the maximum number of increments between global contact searches. The globTrkInc argument applies only when globTrkChoice = SPECIFY. The default value is 100 for surface-to-surface contact and 4 for self-contact.
-
scalePenalty : --is-rst--:py:class:`float` =
1
[source]¶ A Float specifying the factor by which Abaqus/Explicit will scale the default penalty stiffness to obtain the stiffnesses used for the penalty contact pairs. The default value is 1.0.
- setValues(
- globTrkChoice=
DEFAULT
, - globTrkInc=
None
, - fastLocalTrk=
1
, - scalePenalty=
1
, - warpCheckPeriod=
20
, - warpCutoff=
20
, This method modifies the ExpContactControl object.
Note
- Parameters:¶
- globTrkChoice=
DEFAULT
¶ A SymbolicConstant specifying whether or not the default value will be used for the maximum number of increments between global contact searches. Possible values are DEFAULT and SPECIFY. The default value is DEFAULT.
- globTrkInc=
None
¶ An Int specifying the maximum number of increments between global contact searches. The globTrkInc argument applies only when globTrkChoice = SPECIFY. The default value is 100 for surface-to-surface contact and 4 for self-contact.
- fastLocalTrk=
1
¶ A Boolean specifying whether to use the more computationally efficient local tracking method. The default value is ON.
- scalePenalty=
1
¶ A Float specifying the factor by which Abaqus/Explicit will scale the default penalty stiffness to obtain the stiffnesses used for the penalty contact pairs. The default value is 1.0.
- warpCheckPeriod=
20
¶ An Int specifying the number of increments between checks for highly warped facets on main surfaces. The default value is 20.
- warpCutoff=
20
¶ A Float specifying the out-of-plane warping angle (in degrees), at which a facet will be considered to be highly warped. The default value is 20.0.
- globTrkChoice=
- Raises:¶
RangeError –
- class ExpInitialization(
- name,
- overclosureType=
ADJUST
, - interferenceDistance=
None
, - clearanceDistance=
None
, - openingTolerance=
None
, - overclosureTolerance=
None
, - adjustNodalCoords=
True
, - secondaryNodesetName=
None
, - stepFraction=
1
, Bases:
ContactInitialization
The ExpInitialization object is used in conjunction with ContactExp in Abaqus/Explicit analyses to specify contact initialization data. The ExpInitialization object is derived from the ContactInitialization object.
Note
This object can be accessed by:
import interaction mdb.models[name].contactInitializations[name]
The corresponding analysis keywords are:
CONTACT INITIALIZATION DATA
Added in version 2020: The
ExpInitialization
class was added.Note
Member Details:
-
adjustNodalCoords : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] =
True
[source]¶ A Boolean specifying whether to resolve clearances/overclosures by adjusting the nodal coordinates without creating strain in the model. adjustNodalCoords = True can be used only for clearances/overclosures defined in the first step of an analysis. The default value is True.
-
clearanceDistance : --is-rst--:py:class:`float` | :py:obj:`None` =
None
[source]¶ None or a Float specifying the initial clearance distance. This argument is valid only when overclosureType = CLEARANCE and must be specified in that case. The default value is None.
-
interferenceDistance : --is-rst--:py:class:`float` | :py:obj:`None` =
None
[source]¶ None or a Float specifying the interference distance. This argument is valid only when overclosureType = INTERFERENCE. The default value is None.
- name : --is-rst--:py:class:`str`[source]¶
A String specifying the contact initialization repository key.
-
openingTolerance : --is-rst--:py:class:`float` | :py:obj:`None` =
None
[source]¶ None or a Float specifying the distance tolerance within which initial openings will undergo strain-free adjustments. This argument is not valid when overclosureType = INTERFERENCE unless a value has been specified for interferenceDistance. The default value is None.
-
overclosureTolerance : --is-rst--:py:class:`float` | :py:obj:`None` =
None
[source]¶ None or a Float specifying the distance tolerance within which initial overclosures will undergo strain-free adjustments. The default value is None.
-
overclosureType : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` =
'ADJUST'
[source]¶ A SymbolicConstant specifying the type of overclosure to be defined. Possible values are ADJUST, INTERFERENCE, and CLEARANCE. The default value is ADJUST.
-
secondaryNodesetName : --is-rst--:py:class:`str` | :py:obj:`None` =
None
[source]¶ A String specifying the name of the node set containing the secondary nodes to be included in the initial clearance specification. This argument is not valid when overclosureType = INTERFERENCE and if openingTolerance or overclosureTolerance is specified. The default value is None.
Changed in version 2022: The attribute
slaveNodesetName
was renamed tosecondaryNodesetName
.
- setValues(
- overclosureType=
ADJUST
, - interferenceDistance=
None
, - clearanceDistance=
None
, - openingTolerance=
None
, - overclosureTolerance=
None
, - adjustNodalCoords=
True
, - secondaryNodesetName=
None
, - stepFraction=
1
, This method modifies the ExpInitialization object.
Note
- Parameters:¶
- overclosureType=
ADJUST
¶ A SymbolicConstant specifying the type of overclosure to be defined. Possible values are ADJUST, INTERFERENCE, and CLEARANCE. The default value is ADJUST.
- interferenceDistance=
None
¶ None or a Float specifying the interference distance. This argument is valid only when overclosureType = INTERFERENCE. The default value is None.
- clearanceDistance=
None
¶ None or a Float specifying the initial clearance distance. This argument is valid only when overclosureType = CLEARANCE and must be specified in that case. The default value is None.
- openingTolerance=
None
¶ None or a Float specifying the distance tolerance within which initial openings will undergo strain-free adjustments. This argument is not valid when overclosureType = INTERFERENCE unless a value has been specified for interferenceDistance. The default value is None.
- overclosureTolerance=
None
¶ None or a Float specifying the distance tolerance within which initial overclosures will undergo strain-free adjustments. The default value is None.
- adjustNodalCoords=
True
¶ A Boolean specifying whether to resolve clearances/overclosures by adjusting the nodal coordinates without creating strain in the model. adjustNodalCoords = True can be used only for clearances/overclosures defined in the first step of an analysis. The default value is True.
- secondaryNodesetName=
None
¶ A String specifying the name of the node set containing the secondary nodes to be included in the initial clearance specification. This argument is not valid when overclosureType = INTERFERENCE and if openingTolerance or overclosureTolerance is specified. The default value is None.
Changed in version 2022: The argument
slaveNodesetName
was renamed tosecondaryNodesetName
.- stepFraction=
1
¶ A Float specifying the fraction of the step time (between 0.0 and 1.0) in which the interference fit has to be solved. The default value is 1.0. This argument is valid only when overclosureType = INTERFERENCE.
- overclosureType=
- Raises:¶
RangeError –
- class FilmCondition(
- name,
- createStepName,
- surface,
- definition,
- interactionProperty=
''
, - sinkTemperature=
0
, - sinkAmplitude=
''
, - filmCoeff=
0
, - filmCoeffAmplitude=
''
, - field=
''
, - sinkFieldName=
''
, - sinkDistributionType=
UNIFORM
, Bases:
Interaction
The FilmCondition object defines film coefficients and associated sink temperatures for coupled temperature-displacement analyses. The FilmCondition object is derived from the Interaction object.
Note
This object can be accessed by:
import interaction mdb.models[name].interactions[name]
Note
Member Details:
- createStepName : --is-rst--:py:class:`str`[source]¶
A String specifying the name of the step in which the FilmCondition object is created.
- definition : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶
A SymbolicConstant specifying how the film condition is defined. Possible values are EMBEDDED_COEFF, PROPERTY_REF, USER_SUB, and FIELD.
-
field : --is-rst--:py:class:`str` =
''
[source]¶ A String specifying the name of the AnalyticalField object associated with this interaction. The field argument applies only when definition = FIELD. The default value is an empty string.
-
filmCoeff : --is-rst--:py:class:`float` =
0
[source]¶ A Float specifying the reference film coefficient value, hh. The filmCoeff argument applies when definition = EMBEDDED_COEFF, definition = USER_SUB, or definition = FIELD. The default value is 0.0.
-
filmCoeffAmplitude : --is-rst--:py:class:`str` =
''
[source]¶ A String specifying the name of the Amplitude object that gives the variation of the film coefficient, hh, with time. The default value is an empty string. Note: Use empty string in an Abaqus/Standard analysis to specify that the reference film coefficient is applied immediately at the beginning of the step or linearly over the step. Use empty string in an Abaqus/Explicit analysis to specify that the reference film coefficient is applied throughout the step.
-
interactionProperty : --is-rst--:py:class:`str` =
''
[source]¶ A String specifying the name of the FilmConditionProp object associated with this interaction. The interactionProperty argument applies only when definition = PROPERTY_REF. The default value is an empty string.
- setValues(
- interactionProperty=
''
, - sinkTemperature=
0
, - sinkAmplitude=
''
, - filmCoeff=
0
, - filmCoeffAmplitude=
''
, - field=
''
, - sinkFieldName=
''
, - sinkDistributionType=
UNIFORM
, This method modifies the data for an existing FilmCondition object in the step where it is created.
Note
- Parameters:¶
- interactionProperty=
''
¶ A String specifying the name of the FilmConditionProp object associated with this interaction. The interactionProperty argument applies only when definition = PROPERTY_REF. The default value is an empty string.
- sinkTemperature=
0
¶ A Float specifying the reference sink temperature, θ0θ0. The default value is 0.0.
- sinkAmplitude=
''
¶ A String specifying the name of the Amplitude object that gives the variation of the sink temperature, θ0θ0, with time. The default value is an empty string. Note: Use empty string in an Abaqus/Standard analysis to specify that the reference sink temperature is applied immediately at the beginning of the step or linearly over the step. Use empty string in an Abaqus/Explicit analysis to specify that the reference sink temperature is applied throughout the step.
- filmCoeff=
0
¶ A Float specifying the reference film coefficient value, hh. The filmCoeff argument applies when definition = EMBEDDED_COEFF, definition = USER_SUB, or definition = FIELD. The default value is 0.0.
- filmCoeffAmplitude=
''
¶ A String specifying the name of the Amplitude object that gives the variation of the film coefficient, hh, with time. The default value is an empty string. Note: Use empty string in an Abaqus/Standard analysis to specify that the reference film coefficient is applied immediately at the beginning of the step or linearly over the step. Use empty string in an Abaqus/Explicit analysis to specify that the reference film coefficient is applied throughout the step.
- field=
''
¶ A String specifying the name of the AnalyticalField object associated with this interaction. The field argument applies only when definition = FIELD. The default value is an empty string.
- sinkFieldName=
''
¶ A String specifying the name of the AnalyticalField or DiscreteField object associated with the sink temperature. The sinkFieldName argument applies only when sinkDistributionType = ANALYTICAL_FIELD or sinkDistributionType = DISCRETE_FIELD. The default value is an empty string.
- sinkDistributionType=
UNIFORM
¶ A SymbolicConstant specifying how the sink temperature is distributed. Possible values are UNIFORM, ANALYTICAL_FIELD, and DISCRETE_FIELD. The default value is UNIFORM.
- interactionProperty=
- setValuesInStep(stepName)[source]¶
This method modifies the propagating data of an existing FilmCondition object in the specified step.
-
sinkAmplitude : --is-rst--:py:class:`str` =
''
[source]¶ A String specifying the name of the Amplitude object that gives the variation of the sink temperature, θ0θ0, with time. The default value is an empty string. Note: Use empty string in an Abaqus/Standard analysis to specify that the reference sink temperature is applied immediately at the beginning of the step or linearly over the step. Use empty string in an Abaqus/Explicit analysis to specify that the reference sink temperature is applied throughout the step.
-
sinkDistributionType : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` =
'UNIFORM'
[source]¶ A SymbolicConstant specifying how the sink temperature is distributed. Possible values are UNIFORM, ANALYTICAL_FIELD, and DISCRETE_FIELD. The default value is UNIFORM.
-
sinkFieldName : --is-rst--:py:class:`str` =
''
[source]¶ A String specifying the name of the AnalyticalField or DiscreteField object associated with the sink temperature. The sinkFieldName argument applies only when sinkDistributionType = ANALYTICAL_FIELD or sinkDistributionType = DISCRETE_FIELD. The default value is an empty string.
-
class FilmConditionProp(name, temperatureDependency=
0
, dependencies=0
, property=()
)[source]¶ Bases:
ContactProperty
The FilmConditionProp object is an interaction property that defines a film coefficient as a function of temperature and field variables. The FilmConditionProp object is derived from the InteractionProperty object.
Note
This object can be accessed by:
import interaction mdb.models[name].interactionProperties[name]
The corresponding analysis keywords are:
FILM PROPERTY
Note
Member Details:
-
dependencies : --is-rst--int =
0
[source]¶ An Int specifying the number of field variable dependencies. The default value is 0.
-
property : --is-rst--tuple[tuple[float, ...], ...] =
()
[source]¶ A sequence of sequences of Floats specifying the following:
The film coefficient, hh.
Temperature, if the data depend on temperature.
Value of the first field variable, if the data depend on field variables.
Value of the second field variable.
Etc.
-
setValues(temperatureDependency=
0
, dependencies=0
, property=()
)[source]¶ This method modifies the FilmConditionProp object.
Note
- Parameters:¶
- temperatureDependency=
0
¶ A Boolean specifying whether the data depend on temperature. The default value is OFF.
- dependencies=
0
¶ An Int specifying the number of field variable dependencies. The default value is 0.
- property=
()
¶ A sequence of sequences of Floats specifying the following:
The film coefficient, hh.
Temperature, if the data depend on temperature.
Value of the first field variable, if the data depend on field variables.
Value of the second field variable.
Etc.
- temperatureDependency=
- class FilmConditionState[source]¶
Bases:
InteractionState
The FilmConditionState object stores the propagating data for a FilmCondition object. One instance of this object is created internally by the FilmCondition object for each step. The instance is also deleted internally by the FilmCondition object. The FilmConditionState object has no constructor or methods. The FilmConditionState object is derived from the InteractionState object.
Note
This object can be accessed by:
import interaction mdb.models[name].steps[name].interactionStates[name]
The corresponding analysis keywords are:
SFILM
FILM
Note
Member Details:
-
filmCoeff : --is-rst--:py:class:`float` | :py:obj:`None` =
None
[source]¶ A Float specifying the film coefficient.
-
filmCoeffAmplitude : --is-rst--:py:class:`str` =
''
[source]¶ A String specifying the name of the Amplitude object that gives the variation of the film coefficient.
- filmCoeffAmplitudeState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶
A SymbolicConstant specifying the propagation state of the filmCoeffAmplitude member. Possible values are UNSET, SET, UNCHANGED, and FREED.
- filmCoeffState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶
A SymbolicConstant specifying the propagation state of the filmCoeff member. Possible values are UNSET, SET, UNCHANGED, and FREED.
-
interactionProperty : --is-rst--:py:class:`str` =
''
[source]¶ A String specifying the FilmConditionProp object associated with this interaction.
- interactionPropertyState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶
A SymbolicConstant specifying the propagation state of the interactionProperty member. Possible values are UNSET, SET, UNCHANGED, and FREED.
-
sinkAmplitude : --is-rst--:py:class:`str` =
''
[source]¶ A String specifying the name of the Amplitude object that gives the variation of the sink temperature.
- sinkAmplitudeState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶
A SymbolicConstant specifying the propagation state of the sinkAmplitude member. Possible values are UNSET, SET, UNCHANGED, and FREED.
-
sinkTemperature : --is-rst--:py:class:`float` | :py:obj:`None` =
None
[source]¶ A Float specifying the sink temperature.
- sinkTemperatureState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶
A SymbolicConstant specifying the propagation state of the sinkTemperature member. Possible values are UNSET, SET, UNCHANGED, and FREED.
- status : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶
A SymbolicConstant specifying the propagation state of the InteractionState object. Possible values are:
NOT_YET_ACTIVE
CREATED
PROPAGATED
MODIFIED
DEACTIVATED
NO_LONGER_ACTIVE
TYPE_NOT_APPLICABLE
INSTANCE_NOT_APPLICABLE
BUILT_INTO_BASE_STATE
- class FluidCavity(
- name,
- createStepName,
- cavityPoint,
- cavitySurface,
- interactionProperty,
- ambientPressure=
0
, - thickness=
1
, - useAdiabatic=
0
, - checkNormals=
1
, Bases:
Interaction
The FluidCavity object defines a surface-based cavity. The FluidCavity object is derived from the Interaction object.
Note
This object can be accessed by:
import interaction mdb.models[name].interactions[name]
The corresponding analysis keywords are:
FLUID CAVITY
Note
Member Details:
-
ambientPressure : --is-rst--:py:class:`float` =
0
[source]¶ A Float specifying the magnitude of the ambient pressure. The default value is 0.0.
- cavityPoint : --is-rst--:py:class:`~abaqus.Region.Region.Region`[source]¶
A Region object specifying the fluid cavity reference point.
- cavitySurface : --is-rst--:py:class:`~abaqus.Region.Region.Region`[source]¶
A Region object specifying the surface forming the boundary of the fluid cavity.
-
checkNormals : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] =
1
[source]¶ A Boolean specifying whether the analysis will check the consistency of the surface normals. The default value is ON.
- createStepName : --is-rst--:py:class:`str`[source]¶
A String specifying the name of the step in which the FluidCavity object is created.
- interactionProperty : --is-rst--:py:class:`str`[source]¶
A String specifying the FluidCavityProperty object associated with this interaction.
-
setValues(ambientPressure=
0
, thickness=1
, useAdiabatic=0
, checkNormals=1
)[source]¶ This method modifies the FluidCavity object.
Note
- Parameters:¶
- ambientPressure=
0
¶ A Float specifying the magnitude of the ambient pressure. The default value is 0.0.
- thickness=
1
¶ A Float specifying the out-of-plane thickness of the surface for two-dimensional models. This argument is valid only when using two-dimensional models. The default value is 1.0.
- useAdiabatic=
0
¶ A Boolean specifying whether adiabatic behavior is assumed for the ideal gas. This argument is valid only when interactionProperty specifies a pneumatic definition. The default value is OFF.
- checkNormals=
1
¶ A Boolean specifying whether the analysis will check the consistency of the surface normals. The default value is ON.
- ambientPressure=
-
thickness : --is-rst--:py:class:`float` =
1
[source]¶ A Float specifying the out-of-plane thickness of the surface for two-dimensional models. This argument is valid only when using two-dimensional models. The default value is 1.0.
-
useAdiabatic : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] =
0
[source]¶ A Boolean specifying whether adiabatic behavior is assumed for the ideal gas. This argument is valid only when interactionProperty specifies a pneumatic definition. The default value is OFF.
- class FluidCavityProperty(
- name,
- definition=
HYDRAULIC
, - fluidDensity=
None
, - molecularWeight=
None
, - useExpansion=
0
, - expansionTempDep=
0
, - expansionDependencies=
0
, - referenceTemperature=
0
, - expansionTable=
()
, - useBulkModulus=
0
, - bulkModulusTempDep=
0
, - bulkModulusDependencies=
0
, - bulkModulusTable=
()
, - useCapacity=
0
, - capacityType=
POLYNOMIAL
, - capacityTempDep=
0
, - capacityDependencies=
0
, - capacityTable=
()
, Bases:
ContactProperty
The FluidCavityProperty object is an interaction property that defines the fluid behavior for a surface- based fluid cavity. The FluidCavityProperty object is derived from the InteractionProperty object.
Note
This object can be accessed by:
import interaction mdb.models[name].interactionProperties[name]
The corresponding analysis keywords are:
FLUID BEHAVIOR
CAPACITY
FLUID BULK MODULUS
FLUID DENSITY
FLUID EXPANSION
MOLECULAR WEIGHT
Note
Member Details:
-
bulkModulusDependencies : --is-rst--int =
0
[source]¶ An Int specifying the number of field variable dependencies in the fluid bulk modulus data. This argument is applicable only when definition = HYDRAULIC and when useBulkModulus = True. The default value is 0.
-
bulkModulusTable : --is-rst--tuple[tuple[float, ...], ...] =
()
[source]¶ A sequence of sequences of Floats specifying the fluid bulk modulus values. This argument is applicable only when definition = HYDRAULIC and when useBulkModulus = True. Each sequence contains the following data:
The fluid bulk modulus.
Temperature, if the data depend on temperature.
Value of the first field variable, if the data depend on field variables.
Value of the second field variable.
Etc.
-
bulkModulusTempDep : --is-rst--Boolean =
0
[source]¶ A Boolean specifying whether the fluid bulk modulus data will have temperature dependency. This argument is applicable only when definition = HYDRAULIC and when useBulkModulus = True. The default value is OFF.
-
capacityDependencies : --is-rst--int =
0
[source]¶ An Int specifying the number of field variable dependencies in the molar heat capacity data. This argument is applicable only when definition = PNEUMATIC, when useCapacity = True, and when capacityType = TABULAR. The default value is 0.
-
capacityTable : --is-rst--tuple[tuple[float, ...], ...] =
()
[source]¶ A sequence of sequences of Floats specifying the molar heat capacity values in the form of a polynomial expression. This argument is applicable only when definition = PNEUMATIC, when useCapacity = True, and when capacityType = POLYNOMIAL. In this form, only one sequence is specified and that sequence contains the following data:
The first molar heat capacity coefficient.
The second molar heat capacity coefficient.
The third molar heat capacity coefficient.
The fourth molar heat capacity coefficient.
The fifth molar heat capacity coefficient.
Alternatively, the sequence data may specify the molar heat capacity values at constant pressure for an ideal gas species. This argument is applicable only when definition = PNEUMATIC, when useCapacity = True, and when capacityType = TABULAR. Each sequence contains the following data:
The molar heat capacity at constant pressure.
Temperature, if the data depend on temperature.
Value of the first field variable, if the data depend on field variables.
Value of the second field variable.
Etc.
-
capacityTempDep : --is-rst--Boolean =
0
[source]¶ A Boolean specifying whether the molar heat capacity data will have temperature dependency. This argument is applicable only when definition = PNEUMATIC, when useCapacity = True, and when capacityType = TABULAR. The default value is OFF.
-
capacityType : --is-rst--SymbolicConstant =
'POLYNOMIAL'
[source]¶ A SymbolicConstant specifying the method to define the molar heat capacity. Possible values are POLYNOMIAL and TABULAR. The default value is POLYNOMIAL.
-
definition : --is-rst--SymbolicConstant =
'HYDRAULIC'
[source]¶ A SymbolicConstant specifying the type of fluid cavity property to be defined. Possible values are HYDRAULIC and PNEUMATIC. The default value is HYDRAULIC.
-
expansionDependencies : --is-rst--int =
0
[source]¶ An Int specifying the number of field variable dependencies in the thermal fluid expansion data. This argument is applicable only when definition = HYDRAULIC and when useExpansion = True. The default value is 0.
-
expansionTable : --is-rst--tuple[tuple[float, ...], ...] =
()
[source]¶ A sequence of sequences of Floats specifying the thermal expansion coefficients. This argument is applicable only when definition = HYDRAULIC and when useExpansion = True. Each sequence contains the following data:
The mean coefficient of thermal expansion.
Temperature, if the data depend on temperature.
Value of the first field variable, if the data depend on field variables.
Value of the second field variable.
Etc.
-
expansionTempDep : --is-rst--Boolean =
0
[source]¶ A Boolean specifying whether the thermal fluid expansion data will have temperature dependency. This argument is applicable only when definition = HYDRAULIC and when useExpansion = True. The default value is OFF.
-
fluidDensity : --is-rst--float | None =
None
[source]¶ None or a Float specifying the reference fluid density. This argument is applicable only when definition = HYDRAULIC, and is required in that case. The default value is None.
-
molecularWeight : --is-rst--float | None =
None
[source]¶ None or a Float specifying the molecular weight of the ideal gas species. This argument is applicable only when definition = PNEUMATIC, and is required in that case. The default value is None.
-
referenceTemperature : --is-rst--float =
0
[source]¶ A Float specifying the reference temperature for the coefficient of thermal expansion. This argument is applicable only when definition = HYDRAULIC, when useExpansion = True, and when either expansionTempDep = True or when expansionDependencies is greater than 0. The default value is 0.0.
- setValues(
- definition=
HYDRAULIC
, - fluidDensity=
None
, - molecularWeight=
None
, - useExpansion=
0
, - expansionTempDep=
0
, - expansionDependencies=
0
, - referenceTemperature=
0
, - expansionTable=
()
, - useBulkModulus=
0
, - bulkModulusTempDep=
0
, - bulkModulusDependencies=
0
, - bulkModulusTable=
()
, - useCapacity=
0
, - capacityType=
POLYNOMIAL
, - capacityTempDep=
0
, - capacityDependencies=
0
, - capacityTable=
()
, This method modifies the FluidCavityProperty object.
- Parameters:¶
- definition=
HYDRAULIC
¶ A SymbolicConstant specifying the type of fluid cavity property to be defined. Possible values are HYDRAULIC and PNEUMATIC. The default value is HYDRAULIC.
- fluidDensity=
None
¶ None or a Float specifying the reference fluid density. This argument is applicable only when definition = HYDRAULIC, and is required in that case. The default value is None.
- molecularWeight=
None
¶ None or a Float specifying the molecular weight of the ideal gas species. This argument is applicable only when definition = PNEUMATIC, and is required in that case. The default value is None.
- useExpansion=
0
¶ A Boolean specifying whether thermal expansion coefficients will be defined. This argument is applicable only when definition = HYDRAULIC. The default value is OFF.
- expansionTempDep=
0
¶ A Boolean specifying whether the thermal fluid expansion data will have temperature dependency. This argument is applicable only when definition = HYDRAULIC and when useExpansion = True. The default value is OFF.
- expansionDependencies=
0
¶ An Int specifying the number of field variable dependencies in the thermal fluid expansion data. This argument is applicable only when definition = HYDRAULIC and when useExpansion = True. The default value is 0.
- referenceTemperature=
0
¶ A Float specifying the reference temperature for the coefficient of thermal expansion. This argument is applicable only when definition = HYDRAULIC, when useExpansion = True, and when either expansionTempDep = True or when expansionDependencies is greater than 0. The default value is 0.0.
- expansionTable=
()
¶ A sequence of sequences of Floats specifying the thermal expansion coefficients. This argument is applicable only when definition = HYDRAULIC and when useExpansion = True. Each sequence contains the following data:
The mean coefficient of thermal expansion.
Temperature, if the data depend on temperature.
Value of the first field variable, if the data depend on field variables.
Value of the second field variable.
Etc.
- useBulkModulus=
0
¶ A Boolean specifying whether fluid bulk modulus values will be defined. This argument is applicable only when definition = HYDRAULIC. The default value is OFF.
- bulkModulusTempDep=
0
¶ A Boolean specifying whether the fluid bulk modulus data will have temperature dependency. This argument is applicable only when definition = HYDRAULIC and when useBulkModulus = True. The default value is OFF.
- bulkModulusDependencies=
0
¶ An Int specifying the number of field variable dependencies in the fluid bulk modulus data. This argument is applicable only when definition = HYDRAULIC and when useBulkModulus = True. The default value is 0.
- bulkModulusTable=
()
¶ A sequence of sequences of Floats specifying the fluid bulk modulus values. This argument is applicable only when definition = HYDRAULIC and when useBulkModulus = True. Each sequence contains the following data:
The fluid bulk modulus.
Temperature, if the data depend on temperature.
Value of the first field variable, if the data depend on field variables.
Value of the second field variable.
Etc.
- useCapacity=
0
¶ A Boolean specifying whether molar heat capacity values will be defined. This argument is applicable only when definition = PNEUMATIC. The default value is OFF.
- capacityType=
POLYNOMIAL
¶ A SymbolicConstant specifying the method to define the molar heat capacity. Possible values are POLYNOMIAL and TABULAR. The default value is POLYNOMIAL.
- capacityTempDep=
0
¶ A Boolean specifying whether the molar heat capacity data will have temperature dependency. This argument is applicable only when definition = PNEUMATIC, when useCapacity = True, and when capacityType = TABULAR. The default value is OFF.
- capacityDependencies=
0
¶ An Int specifying the number of field variable dependencies in the molar heat capacity data. This argument is applicable only when definition = PNEUMATIC, when useCapacity = True, and when capacityType = TABULAR. The default value is 0.
- capacityTable=
()
¶ A sequence of sequences of Floats specifying the molar heat capacity values in the form of a polynomial expression. This argument is applicable only when definition = PNEUMATIC, when useCapacity = True, and when capacityType = POLYNOMIAL. In this form, only one sequence is specified and that sequence contains the following data:
The first molar heat capacity coefficient.
The second molar heat capacity coefficient.
The third molar heat capacity coefficient.
The fourth molar heat capacity coefficient.
The fifth molar heat capacity coefficient.
Alternatively, the sequence data may specify the molar heat capacity values at constant pressure for an ideal gas species. This argument is applicable only when definition = PNEUMATIC, when useCapacity = True, and when capacityType = TABULAR. Each sequence contains the following data:
The molar heat capacity at constant pressure.
Temperature, if the data depend on temperature.
Value of the first field variable, if the data depend on field variables.
Value of the second field variable.
Etc.
- definition=
-
useBulkModulus : --is-rst--Boolean =
0
[source]¶ A Boolean specifying whether fluid bulk modulus values will be defined. This argument is applicable only when definition = HYDRAULIC. The default value is OFF.
- class FluidCavityState[source]¶
Bases:
InteractionState
The FluidCavityState object stores the propagating data for an FluidCavity object. One instance of this object is created internally by the FluidCavity object for each step. The instance is also deleted internally by the FluidCavity object. The FluidCavityState object has no constructor or methods. The FluidCavityState object is derived from the InteractionState object.
Note
This object can be accessed by:
import interaction mdb.models[name].steps[name].interactionStates[name]
Note
Member Details:
- status : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶
A SymbolicConstant specifying the propagation state of the InteractionState object. Possible values are:
NOT_YET_ACTIVE
CREATED
PROPAGATED
MODIFIED
DEACTIVATED
NO_LONGER_ACTIVE
TYPE_NOT_APPLICABLE
INSTANCE_NOT_APPLICABLE
BUILT_INTO_BASE_STATE
- class FluidExchange(
- name,
- createStepName,
- firstCavity,
- interactionProperty,
- definition=
TO_ENVIRONMENT
, - secondCavity=
''
, - exchangeArea=
1
, Bases:
Interaction
The FluidExchange object is used to define fluid exchange between two fluid cavities or between a fluid cavity and its environment. The FluidExchange object is derived from the Interaction object.
Note
This object can be accessed by:
import interaction mdb.models[name].interactions[name]
The corresponding analysis keywords are:
FLUID EXCHANGE
Note
Member Details:
- createStepName : --is-rst--:py:class:`str`[source]¶
A String specifying the name of the step in which the FluidExchange object is created.
-
definition : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` =
'TO_ENVIRONMENT'
[source]¶ A SymbolicConstant specifying the type of fluid exchange to be defined. Possible values are TO_ENVIRONMENT and BETWEEN_CAVITIES. The default value is TO_ENVIRONMENT.
-
exchangeArea : --is-rst--:py:class:`float` =
1
[source]¶ A Float specifying the effective exchange area. The default value is 1.0.
- firstCavity : --is-rst--:py:class:`str`[source]¶
A String specifying the first FluidCavity object associated with this interaction. This will be the only cavity specified if definition = TO_ENVIRONMENT.
- interactionProperty : --is-rst--:py:class:`str`[source]¶
A String specifying the FluidExchangeProperty object associated with this interaction.
-
secondCavity : --is-rst--:py:class:`str` =
''
[source]¶ A String specifying the second FluidCavity object associated with this interaction. This argument is applicable only when definition = BETWEEN_CAVITIES.
-
setValues(definition=
TO_ENVIRONMENT
, secondCavity=''
, exchangeArea=1
)[source]¶ This method modifies the FluidExchange object.
Note
- Parameters:¶
- definition=
TO_ENVIRONMENT
¶ A SymbolicConstant specifying the type of fluid exchange to be defined. Possible values are TO_ENVIRONMENT and BETWEEN_CAVITIES. The default value is TO_ENVIRONMENT.
- secondCavity=
''
¶ A String specifying the second FluidCavity object associated with this interaction. This argument is applicable only when definition = BETWEEN_CAVITIES.
- exchangeArea=
1
¶ A Float specifying the effective exchange area. The default value is 1.0.
- definition=
- class FluidExchangeProperty(
- name,
- dataTable,
- definition=
BULK_VISCOSITY
, - pressureDependency=
0
, - temperatureDependency=
0
, - fieldDependencies=
0
, Bases:
ContactProperty
The FluidExchangeProperty object is an interaction property that defines the fluid exchange property for a flow between two fluid cavities or between a fluid cavity and its environment. The FluidExchangeProperty object is derived from the InteractionProperty object.
Note
This object can be accessed by:
import interaction mdb.models[name].interactionProperties[name]
The corresponding analysis keywords are:
FLUID EXCHANGE PROPERTY
Note
Member Details:
-
dataTable : --is-rst--tuple[tuple[float, ...], ...] =
()
[source]¶ A sequence of sequences of Floats specifying the viscous and hydrodynamic resistance coefficients when definition = BULK_VISCOSITY. Each sequence contains the following data:
The viscous resistance coefficient.
The hydrodynamic resistance coefficient.
The average absolute pressure, if the data depend on pressure.
The average temperature, if the data depend on temperature.
The value of the first field variable, if the data depend on field variables.
The value of the second field variable.
Etc.
Alternatively, the sequence data may specify the mass flow rate. This is applicable only when definition = MASS_FLUX. In this form, only one sequence is specified and that sequence contains the following data:
The mass flow rate per unit area.
Alternatively, the sequence data may specify the mass rate leakage. This is applicable only when definition = MASS_RATE_LEAK. Each sequence contains the following data:
The absolute value of the mass flow rate per unit area. (The first tabular value entered must always be zero.)
The absolute value of the pressure difference. (The first tabular value entered must always be zero.)
The average absolute pressure, if the data depend on pressure.
The average temperature, if the data depend on temperature.
The value of the first field variable, if the data depend on field variables.
The value of the second field variable.
Etc.
Alternatively, the sequence data may specify the volume flow rate. This is applicable only when definition = VOL_FLUX. In this form, only one sequence is specified and that sequence contains the following data:
The volumetric flow rate per unit area.
Alternatively, the sequence data may specify the volume rate leakage. This is applicable only when definition = VOL_RATE_LEAK. Each sequence contains the following data:
The absolute value of the volumetric flow rate per unit area. (The first tabular value entered must always be zero.)
The absolute value of the pressure difference. (The first tabular value entered must always be zero.)
The average absolute pressure, if the data depend on pressure.
The average temperature, if the data depend on temperature.
The value of the first field variable, if the data depend on field variables.
The value of the second field variable.
Etc.
-
definition : --is-rst--SymbolicConstant =
'BULK_VISCOSITY'
[source]¶ A SymbolicConstant specifying the type of fluid exchange property to be defined. Possible values are BULK_VISCOSITY, MASS_FLUX, MASS_RATE_LEAK, VOL_FLUX, and VOL_RATE_LEAK. The default value is BULK_VISCOSITY.
-
fieldDependencies : --is-rst--int =
0
[source]¶ An Int specifying the number of field variable dependencies in the data. This argument is applicable only when definition = BULK_VISCOSITY, or when definition = MASS_RATE_LEAK, or when definition = VOL_RATE_LEAK. The default value is 0.
-
pressureDependency : --is-rst--Boolean =
0
[source]¶ A Boolean specifying whether the data will have pressure dependency. This argument is applicable only when definition = BULK_VISCOSITY, or when definition = MASS_RATE_LEAK, or when definition = VOL_RATE_LEAK. The default value is OFF.
- setValues(
- definition=
BULK_VISCOSITY
, - pressureDependency=
0
, - temperatureDependency=
0
, - fieldDependencies=
0
, This method modifies the FluidExchangeProperty object.
- Parameters:¶
- definition=
BULK_VISCOSITY
¶ A SymbolicConstant specifying the type of fluid exchange property to be defined. Possible values are BULK_VISCOSITY, MASS_FLUX, MASS_RATE_LEAK, VOL_FLUX, and VOL_RATE_LEAK. The default value is BULK_VISCOSITY.
- pressureDependency=
0
¶ A Boolean specifying whether the data will have pressure dependency. This argument is applicable only when definition = BULK_VISCOSITY, or when definition = MASS_RATE_LEAK, or when definition = VOL_RATE_LEAK. The default value is OFF.
- temperatureDependency=
0
¶ A Boolean specifying whether the data will have temperature dependency. This argument is applicable only when definition = BULK_VISCOSITY, or when definition = MASS_RATE_LEAK, or when definition = VOL_RATE_LEAK. The default value is OFF.
- fieldDependencies=
0
¶ An Int specifying the number of field variable dependencies in the data. This argument is applicable only when definition = BULK_VISCOSITY, or when definition = MASS_RATE_LEAK, or when definition = VOL_RATE_LEAK. The default value is 0.
- definition=
- class FluidExchangeState[source]¶
Bases:
InteractionState
The FluidExchangeState object stores the propagating data for an FluidExchange object. One instance of this object is created internally by the FluidExchange object for each step. The instance is also deleted internally by the FluidExchange object. The FluidExchangeState object has no constructor or methods. The FluidExchangeState object is derived from the InteractionState object.
Note
This object can be accessed by:
import interaction mdb.models[name].steps[name].interactionStates[name]
Note
Member Details:
- status : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶
A SymbolicConstant specifying the propagation state of the InteractionState object. Possible values are:
NOT_YET_ACTIVE
CREATED
PROPAGATED
MODIFIED
DEACTIVATED
NO_LONGER_ACTIVE
TYPE_NOT_APPLICABLE
INSTANCE_NOT_APPLICABLE
BUILT_INTO_BASE_STATE
- class FluidInflator( )[source]¶
Bases:
Interaction
The FluidInflator object is used to define a fluid inflator to model deployment of an airbag. The FluidInflator object is derived from the Interaction object.
Note
This object can be accessed by:
import interaction mdb.models[name].interactions[name]
The corresponding analysis keywords are:
FLUID INFLATOR
Added in version 2019: The
FluidInflator
class was added.Note
Member Details:
-
setValues(inflationTimeAmplitude=
''
, massFlowAmplitude=''
)[source]¶ This method modifies the FluidInflator object.
Note
- class FluidInflatorProperty(
- name,
- definition,
- effectiveArea,
- tankVolume,
- dischargeCoefficient=
None
, - dataTable=
()
, - numFluids=
None
, - mixtureType=
''
, - inflationTime=
()
, - fluidbehaviorName=
()
, - massFraction=
()
, Bases:
ContactProperty
The FluidInflatorProperty object is an interaction property that defines a fluid inflator property to model the deployment of an airbag. The inflator property defines the mass flow rate and temperature as a function of inflation time either directly or by entering tank test data. It also defines the mixture of gases entering the fluid cavity. The FluidInflatorProperty object is derived from the InteractionProperty object.
Note
This object can be accessed by:
import interaction mdb.models[name].interactionProperties[name]
The table data for this object are:
If definition = DUAL PRESSURE, the table data specify the following:
Inflation time.
Inflator pressure.
Tank pressure.
If definition = PRESSURE AND MASS, the table data specify the following:
Inflation time.
Inflator pressure.
Inflator mass flow rate.
If definition = TANK TEST, the table data specify the following:
Inflation time.
Inflator gas temperature.
Tank pressure.
If definition = TEMPERATURE AND MASS, the table data specify the following:
Inflation time.
Inflator gas temperature.
Inflator mass flow rate.
The corresponding analysis keywords are:
FLUID INFLATOR PROPERTY
Added in version 2019: The
FluidInflatorProperty
class was added.Note
Member Details:
- setValues(
- dischargeCoefficient=
None
, - dataTable=
()
, - numFluids=
None
, - mixtureType=
''
, - inflationTime=
()
, - fluidbehaviorName=
()
, - massFraction=
()
, This method modifies the FluidInflatorProperty object.
- Parameters:¶
- dischargeCoefficient=
None
¶ A Float specifying the discharge coefficient. This argument is applicable only if definition = DUAL PRESSURE or definition = PRESSURE AND MASS.
- dataTable=
()
¶ A sequence of sequences of Floats specifying the items described in the “Table data” section below.
- numFluids=
None
¶ An Int specifying the number of gas species used for this inflator.
- mixtureType=
''
¶ A Symbolic constant specifying whether to use mass fraction or the molar fraction for a mixture of ideal gases. The default value is MASS FRACTION. The possible values are MASS FRACTION or MOLAR FRACTION.
- inflationTime=
()
¶ A sequence of sequences of Floats specifying the inflation time.
- fluidbehaviorName=
()
¶ A sequence of sequences of Strings specifying fluid behavior names.
- massFraction=
()
¶ A sequence of sequences of Floats specifying the mass fraction or the molar fraction corresponding to entered fluid behavior.
- dischargeCoefficient=
- class FluidInflatorState[source]¶
Bases:
InteractionState
The FluidInflatorState object stores the propagating data for a FluidInflator object. One instance of this object is created internally by the FluidInflator object for each step. The instance is also deleted internally by the FluidInflator object. The FluidInflatorState object has no constructor or methods. The FluidInflatorState object is derived from the InteractionState object.
Note
This object can be accessed by:
import interaction mdb.models[name].steps[name].interactionStates[name]
Added in version 2019: The
FluidInflatorState
class was added.Note
Member Details:
- status : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶
A SymbolicConstant specifying the propagation state of the InteractionState object. Possible values are:
NOT_YET_ACTIVE
CREATED
PROPAGATED
MODIFIED
DEACTIVATED
NO_LONGER_ACTIVE
TYPE_NOT_APPLICABLE
INSTANCE_NOT_APPLICABLE
BUILT_INTO_BASE_STATE
- class IncidentWave(
- name,
- createStepName,
- sourcePoint,
- standoffPoint,
- surface,
- interactionProperty,
- definition=
PRESSURE
, - amplitude=
''
, - imaginaryAmplitude=
''
, - surfaceNormal=
()
, - initialDepth=
None
, - referenceMagnitude=
None
, - detonationTime=
None
, - magnitudeFactor=
1
, Bases:
Interaction
The IncidentWave object defines incident wave interactions for acoustic and coupled acoustic-structural analyses. The IncidentWave object is derived from the Interaction object.
Note
This object can be accessed by:
import interaction mdb.models[name].interactions[name]
The corresponding analysis keywords are:
INCIDENT WAVE INTERACTION
Note
Member Details:
-
amplitude : --is-rst--:py:class:`str` =
''
[source]¶ A String specifying the name of the Amplitude object that defines the fluid pressure time history at the standoff point, if definition = PRESSURE. If definition = ACCELERATION, then this string specifies the name of the Amplitude object that defines the fluid particle acceleration time history at the standoff point. This member can be specified only if definition = PRESSURE or ACCELERATION. The default value is an empty string.
- createStepName : --is-rst--:py:class:`str`[source]¶
A String specifying the name of the step in which the IncidentWave object is created.
-
definition : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` =
'PRESSURE'
[source]¶ A SymbolicConstant specifying the type of incident wave to be defined. The value must be PRESSURE for linear perturbation steps. An Explicit step is required when the value is set to CONWEP. Possible values are PRESSURE, ACCELERATION, UNDEX, and CONWEP. The default value is PRESSURE.
-
detonationTime : --is-rst--:py:class:`float` | :py:obj:`None` =
None
[source]¶ A Float specifying the time of detonation, given in total time.This argument is valid only when definition = CONWEP.
-
imaginaryAmplitude : --is-rst--:py:class:`str` =
''
[source]¶ A String specifying the name of the Amplitude object that defines the imaginary component of the fluid pressure time history at the standoff point. This member is applicable only for linear perturbation steps and if definition = PRESSURE. The default value is an empty string.
-
initialDepth : --is-rst--:py:class:`float` | :py:obj:`None` =
None
[source]¶ None or a Float specifying the initial depth of the UNDEX bubble. The default value is None.This argument is valid only when definition = UNDEX.
- interactionProperty : --is-rst--:py:class:`str`[source]¶
A String specifying the IncidentWaveProperty object associated with this interaction.
-
magnitudeFactor : --is-rst--:py:class:`float` =
1
[source]¶ A Float specifying the magnitude scale factor. The default value is 1.0.This argument is valid only when definition = CONWEP.
-
referenceMagnitude : --is-rst--:py:class:`float` | :py:obj:`None` =
None
[source]¶ A Float specifying the reference magnitude.This argument is not valid when definition = CONWEP.
- setValues(
- definition=
PRESSURE
, - amplitude=
''
, - imaginaryAmplitude=
''
, - surfaceNormal=
()
, - initialDepth=
None
, - referenceMagnitude=
None
, - detonationTime=
None
, - magnitudeFactor=
1
, This method modifies the IncidentWave object.
Note
- Parameters:¶
- definition=
PRESSURE
¶ A SymbolicConstant specifying the type of incident wave to be defined. The value must be PRESSURE for linear perturbation steps. An Explicit step is required when the value is set to CONWEP. Possible values are PRESSURE, ACCELERATION, UNDEX, and CONWEP. The default value is PRESSURE.
- amplitude=
''
¶ A String specifying the name of the Amplitude object that defines the fluid pressure time history at the standoff point, if definition = PRESSURE. If definition = ACCELERATION, then this string specifies the name of the Amplitude object that defines the fluid particle acceleration time history at the standoff point. This member can be specified only if definition = PRESSURE or ACCELERATION. The default value is an empty string.
- imaginaryAmplitude=
''
¶ A String specifying the name of the Amplitude object that defines the imaginary component of the fluid pressure time history at the standoff point. This member is applicable only for linear perturbation steps and if definition = PRESSURE. The default value is an empty string.
- surfaceNormal=
()
¶ A sequence of three Floats specifying the X, Y, and Z components of the direction cosine of the fluid surface normal.This argument is valid only when definition = UNDEX.
- initialDepth=
None
¶ None or a Float specifying the initial depth of the UNDEX bubble. The default value is None.This argument is valid only when definition = UNDEX.
- referenceMagnitude=
None
¶ A Float specifying the reference magnitude.This argument is not valid when definition = CONWEP.
- detonationTime=
None
¶ A Float specifying the time of detonation, given in total time.This argument is valid only when definition = CONWEP.
- magnitudeFactor=
1
¶ A Float specifying the magnitude scale factor. The default value is 1.0.This argument is valid only when definition = CONWEP.
- definition=
- sourcePoint : --is-rst--:py:class:`~abaqus.Region.Region.Region`[source]¶
A Region object specifying the incident wave source point.
- standoffPoint : --is-rst--:py:class:`~abaqus.Region.Region.Region`[source]¶
A Region object specifying the incident wave standoff point.This argument is not valid when definition = CONWEP.
- surface : --is-rst--:py:class:`~abaqus.Region.Region.Region`[source]¶
A Region object specifying the surface defining the incident wave interaction. In problems involving fluid/surface boundaries, both the fluid surface and the solid surface comprising the boundary must have an incident wave interaction specified.
- class IncidentWaveProperty(
- name,
- definition=
PLANAR
, - propagationModel=
ACOUSTIC
, - soundSpeed=
None
, - fluidDensity=
None
, - specificHeatRatio=
None
, - gravity=
None
, - atmosphericPressure=
None
, - dragCoefficient=
None
, - dragExponent=
2
, - waveEffects=
1
, - chargeDensity=
None
, - chargeMass=
None
, - constantK1=
None
, - constantK2=
None
, - constantA=
None
, - constantB=
None
, - constantKc=
None
, - duration=
None
, - maximumSteps=
1500
, - relativeStepControl=
None
, - absoluteStepControl=
None
, - stepControlExponent=
0
, - genDecayA=
0
, - genDecayB=
0
, - genDecayC=
0
, - seedNumber=
None
, - massTNT=
None
, - massFactor=
1
, - lengthFactor=
1
, - timeFactor=
1
, - pressureFactor=
1
, Bases:
ContactProperty
The IncidentWaveProperty object is an interaction property that defines the properties referred to by an IncidentWave object. The IncidentWaveProperty object is derived from the InteractionProperty object.
Note
This object can be accessed by:
import interaction mdb.models[name].interactionProperties[name]
The corresponding analysis keywords are:
INCIDENT WAVE INTERACTION PROPERTY
UNDEX CHARGE PROPERTY
CONWEP CHARGE PROPERTY
Note
Member Details:
-
absoluteStepControl : --is-rst--float | None =
None
[source]¶ A Float specifying the absolute step size control parameter. The default value is 1x10⁻¹¹.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.
-
atmosphericPressure : --is-rst--float | None =
None
[source]¶ None or a Float specifying the atmospheric pressure. The default value is None.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.
-
chargeDensity : --is-rst--float | None =
None
[source]¶ None or a Float specifying the density of the charge material. The default value is None.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.
-
chargeMass : --is-rst--float | None =
None
[source]¶ None or a Float specifying the mass of the charge material. The default value is None.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.
-
constantA : --is-rst--float | None =
None
[source]¶ None or a Float specifying the charge material constant A. The default value is None.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.
-
constantB : --is-rst--float | None =
None
[source]¶ None or a Float specifying the charge material constant B. The default value is None.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.
-
constantK1 : --is-rst--float | None =
None
[source]¶ None or a Float specifying the charge material constant K. The default value is None.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.
-
constantK2 : --is-rst--float | None =
None
[source]¶ None or a Float specifying the charge material constant k. The default value is None.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.
-
constantKc : --is-rst--float | None =
None
[source]¶ None or a Float specifying the charge material constant Kc. The default value is None.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.
-
definition : --is-rst--SymbolicConstant =
'PLANAR'
[source]¶ A SymbolicConstant specifying the type of wave to be defined. Possible values are PLANAR, SPHERICAL, DIFFUSE, AIR_BLAST, and SURFACE_BLAST. The default value is PLANAR.
-
dragCoefficient : --is-rst--float | None =
None
[source]¶ None or a Float specifying the fluid drag coefficient. The default value is None.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.
-
dragExponent : --is-rst--float =
2
[source]¶ A Float specifying the fluid drag exponent. The default value is 2.0.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.
-
duration : --is-rst--float | None =
None
[source]¶ None or a Float specifying the time duration for the bubble simulation. The default value is None.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.
-
fluidDensity : --is-rst--float | None =
None
[source]¶ A Float specifying the fluid mass density.This argument is not valid when definition = AIR_BLAST or when definition = SURFACE_BLAST.
-
genDecayA : --is-rst--float =
0
[source]¶ A Float specifying the constant A associated with the generalized decay propagation model. The default value is 0.0.This argument is valid only when definition = SPHERICAL and propagationModel = GENERALIZED_DECAY.
-
genDecayB : --is-rst--float =
0
[source]¶ A Float specifying the constant B associated with the generalized decay propagation model. The default value is 0.0.This argument is valid only when definition = SPHERICAL and propagationModel = GENERALIZED_DECAY.
-
genDecayC : --is-rst--float =
0
[source]¶ A Float specifying the constant C associated with the generalized decay propagation model. The default value is 0.0.This argument is valid only when definition = SPHERICAL and propagationModel = GENERALIZED_DECAY.
-
gravity : --is-rst--float | None =
None
[source]¶ None or a Float specifying the acceleration due to gravity. The default value is None.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.
-
lengthFactor : --is-rst--float =
1
[source]¶ A Float specifying the multiplication factor to convert from the analysis length unit to meters. The default value is 1.0.This argument is valid only when definition = AIR_BLAST or definition = SURFACE_BLAST.
-
massFactor : --is-rst--float =
1
[source]¶ A Float specifying the multiplication factor to convert from the preferred mass unit to kilograms. The default value is 1.0.This argument is valid only when definition = AIR_BLAST or definition = SURFACE_BLAST.
-
massTNT : --is-rst--float | None =
None
[source]¶ A Float specifying the equivalent mass of TNT, in any preferred mass unit.This argument is valid only when definition = AIR_BLAST or definition = SURFACE_BLAST.
-
maximumSteps : --is-rst--int =
1500
[source]¶ An Int specifying the maximum number of time steps for the bubble simulation. The default value is 1500.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.
-
pressureFactor : --is-rst--float =
1
[source]¶ A Float specifying the multiplication factor to convert from the analysis pressure unit to pascals. The default value is 1.0.This argument is valid only when definition = AIR_BLAST or definition = SURFACE_BLAST.
-
propagationModel : --is-rst--SymbolicConstant =
'ACOUSTIC'
[source]¶ A SymbolicConstant specifying the spherical propagation model. Possible values are ACOUSTIC, UNDEX_CHARGE, and GENERALIZED_DECAY. The default value is ACOUSTIC.This argument is valid only when definition = SPHERICAL.
-
relativeStepControl : --is-rst--float | None =
None
[source]¶ A Float specifying the relative step size control parameter. The default value is 1x10⁻¹¹.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.
-
seedNumber : --is-rst--int | None =
None
[source]¶ An Int specifying the seed number (N) for the diffuse source calculation. N2 sources will be used in the simulation.This argument is valid only when definition = DIFFUSE.
- setValues(
- definition=
PLANAR
, - propagationModel=
ACOUSTIC
, - soundSpeed=
None
, - fluidDensity=
None
, - specificHeatRatio=
None
, - gravity=
None
, - atmosphericPressure=
None
, - dragCoefficient=
None
, - dragExponent=
2
, - waveEffects=
1
, - chargeDensity=
None
, - chargeMass=
None
, - constantK1=
None
, - constantK2=
None
, - constantA=
None
, - constantB=
None
, - constantKc=
None
, - duration=
None
, - maximumSteps=
1500
, - relativeStepControl=
None
, - absoluteStepControl=
None
, - stepControlExponent=
0
, - genDecayA=
0
, - genDecayB=
0
, - genDecayC=
0
, - seedNumber=
None
, - massTNT=
None
, - massFactor=
1
, - lengthFactor=
1
, - timeFactor=
1
, - pressureFactor=
1
, This method modifies the IncidentWaveProperty object.
- Parameters:¶
- definition=
PLANAR
¶ A SymbolicConstant specifying the type of wave to be defined. Possible values are PLANAR, SPHERICAL, DIFFUSE, AIR_BLAST, and SURFACE_BLAST. The default value is PLANAR.
- propagationModel=
ACOUSTIC
¶ A SymbolicConstant specifying the spherical propagation model. Possible values are ACOUSTIC, UNDEX_CHARGE, and GENERALIZED_DECAY. The default value is ACOUSTIC.This argument is valid only when definition = SPHERICAL.
- soundSpeed=
None
¶ A Float specifying the speed of sound in the fluid.This argument is not valid when definition = AIR_BLAST or when definition = SURFACE_BLAST.
- fluidDensity=
None
¶ A Float specifying the fluid mass density.This argument is not valid when definition = AIR_BLAST or when definition = SURFACE_BLAST.
- specificHeatRatio=
None
¶ None or a Float specifying the ratio of specific heats for gas. The default value is None.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.
- gravity=
None
¶ None or a Float specifying the acceleration due to gravity. The default value is None.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.
- atmosphericPressure=
None
¶ None or a Float specifying the atmospheric pressure. The default value is None.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.
- dragCoefficient=
None
¶ None or a Float specifying the fluid drag coefficient. The default value is None.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.
- dragExponent=
2
¶ A Float specifying the fluid drag exponent. The default value is 2.0.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.
- waveEffects=
1
¶ A Boolean specifying whether or not to include wave effects in the fluid and gas. The default value is ON.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.
- chargeDensity=
None
¶ None or a Float specifying the density of the charge material. The default value is None.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.
- chargeMass=
None
¶ None or a Float specifying the mass of the charge material. The default value is None.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.
- constantK1=
None
¶ None or a Float specifying the charge material constant K. The default value is None.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.
- constantK2=
None
¶ None or a Float specifying the charge material constant k. The default value is None.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.
- constantA=
None
¶ None or a Float specifying the charge material constant A. The default value is None.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.
- constantB=
None
¶ None or a Float specifying the charge material constant B. The default value is None.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.
- constantKc=
None
¶ None or a Float specifying the charge material constant Kc. The default value is None.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.
- duration=
None
¶ None or a Float specifying the time duration for the bubble simulation. The default value is None.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.
- maximumSteps=
1500
¶ An Int specifying the maximum number of time steps for the bubble simulation. The default value is 1500.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.
- relativeStepControl=
None
¶ A Float specifying the relative step size control parameter. The default value is 1x10⁻¹¹.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.
- absoluteStepControl=
None
¶ A Float specifying the absolute step size control parameter. The default value is 1x10⁻¹¹.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.
- stepControlExponent=
0
¶ A Float specifying the step size control exponent. The default value is 0.2.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.
- genDecayA=
0
¶ A Float specifying the constant A associated with the generalized decay propagation model. The default value is 0.0.This argument is valid only when definition = SPHERICAL and propagationModel = GENERALIZED_DECAY.
- genDecayB=
0
¶ A Float specifying the constant B associated with the generalized decay propagation model. The default value is 0.0.This argument is valid only when definition = SPHERICAL and propagationModel = GENERALIZED_DECAY.
- genDecayC=
0
¶ A Float specifying the constant C associated with the generalized decay propagation model. The default value is 0.0.This argument is valid only when definition = SPHERICAL and propagationModel = GENERALIZED_DECAY.
- seedNumber=
None
¶ An Int specifying the seed number (N) for the diffuse source calculation. N2 sources will be used in the simulation.This argument is valid only when definition = DIFFUSE.
- massTNT=
None
¶ A Float specifying the equivalent mass of TNT, in any preferred mass unit.This argument is valid only when definition = AIR_BLAST or definition = SURFACE_BLAST.
- massFactor=
1
¶ A Float specifying the multiplication factor to convert from the preferred mass unit to kilograms. The default value is 1.0.This argument is valid only when definition = AIR_BLAST or definition = SURFACE_BLAST.
- lengthFactor=
1
¶ A Float specifying the multiplication factor to convert from the analysis length unit to meters. The default value is 1.0.This argument is valid only when definition = AIR_BLAST or definition = SURFACE_BLAST.
- timeFactor=
1
¶ A Float specifying the multiplication factor to convert from the analysis time unit to seconds. The default value is 1.0.This argument is valid only when definition = AIR_BLAST or definition = SURFACE_BLAST.
- pressureFactor=
1
¶ A Float specifying the multiplication factor to convert from the analysis pressure unit to pascals. The default value is 1.0.This argument is valid only when definition = AIR_BLAST or definition = SURFACE_BLAST.
- definition=
-
soundSpeed : --is-rst--float | None =
None
[source]¶ A Float specifying the speed of sound in the fluid.This argument is not valid when definition = AIR_BLAST or when definition = SURFACE_BLAST.
-
specificHeatRatio : --is-rst--float | None =
None
[source]¶ None or a Float specifying the ratio of specific heats for gas. The default value is None.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.
-
stepControlExponent : --is-rst--float =
0
[source]¶ A Float specifying the step size control exponent. The default value is 0.2.This argument is valid only when definition = SPHERICAL and propagationModel = UNDEX_CHARGE.
- class IncidentWaveState[source]¶
Bases:
InteractionState
The IncidentWaveState object stores the propagating data of an IncidentWave object in a step. One instance of this object is created internally by the IncidentWave object for each step. The instance is also deleted internally by the IncidentWave object. The IncidentWaveState object has no constructor or methods. The IncidentWaveState object is derived from the InteractionState object.
Note
This object can be accessed by:
import interaction mdb.models[name].steps[name].interactionStates[name]
The corresponding analysis keywords are:
INCIDENT WAVE INTERACTION
Note
Member Details:
- status : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶
A SymbolicConstant specifying the propagation state of the InteractionState object. Possible values are:NOT_YET_ACTIVECREATEDPROPAGATEDMODIFIEDDEACTIVATEDNO_LONGER_ACTIVETYPE_NOT_APPLICABLEINSTANCE_NOT_APPLICABLEBUILT_INTO_BASE_STATE
- class StdContactControl(
- name,
- stiffnessScaleFactor=
1
, - penetrationTolChoice=
RELATIVE
, - relativePenetrationTolerance=
None
, - absolutePenetrationTolerance=
None
, - frictionOnset=
None
, - automaticTolerances=
0
, - maxchp=
0
, - perrmx=
0
, - uerrmx=
0
, - stabilizeChoice=
NONE
, - dampFactor=
1
, - dampCoef=
0
, - tangFraction=
1
, - eosFraction=
0
, - zeroDampingChoice=
COMPUTE
, - zeroDamping=
None
, - enforceWithLagrangeMultipliers=
DEFAULT
, Bases:
ContactControl
The StdContactControl object is used in Abaqus/Standard analyses to specify optional solution controls for problems involving contact between bodies. The StdContactControl object is derived from the ContactControl object.
Note
This object can be accessed by:
import interaction mdb.models[name].contactControls[name]
The corresponding analysis keywords are:
CONTACT CONTROLS
Note
Member Details:
-
absolutePenetrationTolerance : --is-rst--:py:class:`float` | :py:obj:`None` =
None
[source]¶ None or a Float specifying the allowable penetration. Only contact interactions defined with augmented Lagrangian surface behavior will be affected by this argument. The absolutePenetrationTolerance argument applies only when penetrationTolChoice = ABSOLUTE. The relativePenetrationTolerance and absolutePenetrationTolerance arguments are mutually exclusive. The default value is None.
-
automaticTolerances : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] =
0
[source]¶ A Boolean specifying whether Abaqus/Standard should automatically compute an overclosure tolerance and a separation tolerance to prevent chattering in contact. The default value is OFF.The automaticTolerances argument cannot be used with the maxchp, perrmx, and uerrmx arguments.
-
dampCoef : --is-rst--:py:class:`float` =
0
[source]¶ A Float specifying the damping coefficient. The default value is 0.0.This argument is only valid when stabilizeChoice = COEFFICIENT.
-
dampFactor : --is-rst--:py:class:`float` =
1
[source]¶ A Float specifying the value of the damping factor. This value is multiplied by the calculated damping coefficient. The default value is 1.0.This argument is only valid when stabilizeChoice = AUTOMATIC.
-
enforceWithLagrangeMultipliers : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` =
'DEFAULT'
[source]¶ A SymbolicConstant specifying whether to enforce the contact constraints with Lagrange multipliers. Possible values are DEFAULT, ENFORCEMENT_OFF, and ENFORCEMENT_ON. The default value is DEFAULT.
-
eosFraction : --is-rst--:py:class:`float` =
0
[source]¶ A Float specifying the fraction of the damping that remains at the end of the step. The default value is 0.0.This argument is valid only if stabilizeChoice = AUTOMATIC or COEFFICIENT.
- frictionOnset : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶
A SymbolicConstant specifying when the application of friction occurs. Possible values are:
IMMEDIATE, specifying the friction is included in the increment when contact occurs.
DELAYED, specifying the application of friction is delayed until the increment after
contact occurs.
-
maxchp : --is-rst--:py:class:`int` =
0
[source]¶ An Int specifying the maximum number of points that are permitted to violate contact conditions in any increment. The default value is 0.Either the perrmx or the uerrmx argument must be specified in conjunction with the maxchp argument.
-
penetrationTolChoice : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` =
'RELATIVE'
[source]¶ A SymbolicConstant specifying whether the allowable penetration is an absolute value or a value relative to the characteristic contact surface face dimension. Only contact interactions defined with augmented Lagrangian surface behavior will be affected by this argument. Possible values are RELATIVE and ABSOLUTE. The default value is RELATIVE.
-
perrmx : --is-rst--:py:class:`float` =
0
[source]¶ A Float specifying the maximum value of tensile stress (tensile force in GAP- or ITT-type contact elements) allowed to be transmitted at a contact point. The default value is 0.0.The perrmx argument must be specified in conjunction with the maxchp argument.
-
relativePenetrationTolerance : --is-rst--:py:class:`float` | :py:obj:`None` =
None
[source]¶ A Float specifying the ratio of the allowable penetration to the characteristic contact surface face dimension. The float values represent percentages (e.g.: 0.001=0.1%). Only contact interactions defined with augmented Lagrangian surface behavior will be affected by this argument. The default value is 10⁻³.The relativePenetrationTolerance argument applies only when penetrationTolChoice = RELATIVE. The relativePenetrationTolerance and absolutePenetrationTolerance arguments are mutually exclusive.
- setValues(
- stiffnessScaleFactor=
1
, - penetrationTolChoice=
RELATIVE
, - relativePenetrationTolerance=
None
, - absolutePenetrationTolerance=
None
, - frictionOnset=
None
, - automaticTolerances=
0
, - maxchp=
0
, - perrmx=
0
, - uerrmx=
0
, - stabilizeChoice=
NONE
, - dampFactor=
1
, - dampCoef=
0
, - tangFraction=
1
, - eosFraction=
0
, - zeroDampingChoice=
COMPUTE
, - zeroDamping=
None
, - enforceWithLagrangeMultipliers=
DEFAULT
, This method modifies the StdContactControl object.
Note
- Parameters:¶
- stiffnessScaleFactor=
1
¶ A Float specifying the factor by which Abaqus/Standard will scale the default penalty stiffness to obtain the stiffnesses used for the contact pairs. Only contact interactions defined with augmented Lagrangian surface behavior will be affected by this argument. The default value is 1.0.
- penetrationTolChoice=
RELATIVE
¶ A SymbolicConstant specifying whether the allowable penetration is an absolute value or a value relative to the characteristic contact surface face dimension. Only contact interactions defined with augmented Lagrangian surface behavior will be affected by this argument. Possible values are RELATIVE and ABSOLUTE. The default value is RELATIVE.
- relativePenetrationTolerance=
None
¶ A Float specifying the ratio of the allowable penetration to the characteristic contact surface face dimension. The float values represent percentages (e.g.: 0.001=0.1%). Only contact interactions defined with augmented Lagrangian surface behavior will be affected by this argument. The default value is 10⁻³.The relativePenetrationTolerance argument applies only when penetrationTolChoice = RELATIVE. The relativePenetrationTolerance and absolutePenetrationTolerance arguments are mutually exclusive.
- absolutePenetrationTolerance=
None
¶ None or a Float specifying the allowable penetration. Only contact interactions defined with augmented Lagrangian surface behavior will be affected by this argument. The absolutePenetrationTolerance argument applies only when penetrationTolChoice = ABSOLUTE. The relativePenetrationTolerance and absolutePenetrationTolerance arguments are mutually exclusive. The default value is None.
- frictionOnset=
None
¶ A SymbolicConstant specifying when the application of friction occurs. Possible values are:
IMMEDIATE, specifying the friction is included in the increment when contact occurs.
DELAYED, specifying the application of friction is delayed until the increment after contact occurs.
- automaticTolerances=
0
¶ A Boolean specifying whether Abaqus/Standard should automatically compute an overclosure tolerance and a separation tolerance to prevent chattering in contact. The default value is OFF.The automaticTolerances argument cannot be used with the maxchp, perrmx, and uerrmx arguments.
- maxchp=
0
¶ An Int specifying the maximum number of points that are permitted to violate contact conditions in any increment. The default value is 0.Either the perrmx or the uerrmx argument must be specified in conjunction with the maxchp argument.
- perrmx=
0
¶ A Float specifying the maximum value of tensile stress (tensile force in GAP- or ITT-type contact elements) allowed to be transmitted at a contact point. The default value is 0.0.The perrmx argument must be specified in conjunction with the maxchp argument.
- uerrmx=
0
¶ A Float specifying the maximum overclosure distance allowed at a secondary node that is considered to be open. The default value is 0.0.The uerrmx argument must be specified in conjunction with the maxchp argument.
Changed in version 2022: Slave node was changed to secondary node.
- stabilizeChoice=
NONE
¶ A SymbolicConstant specifying whether or not viscous damping will be specified, and if so, how it will be specified. Possible values are NONE, AUTOMATIC, and COEFFICIENT. The default value is NONE.
- dampFactor=
1
¶ A Float specifying the value of the damping factor. This value is multiplied by the calculated damping coefficient. The default value is 1.0.This argument is only valid when stabilizeChoice = AUTOMATIC.
- dampCoef=
0
¶ A Float specifying the damping coefficient. The default value is 0.0.This argument is only valid when stabilizeChoice = COEFFICIENT.
- tangFraction=
1
¶ A Float specifying the tangential stabilization as a fraction of the normal stabilization (damping). The default value is 1.0.This argument is valid only if stabilizeChoice = AUTOMATIC or COEFFICIENT.
- eosFraction=
0
¶ A Float specifying the fraction of the damping that remains at the end of the step. The default value is 0.0.This argument is valid only if stabilizeChoice = AUTOMATIC or COEFFICIENT.
- zeroDampingChoice=
COMPUTE
¶ A SymbolicConstant specifying how the zero-damping clearance will be specified. Possible values are COMPUTE and SPECIFY. The default value is COMPUTE.This argument is valid only if stabilizeChoice = AUTOMATIC or COEFFICIENT.
- zeroDamping=
None
¶ None or a Float specifying the clearance at which damping becomes zero. This argument is valid only when zeroDampingChoice = SPECIFY. This argument is valid only if stabilizeChoice = AUTOMATIC or COEFFICIENT. The default value is None.
- enforceWithLagrangeMultipliers=
DEFAULT
¶ A SymbolicConstant specifying whether to enforce the contact constraints with Lagrange multipliers. Possible values are DEFAULT, ENFORCEMENT_OFF, and ENFORCEMENT_ON. The default value is DEFAULT.
- stiffnessScaleFactor=
- Raises:¶
RangeError –
-
stabilizeChoice : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` =
'NONE'
[source]¶ A SymbolicConstant specifying whether or not viscous damping will be specified, and if so, how it will be specified. Possible values are NONE, AUTOMATIC, and COEFFICIENT. The default value is NONE.
-
stiffnessScaleFactor : --is-rst--:py:class:`float` =
1
[source]¶ A Float specifying the factor by which Abaqus/Standard will scale the default penalty stiffness to obtain the stiffnesses used for the contact pairs. Only contact interactions defined with augmented Lagrangian surface behavior will be affected by this argument. The default value is 1.0.
-
tangFraction : --is-rst--:py:class:`float` =
1
[source]¶ A Float specifying the tangential stabilization as a fraction of the normal stabilization (damping). The default value is 1.0.This argument is valid only if stabilizeChoice = AUTOMATIC or COEFFICIENT.
-
uerrmx : --is-rst--:py:class:`float` =
0
[source]¶ A Float specifying the maximum overclosure distance allowed at a secondary node that is considered to be open. The default value is 0.0.The uerrmx argument must be specified in conjunction with the maxchp argument.
Changed in version 2022: Slave node was changed to secondary node.
-
zeroDamping : --is-rst--:py:class:`float` | :py:obj:`None` =
None
[source]¶ None or a Float specifying the clearance at which damping becomes zero. This argument is valid only when zeroDampingChoice = SPECIFY. This argument is valid only if stabilizeChoice = AUTOMATIC or COEFFICIENT. The default value is None.
-
zeroDampingChoice : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` =
'COMPUTE'
[source]¶ A SymbolicConstant specifying how the zero-damping clearance will be specified. Possible values are COMPUTE and SPECIFY. The default value is COMPUTE.This argument is valid only if stabilizeChoice = AUTOMATIC or COEFFICIENT.
- class StdInitialization(
- name,
- overclosureType=
ADJUST
, - interferenceDistance=
None
, - clearanceDistance=
None
, - openingTolerance=
None
, - overclosureTolerance=
None
, Bases:
ContactInitialization
The StdInitialization object is used in conjunction with ContactStd in Abaqus/Standard analyses to specify contact initialization data. The StdInitialization object is derived from the ContactInitialization object.
Note
This object can be accessed by:
import interaction mdb.models[name].contactInitializations[name]
The corresponding analysis keywords are:
CONTACT INITIALIZATION DATA
Note
Member Details:
-
clearanceDistance : --is-rst--:py:class:`float` | :py:obj:`None` =
None
[source]¶ None or a Float specifying the initial clearance distance. This argument is valid only when overclosureType = CLEARANCE, and must be specified in that case. The default value is None.
-
interferenceDistance : --is-rst--:py:class:`float` | :py:obj:`None` =
None
[source]¶ None or a Float specifying the interference distance. This argument is valid only when overclosureType = INTERFERENCE. The default value is None.
- name : --is-rst--:py:class:`str`[source]¶
A String specifying the contact initialization repository key.
-
openingTolerance : --is-rst--:py:class:`float` | :py:obj:`None` =
None
[source]¶ None or a Float specifying the distance tolerance within which initial openings will undergo strain-free adjustments. This argument is not valid when overclosureType = INTERFERENCE unless a value has been specified for interferenceDistance. The default value is None.
-
overclosureTolerance : --is-rst--:py:class:`float` | :py:obj:`None` =
None
[source]¶ None or a Float specifying the distance tolerance within which initial overclosures will undergo strain-free adjustments.. The default value is None.
-
overclosureType : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` =
'ADJUST'
[source]¶ A SymbolicConstant specifying the type of overclosure to be defined. Possible values are ADJUST, INTERFERENCE, and CLEARANCE. The default value is ADJUST.
- setValues(
- overclosureType=
ADJUST
, - interferenceDistance=
None
, - clearanceDistance=
None
, - openingTolerance=
None
, - overclosureTolerance=
None
, This method modifies the StdInitialization object.
Note
- Parameters:¶
- overclosureType=
ADJUST
¶ A SymbolicConstant specifying the type of overclosure to be defined. Possible values are ADJUST, INTERFERENCE, and CLEARANCE. The default value is ADJUST.
- interferenceDistance=
None
¶ None or a Float specifying the interference distance. This argument is valid only when overclosureType = INTERFERENCE. The default value is None.
- clearanceDistance=
None
¶ None or a Float specifying the initial clearance distance. This argument is valid only when overclosureType = CLEARANCE, and must be specified in that case. The default value is None.
- openingTolerance=
None
¶ None or a Float specifying the distance tolerance within which initial openings will undergo strain-free adjustments. This argument is not valid when overclosureType = INTERFERENCE unless a value has been specified for interferenceDistance. The default value is None.
- overclosureTolerance=
None
¶ None or a Float specifying the distance tolerance within which initial overclosures will undergo strain-free adjustments.. The default value is None.
- overclosureType=
- Raises:¶
RangeError –
- class StdStabilization(
- name,
- zeroDistance=
None
, - reductionFactor=
0
, - scaleFactor=
1
, - tangentialFactor=
0
, - amplitude=
''
, - reset=
0
, Bases:
ContactStabilization
The StdStabilization object is used in conjunction with ContactStd in Abaqus/Standard analyses to specify contact stabilization. The StdStabilization object is derived from the ContactStabilization object.
Note
This object can be accessed by:
import interaction mdb.models[name].contactStabilizations[name]
The corresponding analysis keywords are:
CONTACT STABILIZATION
Note
Member Details:
-
amplitude : --is-rst--:py:class:`str` =
''
[source]¶ A String specifying the name of the Amplitude object that defines a time-dependent scale factor for contact stabilization over the step. The default value is an empty string.
- name : --is-rst--:py:class:`str`[source]¶
A String specifying the contact stabilization repository key.
-
reductionFactor : --is-rst--:py:class:`float` =
0
[source]¶ A Float specifying the factor by which the analysis will reduce the contact stabilization coefficient per increment. The default value is 0.1.
-
reset : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] =
0
[source]¶ A Boolean specifying whether to cancel carryover effects from contact stabilization specifications involving nondefault amplitudes that appeared in previous steps. The default value is OFF.
-
scaleFactor : --is-rst--:py:class:`float` =
1
[source]¶ A Float specifying the factor by which the analysis will scale the contact stabilization coefficient. The default value is 1.0.
- setValues(
- zeroDistance=
None
, - reductionFactor=
0
, - scaleFactor=
1
, - tangentialFactor=
0
, - amplitude=
''
, - reset=
0
, This method modifies the StdStabilization object.
Note
- Parameters:¶
- zeroDistance=
None
¶ None or a Float specifying the clearance distance at which the stabilization becomes zero. The default value is None.
- reductionFactor=
0
¶ A Float specifying the factor by which the analysis will reduce the contact stabilization coefficient per increment. The default value is 0.1.
- scaleFactor=
1
¶ A Float specifying the factor by which the analysis will scale the contact stabilization coefficient. The default value is 1.0.
- tangentialFactor=
0
¶ A Float specifying the factor that scales the contact stabilization coefficient in the tangential direction. The default value is 0.0.
- amplitude=
''
¶ A String specifying the name of the Amplitude object that defines a time-dependent scale factor for contact stabilization over the step. The default value is an empty string.
- reset=
0
¶ A Boolean specifying whether to cancel carryover effects from contact stabilization specifications involving nondefault amplitudes that appeared in previous steps. The default value is OFF.
- zeroDistance=
- Raises:¶
RangeError –
- class ModelChange(
- name,
- createStepName,
- isRestart=
0
, - regionType=
GEOMETRY
, - region=
None
, - activeInStep=
0
, - includeStrain=
0
, Bases:
Interaction
The ModelChange object defines model change interactions for element removal and reactivation. The ModelChange object is derived from the Interaction object.
Note
This object can be accessed by:
import interaction mdb.models[name].interactions[name]
The corresponding analysis keywords are:
MODEL CHANGE
Note
Member Details:
-
activeInStep : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] =
0
[source]¶ A Boolean specifying whether elements are being removed or reactivated. This argument is valid only when isRestart = False. The default value is OFF.
- createStepName : --is-rst--:py:class:`str`[source]¶
A String specifying the name of the step in which the ModelChange object is created.
-
includeStrain : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] =
0
[source]¶ A Boolean specifying whether stress/displacement elements are reactivated with strain. This argument is valid only when isRestart = False and when activeInStep = True. The default value is OFF.
-
isRestart : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] =
0
[source]¶ A Boolean specifying whether this interaction is being used solely to indicate that model change may be required in a subsequent restart analysis (either for elements or contact pairs). The default value is OFF.
-
region : --is-rst--:py:class:`~abaqus.Region.Region.Region` | :py:obj:`None` =
None
[source]¶ A Region object specifying the elements to be removed or reactivated. This argument is valid only when isRestart = False.
-
regionType : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` =
'GEOMETRY'
[source]¶ A SymbolicConstant specifying the region selection type. This argument is valid only when isRestart = False. Possible values are GEOMETRY, SKINS, STRINGERS, and ELEMENTS. The default value is GEOMETRY.
- setValues(
- isRestart=
0
, - regionType=
GEOMETRY
, - region=
None
, - activeInStep=
0
, - includeStrain=
0
, This method modifies the data for an existing ModelChange object in the step where it is created.
Note
- Parameters:¶
- isRestart=
0
¶ A Boolean specifying whether this interaction is being used solely to indicate that model change may be required in a subsequent restart analysis (either for elements or contact pairs). The default value is OFF.
- regionType=
GEOMETRY
¶ A SymbolicConstant specifying the region selection type. This argument is valid only when isRestart = False. Possible values are GEOMETRY, SKINS, STRINGERS, and ELEMENTS. The default value is GEOMETRY.
- region=
None
¶ A Region object specifying the elements to be removed or reactivated. This argument is valid only when isRestart = False.
- activeInStep=
0
¶ A Boolean specifying whether elements are being removed or reactivated. This argument is valid only when isRestart = False. The default value is OFF.
- includeStrain=
0
¶ A Boolean specifying whether stress/displacement elements are reactivated with strain. This argument is valid only when isRestart = False and when activeInStep = True. The default value is OFF.
- isRestart=
-
setValuesInStep(stepName, activeInStep=
0
, includeStrain=0
)[source]¶ This method modifies the propagating data of an existing ModelChange object in the specified step.
Note
- Parameters:¶
- stepName¶
A String specifying the name of the step in which the interaction is modified.
- activeInStep=
0
¶ A Boolean specifying whether elements are being removed or reactivated. This argument is valid only when isRestart = False. The default value is OFF.
- includeStrain=
0
¶ A Boolean specifying whether stress/displacement elements are reactivated with strain. This argument is valid only when isRestart = False and when activeInStep = True. The default value is OFF.
- class PressurePenetration(
- name,
- createStepName,
- contactInteraction,
- mainPoints,
- secondaryPoints,
- penetrationPressure,
- criticalPressure,
- amplitude=
UNSET
, - penetrationTime=
0
, Bases:
Interaction
The PressurePenetration object defines pressure penetration loading simulated with surface-to-surface contact. The PressurePenetration object is derived from the Interaction object.
Note
This object can be accessed by:
import interaction mdb.models[name].interactions[name]
The corresponding analysis keywords are:
PRESSURE PENETRATION
Note
Member Details:
-
contactInteraction : --is-rst--:py:class:`str` =
''
[source]¶ A String specifying the name of the Surface-to-surface contact (Standard) interaction.
-
createStepName : --is-rst--:py:class:`str` =
''
[source]¶ A String specifying the name of the step in which the PressurePenetration object is created.
-
mainPoints : --is-rst--:py:class:`~typing.List`\ \[:py:class:`~abaqus.Region.Region.Region`] =
[]
[source]¶ A RegionArray object specifying the points on the main surface that are exposed to the fluid.
Changed in version 2022: The attribute
masterPoints
was renamed tomainPoints
.
-
secondaryPoints : --is-rst--:py:class:`~typing.List`\ \[:py:class:`~abaqus.Region.Region.Region`] =
[]
[source]¶ A RegionArray object specifying the points on the secondary surface that are exposed to the fluid.
Changed in version 2022: The attribute
slavePoints
was renamed tosecondaryPoints
.
-
setValues(amplitude=
UNSET
, penetrationTime=0
)[source]¶ This method modifies the data for an existing PressurePenetration object in the step where it is created.
- Parameters:¶
- amplitude=
UNSET
¶ A String or the SymbolicConstant UNSET specifying the name of the amplitude reference. UNSET should be used if the load has no amplitude reference. The default value is UNSET. You should provide the amplitude argument only if it is valid for the specified step.
- penetrationTime=
0
¶ A Float specifying the fraction of the current step time over which the fluid pressure on newly penetrated contact surface segments is ramped up to the current magnitude. The default value is 0.001.
- amplitude=
- setValuesInStep(
- stepName,
- penetrationPressure=
None
, - criticalPressure=
None
, - amplitude=
''
, - penetrationTime=
0
, This method modifies the propagating data for an existing PressurePenetration object in the specified step.
- Parameters:¶
- stepName¶
A String specifying the name of the step in which the interaction is modified.
- penetrationPressure=
None
¶ A tuple of Floats specifying the fluid pressure magnitude. For steady state dynamic analyses, a tuple of Complexes specifying the fluid pressure magnitude.
- criticalPressure=
None
¶ A tuple of Floats specifying the critical contact pressure below which fluid penetration starts to occur.
- amplitude=
''
¶ A String or a SymbolicConstant specifying the name of the amplitude reference. Possible values for the SymbolicConstant are UNCHANGED and FREED. UNCHANGED should be used if the amplitude is propagated from the previous analysis step. FREED should be used if the load is changed to have no amplitude reference. You should provide the amplitude argument only if it is valid for the specified step.
- penetrationTime=
0
¶ A Float specifying the fraction of the current step time over which the fluid pressure on newly penetrated contact surface segments is ramped up to the current magnitude. The default value is 0.001.
- class RadiationToAmbient(
- name,
- createStepName,
- surface,
- emissivity,
- field=
''
, - distributionType=
UNIFORM
, - radiationType=
AMBIENT
, - ambientTemperature=
0
, - ambientTemperatureAmp=
''
, Bases:
Interaction
The RadiationToAmbient object defines radiant heat transfer between a surface and its environment. The RadiationToAmbient object is derived from the Interaction object.
Note
This object can be accessed by:
import interaction mdb.models[name].interactions[name]
Note
Member Details:
-
ambientTemperature : --is-rst--:py:class:`float` =
0
[source]¶ A Float specifying the reference ambient temperature, θ0θ0. This argument applies only when radiationType = AMBIENT. The default value is 0.0.
-
ambientTemperatureAmp : --is-rst--:py:class:`str` =
''
[source]¶ A String specifying the name of the Amplitude object that gives the variation of the ambient temperature with time. Note: Use None in an Abaqus/Standard analysis to specify that the reference ambient temperature is applied immediately at the beginning of the step or linearly over the step. Use None in an Abaqus/Explicit analysis to specify that the reference ambient temperature is applied throughout the step. This argument applies only when radiationType = AMBIENT.
- createStepName : --is-rst--:py:class:`str`[source]¶
A String specifying the name of the step in which the RadiationToAmbient object is created.
-
distributionType : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` =
'UNIFORM'
[source]¶ A SymbolicConstant specifying how the radiation is distributed. This argument applies only when radiationType = AMBIENT. Possible values are UNIFORM and ANALYTICAL_FIELD. The default value is UNIFORM.
-
field : --is-rst--:py:class:`str` =
''
[source]¶ A String specifying the name of the AnalyticalField object associated with this interaction. The field argument applies only when distributionType = ANALYTICAL_FIELD. The default value is an empty string.
-
radiationType : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` =
'AMBIENT'
[source]¶ A SymbolicConstant specifying whether to use the default surface radiation behavior, or the cavity radiation approximation. Possible values are AMBIENT and CAVITY. The default value is AMBIENT.
- setValues(
- field=
''
, - distributionType=
UNIFORM
, - radiationType=
AMBIENT
, - ambientTemperature=
0
, - ambientTemperatureAmp=
''
, This method modifies the data for an existing RadiationToAmbient object in the step where it is created.
- Parameters:¶
- field=
''
¶ A String specifying the name of the AnalyticalField object associated with this interaction. The field argument applies only when distributionType = ANALYTICAL_FIELD. The default value is an empty string.
- distributionType=
UNIFORM
¶ A SymbolicConstant specifying how the radiation is distributed. This argument applies only when radiationType = AMBIENT. Possible values are UNIFORM and ANALYTICAL_FIELD. The default value is UNIFORM.
- radiationType=
AMBIENT
¶ A SymbolicConstant specifying whether to use the default surface radiation behavior, or the cavity radiation approximation. Possible values are AMBIENT and CAVITY. The default value is AMBIENT.
- ambientTemperature=
0
¶ A Float specifying the reference ambient temperature, θ0θ0. This argument applies only when radiationType = AMBIENT. The default value is 0.0.
- ambientTemperatureAmp=
''
¶ A String specifying the name of the Amplitude object that gives the variation of the ambient temperature with time. Note: Use None in an Abaqus/Standard analysis to specify that the reference ambient temperature is applied immediately at the beginning of the step or linearly over the step. Use None in an Abaqus/Explicit analysis to specify that the reference ambient temperature is applied throughout the step. This argument applies only when radiationType = AMBIENT.
- field=
-
ambientTemperature : --is-rst--:py:class:`float` =
- class SelfContactExp(
- name,
- createStepName,
- surface,
- interactionProperty,
- mechanicalConstraint=
KINEMATIC
, - contactControls=
''
, Bases:
Interaction
The SelfContactExp object defines self-contact during an Abaqus/Explicit analysis. The SelfContactExp object is derived from the Interaction object.
Note
This object can be accessed by:
import interaction mdb.models[name].interactions[name]
Note
Member Details:
-
contactControls : --is-rst--:py:class:`str` =
''
[source]¶ A String specifying the name of the ContactControl object associated with this interaction. An empty string indicates that the default contact controls will be used. The default value is an empty string.
- createStepName : --is-rst--:py:class:`str`[source]¶
A String specifying the name of the step in which the SelfContactExp object is created.
- interactionProperty : --is-rst--:py:class:`str`[source]¶
A String specifying the name of the ContactProperty object associated with this interaction.
-
mechanicalConstraint : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` =
'KINEMATIC'
[source]¶ A SymbolicConstant specifying the mechanical constraint formulation. Possible values are KINEMATIC and PENALTY. The default value is KINEMATIC.
-
setValues(mechanicalConstraint=
KINEMATIC
, contactControls=''
)[source]¶ This method modifies the data for an existing SelfContactExp object in the step where it is created.
Note
- Parameters:¶
- mechanicalConstraint=
KINEMATIC
¶ A SymbolicConstant specifying the mechanical constraint formulation. Possible values are KINEMATIC and PENALTY. The default value is KINEMATIC.
- contactControls=
''
¶ A String specifying the name of the ContactControl object associated with this interaction. An empty string indicates that the default contact controls will be used. The default value is an empty string.
- mechanicalConstraint=
-
setValuesInStep(stepName, interactionProperty=
''
, contactControls=''
)[source]¶ This method modifies the propagating data for an existing SelfContactExp object in the specified step.
- Parameters:¶
- stepName¶
A String specifying the name of the step in which the interaction is modified.
- interactionProperty=
''
¶ A String specifying the name of the ContactProperty object associated with this interaction.
- contactControls=
''
¶ A String specifying the name of the ContactControl object associated with this interaction. An empty string indicates that the default contact controls will be used. The default value is an empty string.
-
contactControls : --is-rst--:py:class:`str` =
- class SelfContactStd(
- name,
- createStepName,
- surface,
- interactionProperty,
- enforcement=
SURFACE_TO_SURFACE
, - thickness=
1
, - smooth=
0
, - contactControls=
''
, Bases:
Interaction
The SelfContactStd object defines self-contact during an Abaqus/Standard analysis. The SelfContactStd object is derived from the Interaction object.
Note
This object can be accessed by:
import interaction mdb.models[name].interactions[name]
Note
Member Details:
-
contactControls : --is-rst--:py:class:`str` =
''
[source]¶ A String specifying the name of the ContactControl object associated with this interaction. An empty string indicates that the default contact controls will be used. The default value is an empty string.
-
contactTracking : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` =
'TWO_CONFIG'
[source]¶ A SymbolicConstant specifying the choice of contact tracking algorithm. The STATE tracking algorithm uses only normal projections and is specified by using ONE_CONFIG. The PATH tracking algorithm uses crossing and normal projections and is specified by using TWO_CONFIG. Possible values are ONE_CONFIG and TWO_CONFIG. The default value is TWO_CONFIG.This argument is valid only when enforcement = SURFACE_TO_SURFACE.
- createStepName : --is-rst--:py:class:`str`[source]¶
A String specifying the name of the step in which the SelfContactStd object is created.
-
enforcement : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` =
'SURFACE_TO_SURFACE'
[source]¶ A SymbolicConstant specifying the discretization method. Possible values are NODE_TO_SURFACE and SURFACE_TO_SURFACE. The default value is SURFACE_TO_SURFACE.
- interactionProperty : --is-rst--:py:class:`str`[source]¶
A String specifying the name of the ContactProperty object associated with this interaction.
- setValues(
- enforcement=
SURFACE_TO_SURFACE
, - thickness=
1
, - smooth=
0
, - contactControls=
''
, This method modifies the data for an existing SelfContactStd object in the step where it is created.
Note
- Parameters:¶
- enforcement=
SURFACE_TO_SURFACE
¶ A SymbolicConstant specifying the discretization method. Possible values are NODE_TO_SURFACE and SURFACE_TO_SURFACE. The default value is SURFACE_TO_SURFACE.
- thickness=
1
¶ A Boolean specifying whether shell/membrane element thickness is considered. The default value is ON.This argument in valid only when enforcement = SURFACE_TO_SURFACE.
- smooth=
0
¶ A Float specifying the degree of smoothing used for deformable or rigid main surfaces involved when enforcement = NODE_TO_SURFACE. The value given must lie between 0.0 and 0.5. The default value is 0.2.
- contactControls=
''
¶ A String specifying the name of the ContactControl object associated with this interaction. An empty string indicates that the default contact controls will be used. The default value is an empty string.
- enforcement=
-
setValuesInStep(stepName, interactionProperty=
''
, contactControls=''
)[source]¶ This method modifies the propagating data of an existing SelfContactStd object in the specified step.
- Parameters:¶
- stepName¶
A String specifying the name of the step in which the interaction is modified.
- interactionProperty=
''
¶ A String specifying the name of the ContactProperty object associated with this interaction.
- contactControls=
''
¶ A String specifying the name of the ContactControl object associated with this interaction. An empty string indicates that the default contact controls will be used. The default value is an empty string.
-
smooth : --is-rst--:py:class:`float` =
0
[source]¶ A Float specifying the degree of smoothing used for deformable or rigid main surfaces involved when enforcement = NODE_TO_SURFACE. The value given must lie between 0.0 and 0.5. The default value is 0.2.
Changed in version 2022: Rigid master surfaces was changed to rigid main surfaces.
-
supplementaryContact : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` =
'SELECTIVE'
[source]¶ A SymbolicConstant specifying the manner in which mid-face constraints are employed. Possible values are SELECTIVE, NEVER, and ALWAYS. The default value is SELECTIVE.This argument is valid only when enforcement = NODE_TO_SURFACE.
- surface : --is-rst--:py:class:`~abaqus.Region.Region.Region`[source]¶
A Region object specifying the surface where self-contact is defined.
-
thickness : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] =
1
[source]¶ A Boolean specifying whether shell/membrane element thickness is considered. The default value is ON.This argument in valid only when enforcement = SURFACE_TO_SURFACE.
-
contactControls : --is-rst--:py:class:`str` =
- class StdXplCosimulation(
- name,
- createStepName,
- region,
- incrementation=
ALLOW_SUBCYCLING
, - stepSize=
0
, - stepSizeDefinition=
DEFAULT
, Bases:
Interaction
The StdXplCosimulation object defines co-simulation behavior between Abaqus/Standard and Abaqus/Explicit. The StdXplCosimulation object is derived from the Interaction object.
Note
This object can be accessed by:
import interaction mdb.models[name].interactions[name]
Note
Member Details:
- createStepName : --is-rst--:py:class:`str`[source]¶
A String specifying the name of the step in which the StdXplCosimulation object is created.
-
incrementation : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` =
'ALLOW_SUBCYCLING'
[source]¶ A SymbolicConstant specifying whether the analysis programs use the same time increments or one is allowed to use more time increments than the other before exchanging data. Possible values are ALLOW_SUBCYCLING and LOCKSTEP. The default value is ALLOW_SUBCYCLING.
- region : --is-rst--:py:class:`~abaqus.Region.Region.Region`[source]¶
A Region object specifying the import and export region upon which the co-simulation exchanges data with the coupled analysis program.
- setValues(
- incrementation=
ALLOW_SUBCYCLING
, - stepSize=
0
, - stepSizeDefinition=
DEFAULT
, This method modifies the StdXplCosimulation object.
- Parameters:¶
- incrementation=
ALLOW_SUBCYCLING
¶ A SymbolicConstant specifying whether the analysis programs use the same time increments or one is allowed to use more time increments than the other before exchanging data. Possible values are ALLOW_SUBCYCLING and LOCKSTEP. The default value is ALLOW_SUBCYCLING.
- stepSize=
0
¶ A Float specifying the size of the increments to be used by Abaqus/Standard and Abaqus/Explicit. The default value is 0.0.
- stepSizeDefinition=
DEFAULT
¶ A SymbolicConstant specifying whether the increment size is the analysis default or a supplied variable. Possible values are DEFAULT and SPECIFIED. The default value is DEFAULT.
- incrementation=
- class SurfaceToSurfaceContactExp(
- name,
- createStepName,
- main,
- secondary,
- sliding,
- interactionProperty,
- mechanicalConstraint=
KINEMATIC
, - weightingFactorType=
DEFAULT
, - weightingFactor=
0
, - contactControls=
''
, - initialClearance=
OMIT
, - halfThreadAngle=
None
, - pitch=
None
, - majorBoltDiameter=
COMPUTED
, - meanBoltDiameter=
COMPUTED
, - datumAxis=
None
, - useReverseDatumAxis=
0
, - clearanceRegion=
None
, Bases:
Interaction
The SurfaceToSurfaceContactExp object defines surface-to-surface contact during an Abaqus/Explicit analysis. The SurfaceToSurfaceContactExp object is derived from the Interaction object.
Note
This object can be accessed by:
import interaction mdb.models[name].interactions[name]
Note
Member Details:
-
clearanceRegion : --is-rst--:py:class:`~abaqus.Region.Region.Region` | :py:obj:`None` =
None
[source]¶ A Region object specifying the contact region for which clearance is specified.
-
contactControls : --is-rst--:py:class:`str` =
''
[source]¶ A String specifying the name of the ContactControl object associated with this interaction. An empty string indicates that the default contact controls will be used. The default value is an empty string.
- createStepName : --is-rst--:py:class:`str`[source]¶
A String specifying the name of the step in which the SurfaceToSurfaceContactExp object is created.
-
datumAxis : --is-rst--:py:class:`~abaqus.Datum.DatumAxis.DatumAxis` | :py:obj:`None` =
None
[source]¶ A DatumAxis object specifying the orientation of the bolt hole when specifying bolt clearance.
-
halfThreadAngle : --is-rst--:py:class:`str` | :py:obj:`None` =
None
[source]¶ None or a sequence of Floats specifying the half thread angle used for bolt clearance. The default value is None.
-
initialClearance : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`, :py:class:`float`] =
'OMIT'
[source]¶ A SymbolicConstant or a Float specifying the initial clearance at regions of contact. Possible values are OMIT and COMPUTED. The default value is OMIT.
- interactionProperty : --is-rst--:py:class:`str`[source]¶
A String specifying the name of the ContactProperty object associated with this interaction.
- main : --is-rst--:py:class:`~abaqus.Region.Region.Region`[source]¶
A Region object specifying the main surface.
Changed in version 2022: The attribute
master
was renamed tomain
.
-
majorBoltDiameter : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`, :py:class:`float`] =
'COMPUTED'
[source]¶ The SymbolicConstant COMPUTED or a Float specifying the major diameter of the bolt used for bolt clearance. The default value is COMPUTED.
-
meanBoltDiameter : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`, :py:class:`float`] =
'COMPUTED'
[source]¶ The SymbolicConstant COMPUTED or a Float specifying the mean diameter of the bolt used for bolt clearance. The default value is COMPUTED.
-
mechanicalConstraint : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` =
'KINEMATIC'
[source]¶ A SymbolicConstant specifying the mechanical constraint formulation. Possible values are KINEMATIC and PENALTY. The default value is KINEMATIC.
-
pitch : --is-rst--:py:class:`str` | :py:obj:`None` =
None
[source]¶ None or a sequence of Floats specifying the pitch used for bolt clearance. The default value is None.
- secondary : --is-rst--:py:class:`~abaqus.Region.Region.Region`[source]¶
A Region object specifying the secondary surface.
Changed in version 2022: The attribute
slave
was renamed tosecondary
.
- setValues(
- mechanicalConstraint=
KINEMATIC
, - weightingFactorType=
DEFAULT
, - weightingFactor=
0
, - contactControls=
''
, - initialClearance=
OMIT
, - halfThreadAngle=
None
, - pitch=
None
, - majorBoltDiameter=
COMPUTED
, - meanBoltDiameter=
COMPUTED
, - datumAxis=
None
, - useReverseDatumAxis=
0
, - clearanceRegion=
None
, This method modifies the data for an existing SurfaceToSurfaceContactExp object in the step where it is created.
- Parameters:¶
- mechanicalConstraint=
KINEMATIC
¶ A SymbolicConstant specifying the mechanical constraint formulation. Possible values are KINEMATIC and PENALTY. The default value is KINEMATIC.
- weightingFactorType=
DEFAULT
¶ A SymbolicConstant specifying the weighting for node-to-face contact. Possible values are DEFAULT and SPECIFIED. The default value is DEFAULT.
- weightingFactor=
0
¶ A Float specifying the weighting factor for the contact surfaces when weightingFactorType = SPECIFIED. The default value is 0.0.
- contactControls=
''
¶ A String specifying the name of the ContactControl object associated with this interaction. An empty string indicates that the default contact controls will be used. The default value is an empty string.
- initialClearance=
OMIT
¶ A SymbolicConstant or a Float specifying the initial clearance at regions of contact. Possible values are OMIT and COMPUTED. The default value is OMIT.
- halfThreadAngle=
None
¶ None or a sequence of Floats specifying the half thread angle used for bolt clearance. The default value is None.
- pitch=
None
¶ None or a sequence of Floats specifying the pitch used for bolt clearance. The default value is None.
- majorBoltDiameter=
COMPUTED
¶ The SymbolicConstant COMPUTED or a Float specifying the major diameter of the bolt used for bolt clearance. The default value is COMPUTED.
- meanBoltDiameter=
COMPUTED
¶ The SymbolicConstant COMPUTED or a Float specifying the mean diameter of the bolt used for bolt clearance. The default value is COMPUTED.
- datumAxis=
None
¶ A DatumAxis object specifying the orientation of the bolt hole when specifying bolt clearance.
- useReverseDatumAxis=
0
¶ A Boolean specifying whether to reverse the bolt clearance direction given by the datum axis. The default value is OFF.
- clearanceRegion=
None
¶ A Region object specifying the contact region for which clearance is specified.
- mechanicalConstraint=
- setValuesInStep(
- stepName,
- interactionProperty=
''
, - contactControls=
''
, This method modifies the propagating data for an existing SurfaceToSurfaceContactExp object in the specified step.
- Parameters:¶
- stepName¶
A String specifying the name of the step in which the interaction is modified.
- interactionProperty=
''
¶ A String specifying the name of the ContactProperty object associated with this interaction.
- contactControls=
''
¶ A String specifying the name of the ContactControl object associated with this interaction. An empty string indicates that the default contact controls will be used. The default value is an empty string.
- sliding : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶
A SymbolicConstant specifying the contact formulation. Possible values are FINITE and SMALL.
- swapSurfaces()[source]¶
This method switches the main and secondary surfaces of a surface-to-surface contact pair. This command is valid only during the step in which the interaction is created.
Changed in version 2022: Master and slave were changed to main and secondary.
-
useReverseDatumAxis : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] =
0
[source]¶ A Boolean specifying whether to reverse the bolt clearance direction given by the datum axis. The default value is OFF.
-
clearanceRegion : --is-rst--:py:class:`~abaqus.Region.Region.Region` | :py:obj:`None` =
- class SurfaceToSurfaceContactStd(
- name,
- createStepName,
- main,
- secondary,
- sliding,
- interactionProperty,
- interferenceType=
NONE
, - overclosure=
0
, - interferenceDirectionType=
COMPUTED
, - direction=
()
, - amplitude=
''
, - smooth=
0
, - hcrit=
0
, - extensionZone=
0
, - adjustMethod=
NONE
, - adjustTolerance=
0
, - adjustSet=
None
, - enforcement=
SURFACE_TO_SURFACE
, - thickness=
1
, - contactControls=
''
, - tied=
0
, - initialClearance=
OMIT
, - halfThreadAngle=
None
, - pitch=
None
, - majorBoltDiameter=
COMPUTED
, - meanBoltDiameter=
COMPUTED
, - datumAxis=
None
, - useReverseDatumAxis=
0
, - clearanceRegion=
None
, - surfaceSmoothing=
NONE
, - bondingSet=
None
, - handedness=
RIGHT
, - normalAdjustment=
None
, Bases:
Interaction
The SurfaceToSurfaceContactStd object defines surface-to-surface contact during an Abaqus/Standard analysis. The SurfaceToSurfaceContactStd object is derived from the Interaction object.
Note
This object can be accessed by:
import interaction mdb.models[name].interactions[name]
Note
Member Details:
-
adjustMethod : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` =
'NONE'
[source]¶ A SymbolicConstant specifying the adjust method. Possible values are NONE, OVERCLOSED, TOLERANCE, and SET. The default value is NONE.
-
adjustSet : --is-rst--:py:class:`~abaqus.Region.Region.Region` | :py:obj:`None` =
None
[source]¶ A Region object specifying the Set object to which the adjustment is to be applied.
-
adjustTolerance : --is-rst--:py:class:`float` =
0
[source]¶ A Float specifying the adjust tolerance. The default value is 0.0.
-
amplitude : --is-rst--:py:class:`str` =
''
[source]¶ A String specifying the name of the amplitude curve that defines the magnitude of the prescribed interference during the step. Use None to specify that the prescribed interference is applied immediately at the beginning of the step and ramped down to zero linearly over the step.
-
bondingSet : --is-rst--:py:class:`~abaqus.Region.Region.Region` | :py:obj:`None` =
None
[source]¶ A Region object specifying the secondary node sub-set for bonding, used only when the contact property CohesiveBehavior option specifies use.
-
clearanceRegion : --is-rst--:py:class:`~abaqus.Region.Region.Region` | :py:obj:`None` =
None
[source]¶ A Region object specifying the contact region for which clearance is specified.
-
contactControls : --is-rst--:py:class:`str` =
''
[source]¶ A String specifying the name of the ContactControl object associated with this interaction. The empty string indicates that the default contact controls will be used. The default value is an empty string.
-
contactTracking : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` =
'TWO_CONFIG'
[source]¶ A SymbolicConstant specifying the choice of contact tracking algorithm. The STATE tracking algorithm uses only normal projections and is specified by using ONE_CONFIG. The PATH tracking algorithm uses crossing and normal projections and is specified by using TWO_CONFIG. Possible values are ONE_CONFIG and TWO_CONFIG. The default value is TWO_CONFIG.This argument is valid only when sliding = FINITE and enforcement = SURFACE_TO_SURFACE.
- createStepName : --is-rst--:py:class:`str`[source]¶
A String specifying the name of the step in which the SurfaceToSurfaceContactStd object is created.
-
datumAxis : --is-rst--:py:class:`~abaqus.Datum.DatumAxis.DatumAxis` | :py:obj:`None` =
None
[source]¶ A DatumAxis object specifying the orientation of the bolt hole when specifying bolt clearance.
-
direction : --is-rst--:py:class:`tuple` =
()
[source]¶ A sequence of three Floats specifying the following:
XX-direction cosine of the interference direction vector.
YY-direction cosine of the interference direction vector.
ZZ-direction cosine of the interference direction vector.
This argument is required only when interferenceDirectionType = DIRECTION_COSINE.
-
enforcement : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` =
'SURFACE_TO_SURFACE'
[source]¶ A SymbolicConstant specifying the discretization method. Possible values are NODE_TO_SURFACE and SURFACE_TO_SURFACE. The default value is SURFACE_TO_SURFACE.
-
extensionZone : --is-rst--:py:class:`float` =
0
[source]¶ A Float specifying a fraction of the end segment or facet edge length by which the main surface is to be extended to avoid numerical round-off errors associated with contact modeling. The value given must lie between 0.0 and 0.2. The default value is 0.1.
-
halfThreadAngle : --is-rst--:py:class:`str` | :py:obj:`None` =
None
[source]¶ None or a sequence of Floats specifying the half thread angle used for bolt clearance. The default value is None.
-
handedness : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` =
'RIGHT'
[source]¶ A SymbolicConstant specifying the bolt handedness formulation. Possible values are RIGHT and LEFT. The default value is RIGHT.
Added in version 2019: The
handedness
attribute was added.
-
hcrit : --is-rst--:py:class:`float` =
0
[source]¶ A Float specifying the distance by which a secondary node must penetrate the main surface before Abaqus/Standard abandons the current increment and tries again with a smaller increment. The default value is 0.0.
-
initialClearance : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`, :py:class:`float`] =
'OMIT'
[source]¶ A SymbolicConstant or a Float specifying the initial clearance at regions of contact. Possible values are OMIT and COMPUTED. The default value is OMIT.
- interactionProperty : --is-rst--:py:class:`str`[source]¶
A String specifying the name of the ContactProperty object associated with this interaction.
-
interferenceDirectionType : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` =
'COMPUTED'
[source]¶ A SymbolicConstant specifying the method used to determine the interference direction. Possible values are COMPUTED and DIRECTION_COSINE. The default value is COMPUTED.
-
interferenceType : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` =
'NONE'
[source]¶ NONE, specifying no allowable contact interference.
SHRINK_FIT.
UNIFORM.
The default value is NONE.
- main : --is-rst--:py:class:`~abaqus.Region.Region.Region`[source]¶
A Region object specifying the name of the main surface.
Changed in version 2022: The
master
attribute was renamed tomain
.
-
majorBoltDiameter : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`, :py:class:`float`] =
'COMPUTED'
[source]¶ The SymbolicConstant COMPUTED or a Float specifying the major diameter of the bolt used for bolt clearance. The default value is COMPUTED.
-
meanBoltDiameter : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`, :py:class:`float`] =
'COMPUTED'
[source]¶ The SymbolicConstant COMPUTED or a Float specifying the mean diameter of the bolt used for bolt clearance. The default value is COMPUTED.
-
normalAdjustment : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` =
'NONE'
[source]¶ A SymbolicConstant specifying the bolt normal adjustment formulation for all secondary nodes. Possible values are UNIFORM AXIAL COMPONENT and LOCATION DEPENDENT. The default value is UNIFORM AXIAL COMPONENT.
Added in version 2019: The
normalAdjustment
attribute was added.
-
overclosure : --is-rst--:py:class:`float` =
0
[source]¶ A Float specifying the maximum overclosure distance allowed. This argument applies only when interferenceType = UNIFORM. The default value is 0.0.
-
pitch : --is-rst--:py:class:`str` | :py:obj:`None` =
None
[source]¶ None or a sequence of Floats specifying the pitch used for bolt clearance. The default value is None.
- secondary : --is-rst--:py:class:`~abaqus.Region.Region.Region`[source]¶
A Region object specifying the name of the secondary surface.
Changed in version 2022: The
slave
attribute was renamed tosecondary
.
- setValues(
- interferenceType=
NONE
, - overclosure=
0
, - interferenceDirectionType=
COMPUTED
, - direction=
()
, - amplitude=
''
, - smooth=
0
, - hcrit=
0
, - extensionZone=
0
, - adjustMethod=
NONE
, - adjustTolerance=
0
, - adjustSet=
None
, - enforcement=
SURFACE_TO_SURFACE
, - thickness=
1
, - contactControls=
''
, - tied=
0
, - initialClearance=
OMIT
, - halfThreadAngle=
None
, - pitch=
None
, - majorBoltDiameter=
COMPUTED
, - meanBoltDiameter=
COMPUTED
, - datumAxis=
None
, - useReverseDatumAxis=
0
, - clearanceRegion=
None
, - surfaceSmoothing=
NONE
, - bondingSet=
None
, - handedness=
RIGHT
, - normalAdjustment=
None
, This method modifies the data for an existing SurfaceToSurfaceContactStd object in the step where it is created.
- Parameters:¶
- interferenceType=
NONE
¶ A SymbolicConstant specifying the type of time-dependent allowable interference for contact pairs and contact elements. Possible values are:
NONE, specifying no allowable contact interference.
SHRINK_FIT.
UNIFORM.
The default value is NONE.
- overclosure=
0
¶ A Float specifying the maximum overclosure distance allowed. This argument applies only when interferenceType = UNIFORM. The default value is 0.0.
- interferenceDirectionType=
COMPUTED
¶ A SymbolicConstant specifying the method used to determine the interference direction. Possible values are COMPUTED and DIRECTION_COSINE. The default value is COMPUTED.
- direction=
()
¶ A sequence of three Floats specifying the following:
XX-direction cosine of the interference direction vector.
YY-direction cosine of the interference direction vector.
ZZ-direction cosine of the interference direction vector.
This argument is required only when interferenceDirectionType = DIRECTION_COSINE.
- amplitude=
''
¶ A String specifying the name of the amplitude curve that defines the magnitude of the prescribed interference during the step. Use None to specify that the prescribed interference is applied immediately at the beginning of the step and ramped down to zero linearly over the step.
- smooth=
0
¶ A Float specifying the degree of smoothing used for deformable or rigid main surfaces involved when enforcement = NODE_TO_SURFACE. The value given must lie between 0.0 and 0.5. The default value is 0.2.
- hcrit=
0
¶ A Float specifying the distance by which a secondary node must penetrate the main surface before Abaqus/Standard abandons the current increment and tries again with a smaller increment. The default value is 0.0.
- extensionZone=
0
¶ A Float specifying a fraction of the end segment or facet edge length by which the main surface is to be extended to avoid numerical round-off errors associated with contact modeling. The value given must lie between 0.0 and 0.2. The default value is 0.1.
- adjustMethod=
NONE
¶ A SymbolicConstant specifying the adjust method. Possible values are NONE, OVERCLOSED, TOLERANCE, and SET. The default value is NONE.
- adjustTolerance=
0
¶ A Float specifying the adjust tolerance. The default value is 0.0.
- adjustSet=
None
¶ A Region object specifying the Set object to which the adjustment is to be applied.
- enforcement=
SURFACE_TO_SURFACE
¶ A SymbolicConstant specifying the discretization method. Possible values are NODE_TO_SURFACE and SURFACE_TO_SURFACE. The default value is SURFACE_TO_SURFACE.
- thickness=
1
¶ A Boolean specifying whether shell/membrane element thickness is considered. The default value is ON.This argument is not valid when sliding = FINITE and enforcement = NODE_TO_SURFACE.
- contactControls=
''
¶ A String specifying the name of the ContactControl object associated with this interaction. The empty string indicates that the default contact controls will be used. The default value is an empty string.
- tied=
0
¶ A Boolean specifying whether the surfaces are to be “tied” together for the duration of the simulation. The default value is OFF.
- initialClearance=
OMIT
¶ A SymbolicConstant or a Float specifying the initial clearance at regions of contact. Possible values are OMIT and COMPUTED. The default value is OMIT.
- halfThreadAngle=
None
¶ None or a sequence of Floats specifying the half thread angle used for bolt clearance. The default value is None.
- pitch=
None
¶ None or a sequence of Floats specifying the pitch used for bolt clearance. The default value is None.
- majorBoltDiameter=
COMPUTED
¶ The SymbolicConstant COMPUTED or a Float specifying the major diameter of the bolt used for bolt clearance. The default value is COMPUTED.
- meanBoltDiameter=
COMPUTED
¶ The SymbolicConstant COMPUTED or a Float specifying the mean diameter of the bolt used for bolt clearance. The default value is COMPUTED.
- datumAxis=
None
¶ A DatumAxis object specifying the orientation of the bolt hole when specifying bolt clearance.
- useReverseDatumAxis=
0
¶ A Boolean specifying whether to reverse the bolt clearance direction given by the datum axis. The default value is OFF.
- clearanceRegion=
None
¶ A Region object specifying the contact region for which clearance is specified.
- surfaceSmoothing=
NONE
¶ A SymbolicConstant specifying whether to use surface smoothing for geometric surfaces in SurfaceToSurfaceContactStd interactions. Possible values are AUTOMATIC and NONE. The default value is NONE.
- bondingSet=
None
¶ A Region object specifying the secondary node sub-set for bonding, used only when the contact property CohesiveBehavior option specifies use.
- handedness=
RIGHT
¶ A SymbolicConstant specifying the bolt handedness formulation. Possible values are RIGHT and LEFT. The default value is RIGHT.
Added in version 2019: The
normalAdjustment
argument was added.- normalAdjustment=
None
¶ A SymbolicConstant specifying the bolt normal adjustment formulation for all secondary nodes. Possible values are UNIFORM AXIAL COMPONENT and LOCATION DEPENDENT. The default value is UNIFORM AXIAL COMPONENT.
Added in version 2019: The
normalAdjustment
argument was added.
- interferenceType=
- setValuesInStep(
- stepName,
- interactionProperty=
''
, - interferenceType=
NONE
, - overclosure=
0
, - interferenceDirectionType=
COMPUTED
, - direction=
()
, - amplitude=
''
, - contactControls=
''
, This method modifies the propagating data for an existing SurfaceToSurfaceContactStd object in the specified step.
- Parameters:¶
- stepName¶
A String specifying the name of the step in which the interaction is modified.
- interactionProperty=
''
¶ A String specifying the name of the ContactProperty object associated with this interaction.
- interferenceType=
NONE
¶ A SymbolicConstant specifying the type of time-dependent allowable interference for contact pairs and contact elements. Possible values are:
NONE, specifying no allowable contact interference.
SHRINK_FIT.
UNIFORM.
The default value is NONE.
- overclosure=
0
¶ A Float specifying the maximum overclosure distance allowed. This argument applies only when interferenceType = UNIFORM. The default value is 0.0.
- interferenceDirectionType=
COMPUTED
¶ A SymbolicConstant specifying the method used to determine the interference direction. Possible values are COMPUTED and DIRECTION_COSINE. The default value is COMPUTED.
- direction=
()
¶ A sequence of three Floats specifying the following:
XX-direction cosine of the interference direction vector.
YY-direction cosine of the interference direction vector.
ZZ-direction cosine of the interference direction vector.
This argument is required only when interferenceDirectionType = DIRECTION_COSINE.
- amplitude=
''
¶ A String specifying the name of the amplitude curve that defines the magnitude of the prescribed interference during the step. Use None to specify that the prescribed interference is applied immediately at the beginning of the step and ramped down to zero linearly over the step.
- contactControls=
''
¶ A String specifying the name of the ContactControl object associated with this interaction. The empty string indicates that the default contact controls will be used. The default value is an empty string.
- sliding : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶
A SymbolicConstant specifying the contact formulation. Possible values are FINITE and SMALL.
-
smooth : --is-rst--:py:class:`float` =
0
[source]¶ A Float specifying the degree of smoothing used for deformable or rigid main surfaces involved when enforcement = NODE_TO_SURFACE. The value given must lie between 0.0 and 0.5. The default value is 0.2.
-
supplementaryContact : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` =
'SELECTIVE'
[source]¶ A SymbolicConstant specifying the manner in which midface constraints are employed. Possible values are SELECTIVE, NEVER, and ALWAYS. The default value is SELECTIVE.This argument is not valid when sliding = FINITE and enforcement = SURFACE_TO_SURFACE.
-
surfaceSmoothing : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` =
'NONE'
[source]¶ A SymbolicConstant specifying whether to use surface smoothing for geometric surfaces in SurfaceToSurfaceContactStd interactions. Possible values are AUTOMATIC and NONE. The default value is NONE.
- swapSurfaces()[source]¶
This method switches the main and secondary surfaces of a surface-to-surface contact pair. This command is valid only for the step in which the interaction is created.
Changed in version 2022: Master and slave were changed to main and secondary.
-
thickness : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] =
1
[source]¶ A Boolean specifying whether shell/membrane element thickness is considered. The default value is ON.This argument is not valid when sliding = FINITE and enforcement = NODE_TO_SURFACE.
-
adjustMethod : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` =
-
class XFEMCrackGrowth(name, createStepName, crackName, allowGrowth=
1
)[source]¶ Bases:
Interaction
The XFEMCrackGrowth object defines the enrichment activation state for an XFEMCrack. The XFEMCrackGrowth object is derived from the Interaction object.
Note
This object can be accessed by:
import interaction mdb.models[name].interactions[name]
The corresponding analysis keywords are:
ENRICHMENT ACTIVATION
Note
Member Details:
-
allowGrowth : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] =
1
[source]¶ A Boolean specifying whether the crack is allowed to grow (propagate) during this analysis step. The default value is ON.
- crackName : --is-rst--:py:class:`str`[source]¶
A String specifying the XFEMCrack object associated with this interaction.
- createStepName : --is-rst--:py:class:`str`[source]¶
A String specifying the name of the step in which the XFEMCrackGrowth object is created.
-
setValues(allowGrowth=
1
)[source]¶ This method modifies the data for an existing XFEMCrackGrowth object in the step where it is created.
Note
-
setValuesInStep(stepName, allowGrowth=
1
)[source]¶ This method modifies the propagating data for an existing XFEMCrackGrowth object in the specified step.
- class PressurePenetrationState[source]¶
Bases:
InteractionState
The PressurePenetrationState object stores the propagating data of a PressurePenetration object in a step. One instance of this object is created internally by the PressurePenetration object for each step. The instance is also deleted internally by the PressurePenetration object. The PressurePenetrationState object has no constructor or methods. The PressurePenetrationState object is derived from the InteractionState object.
Note
This object can be accessed by:
import interaction mdb.models[name].steps[name].interactionStates[name]
The corresponding analysis keywords are:
PRESSURE PENETRATION
Note
Member Details:
-
amplitude : --is-rst--:py:class:`str` =
''
[source]¶ A String specifying the name of the amplitude reference. The String is empty if the load has no amplitude reference.
- amplitudeState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶
A SymbolicConstant specifying the propagation state of the amplitude member. Possible values are UNSET, SET, UNCHANGED, and FREED.
-
criticalPressure : --is-rst--:py:class:`tuple`\ \[:py:class:`float`, :py:data:`...<Ellipsis>`] =
()
[source]¶ A tuple of Floats specifying the critical contact pressure below which fluid penetration starts to occur.
- criticalPressureState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶
A SymbolicConstant specifying the propagation state of the criticalPressure member. Possible values are UNSET, SET, UNCHANGED, and FREED.
-
penetrationPressure : --is-rst--:py:class:`tuple`\ \[:py:class:`float`, :py:data:`...<Ellipsis>`] =
()
[source]¶ A tuple of Floats specifying the fluid pressure magnitude. For steady state dynamic analyses, a tuple of Complexes specifying the fluid pressure magnitude.
- penetrationPressureState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶
A SymbolicConstant specifying the propagation state of the penetrationPressure member. Possible values are UNSET, SET, UNCHANGED, and FREED.
-
penetrationTime : --is-rst--:py:class:`float` | :py:obj:`None` =
None
[source]¶ A Float specifying the fraction of the current step time over which the fluid pressure on newly penetrated contact surface segments is ramped up to the current magnitude. The default value is 10⁻³.
- penetrationTimeState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶
A SymbolicConstant specifying the propagation state of the penetrationTime member. Possible values are UNSET, SET, UNCHANGED, and FREED.
- status : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶
A SymbolicConstant specifying the propagation state of the InteractionState object. Possible values are:
NOT_YET_ACTIVE
CREATED
PROPAGATED
MODIFIED
DEACTIVATED
NO_LONGER_ACTIVE
TYPE_NOT_APPLICABLE
INSTANCE_NOT_APPLICABLE
BUILT_INTO_BASE_STATE
- class RadiationToAmbientState[source]¶
Bases:
InteractionState
The RadiationToAmbientState object stores the propagating data for a RadiationToAmbient object. One instance of this object is created internally by the RadiationToAmbient object for each step. The instance is also deleted internally by the RadiationToAmbient object. The RadiationToAmbientState object has no constructor or methods. The RadiationToAmbientState object is derived from the InteractionState object.
Note
This object can be accessed by:
import interaction mdb.models[name].steps[name].interactionStates[name]
The corresponding analysis keywords are:
SRADIATE
Note
Member Details:
-
ambientTemperature : --is-rst--:py:class:`float` | :py:obj:`None` =
None
[source]¶ A Float specifying the ambient temperature.
-
ambientTemperatureAmp : --is-rst--:py:class:`str` =
''
[source]¶ A String specifying the name of the Amplitude object that gives the variation of the ambient temperature with time.
- ambientTemperatureAmpState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶
A SymbolicConstant specifying the propagation state of the ambientTemperatureAmp member. Possible values are UNSET, SET, UNCHANGED, and FREED.
- ambientTemperatureState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶
A SymbolicConstant specifying the propagation state of the ambientTemperature member. Possible values are UNSET, SET, UNCHANGED, and FREED.
-
emissivity : --is-rst--:py:class:`float` | :py:obj:`None` =
None
[source]¶ A Float specifying the emissivity.
- emissivityState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶
A SymbolicConstant specifying the propagation state of the emissivity member. Possible values are UNSET, SET, UNCHANGED, and FREED.
- status : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶
A SymbolicConstant specifying the propagation state of the InteractionState object. Possible values are:
NOT_YET_ACTIVE
CREATED
PROPAGATED
MODIFIED
DEACTIVATED
NO_LONGER_ACTIVE
TYPE_NOT_APPLICABLE
INSTANCE_NOT_APPLICABLE
BUILT_INTO_BASE_STATE
- class SelfContactExpState[source]¶
Bases:
InteractionState
The SelfContactExpState object stores the propagating data for a SelfContactExp object. One instance of this object is created internally by the SelfContactExp object for each step. The instance is also deleted internally by the SelfContactExp object. The SelfContactExpState object has no constructor or methods. The SelfContactExpState object is derived from the InteractionState object.
Note
This object can be accessed by:
import interaction mdb.models[name].steps[name].interactionStates[name]
The corresponding analysis keywords are:
CONTACT CONTROLS
CONTACT PAIR
MODEL CHANGE
Note
Member Details:
-
contactControls : --is-rst--:py:class:`str` =
''
[source]¶ A String specifying the name of the ContactControl object associated with this interaction.
- contactControlsState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶
A SymbolicConstant specifying the propagation state of the contactControls member. Possible values are UNSET, SET, UNCHANGED, and FREED.
-
interactionProperty : --is-rst--:py:class:`str` =
''
[source]¶ A String specifying the name of the ContactProperty object associated with this interaction.
- interactionPropertyState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶
A SymbolicConstant specifying the propagation state of the interactionProperty member. Possible values are UNSET, SET, UNCHANGED, and FREED.
- status : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶
A SymbolicConstant specifying the propagation state of the InteractionState object. Possible values are:
NOT_YET_ACTIVE
CREATED
PROPAGATED
MODIFIED
DEACTIVATED
NO_LONGER_ACTIVE
TYPE_NOT_APPLICABLE
INSTANCE_NOT_APPLICABLE
BUILT_INTO_BASE_STATE
- class SelfContactStdState[source]¶
Bases:
InteractionState
The SelfContactStdState object stores the propagating data for a SelfContactStd object. One instance of this object is created internally by the SelfContactStd object for each step. The instance is also deleted internally by the SelfContactStd object. The SelfContactStdState object has no constructor or methods. The SelfContactStdState object is derived from the InteractionState object.
Note
This object can be accessed by:
import interaction mdb.models[name].steps[name].interactionStates[name]
The corresponding analysis keywords are:
CONTACT CONTROLS
CONTACT PAIR
MODEL CHANGE
Note
Member Details:
-
contactControls : --is-rst--:py:class:`str` =
''
[source]¶ A String specifying the name of the ContactControl object associated with this interaction.
- contactControlsState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶
A SymbolicConstant specifying the propagation state of the contactControls member. Possible values are UNSET, SET, UNCHANGED, and FREED.
-
interactionProperty : --is-rst--:py:class:`str` =
''
[source]¶ A String specifying the ContactProperty object associated with this interaction.
- interactionPropertyState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶
A SymbolicConstant specifying the propagation state of the interactionProperty member. Possible values are UNSET, SET, UNCHANGED, and FREED.
- status : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶
A SymbolicConstant specifying the propagation state of the InteractionState object. Possible values are:
NOT_YET_ACTIVE
CREATED
PROPAGATED
MODIFIED
DEACTIVATED
NO_LONGER_ACTIVE
TYPE_NOT_APPLICABLE
INSTANCE_NOT_APPLICABLE
BUILT_INTO_BASE_STATE
- class StdXplCosimulationState[source]¶
Bases:
InteractionState
The StdXplCosimulationState object stores the propagating data for a StdXplCosimulation object. One instance of this object is created internally by the StdXplCosimulation object for each step. The instance is also deleted internally by the StdXplCosimulation object. The StdXplCosimulationState object has no constructor or methods. The StdXplCosimulationState object is derived from the InteractionState object.
Note
This object can be accessed by:
import interaction mdb.models[name].steps[name].interactionStates[name]
The corresponding analysis keywords are:
- CO-SIMULATION
CO-SIMULATION REGION
CO-SIMULATION CONTROLS
Note
Member Details:
- status : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶
A SymbolicConstant specifying the propagation state of the InteractionState object. Possible values are:
NOT_YET_ACTIVE
CREATED
PROPAGATED
MODIFIED
DEACTIVATED
NO_LONGER_ACTIVE
TYPE_NOT_APPLICABLE
INSTANCE_NOT_APPLICABLE
BUILT_INTO_BASE_STATE
- class SurfaceToSurfaceExpState[source]¶
Bases:
InteractionState
The SurfaceToSurfaceExpState object stores the propagating data for a SurfaceToSurfaceContactExp object. One instance of this object is created internally by the SurfaceToSurfaceContactExp object for each step. The instance is also deleted internally by the SurfaceToSurfaceContactExp object. The SurfaceToSurfaceExpState object has no constructor or methods. The SurfaceToSurfaceExpState object is derived from the InteractionState object.
Note
This object can be accessed by:
import interaction mdb.models[name].steps[name].interactionStates[name]
The corresponding analysis keywords are:
CONTACT CONTROLS
CONTACT PAIR
Note
Member Details:
-
contactControls : --is-rst--:py:class:`str` =
''
[source]¶ A String specifying the name of the ContactControl object associated with this interaction.
- contactControlsState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶
A SymbolicConstant specifying the propagation state of the contactControls member. Possible values are UNSET, SET, UNCHANGED, and FREED.
-
interactionProperty : --is-rst--:py:class:`str` =
''
[source]¶ A String specifying the name of the ContactProperty object associated with this interaction.
- interactionPropertyState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶
A SymbolicConstant specifying the propagation state of the interactionProperty member. Possible values are UNSET, SET, UNCHANGED, and FREED.
- status : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶
A SymbolicConstant specifying the propagation state of the InteractionState object. Possible values are:
NOT_YET_ACTIVE
CREATED
PROPAGATED
MODIFIED
DEACTIVATED
NO_LONGER_ACTIVE
TYPE_NOT_APPLICABLE
INSTANCE_NOT_APPLICABLE
BUILT_INTO_BASE_STATE
- class SurfaceToSurfaceStdState[source]¶
Bases:
InteractionState
The SurfaceToSurfaceStdState object stores the propagating data for a SurfaceToSurfaceContactStd object. One instance of this object is created internally by the SurfaceToSurfaceContactStd object for each step. The instance is also deleted internally by the SurfaceToSurfaceContactStd object. The SurfaceToSurfaceStdState object has no constructor or methods. The SurfaceToSurfaceStdState object is derived from the InteractionState object.
Note
This object can be accessed by:
import interaction mdb.models[name].steps[name].interactionStates[name]
The corresponding analysis keywords are:
CONTACT CONTROLS
CONTACT PAIR
CONTACT INTERFERENCE
Note
Member Details:
-
amplitude : --is-rst--:py:class:`str` =
''
[source]¶ A String specifying the name of the Amplitude object that defines the magnitude of the prescribed interference during the step.
- amplitudeState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶
A SymbolicConstant specifying the propagation state of the amplitude member. Possible values are UNSET, SET, UNCHANGED, and FREED.
-
contactControls : --is-rst--:py:class:`str` =
''
[source]¶ A String specifying the name of the ContactControl object associated with this interaction.
- contactControlsState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶
A SymbolicConstant specifying the propagation state of the contactControls member. Possible values are UNSET, SET, UNCHANGED, and FREED.
-
direction : --is-rst--:py:class:`float` | :py:obj:`None` =
None
[source]¶ A tuple of three Floats specifying the following: - X-direction cosine of the interference direction vector. - Y-direction cosine of the interference direction vector. - Z-direction cosine of the interference direction vector.
- directionState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶
A SymbolicConstant specifying the propagation state of the direction member. Possible values are UNSET, SET, UNCHANGED, and FREED.
-
interactionProperty : --is-rst--:py:class:`str` =
''
[source]¶ A String specifying the name of the ContactProperty object associated with this interaction.
- interactionPropertyState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶
A SymbolicConstant specifying the propagation state of the interactionProperty member. Possible values are UNSET, SET, UNCHANGED, and FREED.
- interferenceDirectionType : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶
A SymbolicConstant specifying the interference direction type. Possible values are COMPUTED and DIRECTION_COSINE.
- interferenceDirectionTypeState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶
A SymbolicConstant specifying the propagation state of the interferenceDirectionType member. Possible values are UNSET, SET, UNCHANGED, and FREED.
- interferenceType : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶
A SymbolicConstant specifying the interference type. Possible values are NONE, SHRINK_FIT, and UNIFORM.
- interferenceTypeState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶
A SymbolicConstant specifying the propagation state of the interferenceType member. Possible values are UNSET, SET, UNCHANGED, and FREED.
-
overclosure : --is-rst--:py:class:`float` | :py:obj:`None` =
None
[source]¶ A Float specifying the allowable overclosure.
- overclosureState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶
A SymbolicConstant specifying the propagation state of the overclosure member. Possible values are COMPUTED and DIRECTION_COSINE.
- status : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶
A SymbolicConstant specifying the propagation state of the InteractionState object. Possible values are:
NOT_YET_ACTIVE
CREATED
PROPAGATED
MODIFIED
DEACTIVATED
NO_LONGER_ACTIVE
TYPE_NOT_APPLICABLE
INSTANCE_NOT_APPLICABLE
BUILT_INTO_BASE_STATE
- class XFEMCrackGrowthState[source]¶
Bases:
InteractionState
The XFEMCrackGrowthState object stores the propagating data of an XFEMCrackGrowth object in a step. One instance of this object is created internally by the XFEMCrackGrowth object for each step. The instance is also deleted internally by the XFEMCrackGrowth object. The XFEMCrackGrowthState object has no constructor or methods. The XFEMCrackGrowthState object is derived from the InteractionState object.
Note
This object can be accessed by:
import interaction mdb.models[name].steps[name].interactionStates[name]
The corresponding analysis keywords are:
ENRICHMENT ACTIVATION
Note
Member Details:
-
allowGrowth : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] =
1
[source]¶ A Boolean specifying whether the crack is allowed to grow (propagate) during this analysis step. The default value is ON.
- allowGrowthState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶
A SymbolicConstant specifying the propagation state of the allowGrowth member. Possible values are UNSET, SET, UNCHANGED, and FREED.
- status : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶
A SymbolicConstant specifying the propagation state of the InteractionState object. Possible values are:
NOT_YET_ACTIVE
CREATED
PROPAGATED
MODIFIED
DEACTIVATED
NO_LONGER_ACTIVE
TYPE_NOT_APPLICABLE
INSTANCE_NOT_APPLICABLE
BUILT_INTO_BASE_STATE