• Home
  • Features
  • Pricing
  • Docs
  • Announcements
  • Sign In

haiiliin / abqpy / 5910646359

19 Aug 2023 09:25AM UTC coverage: 83.152% (-0.1%) from 83.3%
5910646359

push

github

web-flow
[typing] Fix wrong mypy typing annotations (backport #4879) (#4880)

* [typing] Fix wrong mypy typing annotations (#4879)

* Fix mypy abqpy issues

* Mypy typings

* Update typing annotations for SymbolicConstants

* Fixing typings

* Add future annotations

* Use list/dict/tuple instead of List/Dict/Tuple

* Fix Optional typings

* Add future annotations

* Update xyPlot.py

* Update .pre-commit-config.yaml

* Fix list typings for Python 3.7/3.8

* Fixing more typings

* Fix more typings

* Update conf.py

* Update .pre-commit-config.yaml

* Revert "Update conf.py"

This reverts commit e8449ae0c.

* Update conf.py

* Revert "Update conf.py"

This reverts commit 3be44d0a5.

* Docs Not -W

(cherry picked from commit d7be4b472)

# Conflicts:
#	src/abaqus/BasicGeometry/Cell.py
#	src/abaqus/BasicGeometry/CellArray.py
#	src/abaqus/BasicGeometry/Face.py
#	src/abaqus/BasicGeometry/FaceArray.py
#	src/abaqus/BoundaryCondition/BoundaryConditionModel.py
#	src/abaqus/BoundaryCondition/SubmodelBC.py
#	src/abaqus/Datum/DatumCsys.py
#	src/abaqus/DisplayGroup/LeafFromConstraintNames.py
#	src/abaqus/EngineeringFeature/DataImperfection.py
#	src/abaqus/EngineeringFeature/EngineeringFeature.py
#	src/abaqus/EngineeringFeature/EngineeringFeatureBase.py
#	src/abaqus/EngineeringFeature/FileImperfection.py
#	src/abaqus/EngineeringFeature/InputImperfection.py
#	src/abaqus/FieldReport/FieldReportSession.py
#	src/abaqus/FieldReport/writeFieldReport.py
#	src/abaqus/Interaction/ContactExp.py
#	src/abaqus/Interaction/ContactStd.py
#	src/abaqus/Interaction/ExpInitialization.py
#	src/abaqus/Interaction/FluidInflatorProperty.py
#	src/abaqus/Interaction/FluidInflatorState.py
#	src/abaqus/Interaction/InteractionContactInitializationModel.py
#	src/abaqus/Interaction/InteractionModel.py
#	src/abaqus/Interaction/InteractionPropertyModel.py
#	src/abaqus/Interaction/SurfaceCrushTriggerAssignment.py
#... (continued)

3258 of 3258 new or added lines in 713 files covered. (100.0%)

24089 of 28970 relevant lines covered (83.15%)

0.83 hits per line

Source File
Press 'n' to go to next uncovered line, 'b' for previous

67.61
/src/abaqus/Interaction/InteractionModel.py
1
from __future__ import annotations
1✔
2

3
from typing import Union
1✔
4

5
from typing_extensions import Literal
1✔
6

7
from abqpy.decorators import abaqus_class_doc, abaqus_method_doc
1✔
8

9
from ..BasicGeometry.ModelDot import ModelDot
1✔
10
from ..Datum.DatumAxis import DatumAxis
1✔
11
from ..Interaction.AcousticImpedance import AcousticImpedance
1✔
12
from ..Interaction.ActuatorSensor import ActuatorSensor
1✔
13
from ..Interaction.CavityRadiation import CavityRadiation
1✔
14
from ..Interaction.ConcentratedFilmCondition import ConcentratedFilmCondition
1✔
15
from ..Interaction.ConcentratedRadiationToAmbient import ConcentratedRadiationToAmbient
1✔
16
from ..Interaction.ContactExp import ContactExp
1✔
17
from ..Interaction.ContactPropertyAssignment import ContactPropertyAssignment
1✔
18
from ..Interaction.ContactStd import ContactStd
1✔
19
from ..Interaction.CyclicSymmetry import CyclicSymmetry
1✔
20
from ..Interaction.ElasticFoundation import ElasticFoundation
1✔
21
from ..Interaction.FilmCondition import FilmCondition
1✔
22
from ..Interaction.FluidCavity import FluidCavity
1✔
23
from ..Interaction.FluidExchange import FluidExchange
1✔
24
from ..Interaction.IncidentWave import IncidentWave
1✔
25
from ..Interaction.InitializationAssignment import InitializationAssignment
1✔
26
from ..Interaction.MasterSlaveAssignment import MasterSlaveAssignment
1✔
27
from ..Interaction.ModelChange import ModelChange
1✔
28
from ..Interaction.PressurePenetration import PressurePenetration
1✔
29
from ..Interaction.RadiationToAmbient import RadiationToAmbient
1✔
30
from ..Interaction.RegionPairs import RegionPairs
1✔
31
from ..Interaction.SelfContactExp import SelfContactExp
1✔
32
from ..Interaction.SelfContactStd import SelfContactStd
1✔
33
from ..Interaction.SlidingTransitionAssignment import SlidingTransitionAssignment
1✔
34
from ..Interaction.SmoothingAssignment import SmoothingAssignment
1✔
35
from ..Interaction.StabilizationAssignment import StabilizationAssignment
1✔
36
from ..Interaction.StdXplCosimulation import StdXplCosimulation
1✔
37
from ..Interaction.SurfaceFeatureAssignment import SurfaceFeatureAssignment
1✔
38
from ..Interaction.SurfaceOffsetAssignment import SurfaceOffsetAssignment
1✔
39
from ..Interaction.SurfaceThicknessAssignment import SurfaceThicknessAssignment
1✔
40
from ..Interaction.SurfaceToSurfaceContactExp import SurfaceToSurfaceContactExp
1✔
41
from ..Interaction.SurfaceToSurfaceContactStd import SurfaceToSurfaceContactStd
1✔
42
from ..Interaction.XFEMCrackGrowth import XFEMCrackGrowth
1✔
43
from ..Region.Region import Region
1✔
44
from ..Region.RegionArray import RegionArray
1✔
45
from ..UtilityAndView.abaqusConstants import (
1✔
46
    ALL_NODAL_DIAMETER,
47
    ALLOW_SUBCYCLING,
48
    AMBIENT,
49
    BLOCKING_ALL,
50
    COMPUTED,
51
    COMPUTED_TOLERANCE,
52
    CONTACT,
53
    DEFAULT,
54
    GEOMETRY,
55
    KINEMATIC,
56
    LAGRANGIAN,
57
    MODEL,
58
    NONE,
59
    OFF,
60
    OMIT,
61
    ON,
62
    PLANE,
63
    PRESSURE,
64
    SURFACE_TO_SURFACE,
65
    TABULAR,
66
    TO_ENVIRONMENT,
67
    UNIFORM,
68
    UNSET,
69
    USE_GEOMETRY,
70
    Boolean,
71
)
72
from ..UtilityAndView.abaqusConstants import abaqusConstants as C
1✔
73
from .InteractionContactControlModel import InteractionContactControlModel
1✔
74
from .InteractionContactInitializationModel import InteractionContactInitializationModel
1✔
75
from .InteractionContactStabilizationModel import InteractionContactStabilizationModel
1✔
76
from .InteractionPropertyModel import InteractionPropertyModel
1✔
77

78

79
@abaqus_class_doc
1✔
80
class InteractionModel(
1✔
81
    InteractionContactControlModel,
82
    InteractionContactInitializationModel,
83
    InteractionContactStabilizationModel,
84
    InteractionPropertyModel,
85
):
86
    """Abaqus creates a Model object named `Model-1` when a session is started.
87

88
    .. note::
89
        This object can be accessed by::
90

91
            mdb.models[name]
92
    """
93

94
    @abaqus_method_doc
1✔
95
    def contactDetection(
1✔
96
        self,
97
        name: str = "",
98
        createStepName: str = "",
99
        searchDomain: Literal[C.MODEL] = MODEL,
100
        defaultType: Literal[C.CONTACT, C.CONTACT_EXPLICIT, C.TIE, C.CONTACT_STANDARD] = CONTACT,
101
        interactionProperty: str = "",
102
        separationTolerance: float | None = None,
103
        extendByAngle: float = 20,
104
        mergeWithinAngle: float = 20,
105
        searchSingleInstances: Boolean = OFF,
106
        nameEachSurfaceFound: Boolean = ON,
107
        createUnionOfMasterSurfaces: Boolean = OFF,
108
        createUnionOfSlaveSurfaces: Boolean = OFF,
109
        createUnionOfMasterSlaveSurfaces: Boolean = OFF,
110
        includePlanar: Boolean = ON,
111
        includeCylindricalSphericalToric: Boolean = ON,
112
        includeSplineBased: Boolean = ON,
113
        includeMeshSolid: Boolean = ON,
114
        includeMeshShell: Boolean = ON,
115
        includeMeshMembrane: Boolean = OFF,
116
        includeOverclosed: Boolean = ON,
117
        includeNonOverlapping: Boolean = OFF,
118
        meshedGeometrySearchTechnique: Literal[C.USE_MESH, C.USE_GEOMETRY] = USE_GEOMETRY,
119
        useShellThickness: Boolean = ON,
120
        surfaceSmoothing: Literal[C.AUTOMATIC, C.NONE] | None = None,
121
    ):
122
        """This method uses contact detection to create SurfaceToSurfaceContactStd, SurfaceToSurfaceContactExp,
123
        and Tie objects.
124

125
        Parameters
126
        ----------
127
        name
128
            A String specifying the prefix used to generate repository keys. The default value is
129
            "CP-"
130
        createStepName
131
            A String specifying the name of the step in which the SurfaceToSurfaceContactStd,
132
            SurfaceToSurfaceContactExp, and Tie objects are created. The default value is "Initial."
133
        searchDomain
134
            A SymbolicConstant MODEL or a sequence of Strings specifying the names of instances to
135
            search. MODEL indicates the whole model is searched. The default value is MODEL.
136
        defaultType
137
            A SymbolicConstant specifying the default type of object to create. Possible values are
138
            CONTACT, CONTACT_STANDARD, CONTACT_EXPLICIT, and TIE. If CONTACT is used, the behavior
139
            is determined by the type of Step in the model. If an ExplicitDynamicsStep or
140
            TempDisplacementDynamicsStep exists, then SurfaceToSurfaceContactExp is created by
141
            default. Otherwise SurfaceToSurfaceContactStd is created by default. The default value
142
            is CONTACT.
143
        interactionProperty
144
            A String specifying the name of the ContactProperty object associated with any
145
            interactions created.
146
        separationTolerance
147
            A Float specifying the maximum separation for considering two surfaces to be candidates
148
            for contact, where separation is the maximum distance between the points of closest
149
            approach on the two surfaces. The default value is a function of the model.
150
        extendByAngle
151
            None or a Float specifying the angle for extending surface definitions to include
152
            adjacent faces. The default value is 20.
153
        mergeWithinAngle
154
            None or a Float specifying the angle for merging adjacent contact pairs that lie within
155
            the angle. The default value is 20.
156
        searchSingleInstances
157
            A Boolean specifying whether to include surface pairs within a single instance. The
158
            default value is OFF.
159
        nameEachSurfaceFound
160
            A Boolean specifying whether to assign a name to each surface found. The default value
161
            is ON.
162
        createUnionOfMasterSurfaces
163
            A Boolean specifying whether to create a surface that is the union of all master surfaces
164
            found. The default value is OFF.
165
        createUnionOfSlaveSurfaces
166
            A Boolean specifying whether to create a surface that is the union of all slave
167
            surfaces found. The default value is OFF.
168
        createUnionOfMasterSlaveSurfaces
169
            A Boolean specifying whether to create a surface that is the union of all master and
170
            slave surfaces found. The default value is OFF.
171
        includePlanar
172
            A Boolean specifying whether to include planar geometry. The default value is ON.
173
        includeCylindricalSphericalToric
174
            A Boolean specifying whether to include cylindrical, spherical, and toric geometry. The
175
            default value is ON.
176
        includeSplineBased
177
            A Boolean specifying whether to include spline-based geometry. The default value is ON.
178
        includeMeshSolid
179
            A Boolean specifying whether to include solid mesh entities. The default value is ON.
180
        includeMeshShell
181
            A Boolean specifying whether to include shell mesh entities. The default value is ON.
182
        includeMeshMembrane
183
            A Boolean specifying whether to include mesh membrane entities. The default value is
184
            OFF.
185
        includeOverclosed
186
            A Boolean specifying whether to include overclosed pairs. The default value is ON.
187
        includeNonOverlapping
188
            A Boolean specifying whether to include opposing geometry surfaces that do not overlap.
189
            The default value is OFF.
190
        meshedGeometrySearchTechnique
191
            A SymbolicConstant USE_GEOMETRY or USE_MESH specifying whether to locate pairs in meshed
192
            geometry using the geometric entities or mesh entities. The default value is
193
            USE_GEOMETRY.
194
        useShellThickness
195
            A Boolean specifying whether to account for shell thickness and offset during contact
196
            detection. The default value is ON.
197
        surfaceSmoothing
198
            A SymbolicConstant specifying whether to use surface smoothing for geometric surfaces in
199
            SurfaceToSurfaceContactStd interactions. Possible values are NONE and AUTOMATIC. The
200
            default value isAUTOMATIC.
201

202
        Returns
203
        -------
204
        None.
205
        """
206
        ...
×
207

208
    @abaqus_method_doc
1✔
209
    def getSurfaceSeparation(self) -> tuple[tuple[str, str, float, bool]]:
1✔
210
        """This method returns a list of all possible contacts that can be created using the ContactDetection
211
        method.
212

213
        Returns
214
        -------
215
        tuple[tuple[str, str, float, bool]]
216
            Tuple of tuples, where each tuple holds information, to be used in contact creation as
217
            follows:
218

219
            - A string specifying the name of the master surface used in contact.
220
            - A string specifying the name of the slave surface used in contact.
221
            - A float specifying the separation distance between the master surface and the slave
222
              surface.
223
            - A boolean specifying whether or not contact surfaces are overclosed.
224
        """
225
        return (("main", "secondary", 0.0, False),)
×
226

227
    @abaqus_method_doc
1✔
228
    def AcousticImpedance(
1✔
229
        self,
230
        name: str,
231
        createStepName: str,
232
        surface: Region,
233
        definition: Literal[C.TABULAR, C.NONREFLECTING] = TABULAR,
234
        interactionProperty: str = "",
235
        nonreflectingType: Literal[
236
            C.PLANE, C.ELLIPTICAL, C.IMPROVED, C.SPHERICAL, C.PROLATE, C.CIRCULAR, C.NONREFLECTING
237
        ] = PLANE,
238
        radius: float = 1,
239
        semimajorAxis: float = 1,
240
        eccentricity: float = 0,
241
        centerCoordinates: tuple = (),
242
        directionCosine: tuple = (),
243
    ) -> AcousticImpedance:
244
        """This method creates an AcousticImpedance object.
245

246
        .. note::
247
            This function can be accessed by::
248

249
                mdb.models[name].AcousticImpedance
250

251
        Parameters
252
        ----------
253
        name
254
            A String specifying the repository key.
255
        createStepName
256
            A String specifying the name of the step in which the AcousticImpedance object is
257
            created.
258
        surface
259
            A Region object specifying the acoustic boundary surface.
260
        definition
261
            A SymbolicConstant specifying the type of acoustic impedance to be defined. Possible
262
            values are TABULAR and NONREFLECTING. The default value is TABULAR.
263
        interactionProperty
264
            A String specifying the AcousticImpedanceProp object associated with this interaction.
265
        nonreflectingType
266
            A SymbolicConstant specifying the type of nonreflecting geometry to be defined. Possible
267
            values are PLANE, IMPROVED, CIRCULAR, SPHERICAL, ELLIPTICAL, and PROLATE. The default
268
            value is PLANE.This argument is valid only when **definition** = NONREFLECTING.
269
        radius
270
            A Float specifying the radius of the circle or sphere defining the boundary surface. The
271
            default value is 1.0.This argument is valid only when **definition** = NONREFLECTING, and
272
            **nonreflectingType** = CIRCULAR or SPHERICAL.
273
        semimajorAxis
274
            A Float specifying the semimajor axis length of the ellipse or prolate spheroid defining
275
            the boundary surface. The default value is 1.0.This argument is valid only when
276
            **definition** = NONREFLECTING, and **nonreflectingType** = ELLIPTICAL or PROLATE.
277
        eccentricity
278
            A Float specifying the eccentricity of the ellipse or prolate spheroid defining the
279
            boundary surface. The default value is 0.0.This argument is valid only when
280
            **definition** = NONREFLECTING, and **nonreflectingType** = ELLIPTICAL or PROLATE.
281
        centerCoordinates
282
            A sequence of three Floats specifying the X, Y, and Z coordinates of the center of the
283
            ellipse or prolate spheroid defining the boundary surface. The default value is (0, 0,
284
            0).This argument is valid only when **definition** = NONREFLECTING, and
285
            **nonreflectingType** = ELLIPTICAL or PROLATE.
286
        directionCosine
287
            A sequence of three Floats specifying the X, Y, and Z components of the direction cosine
288
            of the major axis of the ellipse or prolate spheroid defining the boundary surface. The
289
            default value is (0, 0, 1).This argument is valid only when **definition** = NONREFLECTING,
290
            and **nonreflectingType** = ELLIPTICAL or PROLATE.
291

292
        Returns
293
        -------
294
        AcousticImpedance
295
            An AcousticImpedance object.
296
        """
297
        self.interactions[name] = interaction = AcousticImpedance(
×
298
            name,
299
            createStepName,
300
            surface,
301
            definition,
302
            interactionProperty,
303
            nonreflectingType,
304
            radius,
305
            semimajorAxis,
306
            eccentricity,
307
            centerCoordinates,
308
            directionCosine,
309
        )
310
        return interaction
×
311

312
    @abaqus_method_doc
1✔
313
    def ActuatorSensor(
1✔
314
        self,
315
        name: str,
316
        createStepName: str,
317
        point: Region,
318
        interactionProperty: str,
319
        noCoordComponents: int,
320
        unsymm: Boolean,
321
        noSolutionDepVar: int,
322
        userSubUel: str,
323
        dof: str,
324
        solutionDepVars: tuple,
325
    ) -> ActuatorSensor:
326
        """This method creates an ActuatorSensor object.
327

328
        .. note::
329
            This function can be accessed by::
330

331
                mdb.models[name].ActuatorSensor
332

333
        Parameters
334
        ----------
335
        name
336
            A String specifying the repository key.
337
        createStepName
338
            A String specifying the name of the step in which the actuator/sensor interaction is
339
            created. **createStepName** must be set to 'Initial'.
340
        point
341
            A Region object specifying the point at which the constraint is applied.
342
        interactionProperty
343
            A String specifying the ActuatorSensorProp object associated with this interaction.
344
        noCoordComponents
345
            An Int specifying the number of coordinate components supplied to the user subroutine
346
            (UEL).
347
        unsymm
348
            A Boolean specifying whether the element matrices are symmetric (ON) or unsymmetric
349
            (OFF). The default value is OFF.
350
        noSolutionDepVar
351
            An Int specifying the number of solution-dependent variables. The default value is 0.
352
        userSubUel
353
            A String specifying the name of the user subroutine (UEL) that defines the user element.
354
        dof
355
            A String specifying the degrees of freedom, separated by commas.
356
        solutionDepVars
357
            A sequence of Floats specifying the initial values of the solution-dependent variables.
358

359
        Returns
360
        -------
361
        ActuatorSensor
362
            An ActuatorSensor object.
363
        """
364
        self.interactions[name] = interaction = ActuatorSensor(
×
365
            name,
366
            createStepName,
367
            point,
368
            interactionProperty,
369
            noCoordComponents,
370
            unsymm,
371
            noSolutionDepVar,
372
            userSubUel,
373
            dof,
374
            solutionDepVars,
375
        )
376
        return interaction
×
377

378
    @abaqus_method_doc
1✔
379
    def CavityRadiation(
1✔
380
        self,
381
        name: str,
382
        createStepName: str,
383
        surfaces: RegionArray,
384
        surfaceEmissivities: tuple = (),
385
        ambientTemp: float | None = None,
386
        blocking: Literal[C.NO_BLOCKING, C.BLOCKING_ALL, C.PARTIAL_BLOCKING] = BLOCKING_ALL,
387
        blockingSurfaces: RegionArray | None = None,
388
        rangeOfView: float | None = None,
389
        surfaceReflection: Boolean = ON,
390
        viewfactorAccurTol: float = 0,
391
        minInfinitesimalRatio: float = 64,
392
        numPointsPerEdge: int = 3,
393
        minLumpedAreaDS: float = 5,
394
        cyclicSymmetry: Boolean = OFF,
395
        cyclicImages: int = 2,
396
        cyclicRotPt: ModelDot | None = None,
397
        cyclicRotEndPt: ModelDot | None = None,
398
        cyclicSymPt: ModelDot | None = None,
399
        periodicSymmetries: int = 0,
400
        periodicImages_1: int = 2,
401
        periodicImages_2: int = 2,
402
        periodicImages_3: int = 2,
403
        periodicSymAxis_1: str = "",
404
        periodicSymAxis_2: str = "",
405
        periodicSymPlane_1: str = "",
406
        periodicSymPlane_2: str = "",
407
        periodicSymPlane_3: str = "",
408
        periodicDistance_1: tuple = (),
409
        periodicDistance_2: tuple = (),
410
        periodicDistance_3: tuple = (),
411
        periodicSymZ: float | None = None,
412
        periodicDistZ: float | None = None,
413
        reflectionSymmetries: int = 0,
414
        reflectionSymAxis_1: str = "",
415
        reflectionSymAxis_2: str = "",
416
        reflectionSymPlane_1: str = "",
417
        reflectionSymPlane_2: str = "",
418
        reflectionSymPlane_3: str = "",
419
        reflectionSymZ: float | None = None,
420
    ) -> CavityRadiation:
421
        """This method creates a CavityRadiation object.
422

423
        .. note::
424
            This function can be accessed by::
425

426
                mdb.models[name].CavityRadiation
427

428
        Parameters
429
        ----------
430
        name
431
            A String specifying the repository key.
432
        createStepName
433
            A String specifying the name of the step in which the cavity radiation interaction
434
            should be created.
435
        surfaces
436
            A RegionArray object specifying the surfaces for which radiation viewfactor control is
437
            being specified.
438
        surfaceEmissivities
439
            A sequence of Strings specifying the names of the Cavity Radiation properties containing
440
            the surface emissivity data. One name per specified surface. The emissivity data is
441
            ignored when **surfaceReflection** = OFF.
442
        ambientTemp
443
            None or a Float specifying the reference ambient temperature value, θ0θ0. Specifying a
444
            value indicates an open cavity. The default value is None.
445
        blocking
446
            A SymbolicConstant specifying the blocking checks to be performed in the viewfactor
447
            calculations. Possible values are BLOCKING_ALL, NO_BLOCKING, and PARTIAL_BLOCKING. The
448
            default value is BLOCKING_ALL.
449
        blockingSurfaces
450
            A RegionArray object specifying the surfaces that provide blocking inside the cavity.
451
            This argument applies only when **blocking** = PARTIAL_BLOCKING.
452
        rangeOfView
453
            None or a Float specifying the maximum distance between surface facets at which
454
            viewfactors are calculated. More distant facets are deemed too far apart to exchange
455
            significant amounts of heat through radiation effects, and the viewfactors between these
456
            facets are assumed to be zero. If **rangeOfView** = None, there is no upper limit. The
457
            default value is None.
458
        surfaceReflection
459
            A Boolean specifying whether heat reflections are to be included in the cavity radiation
460
            calculations. The default value is ON.
461
        viewfactorAccurTol
462
            A Float specifying the acceptable tolerance for the viewfactor calculations. The default
463
            value is 0.05.
464
        minInfinitesimalRatio
465
            A Float specifying the facet area ratio above which the infinitesimal-to-finite area
466
            approximation is used for viewfactor calculations. The default value is 64.0.
467
        numPointsPerEdge
468
            An Int specifying the number of Gauss integration points to be used along each edge when
469
            the numerical integration of contour integrals is used for viewfactor calculations. One
470
            to five integration points are allowed. The default value is 3.
471
        minLumpedAreaDS
472
            A Float specifying the nondimensional distance-square value above which the lumped area
473
            approximation is used for viewfactor calculations. The default value is 5.0.
474
        cyclicSymmetry
475
            A Boolean specifying whether cyclic symmetry will be applied. This argument cannot be
476
            specified for axisymmetric models. The default value is OFF.
477
        cyclicImages
478
            An Int specifying the number of cyclically similar images that compose the cavity formed
479
            as a result of this symmetry. This argument applies only when **cyclicSymmetry** = ON. The
480
            default value is 2.
481
        cyclicRotPt
482
            A ModelDot object specifying the rotation axis point. This argument applies only when
483
            **cyclicSymmetry** = ON.
484
        cyclicRotEndPt
485
            A ModelDot object specifying the rotation axis end point. This argument applies only for
486
            three-dimensional models, and only when **cyclicSymmetry** = ON.
487
        cyclicSymPt
488
            A ModelDot object specifying the symmetry axis end point. This argument applies only
489
            when **cyclicSymmetry** = ON.
490
        periodicSymmetries
491
            An Int specifying the number of periodic symmetries that will be applied. The default
492
            value is 0.
493
        periodicImages_1
494
            An Int specifying the number of repetitions used in the numerical calculation of the
495
            cavity viewfactors resulting from the first periodic symmetry. The result of this
496
            symmetry is a cavity composed of the cavity surface defined in the model plus twice the
497
            value of **periodicImages_1**. This argument applies only when **periodicSymmetries** is
498
            greater than zero. The default value is 2.
499
        periodicImages_2
500
            An Int specifying the number of repetitions used in the numerical calculation of the
501
            cavity viewfactors resulting from the second periodic symmetry. The result of this
502
            symmetry is a cavity composed of the cavity surface defined in the model plus twice the
503
            value of **periodicImages_2**. This argument applies only when **periodicSymmetries** is
504
            greater than one. The default value is 2.
505
        periodicImages_3
506
            An Int specifying the number of repetitions used in the numerical calculation of the
507
            cavity viewfactors resulting from the third periodic symmetry. The result of this
508
            symmetry is a cavity composed of the cavity surface defined in the model plus twice the
509
            value of **periodicImages_3**. This argument applies only when **periodicSymmetries** = 3.
510
            The default value is 2.
511
        periodicSymAxis_1
512
            A straight Edge, a Datum object representing a datum axis, or an ElementEdge object
513
            indicating the first line of symmetry in two-dimensional models. This argument applies
514
            only for 2D models, and when **periodicSymmetries** is greater than zero.
515
        periodicSymAxis_2
516
            A straight Edge, a Datum object representing a datum axis, or an ElementEdge object
517
            indicating the second line of symmetry in two-dimensional models. This argument applies
518
            only for two-dimensional models, and when **periodicSymmetries** = 2.
519
        periodicSymPlane_1
520
            A planar Face, an ElementFace, or a Datum object representing a datum plane; indicating
521
            the first plane of symmetry in three-dimensional models. This argument applies only for
522
            three-dimensional models, and when **periodicSymmetries** is greater than zero.
523
        periodicSymPlane_2
524
            A planar Face, an ElementFace, or a Datum object representing a datum plane; indicating
525
            the second plane of symmetry in three-dimensional models. This argument applies only for
526
            three-dimensional models, and when **periodicSymmetries** is greater than one.
527
        periodicSymPlane_3
528
            A planar Face, an ElementFace, or a Datum object representing a datum plane; indicating
529
            the third plane of symmetry in three-dimensional models. This argument applies only for
530
            three-dimensional models, and when **periodicSymmetries** = 3.
531
        periodicDistance_1
532
            A sequence of sequences of Floats specifying the two points of the vector that describes
533
            the periodic distance for the first periodic symmetry. Each point is defined by a tuple
534
            of three coordinates indicating its position. This argument applies only when
535
            **periodicSymmetries** is greater than zero. The default value is an empty sequence.
536
        periodicDistance_2
537
            A sequence of sequences of Floats specifying the two points of the vector that describes
538
            the periodic distance for the second periodic symmetry. Each point is defined by a tuple
539
            of three coordinates indicating its position. This argument applies only when
540
            **periodicSymmetries** is greater than one. The default value is an empty sequence.
541
        periodicDistance_3
542
            A sequence of sequences of Floats specifying the two points of the vector that describes
543
            the periodic distance for the third periodic symmetry. Each point is defined by a tuple
544
            of three coordinates indicating its position. This argument applies only when
545
            **periodicSymmetries** = 3. The default value is an empty sequence.
546
        periodicSymZ
547
            None or a Float specifying the Z value indicating the symmetry reference line in
548
            axisymmetric models. This argument applies only for axisymmetric models, and when
549
            **periodicSymmetries** = 1. The default value is None.
550
        periodicDistZ
551
            None or a Float specifying the Z value indicating the periodic distance in axisymmetric
552
            models. This argument applies only for axisymmetric models, and when
553
            **periodicSymmetries** = 1. The default value is None.
554
        reflectionSymmetries
555
            An Int specifying the number of reflection symmetries will be applied. The default value
556
            is 0.
557
        reflectionSymAxis_1
558
            A straight Edge, a Datum object representing a datum axis, or an ElementEdge object
559
            indicating the first line of symmetry in two-dimensional models. This argument applies
560
            only for two-dimensional models, and when **reflectionSymmetries** is greater than zero.
561
        reflectionSymAxis_2
562
            A straight Edge, a Datum object representing a datum axis, or an ElementEdge object
563
            indicating the second line of symmetry in two-dimensional models. This argument applies
564
            only for two-dimensional models, and when **reflectionSymmetries** = 2.
565
        reflectionSymPlane_1
566
            A planar Face, an ElementFace, or a Datum object representing a datum plane; indicating
567
            the first plane of symmetry in three-dimensional models. This argument applies only for
568
            three-dimensional models, and when **reflectionSymmetries** is greater than zero.
569
        reflectionSymPlane_2
570
            A planar Face, an ElementFace, or a Datum object representing a datum plane; indicating
571
            the second plane of symmetry in three-dimensional models. This argument applies only for
572
            three-dimensional models, and when **reflectionSymmetries** is greater than one.
573
        reflectionSymPlane_3
574
            A planar Face, an ElementFace, or a Datum object representing a datum plane; indicating
575
            the third plane of symmetry in three-dimensional models. This argument applies only for
576
            three-dimensional models, and when **reflectionSymmetries** = 3.
577
        reflectionSymZ
578
            None or a Float specifying the Z value indicating the symmetry reference line in
579
            axisymmetric models. This argument applies only for axisymmetric models, and when
580
            **reflectionSymmetries** = 1. The default value is None.
581

582
        Returns
583
        -------
584
        CavityRadiation
585
            A CavityRadiation object.
586
        """
587
        self.interactions[name] = interaction = CavityRadiation(
×
588
            name,
589
            createStepName,
590
            surfaces,
591
            surfaceEmissivities,
592
            ambientTemp,
593
            blocking,
594
            blockingSurfaces,
595
            rangeOfView,
596
            surfaceReflection,
597
            viewfactorAccurTol,
598
            minInfinitesimalRatio,
599
            numPointsPerEdge,
600
            minLumpedAreaDS,
601
            cyclicSymmetry,
602
            cyclicImages,
603
            cyclicRotPt,
604
            cyclicRotEndPt,
605
            cyclicSymPt,
606
            periodicSymmetries,
607
            periodicImages_1,
608
            periodicImages_2,
609
            periodicImages_3,
610
            periodicSymAxis_1,
611
            periodicSymAxis_2,
612
            periodicSymPlane_1,
613
            periodicSymPlane_2,
614
            periodicSymPlane_3,
615
            periodicDistance_1,
616
            periodicDistance_2,
617
            periodicDistance_3,
618
            periodicSymZ,
619
            periodicDistZ,
620
            reflectionSymmetries,
621
            reflectionSymAxis_1,
622
            reflectionSymAxis_2,
623
            reflectionSymPlane_1,
624
            reflectionSymPlane_2,
625
            reflectionSymPlane_3,
626
            reflectionSymZ,
627
        )
628
        return interaction
×
629

630
    @abaqus_method_doc
1✔
631
    def ConcentratedFilmCondition(
1✔
632
        self,
633
        name: str,
634
        createStepName: str,
635
        region: Region,
636
        definition: Literal[C.EMBEDDED_COEFF, C.FIELD, C.USER_SUB, C.PROPERTY_REF],
637
        nodalArea: float = 1,
638
        explicitRegionType: Literal[C.LAGRANGIAN, C.SLIDING, C.EULERIAN] = LAGRANGIAN,
639
        interactionProperty: str = "",
640
        field: str = "",
641
        sinkTemperature: float = 0,
642
        sinkAmplitude: str = "",
643
        filmCoeff: float = 0,
644
        filmCoeffAmplitude: str = "",
645
        sinkFieldName: str = "",
646
        sinkDistributionType: Literal[C.DISCRETE_FIELD, C.UNIFORM, C.ANALYTICAL_FIELD] = UNIFORM,
647
    ) -> ConcentratedFilmCondition:
648
        """This method creates a ConcentratedFilmCondition object.
649

650
        .. note::
651
            This function can be accessed by::
652

653
                mdb.models[name].ConcentratedFilmCondition
654

655
        Parameters
656
        ----------
657
        name
658
            A String specifying the repository key.
659
        createStepName
660
            A String specifying the name of the step in which the ConcentratedFilmCondition object
661
            is created.
662
        region
663
            A Region object specifying the region to which the concentrated film condition
664
            interaction is applied. The interaction is applied to each node in the region.
665
        definition
666
            A SymbolicConstant specifying how the concentrated film condition is defined. Possible
667
            values are EMBEDDED_COEFF, PROPERTY_REF, USER_SUB, and FIELD.
668
        nodalArea
669
            A Float specifying the area associated with the node where the concentrated film
670
            condition is applied. The default value is 1.0.
671
        explicitRegionType
672
            A SymbolicConstant specifying how the concentrated film condition is applied to the
673
            boundary of an adaptive mesh domain. Possible values are LAGRANGIAN, SLIDING, and
674
            EULERIAN. The default value is LAGRANGIAN. This argument applies only during an
675
            Abaqus/Explicit analysis.
676
        interactionProperty
677
            A String specifying the name of the FilmConditionProp object associated with this
678
            interaction. The **interactionProperty** argument applies only when
679
            **definition** = PROPERTY_REF. The default value is an empty string.
680
        field
681
            A String specifying the name of the AnalyticalField object associated with this
682
            interaction. The **field** argument applies only when **definition** = FIELD. The default
683
            value is an empty string.
684
        sinkTemperature
685
            A Float specifying the reference sink temperature, θ0θ0. The default value is 0.0.
686
        sinkAmplitude
687
            A String specifying the name of the Amplitude object that gives the variation of the
688
            sink temperature, θ0θ0, with time. The default value is an empty string. Note: Use None in
689
            an Abaqus/Standard analysis to specify that the reference sink temperature is applied
690
            immediately at the beginning of the step or linearly over the step. Use None in an
691
            Abaqus/Explicit analysis to specify that the reference sink temperature is applied
692
            throughout the step.
693
        filmCoeff
694
            A Float specifying the reference film coefficient value, hh. The **filmCoeff** argument
695
            applies when **definition** = EMBEDDED_COEFF, **definition** = USER_SUB, or **definition** = FIELD.
696
            The default value is 0.0.
697
        filmCoeffAmplitude
698
            A String specifying the name of the Amplitude object that gives the variation of the
699
            film coefficient, hh, with time. The default value is an empty string. Note: Use None in
700
            an Abaqus/Standard analysis to specify that the reference film coefficient is applied
701
            immediately at the beginning of the step or linearly over the step. Use None in an
702
            Abaqus/Explicit analysis to specify that the reference film coefficient is applied
703
            throughout the step.
704
        sinkFieldName
705
            A String specifying the name of the AnalyticalField or DiscreteField object associated
706
            with the sink temperature. The **sinkFieldName** argument applies only when
707
            **sinkDistributionType** = ANALYTICAL_FIELD or **sinkDistributionType** = DISCRETE_FIELD. The
708
            default value is an empty string.
709
        sinkDistributionType
710
            A SymbolicConstant specifying how the sink temperature is distributed. Possible values
711
            are UNIFORM, ANALYTICAL_FIELD, and DISCRETE_FIELD. The default value is UNIFORM.
712

713
        Returns
714
        -------
715
        ConcentratedFilmCondition
716
            A ConcentratedFilmCondition object.
717
        """
718
        self.interactions[name] = interaction = ConcentratedFilmCondition(
×
719
            name,
720
            createStepName,
721
            region,
722
            definition,
723
            nodalArea,
724
            explicitRegionType,
725
            interactionProperty,
726
            field,
727
            sinkTemperature,
728
            sinkAmplitude,
729
            filmCoeff,
730
            filmCoeffAmplitude,
731
            sinkFieldName,
732
            sinkDistributionType,
733
        )
734
        return interaction
×
735

736
    @abaqus_method_doc
1✔
737
    def ConcentratedRadiationToAmbient(
1✔
738
        self,
739
        name: str,
740
        createStepName: str,
741
        region: Region,
742
        ambientTemperature: float,
743
        ambientTemperatureAmp: str,
744
        emissivity: float,
745
        nodalArea: float = 1,
746
        explicitRegionType: Literal[C.LAGRANGIAN, C.SLIDING, C.EULERIAN] = LAGRANGIAN,
747
        field: str = "",
748
        distributionType: Literal[C.UNIFORM, C.ANALYTICAL_FIELD] = UNIFORM,
749
    ) -> ConcentratedRadiationToAmbient:
750
        """This method creates a ConcentratedRadiationToAmbient object.
751

752
        .. note::
753
            This function can be accessed by::
754

755
                mdb.models[name].ConcentratedRadiationToAmbient
756

757
        Parameters
758
        ----------
759
        name
760
            A String specifying the repository key.
761
        createStepName
762
            A String specifying the name of the step in which the ConcentratedRadiationToAmbient
763
            object is created.
764
        region
765
            A Region object specifying the region to which the concentrated radiation interaction is
766
            applied. The interaction is applied to each node in the region.
767
        ambientTemperature
768
            A Float specifying the reference ambient temperature, θ0θ0.
769
        ambientTemperatureAmp
770
            A String specifying the name of the Amplitude object that gives the variation of the
771
            ambient temperature with time. Note: Use None in an Abaqus/Standard analysis to specify
772
            that the reference ambient temperature is applied immediately at the beginning of the
773
            step or linearly over the step. Use None in an Abaqus/Explicit analysis to specify that
774
            the reference ambient temperature is applied throughout the step.
775
        emissivity
776
            A Float specifying the emissivity, ϵϵ.
777
        nodalArea
778
            A Float specifying the area associated with the node where the concentrated radiation
779
            interaction is applied. The default value is 1.0.
780
        explicitRegionType
781
            A SymbolicConstant specifying how the concentrated radiation is applied to the boundary
782
            of an adaptive mesh domain. Possible values are LAGRANGIAN, SLIDING, and EULERIAN. The
783
            default value is LAGRANGIAN. Note: *explicitRegionType* applies only during an
784
            Abaqus/Explicit analysis.
785
        field
786
            A String specifying the name of the AnalyticalField object associated with this
787
            interaction. The **field** argument applies only when **distributionType** = ANALYTICAL_FIELD.
788
            The default value is an empty string.
789
        distributionType
790
            A SymbolicConstant specifying how the radiation is defined. Possible values are UNIFORM
791
            and ANALYTICAL_FIELD. The default value is UNIFORM.
792

793
        Returns
794
        -------
795
        ConcentratedRadiationToAmbient
796
            A ConcentratedRadiationToAmbient object.
797
        """
798
        self.interactions[name] = interaction = ConcentratedRadiationToAmbient(
×
799
            name,
800
            createStepName,
801
            region,
802
            ambientTemperature,
803
            ambientTemperatureAmp,
804
            emissivity,
805
            nodalArea,
806
            explicitRegionType,
807
            field,
808
            distributionType,
809
        )
810
        return interaction
×
811

812
    @abaqus_method_doc
1✔
813
    def ContactExp(
1✔
814
        self,
815
        name: str,
816
        createStepName: str,
817
        useAllstar: Boolean = OFF,
818
        globalSmoothing: Boolean = ON,
819
        includedPairs: RegionPairs | None = None,
820
        excludedPairs: RegionPairs | None = None,
821
        contactPropertyAssignments: ContactPropertyAssignment | None = None,
822
        surfaceThicknessAssignments: SurfaceThicknessAssignment | None = None,
823
        surfaceOffsetAssignments: SurfaceOffsetAssignment | None = None,
824
        surfaceFeatureAssignments: SurfaceFeatureAssignment | None = None,
825
        smoothingAssignments: SmoothingAssignment | None = None,
826
        masterSlaveAssignments: MasterSlaveAssignment | None = None,
827
    ):
828
        """This method creates a ContactExp object.
829

830
        .. note::
831
            This function can be accessed by::
832

833
                mdb.models[name].ContactExp
834

835
        Parameters
836
        ----------
837
        name
838
            A String specifying the repository key.
839
        createStepName
840
            A String specifying the name of the step in which this contact interaction is created.
841
        useAllstar
842
            A Boolean specifying whether the contacting surface pair consists of all exterior faces,
843
            shell edges, beam segments, analytical rigid surfaces, and, when applicable, Eulerian
844
            material surfaces.
845
        globalSmoothing
846
            A Boolean specifying whether surface smoothing (geometric correction) is automatically
847
            applied to all eligible surfaces. The default value is ON.
848
        includedPairs
849
            A RegionPairs object specifying the domain pairs included in contact.
850
        excludedPairs
851
            A RegionPairs object specifying the domain pairs excluded from contact.
852
        contactPropertyAssignments
853
            A ContactPropertyAssignment object specifying the contact property assignments in the
854
            contact domain.
855
        surfaceThicknessAssignments
856
            A SurfaceThicknessAssignment object specifying the surface thickness assignments in the
857
            contact domain.
858
        surfaceOffsetAssignments
859
            A SurfaceOffsetAssignment object specifying the surface offset fraction assignments in
860
            the contact domain.
861
        surfaceFeatureAssignments
862
            A SurfaceFeatureAssignment object specifying the surface feature angle assignments in
863
            the contact domain.
864
        smoothingAssignments
865
            A SmoothingAssignment object specifying the surface smoothing assignments in the contact
866
            domain.
867
        masterSlaveAssignments
868
            A MasterSlaveAssignment object specifying the master-slave assignments in the
869
            contact domain.
870

871
        Returns
872
        -------
873
        ContactExp
874
            A ContactExp object.
875
        """
876
        self.interactions[name] = interaction = ContactExp(
×
877
            name,
878
            createStepName,
879
            useAllstar,
880
            globalSmoothing,
881
            includedPairs,
882
            excludedPairs,
883
            contactPropertyAssignments,
884
            surfaceThicknessAssignments,
885
            surfaceOffsetAssignments,
886
            surfaceFeatureAssignments,
887
            smoothingAssignments,
888
            masterSlaveAssignments,
889
        )
890
        return interaction
×
891

892
    @abaqus_method_doc
1✔
893
    def ContactStd(
1✔
894
        self,
895
        name: str,
896
        createStepName: str,
897
        useAllstar: Boolean = OFF,
898
        globalSmoothing: Boolean = ON,
899
        includedPairs: RegionPairs | None = None,
900
        excludedPairs: RegionPairs | None = None,
901
        contactPropertyAssignments: ContactPropertyAssignment | None = None,
902
        surfaceThicknessAssignments: SurfaceThicknessAssignment | None = None,
903
        surfaceOffsetAssignments: SurfaceOffsetAssignment | None = None,
904
        surfaceFeatureAssignments: SurfaceFeatureAssignment | None = None,
905
        masterSlaveAssignments: MasterSlaveAssignment | None = None,
906
        initializationAssignments: InitializationAssignment | None = None,
907
        stabilizationAssignments: StabilizationAssignment | None = None,
908
        smoothingAssignments: SmoothingAssignment | None = None,
909
        slidingTransitionAssignments: SlidingTransitionAssignment | None = None,
910
    ) -> ContactStd:
911
        """This method creates a ContactStd object.
912

913
        .. note::
914
            This function can be accessed by::
915

916
                mdb.models[name].ContactStd
917

918
        Parameters
919
        ----------
920
        name
921
            A String specifying the repository key.
922
        createStepName
923
            A String specifying the name of the step in which this contact interaction is created.
924
        useAllstar
925
            A Boolean specifying whether the contacting surface pairs consist of all exterior faces
926
            in the model.
927
        globalSmoothing
928
            A Boolean specifying whether surface smoothing (geometric correction) is automatically
929
            applied to all eligible surfaces. The default value is ON.
930
        includedPairs
931
            A RegionPairs object specifying the domain pairs included in contact.
932
        excludedPairs
933
            A RegionPairs object specifying the domain pairs excluded from contact.
934
        contactPropertyAssignments
935
            A ContactPropertyAssignment object specifying the contact property assignments in the
936
            contact domain.
937
        surfaceThicknessAssignments
938
            A SurfaceThicknessAssignment object specifying the surface thickness assignments in the
939
            contact domain.
940
        surfaceOffsetAssignments
941
            A SurfaceOffsetAssignment object specifying the surface offset fraction assignments in
942
            the contact domain.
943
        surfaceFeatureAssignments
944
            A SurfaceFeatureAssignment object specifying the surface feature angle assignments in
945
            the contact domain.
946
        masterSlaveAssignments
947
            A MasterSlaveAssignment object specifying the master-slave assignments in the
948
            contact domain.
949
        initializationAssignments
950
            An InitializationAssignment object specifying the contact initialization assignments in
951
            the contact domain.
952
        stabilizationAssignments
953
            A StabilizationAssignment object specifying the contact stabilization assignments in the
954
            contact domain.
955
        smoothingAssignments
956
            A SmoothingAssignment object specifying the surface smoothing assignments in the contact
957
            domain.
958
        slidingTransitionAssignments
959
            A SlidingTransitionAssignments object specifying the sliding transition assignments in
960
            the contact domain.
961

962
        Returns
963
        -------
964
        ContactStd
965
            A ContactStd object.
966
        """
967
        self.interactions[name] = interaction = ContactStd(
×
968
            name,
969
            createStepName,
970
            useAllstar,
971
            globalSmoothing,
972
            includedPairs,
973
            excludedPairs,
974
            contactPropertyAssignments,
975
            surfaceThicknessAssignments,
976
            surfaceOffsetAssignments,
977
            surfaceFeatureAssignments,
978
            masterSlaveAssignments,
979
            initializationAssignments,
980
            stabilizationAssignments,
981
            smoothingAssignments,
982
            slidingTransitionAssignments,
983
        )
984
        return interaction
×
985

986
    @abaqus_method_doc
1✔
987
    def CyclicSymmetry(
1✔
988
        self,
989
        name: str,
990
        createStepName: str,
991
        master: Region,
992
        slave: Region,
993
        repetitiveSectors: int,
994
        axisPoint1: Region,
995
        axisPoint2: Region,
996
        extractedNodalDiameter: Literal[C.ALL_NODAL_DIAMETER, C.SPECIFIED_NODAL_DIAMETER] = ALL_NODAL_DIAMETER,
997
        lowestNodalDiameter: int = 0,
998
        highestNodalDiameter: int = 0,
999
        excitationNodalDiameter: int = 0,
1000
        adjustTie: Boolean = ON,
1001
        positionTolerance: float = 0,
1002
        positionToleranceMethod: Literal[C.SPECIFY_TOLERANCE, C.COMPUTED_TOLERANCE] = COMPUTED_TOLERANCE,
1003
    ) -> CyclicSymmetry:
1004
        """This method creates a CyclicSymmetry object.
1005

1006
        .. note::
1007
            This function can be accessed by::
1008

1009
                mdb.models[name].CyclicSymmetry
1010

1011
        Parameters
1012
        ----------
1013
        name
1014
            A String specifying the repository key.
1015
        createStepName
1016
            A String specifying the name of the step in which the cyclic symmetry interaction should
1017
            be created.
1018
        master
1019
            A Region object specifying the master surface.
1020
        slave
1021
            A Region object specifying the slave surface.
1022
        repetitiveSectors
1023
            An Int specifying the total number of sectors in the cyclic symmetric model.
1024
        axisPoint1
1025
            A Region object specifying the first point of the axis of symmetry. The region should
1026
            contain exactly one mesh node, vertex, interesting point, reference point, or datum
1027
            point. In a two-dimensional model **axisPoint1** is the only point used to define the axis
1028
            of symmetry.
1029
        axisPoint2
1030
            A Region object specifying the second point of the axis of symmetry. The region should
1031
            contain exactly one mesh node, vertex, interesting point, reference point, or datum
1032
            point. This point is ignored in a two-dimensional model.
1033
        extractedNodalDiameter
1034
            A SymbolicConstant specifying whether Abaqus should extract all possible nodal diameters
1035
            or the nodal diameters between the user-specified values for **lowestNodalDiameter** and
1036
            **highestNodalDiameter**. Possible values are ALL_NODAL_DIAMETER and
1037
            SPECIFIED_NODAL_DIAMETER. The default value is ALL_NODAL_DIAMETER.
1038
        lowestNodalDiameter
1039
            An Int specifying the lowest nodal diameter to be used in the eigenfrequency analysis.
1040
            The default value is 0.
1041
        highestNodalDiameter
1042
            An Int specifying the highest nodal diameter to be used in the eigenfrequency analysis.
1043
            This argument value should be less than or equal to the half of the total number of
1044
            sectors (as specified in the **repetitiveSectors** parameter). The default value is 0.
1045
        excitationNodalDiameter
1046
            An Int specifying the nodal diameter for which the modal-based steady-state dynamic
1047
            analysis will be performed. This value should be greater than or equal to the lowest
1048
            nodal diameter (specified in the **lowestNodalDiameter** parameter), and less than or
1049
            equal to the highest nodal diameter (specified in the **highestNodalDiameter** parameter).
1050
            The default value is 0.
1051
        adjustTie
1052
            A Boolean specifying whether or not to adjust the slave surface of the cyclic
1053
            symmetry to tie it to the master surface. The default value is ON.
1054
        positionTolerance
1055
            A Float specifying the position tolerance. The*positionTolerance* argument applies only
1056
            when **positionToleranceMethod** = SPECIFY_TOLERANCE. The default value is 0.0.
1057
        positionToleranceMethod
1058
            A SymbolicConstant specifying the method used to determine the position tolerance.
1059
            Possible values are COMPUTED_TOLERANCE and SPECIFY_TOLERANCE. The default value is
1060
            COMPUTED_TOLERANCE.
1061

1062
        Returns
1063
        -------
1064
        CyclicSymmetry
1065
            A CyclicSymmetry object.
1066
        """
1067
        self.interactions[name] = interaction = CyclicSymmetry(
×
1068
            name,
1069
            createStepName,
1070
            master,
1071
            slave,
1072
            repetitiveSectors,
1073
            axisPoint1,
1074
            axisPoint2,
1075
            extractedNodalDiameter,
1076
            lowestNodalDiameter,
1077
            highestNodalDiameter,
1078
            excitationNodalDiameter,
1079
            adjustTie,
1080
            positionTolerance,
1081
            positionToleranceMethod,
1082
        )
1083
        return interaction
×
1084

1085
    @abaqus_method_doc
1✔
1086
    def ElasticFoundation(self, name: str, createStepName: str, surface: Region, stiffness: float) -> ElasticFoundation:
1✔
1087
        """This method creates an ElasticFoundation object.
1088

1089
        .. note::
1090
            This function can be accessed by::
1091

1092
                mdb.models[name].ElasticFoundation
1093

1094
        Parameters
1095
        ----------
1096
        name
1097
            A String specifying the repository key.
1098
        createStepName
1099
            A String specifying the name of the step in which the ElasticFoundation object is
1100
            created. **createStepName** must be set to 'Initial'.
1101
        surface
1102
            A Region object specifying the surface to which the foundation applies.
1103
        stiffness
1104
            A Float specifying the foundation stiffness per area (or per length for beams).
1105

1106
        Returns
1107
        -------
1108
        ElasticFoundation
1109
            An ElasticFoundation object.
1110
        """
1111
        self.interactions[name] = interaction = ElasticFoundation(name, createStepName, surface, stiffness)
×
1112
        return interaction
×
1113

1114
    @abaqus_method_doc
1✔
1115
    def FilmCondition(
1✔
1116
        self,
1117
        name: str,
1118
        createStepName: str,
1119
        surface: Region,
1120
        definition: Literal[C.EMBEDDED_COEFF, C.FIELD, C.USER_SUB, C.PROPERTY_REF],
1121
        interactionProperty: str = "",
1122
        sinkTemperature: float = 0,
1123
        sinkAmplitude: str = "",
1124
        filmCoeff: float = 0,
1125
        filmCoeffAmplitude: str = "",
1126
        field: str = "",
1127
        sinkFieldName: str = "",
1128
        sinkDistributionType: Literal[C.DISCRETE_FIELD, C.UNIFORM, C.ANALYTICAL_FIELD] = UNIFORM,
1129
    ) -> FilmCondition:
1130
        """This method creates a FilmCondition object.
1131

1132
        .. note::
1133
            This function can be accessed by::
1134

1135
                mdb.models[name].FilmCondition
1136

1137
        Parameters
1138
        ----------
1139
        name
1140
            A String specifying the repository key.
1141
        createStepName
1142
            A String specifying the name of the step in which the FilmCondition object is created.
1143
        surface
1144
            A Region object specifying the name of the surface to which the film condition
1145
            interaction is applied.
1146
        definition
1147
            A SymbolicConstant specifying how the film condition is defined. Possible values are
1148
            EMBEDDED_COEFF, PROPERTY_REF, USER_SUB, and FIELD.
1149
        interactionProperty
1150
            A String specifying the name of the FilmConditionProp object associated with this
1151
            interaction. The **interactionProperty** argument applies only when
1152
            **definition** = PROPERTY_REF. The default value is an empty string.
1153
        sinkTemperature
1154
            A Float specifying the reference sink temperature, θ0θ0. The default value is 0.0.
1155
        sinkAmplitude
1156
            A String specifying the name of the Amplitude object that gives the variation of the
1157
            sink temperature, θ0θ0, with time. The default value is an empty string. Note: Use empty
1158
            string in an Abaqus/Standard analysis to specify that the reference sink temperature is
1159
            applied immediately at the beginning of the step or linearly over the step. Use empty
1160
            string in an Abaqus/Explicit analysis to specify that the reference sink temperature is
1161
            applied throughout the step.
1162
        filmCoeff
1163
            A Float specifying the reference film coefficient value, hh. The **filmCoeff** argument
1164
            applies when **definition** = EMBEDDED_COEFF, **definition** = USER_SUB, or **definition** = FIELD.
1165
            The default value is 0.0.
1166
        filmCoeffAmplitude
1167
            A String specifying the name of the Amplitude object that gives the variation of the
1168
            film coefficient, hh, with time. The default value is an empty string. Note: Use empty
1169
            string in an Abaqus/Standard analysis to specify that the reference film coefficient is
1170
            applied immediately at the beginning of the step or linearly over the step. Use empty
1171
            string in an Abaqus/Explicit analysis to specify that the reference film coefficient is
1172
            applied throughout the step.
1173
        field
1174
            A String specifying the name of the AnalyticalField object associated with this
1175
            interaction. The **field** argument applies only when **definition** = FIELD. The default
1176
            value is an empty string.
1177
        sinkFieldName
1178
            A String specifying the name of the AnalyticalField or DiscreteField object associated
1179
            with the sink temperature. The **sinkFieldName** argument applies only when
1180
            **sinkDistributionType** = ANALYTICAL_FIELD or **sinkDistributionType** = DISCRETE_FIELD. The
1181
            default value is an empty string.
1182
        sinkDistributionType
1183
            A SymbolicConstant specifying how the sink temperature is distributed. Possible values
1184
            are UNIFORM, ANALYTICAL_FIELD, and DISCRETE_FIELD. The default value is UNIFORM.
1185

1186
        Returns
1187
        -------
1188
        FilmCondition
1189
            A FilmCondition object.
1190
        """
1191
        self.interactions[name] = interaction = FilmCondition(
×
1192
            name,
1193
            createStepName,
1194
            surface,
1195
            definition,
1196
            interactionProperty,
1197
            sinkTemperature,
1198
            sinkAmplitude,
1199
            filmCoeff,
1200
            filmCoeffAmplitude,
1201
            field,
1202
            sinkFieldName,
1203
            sinkDistributionType,
1204
        )
1205
        return interaction
×
1206

1207
    @abaqus_method_doc
1✔
1208
    def FluidCavity(
1✔
1209
        self,
1210
        name: str,
1211
        createStepName: str,
1212
        cavityPoint: Region,
1213
        cavitySurface: Region,
1214
        interactionProperty: str,
1215
        ambientPressure: float = 0,
1216
        thickness: float = 1,
1217
        useAdiabatic: Boolean = OFF,
1218
        checkNormals: Boolean = ON,
1219
    ) -> FluidCavity:
1220
        """This method creates an FluidCavity object.
1221

1222
        .. note::
1223
            This function can be accessed by::
1224

1225
                mdb.models[name].FluidCavity
1226

1227
        Parameters
1228
        ----------
1229
        name
1230
            A String specifying the repository key.
1231
        createStepName
1232
            A String specifying the name of the step in which the FluidCavity object is created.
1233
        cavityPoint
1234
            A Region object specifying the fluid cavity reference point.
1235
        cavitySurface
1236
            A Region object specifying the surface forming the boundary of the fluid cavity.
1237
        interactionProperty
1238
            A String specifying the FluidCavityProperty object associated with this interaction.
1239
        ambientPressure
1240
            A Float specifying the magnitude of the ambient pressure. The default value is 0.0.
1241
        thickness
1242
            A Float specifying the out-of-plane thickness of the surface for two-dimensional models.
1243
            This argument is valid only when using two-dimensional models. The default value is 1.0.
1244
        useAdiabatic
1245
            A Boolean specifying whether adiabatic behavior is assumed for the ideal gas. This
1246
            argument is valid only when **interactionProperty** specifies a pneumatic definition. The
1247
            default value is OFF.
1248
        checkNormals
1249
            A Boolean specifying whether the analysis will check the consistency of the surface
1250
            normals. The default value is ON.
1251

1252
        Returns
1253
        -------
1254
        FluidCavity
1255
            A FluidCavity object.
1256
        """
1257
        self.interactions[name] = interaction = FluidCavity(
×
1258
            name,
1259
            createStepName,
1260
            cavityPoint,
1261
            cavitySurface,
1262
            interactionProperty,
1263
            ambientPressure,
1264
            thickness,
1265
            useAdiabatic,
1266
            checkNormals,
1267
        )
1268
        return interaction
×
1269

1270
    @abaqus_method_doc
1✔
1271
    def FluidExchange(
1✔
1272
        self,
1273
        name: str,
1274
        createStepName: str,
1275
        firstCavity: str,
1276
        interactionProperty: str,
1277
        definition: Literal[C.BETWEEN_CAVITIES, C.TO_ENVIRONMENT] = TO_ENVIRONMENT,
1278
        secondCavity: str = "",
1279
        exchangeArea: float = 1,
1280
    ) -> FluidExchange:
1281
        """This method creates an FluidExchange object.
1282

1283
        .. note::
1284
            This function can be accessed by::
1285

1286
                mdb.models[name].FluidExchange
1287

1288
        Parameters
1289
        ----------
1290
        name
1291
            A String specifying the repository key.
1292
        createStepName
1293
            A String specifying the name of the step in which the FluidExchange object is created.
1294
        firstCavity
1295
            A String specifying the first FluidCavity object associated with this interaction. This
1296
            will be the only cavity specified if **definition** = TO_ENVIRONMENT.
1297
        interactionProperty
1298
            A String specifying the FluidExchangeProperty object associated with this interaction.
1299
        definition
1300
            A SymbolicConstant specifying the type of fluid exchange to be defined. Possible values
1301
            are TO_ENVIRONMENT and BETWEEN_CAVITIES. The default value is TO_ENVIRONMENT.
1302
        secondCavity
1303
            A String specifying the second FluidCavity object associated with this interaction. This
1304
            argument is applicable only when **definition** = BETWEEN_CAVITIES.
1305
        exchangeArea
1306
            A Float specifying the effective exchange area. The default value is 1.0.
1307

1308
        Returns
1309
        -------
1310
        FluidExchange
1311
            A FluidExchange object.
1312
        """
1313
        self.interactions[name] = interaction = FluidExchange(
×
1314
            name,
1315
            createStepName,
1316
            firstCavity,
1317
            interactionProperty,
1318
            definition,
1319
            secondCavity,
1320
            exchangeArea,
1321
        )
1322
        return interaction
×
1323

1324
    @abaqus_method_doc
1✔
1325
    def IncidentWave(
1✔
1326
        self,
1327
        name: str,
1328
        createStepName: str,
1329
        sourcePoint: Region,
1330
        standoffPoint: Region,
1331
        surface: Region,
1332
        interactionProperty: str,
1333
        definition: Literal[C.PRESSURE, C.UNDEX, C.CONWEP, C.ACCELERATION] = PRESSURE,
1334
        amplitude: str = "",
1335
        imaginaryAmplitude: str = "",
1336
        surfaceNormal: tuple = (),
1337
        initialDepth: float | None = None,
1338
        referenceMagnitude: float | None = None,
1339
        detonationTime: float | None = None,
1340
        magnitudeFactor: float = 1,
1341
    ) -> IncidentWave:
1342
        """This method creates an IncidentWave object.
1343

1344
        .. note::
1345
            This function can be accessed by::
1346

1347
                mdb.models[name].IncidentWave
1348

1349
        Parameters
1350
        ----------
1351
        name
1352
            A String specifying the repository key.
1353
        createStepName
1354
            A String specifying the name of the step in which the IncidentWave object is created.
1355
        sourcePoint
1356
            A Region object specifying the incident wave source point.
1357
        standoffPoint
1358
            A Region object specifying the incident wave standoff point.This argument is not valid
1359
            when **definition** = CONWEP.
1360
        surface
1361
            A Region object specifying the surface defining the incident wave interaction. In
1362
            problems involving fluid/surface boundaries, both the fluid surface and the solid
1363
            surface comprising the boundary must have an incident wave interaction specified.
1364
        interactionProperty
1365
            A String specifying the IncidentWaveProperty object associated with this interaction.
1366
        definition
1367
            A SymbolicConstant specifying the type of incident wave to be defined. The value must be
1368
            PRESSURE for linear perturbation steps. An Explicit step is required when the value is
1369
            set to CONWEP. Possible values are PRESSURE, ACCELERATION, UNDEX, and CONWEP. The
1370
            default value is PRESSURE.
1371
        amplitude
1372
            A String specifying the name of the Amplitude object that defines the fluid pressure
1373
            time history at the standoff point, if **definition** = PRESSURE. If
1374
            **definition** = ACCELERATION, then this string specifies the name of the Amplitude object
1375
            that defines the fluid particle acceleration time history at the standoff point. This
1376
            member can be specified only if **definition** = PRESSURE or ACCELERATION. The default value
1377
            is an empty string.
1378
        imaginaryAmplitude
1379
            A String specifying the name of the Amplitude object that defines the imaginary
1380
            component of the fluid pressure time history at the standoff point. This member is
1381
            applicable only for linear perturbation steps and if **definition** = PRESSURE. The default
1382
            value is an empty string.
1383
        surfaceNormal
1384
            A sequence of three Floats specifying the X, Y, and Z components of the direction cosine
1385
            of the fluid surface normal.This argument is valid only when **definition** = UNDEX.
1386
        initialDepth
1387
            None or a Float specifying the initial depth of the UNDEX bubble. The default value is
1388
            None.This argument is valid only when **definition** = UNDEX.
1389
        referenceMagnitude
1390
            A Float specifying the reference magnitude.This argument is not valid when
1391
            **definition** = CONWEP.
1392
        detonationTime
1393
            A Float specifying the time of detonation, given in total time.This argument is valid
1394
            only when **definition** = CONWEP.
1395
        magnitudeFactor
1396
            A Float specifying the magnitude scale factor. The default value is 1.0.This argument is
1397
            valid only when **definition** = CONWEP.
1398

1399
        Returns
1400
        -------
1401
        IncidentWave
1402
            An IncidentWave object.
1403
        """
1404
        self.interactions[name] = interaction = IncidentWave(
×
1405
            name,
1406
            createStepName,
1407
            sourcePoint,
1408
            standoffPoint,
1409
            surface,
1410
            interactionProperty,
1411
            definition,
1412
            amplitude,
1413
            imaginaryAmplitude,
1414
            surfaceNormal,
1415
            initialDepth,
1416
            referenceMagnitude,
1417
            detonationTime,
1418
            magnitudeFactor,
1419
        )
1420
        return interaction
×
1421

1422
    @abaqus_method_doc
1✔
1423
    def ModelChange(
1✔
1424
        self,
1425
        name: str,
1426
        createStepName: str,
1427
        isRestart: Boolean = OFF,
1428
        regionType: Literal[C.SKINS, C.GEOMETRY, C.ELEMENTS, C.STRINGERS] = GEOMETRY,
1429
        region: Region | None = None,
1430
        activeInStep: Boolean = OFF,
1431
        includeStrain: Boolean = OFF,
1432
    ) -> ModelChange:
1433
        """This method creates a ModelChange object.
1434

1435
        .. note::
1436
            This function can be accessed by::
1437

1438
                mdb.models[name].ModelChange
1439

1440
        Parameters
1441
        ----------
1442
        name
1443
            A String specifying the repository key.
1444
        createStepName
1445
            A String specifying the name of the step in which the ModelChange object is created.
1446
        isRestart
1447
            A Boolean specifying whether this interaction is being used solely to indicate that
1448
            model change may be required in a subsequent restart analysis (either for elements or
1449
            contact pairs). The default value is OFF.
1450
        regionType
1451
            A SymbolicConstant specifying the region selection type. This argument is valid only
1452
            when **isRestart** = False. Possible values are GEOMETRY, SKINS, STRINGERS, and ELEMENTS.
1453
            The default value is GEOMETRY.
1454
        region
1455
            A Region object specifying the elements to be removed or reactivated. This argument is
1456
            valid only when **isRestart** = False.
1457
        activeInStep
1458
            A Boolean specifying whether elements are being removed or reactivated. This argument is
1459
            valid only when **isRestart** = False. The default value is OFF.
1460
        includeStrain
1461
            A Boolean specifying whether stress/displacement elements are reactivated with strain.
1462
            This argument is valid only when **isRestart** = False and when **activeInStep** = True. The
1463
            default value is OFF.
1464

1465
        Returns
1466
        -------
1467
        ModelChange
1468
            A ModelChange object.
1469
        """
1470
        self.interactions[name] = interaction = ModelChange(
×
1471
            name,
1472
            createStepName,
1473
            isRestart,
1474
            regionType,
1475
            region,
1476
            activeInStep,
1477
            includeStrain,
1478
        )
1479
        return interaction
×
1480

1481
    @abaqus_method_doc
1✔
1482
    def PressurePenetration(
1✔
1483
        self,
1484
        name: str,
1485
        createStepName: str,
1486
        contactInteraction: str,
1487
        masterPoints: RegionArray,
1488
        slavePoints: RegionArray,
1489
        penetrationPressure: float,
1490
        criticalPressure: float,
1491
        amplitude: str = UNSET,
1492
        penetrationTime: float = 0,
1493
    ) -> PressurePenetration:
1494
        """This method creates a PressurePenetration object.
1495

1496
        .. note::
1497
            This function can be accessed by::
1498

1499
                mdb.models[name].PressurePenetration
1500

1501
        Parameters
1502
        ----------
1503
        name
1504
            A String specifying the repository key.
1505
        createStepName
1506
            A String specifying the name of the step in which the PressurePenetration object is
1507
            created.
1508
        contactInteraction
1509
            A String specifying the name of the Surface-to-surface contact (Standard) interaction.
1510
        masterPoints
1511
            A RegionArray object specifying the points on the master surface that are exposed to the
1512
            fluid.
1513
        slavePoints
1514
            A RegionArray object specifying the points on the slave surface that are exposed to
1515
            the fluid.
1516
        penetrationPressure
1517
            A tuple of Floats specifying the fluid pressure magnitude. For steady state dynamic
1518
            analyses, a tuple of Complexes specifying the fluid pressure magnitude.
1519
        criticalPressure
1520
            A tuple of Floats specifying the critical contact pressure below which fluid penetration
1521
            starts to occur.
1522
        amplitude
1523
            A String or the SymbolicConstant UNSET specifying the name of the amplitude reference.
1524
            UNSET should be used if the load has no amplitude reference. The default value is UNSET.
1525
            You should provide the **amplitude** argument only if it is valid for the specified step.
1526
        penetrationTime
1527
            A Float specifying the fraction of the current step time over which the fluid pressure
1528
            on newly penetrated contact surface segments is ramped up to the current magnitude. The
1529
            default value is 0.001.
1530

1531
        Returns
1532
        -------
1533
        PressurePenetration
1534
            A PressurePenetration object.
1535
        """
1536
        self.interactions[name] = interaction = PressurePenetration(
×
1537
            name,
1538
            createStepName,
1539
            contactInteraction,
1540
            masterPoints,
1541
            slavePoints,
1542
            penetrationPressure,
1543
            criticalPressure,
1544
            amplitude,
1545
            penetrationTime,
1546
        )
1547
        return interaction
×
1548

1549
    @abaqus_method_doc
1✔
1550
    def RadiationToAmbient(
1✔
1551
        self,
1552
        name: str,
1553
        createStepName: str,
1554
        surface: Region,
1555
        emissivity: float,
1556
        field: str = "",
1557
        distributionType: Literal[C.AMBIENT, C.UNIFORM, C.ANALYTICAL_FIELD] = UNIFORM,
1558
        radiationType: Literal[C.AMBIENT, C.CAVITY] = AMBIENT,
1559
        ambientTemperature: float = 0,
1560
        ambientTemperatureAmp: str = "",
1561
    ) -> RadiationToAmbient:
1562
        """This method creates a RadiationToAmbient object.
1563

1564
        .. note::
1565
            This function can be accessed by::
1566

1567
                mdb.models[name].RadiationToAmbient
1568

1569
        Parameters
1570
        ----------
1571
        name
1572
            A String specifying the repository key.
1573
        createStepName
1574
            A String specifying the name of the step in which the RadiationToAmbient object is
1575
            created.
1576
        surface
1577
            A Region object specifying the surface to which the radiation interaction is applied.
1578
        emissivity
1579
            A Float specifying the emissivity, ϵϵ.
1580
        field
1581
            A String specifying the name of the AnalyticalField object associated with this
1582
            interaction. The **field** argument applies only when **distributionType** = ANALYTICAL_FIELD.
1583
            The default value is an empty string.
1584
        distributionType
1585
            A SymbolicConstant specifying how the radiation is distributed. This argument applies
1586
            only when **radiationType** = AMBIENT. Possible values are UNIFORM and ANALYTICAL_FIELD. The
1587
            default value is UNIFORM.
1588
        radiationType
1589
            A SymbolicConstant specifying whether to use the default surface radiation behavior, or
1590
            the cavity radiation approximation. Possible values are AMBIENT and CAVITY. The default
1591
            value is AMBIENT.
1592
        ambientTemperature
1593
            A Float specifying the reference ambient temperature, θ0θ0. This argument applies only
1594
            when **radiationType** = AMBIENT. The default value is 0.0.
1595
        ambientTemperatureAmp
1596
            A String specifying the name of the Amplitude object that gives the variation of the
1597
            ambient temperature with time. Note: Use None in an Abaqus/Standard analysis to specify
1598
            that the reference ambient temperature is applied immediately at the beginning of the
1599
            step or linearly over the step. Use None in an Abaqus/Explicit analysis to specify that
1600
            the reference ambient temperature is applied throughout the step. This argument applies
1601
            only when **radiationType** = AMBIENT.
1602

1603
        Returns
1604
        -------
1605
        RadiationToAmbient
1606
            A RadiationToAmbient object.
1607
        """
1608
        self.interactions[name] = interaction = RadiationToAmbient(
×
1609
            name,
1610
            createStepName,
1611
            surface,
1612
            emissivity,
1613
            field,
1614
            distributionType,
1615
            radiationType,
1616
            ambientTemperature,
1617
            ambientTemperatureAmp,
1618
        )
1619
        return interaction
×
1620

1621
    @abaqus_method_doc
1✔
1622
    def SelfContactExp(
1✔
1623
        self,
1624
        name: str,
1625
        createStepName: str,
1626
        surface: Region,
1627
        interactionProperty: str,
1628
        mechanicalConstraint: Literal[C.PENALTY, C.KINEMATIC] = KINEMATIC,
1629
        contactControls: str = "",
1630
    ) -> SelfContactExp:
1631
        """This method creates a SelfContactExp object.
1632

1633
        .. note::
1634
            This function can be accessed by::
1635

1636
                mdb.models[name].SelfContactExp
1637

1638
        Parameters
1639
        ----------
1640
        name
1641
            A String specifying the repository key.
1642
        createStepName
1643
            A String specifying the name of the step in which the SelfContactExp object is created.
1644
        surface
1645
            A Region object specifying the surface where self-contact is defined.
1646
        interactionProperty
1647
            A String specifying the name of the ContactProperty object associated with this
1648
            interaction.
1649
        mechanicalConstraint
1650
            A SymbolicConstant specifying the mechanical constraint formulation. Possible values are
1651
            KINEMATIC and PENALTY. The default value is KINEMATIC.
1652
        contactControls
1653
            A String specifying the name of the ContactControl object associated with this
1654
            interaction. An empty string indicates that the default contact controls will be used.
1655
            The default value is an empty string.
1656

1657
        Returns
1658
        -------
1659
        SelfContactExp
1660
            A SelfContactExp object.
1661
        """
1662
        self.interactions[name] = interaction = SelfContactExp(
×
1663
            name,
1664
            createStepName,
1665
            surface,
1666
            interactionProperty,
1667
            mechanicalConstraint,
1668
            contactControls,
1669
        )
1670
        return interaction
×
1671

1672
    @abaqus_method_doc
1✔
1673
    def SelfContactStd(
1✔
1674
        self,
1675
        name: str,
1676
        createStepName: str,
1677
        surface: Region,
1678
        interactionProperty: str,
1679
        enforcement: Literal[C.NODE_TO_SURFACE, C.SURFACE_TO_SURFACE] = SURFACE_TO_SURFACE,
1680
        thickness: Boolean = ON,
1681
        smooth: float = 0,
1682
        contactControls: str = "",
1683
    ) -> SelfContactStd:
1684
        """This method creates a SelfContactStd object.
1685

1686
        .. note::
1687
            This function can be accessed by::
1688

1689
                mdb.models[name].SelfContactStd
1690

1691
        Parameters
1692
        ----------
1693
        name
1694
            A String specifying the repository key.
1695
        createStepName
1696
            A String specifying the name of the step in which the SelfContactStd object is created.
1697
        surface
1698
            A Region object specifying the surface where self-contact is defined.
1699
        interactionProperty
1700
            A String specifying the name of the ContactProperty object associated with this
1701
            interaction.
1702
        enforcement
1703
            A SymbolicConstant specifying the discretization method. Possible values are
1704
            NODE_TO_SURFACE and SURFACE_TO_SURFACE. The default value is SURFACE_TO_SURFACE.
1705
        thickness
1706
            A Boolean specifying whether shell/membrane element thickness is considered. The default
1707
            value is ON.This argument in valid only when **enforcement** = SURFACE_TO_SURFACE.
1708
        smooth
1709
            A Float specifying the degree of smoothing used for deformable or rigid master surfaces
1710
            involved when **enforcement** = NODE_TO_SURFACE. The value given must lie between 0.0 and
1711
            0.5. The default value is 0.2.
1712
        contactControls
1713
            A String specifying the name of the ContactControl object associated with this
1714
            interaction. An empty string indicates that the default contact controls will be used.
1715
            The default value is an empty string.
1716

1717
        Returns
1718
        -------
1719
        SelfContactStd
1720
            A SelfContactStd object.
1721
        """
1722
        self.interactions[name] = interaction = SelfContactStd(
×
1723
            name,
1724
            createStepName,
1725
            surface,
1726
            interactionProperty,
1727
            enforcement,
1728
            thickness,
1729
            smooth,
1730
            contactControls,
1731
        )
1732
        return interaction
×
1733

1734
    @abaqus_method_doc
1✔
1735
    def StdXplCosimulation(
1✔
1736
        self,
1737
        name: str,
1738
        createStepName: str,
1739
        region: Region,
1740
        incrementation: Literal[C.LOCKSTEP, C.ALLOW_SUBCYCLING] = ALLOW_SUBCYCLING,
1741
        stepSize: float = 0,
1742
        stepSizeDefinition: Literal[C.DEFAULT, C.SPECIFIED] = DEFAULT,
1743
    ) -> StdXplCosimulation:
1744
        """This method creates a StdXplCosimulation object.
1745

1746
        .. note::
1747
            This function can be accessed by::
1748

1749
                mdb.models[name].StdXplCosimulation
1750

1751
        Parameters
1752
        ----------
1753
        name
1754
            A String specifying the repository key.
1755
        createStepName
1756
            A String specifying the name of the step in which the StdXplCosimulation object is
1757
            created.
1758
        region
1759
            A Region object specifying the import and export region upon which the co-simulation
1760
            exchanges data with the coupled analysis program.
1761
        incrementation
1762
            A SymbolicConstant specifying whether the analysis programs use the same time increments
1763
            or one is allowed to use more time increments than the other before exchanging data.
1764
            Possible values are ALLOW_SUBCYCLING and LOCKSTEP. The default value is
1765
            ALLOW_SUBCYCLING.
1766
        stepSize
1767
            A Float specifying the size of the increments to be used by Abaqus/Standard and
1768
            Abaqus/Explicit. The default value is 0.0.
1769
        stepSizeDefinition
1770
            A SymbolicConstant specifying whether the increment size is the analysis default or a
1771
            supplied variable. Possible values are DEFAULT and SPECIFIED. The default value is
1772
            DEFAULT.
1773

1774
        Returns
1775
        -------
1776
        StdXplCosimulation
1777
            A StdXplCosimulation object.
1778
        """
1779
        self.interactions[name] = interaction = StdXplCosimulation(
×
1780
            name, createStepName, region, incrementation, stepSize, stepSizeDefinition
1781
        )
1782
        return interaction
×
1783

1784
    @abaqus_method_doc
1✔
1785
    def SurfaceToSurfaceContactExp(
1✔
1786
        self,
1787
        name: str,
1788
        createStepName: str,
1789
        master: Region,
1790
        slave: Region,
1791
        sliding: Literal[C.SMALL, C.FINITE],
1792
        interactionProperty: str,
1793
        mechanicalConstraint: Literal[C.PENALTY, C.KINEMATIC] = KINEMATIC,
1794
        weightingFactorType: Literal[C.DEFAULT, C.SPECIFIED] = DEFAULT,
1795
        weightingFactor: float = 0,
1796
        contactControls: str = "",
1797
        initialClearance: Union[Literal[C.OMIT, C.COMPUTED], float] = OMIT,
1798
        halfThreadAngle: str | None = None,
1799
        pitch: str | None = None,
1800
        majorBoltDiameter: Union[Literal[C.COMPUTED], float] = COMPUTED,
1801
        meanBoltDiameter: Union[Literal[C.COMPUTED], float] = COMPUTED,
1802
        datumAxis: DatumAxis | None = None,
1803
        useReverseDatumAxis: Boolean = OFF,
1804
        clearanceRegion: Region | None = None,
1805
    ) -> SurfaceToSurfaceContactExp:
1806
        """This method creates a SurfaceToSurfaceContactExp object.
1807

1808
        .. note::
1809
            This function can be accessed by::
1810

1811
                mdb.models[name].SurfaceToSurfaceContactExp
1812

1813
        Parameters
1814
        ----------
1815
        name
1816
            A String specifying the repository key.
1817
        createStepName
1818
            A String specifying the name of the step in which the SurfaceToSurfaceContactExp object
1819
            is created.
1820
        master
1821
            A Region object specifying the main surface.
1822
        slave
1823
            A Region object specifying the secondary surface.
1824
        sliding
1825
            A SymbolicConstant specifying the contact formulation. Possible values are FINITE and
1826
            SMALL.
1827
        interactionProperty
1828
            A String specifying the name of the ContactProperty object associated with this
1829
            interaction.
1830
        mechanicalConstraint
1831
            A SymbolicConstant specifying the mechanical constraint formulation. Possible values are
1832
            KINEMATIC and PENALTY. The default value is KINEMATIC.
1833
        weightingFactorType
1834
            A SymbolicConstant specifying the weighting for node-to-face contact. Possible values
1835
            are DEFAULT and SPECIFIED. The default value is DEFAULT.
1836
        weightingFactor
1837
            A Float specifying the weighting factor for the contact surfaces when
1838
            **weightingFactorType** = SPECIFIED. The default value is 0.0.
1839
        contactControls
1840
            A String specifying the name of the ContactControl object associated with this
1841
            interaction. An empty string indicates that the default contact controls will be used.
1842
            The default value is an empty string.
1843
        initialClearance
1844
            A SymbolicConstant or a Float specifying the initial clearance at regions of contact.
1845
            Possible values are OMIT and COMPUTED. The default value is OMIT.
1846
        halfThreadAngle
1847
            None or a sequence of Floats specifying the half thread angle used for bolt clearance.
1848
            The default value is None.
1849
        pitch
1850
            None or a sequence of Floats specifying the pitch used for bolt clearance. The default
1851
            value is None.
1852
        majorBoltDiameter
1853
            The SymbolicConstant COMPUTED or a Float specifying the major diameter of the bolt used
1854
            for bolt clearance. The default value is COMPUTED.
1855
        meanBoltDiameter
1856
            The SymbolicConstant COMPUTED or a Float specifying the mean diameter of the bolt used
1857
            for bolt clearance. The default value is COMPUTED.
1858
        datumAxis
1859
            A DatumAxis object specifying the orientation of the bolt hole when specifying bolt
1860
            clearance.
1861
        useReverseDatumAxis
1862
            A Boolean specifying whether to reverse the bolt clearance direction given by the datum
1863
            axis. The default value is OFF.
1864
        clearanceRegion
1865
            A Region object specifying the contact region for which clearance is specified.
1866

1867
        Returns
1868
        -------
1869
        SurfaceToSurfaceContactExp
1870
            A SurfaceToSurfaceContactExp object.
1871
        """
1872
        self.interactions[name] = interaction = SurfaceToSurfaceContactExp(
×
1873
            name,
1874
            createStepName,
1875
            master,
1876
            slave,
1877
            sliding,
1878
            interactionProperty,
1879
            mechanicalConstraint,
1880
            weightingFactorType,
1881
            weightingFactor,
1882
            contactControls,
1883
            initialClearance,
1884
            halfThreadAngle,
1885
            pitch,
1886
            majorBoltDiameter,
1887
            meanBoltDiameter,
1888
            datumAxis,
1889
            useReverseDatumAxis,
1890
            clearanceRegion,
1891
        )
1892
        return interaction
×
1893

1894
    @abaqus_method_doc
1✔
1895
    def SurfaceToSurfaceContactStd(
1✔
1896
        self,
1897
        name: str,
1898
        createStepName: str,
1899
        master: Region,
1900
        slave: Region,
1901
        sliding: Literal[C.SMALL, C.FINITE],
1902
        interactionProperty: str,
1903
        interferenceType: Literal[C.UNIFORM, C.NONE, C.SHRINK_FIT] = NONE,
1904
        overclosure: float = 0,
1905
        interferenceDirectionType: Literal[C.COMPUTED, C.DIRECTION_COSINE] = COMPUTED,
1906
        direction: tuple = (),
1907
        amplitude: str = "",
1908
        smooth: float = 0,
1909
        hcrit: float = 0,
1910
        extensionZone: float = 0,
1911
        adjustMethod: Literal[C.SET, C.TOLERANCE, C.OVERCLOSED, C.NONE] = NONE,
1912
        adjustTolerance: float = 0,
1913
        adjustSet: Region | None = None,
1914
        enforcement: Literal[C.NODE_TO_SURFACE, C.SURFACE_TO_SURFACE] = SURFACE_TO_SURFACE,
1915
        thickness: Boolean = ON,
1916
        contactControls: str = "",
1917
        tied: Boolean = OFF,
1918
        initialClearance: Union[Literal[C.OMIT, C.COMPUTED], float] = OMIT,
1919
        halfThreadAngle: str | None = None,
1920
        pitch: str | None = None,
1921
        majorBoltDiameter: Union[Literal[C.COMPUTED], float] = COMPUTED,
1922
        meanBoltDiameter: Union[Literal[C.COMPUTED], float] = COMPUTED,
1923
        datumAxis: DatumAxis | None = None,
1924
        useReverseDatumAxis: Boolean = OFF,
1925
        clearanceRegion: Region | None = None,
1926
        surfaceSmoothing: Literal[C.AUTOMATIC, C.NONE] = NONE,
1927
        bondingSet: Region | None = None,
1928
    ) -> SurfaceToSurfaceContactStd:
1929
        """This method creates a SurfaceToSurfaceContactStd object.
1930

1931
        .. note::
1932
            This function can be accessed by::
1933

1934
                mdb.models[name].SurfaceToSurfaceContactStd
1935

1936
        Parameters
1937
        ----------
1938
        name
1939
            A String specifying the repository key.
1940
        createStepName
1941
            A String specifying the name of the step in which the SurfaceToSurfaceContactStd object
1942
            is created.
1943
        master
1944
            A Region object specifying the master surface.
1945
        slave
1946
            A Region object specifying the slave surface.
1947
        sliding
1948
            A SymbolicConstant specifying the contact formulation. Possible values are FINITE and
1949
            SMALL.
1950
        interactionProperty
1951
            A String specifying the name of the ContactProperty object associated with this
1952
            interaction.
1953
        interferenceType
1954
            A SymbolicConstant specifying the type of time-dependent allowable interference for
1955
            contact pairs and contact elements. Possible values are:
1956

1957
            - NONE, specifying no allowable contact interference.
1958
            - SHRINK_FIT.
1959
            - UNIFORM.
1960

1961
            The default value is NONE.
1962
        overclosure
1963
            A Float specifying the maximum overclosure distance allowed. This argument applies only
1964
            when **interferenceType** = UNIFORM. The default value is 0.0.
1965
        interferenceDirectionType
1966
            A SymbolicConstant specifying the method used to determine the interference direction.
1967
            Possible values are COMPUTED and DIRECTION_COSINE. The default value is COMPUTED.
1968
        direction
1969
            A sequence of three Floats specifying the following:
1970

1971
            - XX-direction cosine of the interference direction vector.
1972
            - YY-direction cosine of the interference direction vector.
1973
            - ZZ-direction cosine of the interference direction vector.
1974

1975
            This argument is required only when **interferenceDirectionType** = DIRECTION_COSINE.
1976
        amplitude
1977
            A String specifying the name of the amplitude curve that defines the magnitude of the
1978
            prescribed interference during the step. Use None to specify that the prescribed
1979
            interference is applied immediately at the beginning of the step and ramped down to zero
1980
            linearly over the step.
1981
        smooth
1982
            A Float specifying the degree of smoothing used for deformable or rigid master surfaces
1983
            involved when **enforcement** = NODE_TO_SURFACE. The value given must lie between 0.0 and
1984
            0.5. The default value is 0.2.
1985
        hcrit
1986
            A Float specifying the distance by which a slave node must penetrate the master
1987
            surface before Abaqus/Standard abandons the current increment and tries again with a
1988
            smaller increment. The default value is 0.0.
1989
        extensionZone
1990
            A Float specifying a fraction of the end segment or facet edge length by which the master
1991
            surface is to be extended to avoid numerical round-off errors associated with contact
1992
            modeling. The value given must lie between 0.0 and 0.2. The default value is 0.1.
1993
        adjustMethod
1994
            A SymbolicConstant specifying the adjust method. Possible values are NONE, OVERCLOSED,
1995
            TOLERANCE, and SET. The default value is NONE.
1996
        adjustTolerance
1997
            A Float specifying the adjust tolerance. The default value is 0.0.
1998
        adjustSet
1999
            A Region object specifying the Set object to which the adjustment is to be applied.
2000
        enforcement
2001
            A SymbolicConstant specifying the discretization method. Possible values are
2002
            NODE_TO_SURFACE and SURFACE_TO_SURFACE. The default value is SURFACE_TO_SURFACE.
2003
        thickness
2004
            A Boolean specifying whether shell/membrane element thickness is considered. The default
2005
            value is ON.This argument is not valid when **sliding** = FINITE and
2006
            **enforcement** = NODE_TO_SURFACE.
2007
        contactControls
2008
            A String specifying the name of the ContactControl object associated with this
2009
            interaction. The empty string indicates that the default contact controls will be used.
2010
            The default value is an empty string.
2011
        tied
2012
            A Boolean specifying whether the surfaces are to be "tied" together for the duration of
2013
            the simulation. The default value is OFF.
2014
        initialClearance
2015
            A SymbolicConstant or a Float specifying the initial clearance at regions of contact.
2016
            Possible values are OMIT and COMPUTED. The default value is OMIT.
2017
        halfThreadAngle
2018
            None or a sequence of Floats specifying the half thread angle used for bolt clearance.
2019
            The default value is None.
2020
        pitch
2021
            None or a sequence of Floats specifying the pitch used for bolt clearance. The default
2022
            value is None.
2023
        majorBoltDiameter
2024
            The SymbolicConstant COMPUTED or a Float specifying the major diameter of the bolt used
2025
            for bolt clearance. The default value is COMPUTED.
2026
        meanBoltDiameter
2027
            The SymbolicConstant COMPUTED or a Float specifying the mean diameter of the bolt used
2028
            for bolt clearance. The default value is COMPUTED.
2029
        datumAxis
2030
            A DatumAxis object specifying the orientation of the bolt hole when specifying bolt
2031
            clearance.
2032
        useReverseDatumAxis
2033
            A Boolean specifying whether to reverse the bolt clearance direction given by the datum
2034
            axis. The default value is OFF.
2035
        clearanceRegion
2036
            A Region object specifying the contact region for which clearance is specified.
2037
        surfaceSmoothing
2038
            A SymbolicConstant specifying whether to use surface smoothing for geometric surfaces in
2039
            SurfaceToSurfaceContactStd interactions. Possible values are AUTOMATIC and NONE. The
2040
            default value is NONE.
2041
        bondingSet
2042
            A Region object specifying the slave node sub-set for bonding, used only when the
2043
            contact property CohesiveBehavior option specifies use.
2044

2045
        Returns
2046
        -------
2047
        SurfaceToSurfaceContactStd
2048
            A SurfaceToSurfaceContactStd object.
2049
        """
2050
        self.interactions[name] = interaction = SurfaceToSurfaceContactStd(
×
2051
            name,
2052
            createStepName,
2053
            master,
2054
            slave,
2055
            sliding,
2056
            interactionProperty,
2057
            interferenceType,
2058
            overclosure,
2059
            interferenceDirectionType,
2060
            direction,
2061
            amplitude,
2062
            smooth,
2063
            hcrit,
2064
            extensionZone,
2065
            adjustMethod,
2066
            adjustTolerance,
2067
            adjustSet,
2068
            enforcement,
2069
            thickness,
2070
            contactControls,
2071
            tied,
2072
            initialClearance,
2073
            halfThreadAngle,
2074
            pitch,
2075
            majorBoltDiameter,
2076
            meanBoltDiameter,
2077
            datumAxis,
2078
            useReverseDatumAxis,
2079
            clearanceRegion,
2080
            surfaceSmoothing,
2081
            bondingSet,
2082
        )
2083
        return interaction
×
2084

2085
    @abaqus_method_doc
1✔
2086
    def XFEMCrackGrowth(
1✔
2087
        self, name: str, createStepName: str, crackName: str, allowGrowth: Boolean = ON
2088
    ) -> XFEMCrackGrowth:
2089
        """This method creates an XFEMCrackGrowth object.
2090

2091
        .. note::
2092
            This function can be accessed by::
2093

2094
                mdb.models[name].XFEMCrackGrowth
2095

2096
        Parameters
2097
        ----------
2098
        name
2099
            A String specifying the repository key.
2100
        createStepName
2101
            A String specifying the name of the step in which the XFEMCrackGrowth object is created.
2102
        crackName
2103
            A String specifying the XFEMCrack object associated with this interaction.
2104
        allowGrowth
2105
            A Boolean specifying whether the crack is allowed to grow (propagate) during this
2106
            analysis step. The default value is ON.
2107

2108
        Returns
2109
        -------
2110
        XFEMCrackGrowth
2111
            A XFEMCrackGrowth object.
2112
        """
2113
        self.interactions[name] = interaction = XFEMCrackGrowth(name, createStepName, crackName, allowGrowth)
×
2114
        return interaction
×
STATUS · Troubleshooting · Open an Issue · Sales · Support · CAREERS · ENTERPRISE · START FREE · SCHEDULE DEMO
ANNOUNCEMENTS · TWITTER · TOS & SLA · Supported CI Services · What's a CI service? · Automated Testing

© 2026 Coveralls, Inc