This repository has been archived by the owner on Mar 4, 2023. It is now read-only.
/
SurfaceTraction.py
306 lines (276 loc) · 15.1 KB
/
SurfaceTraction.py
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
import typing
from abaqusConstants import *
from .Load import Load
from ..Region.Region import Region
class SurfaceTraction(Load):
"""The SurfaceTraction object defines surface traction on a region.
The SurfaceTraction object is derived from the Load object.
Attributes
----------
name: str
A String specifying the load repository key.
angle: float
A Float specifying an additional rotation of **directionVector** about an axis. The
default value is 0.0.
axis: SymbolicConstant
A SymbolicConstant specifying the axis about which to apply an additional rotation of
**directionVector**. Possible values are AXIS_1, AXIS_2, and AXIS_3. The default value is
AXIS_1.
follower: Boolean
A Boolean specifying whether the direction of the force changes with rotation. The
default value is ON.This parameter may be modified only if **traction** is GENERAL. You
should provide the **follower** argument only if it is valid for the specified step.
resultant: Boolean
A Boolean specifying whether the to maintain a constant resultant force by defining
traction per unit undeformed area. If **resultant** is OFF, traction is defined per unit
deformed area. The default value is OFF.You should provide the **resultant** argument only
if it is valid for the specified step.
traction: SymbolicConstant
A SymbolicConstant specifying how to apply surface traction. Possible values are SHEAR
and GENERAL. The default value is SHEAR.
distributionType: SymbolicConstant
A SymbolicConstant specifying how the surface traction is distributed spatially.
Possible values are UNIFORM, USER_DEFINED, and FIELD. The default value is UNIFORM.
field: str
A String specifying the name of the :py:class:`~abaqus.Field.AnalyticalField.AnalyticalField` object associated with this load.
The **field** argument applies only when **distributionType=FIELD**. The default value is an
empty string.
userCsys: str
A String specifying a CSYS defined by a user-subroutine. If **userCsys=None**, the degrees
of freedom are defined in the global coordinate system or by the **localCsys** parameter
if defined. The default value is "None".
localCsys: int
None or a :py:class:`~abaqus.Datum.DatumCsys.DatumCsys` object specifying the local coordinate system of the load's degrees
of freedom. If **localCsys=None**, the degrees of freedom are defined in the global
coordinate system or by the **userCsys** parameter if defined. When this member is
queried, it returns an Int. The default value is None.
directionVector: tuple
A :py:class:`~abaqus.BasicGeometry.VertexArray.VertexArray` object of length 2 specifying the direction of the load. Instead of
through a ConstrainedSketchVertex, each point may be specified through a tuple of coordinates. If
**traction** is SHEAR, then **directionVector** will be projected onto the region surface.
This parameter is available only if **traction** is GENERAL or SHEAR.
region: Region
A :py:class:`~abaqus.Region.Region.Region` object specifying the region to which the load is applied.
Notes
-----
This object can be accessed by:
.. code-block:: python
import load
mdb.models[name].loads[name]
"""
# A String specifying the load repository key.
name: str = ""
# A Float specifying an additional rotation of *directionVector* about an axis. The
# default value is 0.0.
angle: float = 0
# A SymbolicConstant specifying the axis about which to apply an additional rotation of
# *directionVector*. Possible values are AXIS_1, AXIS_2, and AXIS_3. The default value is
# AXIS_1.
axis: SymbolicConstant = AXIS_1
# A Boolean specifying whether the direction of the force changes with rotation. The
# default value is ON.This parameter may be modified only if *traction* is GENERAL. You
# should provide the *follower* argument only if it is valid for the specified step.
follower: Boolean = ON
# A Boolean specifying whether the to maintain a constant resultant force by defining
# traction per unit undeformed area. If *resultant* is OFF, traction is defined per unit
# deformed area. The default value is OFF.You should provide the *resultant* argument only
# if it is valid for the specified step.
resultant: Boolean = OFF
# A SymbolicConstant specifying how to apply surface traction. Possible values are SHEAR
# and GENERAL. The default value is SHEAR.
traction: SymbolicConstant = SHEAR
# A SymbolicConstant specifying how the surface traction is distributed spatially.
# Possible values are UNIFORM, USER_DEFINED, and FIELD. The default value is UNIFORM.
distributionType: SymbolicConstant = UNIFORM
# A String specifying the name of the AnalyticalField object associated with this load.
# The *field* argument applies only when *distributionType*=FIELD. The default value is an
# empty string.
field: str = ""
# A String specifying a CSYS defined by a user-subroutine. If *userCsys*=None, the degrees
# of freedom are defined in the global coordinate system or by the *localCsys* parameter
# if defined. The default value is "None".
userCsys: str = ""
# None or a DatumCsys object specifying the local coordinate system of the load's degrees
# of freedom. If *localCsys*=None, the degrees of freedom are defined in the global
# coordinate system or by the *userCsys* parameter if defined. When this member is
# queried, it returns an Int. The default value is None.
localCsys: int = None
# A VertexArray object of length 2 specifying the direction of the load. Instead of
# through a ConstrainedSketchVertex, each point may be specified through a tuple of coordinates. If
# *traction* is SHEAR, then *directionVector* will be projected onto the region surface.
# This parameter is available only if *traction* is GENERAL or SHEAR.
directionVector: tuple = ()
# A Region object specifying the region to which the load is applied.
region: Region = Region()
def __init__(
self,
name: str,
createStepName: str,
region: Region,
magnitude: float,
distributionType: SymbolicConstant = UNIFORM,
field: str = "",
amplitude: str = UNSET,
angle: float = 0,
axis: SymbolicConstant = AXIS_1,
localCsys: int = None,
userCsys: str = "",
directionVector: tuple = (),
follower: Boolean = ON,
resultant: Boolean = OFF,
traction: SymbolicConstant = SHEAR,
):
"""This method creates a SurfaceTraction object.
Notes
-----
This function can be accessed by:
.. code-block:: python
mdb.models[name].SurfaceTraction
Parameters
----------
name
A String specifying the load repository key.
createStepName
A String specifying the name of the step in which the load is created.
region
A Region object specifying the region to which the load is applied.
magnitude
A Float or Complex specifying the load magnitude. *magnitude* is optional if
*distributionType*=USER_DEFINED.
distributionType
A SymbolicConstant specifying how the surface traction is distributed spatially.
Possible values are UNIFORM, USER_DEFINED, and FIELD. The default value is UNIFORM.
field
A String specifying the name of the AnalyticalField object associated with this load.
The *field* argument applies only when *distributionType*=FIELD. The default value is an
empty string.
amplitude
A String or the SymbolicConstant UNSET specifying the name of the amplitude reference.
UNSET should be used if the load has no amplitude reference. The default value is UNSET.
You should provide the *amplitude* argument only if it is valid for the specified step.
angle
A Float specifying an additional rotation of *directionVector* about an axis. The
default value is 0.0.
axis
A SymbolicConstant specifying the axis about which to apply an additional rotation of
*directionVector*. Possible values are AXIS_1, AXIS_2, and AXIS_3. The default value is
AXIS_1.
localCsys
None or a DatumCsys object specifying the local coordinate system of the load's degrees
of freedom. If *localCsys*=None, the degrees of freedom are defined in the global
coordinate system or by the *userCsys* parameter if defined. When this member is
queried, it returns an Int. The default value is None.
userCsys
A String specifying a CSYS defined by a user-subroutine. If *userCsys*=None, the degrees
of freedom are defined in the global coordinate system or by the *localCsys* parameter
if defined. The default value is "None".
directionVector
A VertexArray object of length 2 specifying the direction of the load. Instead of
through a ConstrainedSketchVertex, each point may be specified through a tuple of coordinates. If
*traction* is SHEAR, then *directionVector* will be projected onto the region surface.
This parameter is available only if *traction* is GENERAL or SHEAR.
follower
A Boolean specifying whether the direction of the force changes with rotation. The
default value is ON.This parameter may be modified only if *traction* is GENERAL. You
should provide the *follower* argument only if it is valid for the specified step.
resultant
A Boolean specifying whether the to maintain a constant resultant force by defining
traction per unit undeformed area. If *resultant* is OFF, traction is defined per unit
deformed area. The default value is OFF.You should provide the *resultant* argument only
if it is valid for the specified step.
traction
A SymbolicConstant specifying how to apply surface traction. Possible values are SHEAR
and GENERAL. The default value is SHEAR.
Returns
-------
A SurfaceTraction object.
"""
super().__init__()
pass
def setValues(
self,
distributionType: SymbolicConstant = UNIFORM,
field: str = "",
amplitude: str = UNSET,
angle: float = 0,
axis: SymbolicConstant = AXIS_1,
localCsys: int = None,
userCsys: str = "",
directionVector: tuple = (),
follower: Boolean = ON,
resultant: Boolean = OFF,
traction: SymbolicConstant = SHEAR,
):
"""This method modifies the data for an existing SurfaceTraction object in the step where
it is created.
Parameters
----------
distributionType
A SymbolicConstant specifying how the surface traction is distributed spatially.
Possible values are UNIFORM, USER_DEFINED, and FIELD. The default value is UNIFORM.
field
A String specifying the name of the AnalyticalField object associated with this load.
The *field* argument applies only when *distributionType*=FIELD. The default value is an
empty string.
amplitude
A String or the SymbolicConstant UNSET specifying the name of the amplitude reference.
UNSET should be used if the load has no amplitude reference. The default value is UNSET.
You should provide the *amplitude* argument only if it is valid for the specified step.
angle
A Float specifying an additional rotation of *directionVector* about an axis. The
default value is 0.0.
axis
A SymbolicConstant specifying the axis about which to apply an additional rotation of
*directionVector*. Possible values are AXIS_1, AXIS_2, and AXIS_3. The default value is
AXIS_1.
localCsys
None or a DatumCsys object specifying the local coordinate system of the load's degrees
of freedom. If *localCsys*=None, the degrees of freedom are defined in the global
coordinate system or by the *userCsys* parameter if defined. When this member is
queried, it returns an Int. The default value is None.
userCsys
A String specifying a CSYS defined by a user-subroutine. If *userCsys*=None, the degrees
of freedom are defined in the global coordinate system or by the *localCsys* parameter
if defined. The default value is "None".
directionVector
A VertexArray object of length 2 specifying the direction of the load. Instead of
through a ConstrainedSketchVertex, each point may be specified through a tuple of coordinates. If
*traction* is SHEAR, then *directionVector* will be projected onto the region surface.
This parameter is available only if *traction* is GENERAL or SHEAR.
follower
A Boolean specifying whether the direction of the force changes with rotation. The
default value is ON.This parameter may be modified only if *traction* is GENERAL. You
should provide the *follower* argument only if it is valid for the specified step.
resultant
A Boolean specifying whether the to maintain a constant resultant force by defining
traction per unit undeformed area. If *resultant* is OFF, traction is defined per unit
deformed area. The default value is OFF.You should provide the *resultant* argument only
if it is valid for the specified step.
traction
A SymbolicConstant specifying how to apply surface traction. Possible values are SHEAR
and GENERAL. The default value is SHEAR.
"""
pass
def setValuesInStep(
self,
stepName: str,
magnitude: typing.Union[SymbolicConstant, float] = None,
amplitude: str = "",
):
"""This method modifies the propagating data for an existing SurfaceTraction object in the
specified step.
Parameters
----------
stepName
A String specifying the name of the step in which the load is modified.
magnitude
A Float, a Complex, or the SymbolicConstant UNCHANGED specifying the load magnitude.
UNCHANGED should be used if the magnitude is propagated from the previous analysis step.
amplitude
A String or a SymbolicConstant specifying the name of the amplitude reference. Possible
values for the SymbolicConstant are UNCHANGED and FREED. UNCHANGED should be used if the
amplitude is propagated from the previous analysis step. FREED should be used if the
load has no amplitude reference. You should provide the *amplitude* argument only if it
is valid for the specified step.
"""
pass