ansys.dyna.core.pre.dynabase

Module for creating a DYNA input deck.

Classes

Motion	Generic enumeration.
RWMotion	Generic enumeration.
DOF	Generic enumeration.
Switch	Generic enumeration.
InvariantNode	Generic enumeration.
EnergyFlag	Generic enumeration.
HourglassControl	Generic enumeration.
BulkViscosity	Generic enumeration.
CaseType	Generic enumeration.
OutputEcho	Generic enumeration.
Box	Defines a box-shaped volume.
Curve	Defines a curve as a function of time.
Function	Defines a function that can be referenced by a limited number of keyword options.
Table2D	Define a table,a curve ID is specified for each value defined in the table.
Point	Defines a point.
Direction	Defines a direction.
Transform	Defines a transformation.
Velocity	Defines a translational velocity.
RotVelocity	Defines a rotational velocity.
BaseObj	Define the base object.
ParameterType	Contains the parameter types.
DynaBase	Contains methods for creating a general LS-DYNA keyword.
BaseSet	Defines the base class for all set classes.
NodeSet	Defines a nodal set with some identical or unique attributes.
SetType	Contains the enums for setting types.
NodesetGeneral	Includes nodal points of element sets.
NodeSetBox	include the nodes inside boxes.
PartSet	Defines a set of parts with optional attributes.
SegmentSet	Defines a set of segments with optional identical or unique attributes.
BeamFormulation	Generic enumeration.
ShellFormulation	Generic enumeration.
IGAFormulation	Generic enumeration.
SolidFormulation	Generic enumeration.
HourglassType	Generic enumeration.
BeamSection	Defines cross-sectional properties for beams, trusses, discrete beams, and cable elements.
ShellSection	Defines section properties for shell elements.
IGASection	Defines section properties for isogeometric shell elements.
Part	Defines the part object.
BeamPart	Defines a beam part.
ShellPart	Defines a shell part.
IGAPart	Defines an isogeometric shell part.
SolidPart	Defines a solid part.
DRO	Generic enumeration.
DiscretePart	Defines a discrete part.
Parts	Stores the part list.
AnalysisType	Generic enumeration.
TimestepCtrol	Generic enumeration.
Integration	Generic enumeration.
ImplicitAnalysis	Activates implicit analysis and defines associated control parameters.
ThermalAnalysisType	Generic enumeration.
ThermalAnalysisTimestep	Generic enumeration.
ThermalAnalysis	Activates thermal analysis and defines associated control parameters.
ContactCategory	Generic enumeration.
ContactType	Generic enumeration.
OffsetType	Generic enumeration.
ContactFormulation	Generic enumeration.
SBOPT	Generic enumeration.
ContactSurface	Defines a contact interface.
Contact	Provide a way of treating interaction between disjoint parts.
ContactGroup	Create a contact group.
Constraint	Provides a way of constraining degrees of freedom to move together in some way.
BoundaryCondition	Provides a way of defining imposed motions on boundary nodes.
InitialCondition	Provides a way of initializing velocities and detonation points.
RigidwallCylinder	Defines a rigid wall with a cylinder form.
RigidwallSphere	Defines a rigid wall with a sphere form.
RigidwallPlanar	Defines planar rigid walls with either finite or infinite size.
GravityOption	Generic enumeration.
Gravity	Defines body force loads using global axes directions.

Module Contents

class ansys.dyna.core.pre.dynabase.Motion

Bases: enum.Enum

Generic enumeration.

Derive from this class to define new enumerations.

VELOCITY = 0

ACCELERATION = 1

DISPLACEMENT = 2

class ansys.dyna.core.pre.dynabase.RWMotion

Bases: enum.Enum

Generic enumeration.

Derive from this class to define new enumerations.

VELOCITY = 0

DISPLACEMENT = 1

class ansys.dyna.core.pre.dynabase.DOF

Bases: enum.Enum

Generic enumeration.

Derive from this class to define new enumerations.

X_TRANSLATIONAL = 1

Y_TRANSLATIONAL = 2

Z_TRANSLATIONAL = 3

X_ROTATIONAL = 5

Y_ROTATIONAL = 6

Z_ROTATIONAL = 7

class ansys.dyna.core.pre.dynabase.Switch

Bases: enum.Enum

Generic enumeration.

Derive from this class to define new enumerations.

OFF = 0

ON = 1

class ansys.dyna.core.pre.dynabase.InvariantNode

Bases: enum.Enum

Generic enumeration.

Derive from this class to define new enumerations.

OFF = 1

ON_FOR_SHELL_TSHELL = 2

ON_FOR_SOLID = 3

ON_FOR_SHELL_TSHELL_SOLID = 4

class ansys.dyna.core.pre.dynabase.EnergyFlag

Bases: enum.Enum

Generic enumeration.

Derive from this class to define new enumerations.

NOT_COMPUTED = 1

COMPUTED = 2

class ansys.dyna.core.pre.dynabase.HourglassControl

Bases: enum.Enum

Generic enumeration.

Derive from this class to define new enumerations.

STANDARD_VISCOSITY_FORM = 1

FLANAGAN_BELYTSCHKO_INTEGRATION_SOLID = 2

class ansys.dyna.core.pre.dynabase.BulkViscosity

Bases: enum.Enum

Generic enumeration.

Derive from this class to define new enumerations.

STANDARD_BULK_VISCOSITY = 1

RICHARDS_WILKINS_BULK_VISCOSITY = 2

COMPUTE_INTERNAL_ENERGY_DISSIPATED

class ansys.dyna.core.pre.dynabase.CaseType

Bases: enum.Enum

Generic enumeration.

Derive from this class to define new enumerations.

STRUCTURE = 1

ICFD = 2

SALE = 3

EM = 4

IGA = 5

class ansys.dyna.core.pre.dynabase.OutputEcho

Bases: enum.Enum

Generic enumeration.

Derive from this class to define new enumerations.

ALL_DATA_PRINTED = 0

SUPPRESSED_NODAL_PRINTING = 1

SUPPRESSED_ELEMENT_PRINTING = 2

SUPPRESSED_NODAL_AND_ELEMENT_PRINTING = 3

class ansys.dyna.core.pre.dynabase.Box(xmin=0, xmax=0, ymin=0, ymax=0, zmin=0, zmax=0)

Defines a box-shaped volume.

xmin

xmax

ymin

ymax

zmin

zmax

create(stub)

Create box.

class ansys.dyna.core.pre.dynabase.Curve(sfo=1, x=[], y=[], func=None, title='')

Defines a curve as a function of time.

For example, load (ordinate value).

sfo

abscissa

ordinate

func

title

create(stub=None)

Create a curve.

class ansys.dyna.core.pre.dynabase.Function(Function=None)

Defines a function that can be referenced by a limited number of keyword options.

function

tabulated = False

set_tabulated(heading='', function='', x=[], y=[])

create(stub)

Create function.

class ansys.dyna.core.pre.dynabase.Table2D(title='')

Define a table,a curve ID is specified for each value defined in the table.

title

valuecurvelist = []

append(value=0, curve=None)

create(stub=None)

Create Table2D.

class ansys.dyna.core.pre.dynabase.Point(x=0, y=0, z=0)

Defines a point.

x

y

z

class ansys.dyna.core.pre.dynabase.Direction(x=0, y=0, z=0)

Defines a direction.

x

y

z

class ansys.dyna.core.pre.dynabase.Transform(option=None, param1=0, param2=0, param3=0, param4=0, param5=0, param6=0, param7=0)

Defines a transformation.

paramlist = []

add_transform(option=None, param1=0, param2=0, param3=0, param4=0, param5=0, param6=0, param7=0)

Defines a transformation matrix.

create(stub)

Create a transformation.

class ansys.dyna.core.pre.dynabase.Velocity(x=0, y=0, z=0)

Defines a translational velocity.

x

y

z

class ansys.dyna.core.pre.dynabase.RotVelocity(x=0, y=0, z=0)

Defines a rotational velocity.

x

y

z

class ansys.dyna.core.pre.dynabase.BaseObj

Define the base object.

type = ''

subtype = ''

get_data() → List

Get the data of the object.

class ansys.dyna.core.pre.dynabase.ParameterType

Bases: enum.Enum

Contains the parameter types.

R = 1

I = 2

C = 3

class ansys.dyna.core.pre.dynabase.DynaBase

Contains methods for creating a general LS-DYNA keyword.

stub

mainname = ''

implicitanalysis

parts

boundaryconditions

initialconditions

constraints

contacts

entities = []

have_accuracy = False

have_energy = False

have_hourglass = False

have_bulk_viscosity = False

have_control_shell = False

init_velocity: List = None

bdy_spc: List = None

get_stub()

Get the stub of the DynaBase object.

set_parent(parent=None)

set_timestep(tssfac=0.9, isdo=0, timestep_size_for_mass_scaled=0.0, max_timestep=None)

Set the structural time step size control using different options.

Parameters:

tssfacfloat, optional

Scale factor for computed time step. The default is 0.9.

isdoint, optional

Basis of the time size calculation for four-node shell elements. The default is 0.

timestep_size_for_mass_scaledfloat, optional

Time step size for mass scaled solutions. The default is 0.0.

max_timestepCurve, optional

Load curve that limits the maximum time step size. The default is None.

Returns:

bool

True when successful, False when failed.

set_accuracy(objective_stress_updates=Switch.OFF, invariant_node_number=InvariantNode.OFF, partsetid_for_objective_stress_updates=0, implicit_accuracy_flag=Switch.OFF, explicit_accuracy_flag=Switch.OFF)

Define control parameters that can improve the accuracy of the calculation.

Parameters:

objective_stress_updatesint

Global flag for 2nd order objective stress updates.

invariant_node_numberint

Invariant node numbering for shell and solid elements.

partsetid_for_objective_stress_updatesint, optional

Part set ID for objective stress updates. The default is 0.

implicit_accuracy_flagint

Implicit accuracy flag.

explicit_accuracy_flagfloat

Explicit accuracy parameter.

• EQ.0.0: Off

• GT.0.0: On

Returns:

bool

True when successful, False when failed.

set_energy(hourglass_energy=EnergyFlag.NOT_COMPUTED, rigidwall_energy=EnergyFlag.COMPUTED, sliding_interface_energy=EnergyFlag.NOT_COMPUTED, rayleigh_energy=EnergyFlag.NOT_COMPUTED, initial_reference_geometry_energy=EnergyFlag.COMPUTED)

Provide controls for energy dissipation options.

Parameters:

hourglass_energyenum

Hourglass energy calculation option.

rigidwall_energyint

Rigidwall energy dissipation option.

• EQ.1: Energy dissipation is not computed.

• EQ.2: Energy dissipation is computed.

sliding_interface_energyint

Sliding interface energy dissipation option.

• EQ.1: Energy dissipation is not computed.

• EQ.2: Energy dissipation is computed.

rayleigh_energyint

Rayleigh energy dissipation option.

• EQ.1: Energy dissipation is not computed.

• EQ.2: Energy dissipation is computed.

initial_reference_geometry_energyint

Initial reference geometry energy option.

• EQ.1: Initial reference geometry energy is not computed.

• EQ.2: Initial reference geometry energy is computed.

Returns:

bool

True when successful, False when failed.

set_output(print_suppression_d3hsp=False, print_suppression_echo=OutputEcho.ALL_DATA_PRINTED)

Set miscellaneous output parameters.

Parameters:

print_suppression_d3hspbool, optional

Whether to suppress printing during the input phase flag for the D3HSP file. The default is True, which means that none of these are printed: nodal coordinates, element connectivities, rigid wall definitions, nodal SPCs, initial velocities, initial strains, adaptive constraints, and SPR2/SPR3 constraints. If False, no suppression occurs.

print_suppression_echoOutputEcho

Print suppression setting during the input phase flag for the echo file. Options are:

• ALL_DATA_PRINTED: All data is printed.

• SUPPRESSED_NODAL_PRINTING: Nodal printing is suppressed.

• SUPPRESSED_ELEMENT_PRINTING: Element printing is suppressed.

• SUPPRESSED_NODAL_AND_ELEMENT_PRINTING : Both nodal and element printing is suppressed.

set_hourglass(controltype=HourglassControl.STANDARD_VISCOSITY_FORM, coefficient=0.1)

Redefine the default values for the hourglass control type and coefficient.

Parameters:

controltypeenum

Default hourglass control type.

coefficientfloat, optional

Default hourglass coefficient. The default is 0..

Returns:

bool

True when successful, False when failed.

set_bulk_viscosity(quadratic_viscosity_coeff=1.5, linear_viscosity_coeff=0.06, bulk_viscosity_type=BulkViscosity.STANDARD_BULK_VISCOSITY)

Reset the default values of the bulk viscosity coefficients globally.

Parameters:

quadratic_viscosity_coefffloat, optional

Default quadratic viscosity coefficient. The default is 1.5.

linear_viscosity_coefffloat, optional

Default linear viscosity coefficient. The default is 0.06.

bulk_viscosity_typeenum

Default bulk viscosity type.

Returns:

bool

True when successful, False when failed.

set_init_temperature(temp=0)

Define initial nodal point temperatures on all nodes.

Parameters:

tempfloat, optional

Temperature at node. The default is 0.

Returns:

bool

True when successful, False when failed.

create_control_shell(wrpang=20, esort=0, irnxx=-1, istupd=0, theory=2, bwc=2, miter=1, proj=0, irquad=0)

Provide controls for computing shell response.

Parameters:

wrpangint, optional

Shell element warpage angle in degrees. The default is 20.

esortint

Sorting of triangular shell elements to automatically switch degenerate quadrilateral shell formulations to more suitable triangular shell formulations. The default is 0.

irnxxint, optional

Shell normal update option. The default is 1.

istupdint, optional

Shell thickness change option for deformable shells. The default is 0.

theoryint, optional

Default shell formulation. The default is 2.

bwcint, optional

Warping stiffness for Belytschko-Tsay shells. The default is 2.

miterint, optional

Plane stress plasticity option. The default is 1.

projint, optional

Projection method for the warping stiffness in the Belytschko-Tsay shell and the Belytschko-Wong-Chiang elements. The default is 0.

irquadint, optional

In-plane integration rule for the eight-node quadratic shell element. The default is 0.

• EQ.2: 2*2 Gauss quadrature

• EQ.3: 3*3 Gauss quadrature

Returns:

bool

True when successful, False when failed.

create_control_solid(esort=0, fmatrx=0, niptets=4, swlocl=1, psfail=0, t10jtol=0.0, icoh=0, tet13k=0)

Provide controls for a solid element response.

Parameters:

esortint, optional

Automatic sorting of tetrahedral and pentahedral elements to avoid use of degenerate formulations for these shapes. The default is 0.

• EQ.0: No sorting

• EQ.1: Sort

fmatrxint, optional

Method to use in the calculation of the deformation gradient matrix. The default is 1.

niptetsint, optional

Number of integration points used in the quadratic tetrahedron elements. The default is 4.

swloclint, optional

Output option for stresses in solid elements used as spot welds with material \*MAT_SPOTWELD. The default is 1.

psfailint, optional

Solid element erosion from negative volume is limited only to solid elements in the part set indicated by PSFAIL. The default is 0.

t10jtolfloat, optional

Tolerance for Jacobian in four-point, 10-noded quadratic tetrahedra. The default is 0.0.

icohint, optional

Breaking LS-DYNA convention ICOH is interpreted digit-wise. The default is 0.

tet13kint, optional

Flag for whether to invoke a consistent tangent stiffness matrix for the pressure averaged tetrahedron. The default is 0, in which case this matrix is not invoked. If this parameter is set to 1, this matrix is invoked.

Returns:

bool

True when successful, False when failed.

create_control_contact(rwpnal, shlthk=0, orien=1, ssthk=0, ignore=0, igactc=0)

Change defaults for computation with contact surfaces.

Parameters:

rwpnalfloat

Scale factor for rigid wall penalties, which treat nodal points interacting with rigid walls.

shlthkint, optional

Flag for whether to consider shell thickness offsets in non-automatic surface-to-surface and non-automatic nodes-to-surface type contacts. The default is 0, in which case these offsets are not considered. If this parameter is set to 1, these offsets are considered.

orienint, optional

Flag for whether to automatically reorient contact interface segments during initialization. The default is 1, in which case reorientation automatically occurs. If this parameter is set to 0, reorientation does not occur.

ssthkint, optional

Flag for whether to determine default contact thickness for shells in single surface contact types. The default is 0, in which case default contact thickness is not determined. If this parameter is set to 1, default contact thickness is determined.

ignoreint, optional

Flag for whether to ignore initial penetrations in the \*CONTACT_AUTOMATIC options. The default is 0, in which case initial penetrations are ignored. If this parameter is set to 1, initial penetrations are not ignored.

igactcint, optional

Flag for whether to use isogeometric shells for contact detection when the contact involves isogeometric shells. The default is 0, which means isogeometric shells are not used. If this parameter is set to 1, isogeometric shells are used.

Returns:

bool

True when successful, False when failed.

create_damping_global(lcid=0, valdmp=0.0)

Define mass-weighted nodal damping.

Mass-weighted nodal damping applies globally to the nodes of deformable bodies and to the mass center of rigid bodies.

Parameters:

lcidint, optional

Load curve ID, which specifies the system damping constant versus the time. The default is 0.

valdmpfloat, optional

System damping constant. The default is 0.0.

Returns:

bool

True when successful, False when failed.

get_solid_elements()

Get solid elements.

Returns:

list

list[0],solid element connectivity,list[0] = [[n1,n2,n3,n4,n5,n6,n7,n8],[…],…] list[1],node coordinates,list[1] = [[x1,y1,z1],[x2,y2,z2],…]

create_general_keyword(opcode, keyworddata)

Create general keyword.

Parameters:

opcodestr

Keyword card name.

keyworddatastring

Keyword data.

Example::

Create a \*INITIAL_VELOCITY keyword.

$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$ *INITIAL_VELOCITY

& vx vy vz vxr vyr vzr 1.480E+01 0.000E+00 0.000E+00 0.000E+00 0.000E+00 0.000E+00 $$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$

opcode = “INITIAL_VELOCITY” keyworddata = “0

1.480E+01,0.000E+00,0.000E+00,0.000E+00,0.000E+00,0.000E+00”

create_general_keyword(opcode = opcode,keyworddata=keyworddata)

add(obj)

Add entities to an object.

set_transform(filename=None, idnoff=0, ideoff=0, idpoff=0, idmoff=0, idsoff=0, idfoff=0, transform=None)

Include independent input files containing model data, allow for node, element, and set IDs to be offset and for coordinates and constitutive parameters to be transformed and scaled.

Parameters:

filenamestr

Name of file to include in the keyword file.

idnoffint

Offset to node ID.

ideoffint

Offset to element ID.

idpoffint

Offset to part ID.

idmoffint

Offset to material ID.

idsoffint

Offset to set ID.

idfoffint

Offset to function ID, table ID, and curve ID.

transformTransform

Definition for the transformation.

save_file()

Save keyword files.

Returns:

bool

True when successful, False when failed.

class ansys.dyna.core.pre.dynabase.BaseSet

Defines the base class for all set classes.

type = 'PARTSET'

id = 0

class ansys.dyna.core.pre.dynabase.NodeSet(nodes=[])

Defines a nodal set with some identical or unique attributes.

nodes

type = 'NODESET'

create(stub)

Create a node set.

num()

Get the number of nodes in the node set.

id(pos)

Get the node ID by position.

get_nid()

Get the node ID.

class ansys.dyna.core.pre.dynabase.SetType

Bases: enum.Enum

Contains the enums for setting types.

SHELL = 'SET_SHELL'

SOLID = 'SET_SOLID'

BEAM = 'SET_BEAM'

TSHELL = 'SET_TSHELL'

DISCRETE = 'SET_DISCRETE'

class ansys.dyna.core.pre.dynabase.NodesetGeneral(settype=SetType.SHELL, setids=[])

Bases: BaseSet

Includes nodal points of element sets.

Element sets are defined by SET_XXXX_LIST, where XXXX can be SHELL, SOLID, BEAM, TSHELL or DISCRETE.

settype

setids

create(stub)

Create a node set.

class ansys.dyna.core.pre.dynabase.NodeSetBox(boxes=[])

Bases: BaseSet

include the nodes inside boxes.

Parameters:

boxeslist

A list of BOX.

boxes

type = 'NODESETBOX'

create(stub)

Create a node set.

class ansys.dyna.core.pre.dynabase.PartSet(parts=[])

Bases: BaseSet

Defines a set of parts with optional attributes.

parts

create(stub)

Create a part set.

num()

Get the number of parts in the part set.

pos(pos)

Get a part ID by position.

get_pid()

Get the part ID.

class ansys.dyna.core.pre.dynabase.SegmentSet(segments=[])

Bases: BaseSet

Defines a set of segments with optional identical or unique attributes.

Parameters:

segmentslist [[point1,point2,point3,point4],[point5,point6,point7,point8]…]

Define segments.

segments

type = 'SEGMENTSET'

create(stub)

Create a segment set.

class ansys.dyna.core.pre.dynabase.BeamFormulation

Bases: enum.Enum

Generic enumeration.

Derive from this class to define new enumerations.

SPOTWELD = 9

class ansys.dyna.core.pre.dynabase.ShellFormulation

Bases: enum.Enum

Generic enumeration.

Derive from this class to define new enumerations.

FULLY_INTEGRATED

BELYTSCHKO_TSAY = 2

SR_HUGHES_LIU = 6

FULLY_INTEGRATED_BELYTSCHKO_TSAY_MEMBRANE = 9

PLANE_STRESS = 12

class ansys.dyna.core.pre.dynabase.IGAFormulation

Bases: enum.Enum

Generic enumeration.

Derive from this class to define new enumerations.

REISSNER_MINDLIN_FIBERS_AT_CONTROL_POINTS = 0

KIRCHHOFF_LOVE_FIBERS_AT_CONTROL_POINTS = 1

KIRCHHOFF_LOVE_FIBERS_AT_INTEGRATION_POINTS = 2

REISSNER_MINDLIN_FIBERS_AT_INTEGRATION_POINTS = 3

class ansys.dyna.core.pre.dynabase.SolidFormulation

Bases: enum.Enum

Generic enumeration.

Derive from this class to define new enumerations.

EIGHT_POINT_ENHANCED_STRAIN_SOLID_ELEMENT

CONSTANT_STRESS_SOLID_ELEMENT = 1

EIGHT_POINT_HEXAHEDRON = 2

FULLY_INTEGRATED_QUADRATIC_EIGHT_NODE_ELEMENT = 3

ONE_POINT_COROTATIONAL = 0

IMPLICIT_9_POINT_ENHANCED_STRAIN = 18

class ansys.dyna.core.pre.dynabase.HourglassType

Bases: enum.Enum

Generic enumeration.

Derive from this class to define new enumerations.

STANDARD_LSDYNA_VISCOUS = 1

FLANAGAN_BELYTSCHKO_VISOCOUS = 2

FLANAGAN_BELYTSCHKO_VISOCOUS_WITH_EXTRA_VOLUME_INTEGRATION = 3

FLANAGAN_BELYTSCHKO_STIFFNESS = 4

FLANAGAN_BELYTSCHKO_STIFFNESS_WITH_EXTRA_VOLUME_INTEGRATION = 5

BELYTSCHKO_BINDEMAN = 6

ACTIVATES_FULL_PROJECTION_WARPING_STIFFNESS = 8

class ansys.dyna.core.pre.dynabase.BeamSection(element_formulation, shear_factor=1, cross_section=0, thickness_n1=0, thickness_n2=0)

Defines cross-sectional properties for beams, trusses, discrete beams, and cable elements.

id

class ansys.dyna.core.pre.dynabase.ShellSection(element_formulation, shear_factor=1, integration_points=5, printout=0, thickness1=0, thickness2=0, thickness3=0, thickness4=0)

Defines section properties for shell elements.

id

class ansys.dyna.core.pre.dynabase.IGASection(element_formulation, shear_factor=1, thickness=1)

Defines section properties for isogeometric shell elements.

id

class ansys.dyna.core.pre.dynabase.Part(id)

Defines the part object.

stub

type = ''

id

secid = 0

mid = 0

eosid = 0

hgid = 0

grav = 0

adpopt = 0

tmid = 0

formulation = 0

stiffness_damping = 0

rigidbody_initial_velocity = False

translation

rotation

extra_nodes_defined = False

set_material(mat, mat_thermal=None)

Set the material.

set_element_formulation(formulation)

Set the element formulation.

set_stiffness_damping_coefficient(coefficient)

Set the stiffness damping coefficient.

set_extra_nodes(nodeset)

Set extra nodes for the rigid body.

Parameters:

nodesetNodeSet

Extra nodes list.

set_rigidbody_initial_velocity(translation=Velocity(0, 0, 0), rotation=RotVelocity(0, 0, 0))

Set initial translational and rotational velocities for the rigid body.

Initial translational and rotational velocities are set at the center of gravity for a rigid body or a nodal rigid body.

set_property()

Set properties for the part.

class ansys.dyna.core.pre.dynabase.BeamPart(pid)

Bases: Part

Defines a beam part.

A beam part definition consists of the combined material information, section properties, hourglass type, thermal properties, and a flag for part adaptivity.

stub

type = 'BEAM'

crosstype = 1

set_cross_type(cross)

Set the type for the cross section.

set_diameter(diameter)

Set the outer diameter for the cross section.

set_property()

Set properties for the beam part.

class ansys.dyna.core.pre.dynabase.ShellPart(pid)

Bases: Part

Defines a shell part.

A shell part definition consists of the combined material information, section properties, hourglass type, thermal properties, and a flag for part adaptivity.

stub

type = 'SHELL'

shear_factor = 1

intpoints = 5

print = 0

thickness = 1

hourglasstype

defined_des_surface = False

despid = 0

desxid = 0

des_nquad = 1

des_nsid = 0

des_rsf = 1

set_hourglass(type=HourglassType.STANDARD_LSDYNA_VISCOUS, coefficient=0.1)

Set the hourglass type, which identifies the bulk viscosity.

Parameters:

typeenum

Default hourglass control type.

coefficientfloat, optional

Default hourglass coefficient. The default is 0..

set_shear_factor(factor)

Set the shear correction factor, which scales the transverse shear stress.

set_integration_points(points=5)

Set the number of through thickness integration points.

set_printout(print)

Set the printout option.

set_thickness(thickness)

Set the shell thickness.

set_des_surface(despid=0, desxid=0, nquad=1, nsid=0, rsf=-1)

Generate and place discrete element sphere (DES) elements on the surface of shell elements.

Parameters:

despidint, optional

Part ID for the generated DES elements. The default is 0.

desxidint, optional

Section ID for the generated DES elements. The default is 0.

nquadint, optional

Number of equally spaced DES elements to create on a shell element in each local shell direction. The default is 1.

nsidint, optional

If defined, this card creates a node set with ID NSID for the nodes generated by this card. The default is 0.

rsffloat, optional

Scale factor for determining the DES radius. The default is 1.

set_property()

Set properties for the shell part.

class ansys.dyna.core.pre.dynabase.IGAPart(pid)

Bases: Part

Defines an isogeometric shell part.

The part definition consists of the combined material information, section properties, hourglass type, thermal properties, and a flag for part adaptivity.

stub

type = 'IGA'

shear_factor = 1

thickness = 1

set_shear_factor(factor)

Set the shear correction factor, which scales the transverse shear stress.

set_thickness(thickness)

Set the shell thickness.

set_property()

Set properties for the IGA part.

class ansys.dyna.core.pre.dynabase.SolidPart(pid)

Bases: Part

Defines a solid part.

The part definition consists of the combined material information, section properties, hourglass type, thermal properties, and a flag for part adaptivity.

stub

type = 'SOLID'

hourglasstype

set_hourglass(type=HourglassType.STANDARD_LSDYNA_VISCOUS, coefficient=0.1)

Set the hourglass type, which identifies the bulk viscosity.

Parameters:

typeenum

Default hourglass control type.

coefficientfloat, optional

Default hourglass coefficient. The default is 0..

set_property()

Set the properties for the solid part.

class ansys.dyna.core.pre.dynabase.DRO

Bases: enum.Enum

Generic enumeration.

Derive from this class to define new enumerations.

DESCRIBES_TRANSLATIONAL_SPRING = 0

DESCRIBES_TORSIONAL_SPRING = 1

class ansys.dyna.core.pre.dynabase.DiscretePart(pid)

Bases: Part

Defines a discrete part.

The part definition consists of the combined material information, section properties, hourglass type, thermal properties, and a flag for part adaptivity.

type = 'DISCRETE'

stub

displacement_option = 0

set_displacement_option(displacement_option=DRO.DESCRIBES_TRANSLATIONAL_SPRING)

Set the displacement, which defines the rotation.

set_property()

Set properties for the discrete part.

class ansys.dyna.core.pre.dynabase.Parts

Stores the part list.

beamlist = []

shelllist = []

solidlist = []

igalist = []

icfdlist = []

icfdvolumelist = []

discretelist = []

isphstructlist = []

isphfluidlist = []

add(part)

Add a part to the part list.

get_num_shellpart()

Get the number of shell parts.

set_property()

Set properties for added parts.

class ansys.dyna.core.pre.dynabase.AnalysisType

Bases: enum.Enum

Generic enumeration.

Derive from this class to define new enumerations.

EXPLICIT = 0

IMPLICIT = 1

EXPLICIT_FOLLOWED_BY_IMPLICIT = 2

class ansys.dyna.core.pre.dynabase.TimestepCtrol

Bases: enum.Enum

Generic enumeration.

Derive from this class to define new enumerations.

CONSTANT_TIMESTEP_SIZE = 0

AUTOMATICALLY_ADJUST_TIMESTEP_SIZE = 1

class ansys.dyna.core.pre.dynabase.Integration

Bases: enum.Enum

Generic enumeration.

Derive from this class to define new enumerations.

NEWMARK_TIME_INTEGRATION = 1

MODAL_SUPERPOSITION_FOLLOWING_EIGENVALUE = 2

class ansys.dyna.core.pre.dynabase.ImplicitAnalysis(analysis_type=AnalysisType.IMPLICIT, initial_timestep_size=0)

Activates implicit analysis and defines associated control parameters.

defined = False

defined_auto = False

defined_dynamic = False

defined_eigenvalue = False

defined_solution = False

defined_mass_matrix = False

imflag

dt0

stub

set_initial_timestep_size(size=0)

Define the initial time step size.

set_timestep(control_flag=TimestepCtrol.CONSTANT_TIMESTEP_SIZE, Optimum_equilibrium_iteration_count=11)

Define parameters for automatic time step control during implicit analysis.

Parameters:

control_flagint

Automatic time step control flag.

Optimum_equilibrium_iteration_countint, optional

Optimum equilibrium iteration count per time step. The default is 11.

Returns:

bool

True when successful, False when failed.

set_dynamic(integration_method=Integration.NEWMARK_TIME_INTEGRATION, gamma=0.5, beta=0.25)

Activate implicit dynamic analysis and define time integration constants.

Parameters:

integration_methodenum

Implicit analysis type.

gammafloat, optional

Newmark time integration constant. The default is 0.5.

betafloat, optional

Newmark time integration constant. The default is 0.25.

Returns:

bool

True when successful, False when failed.

set_eigenvalue(number_eigenvalues=0, shift_scale=0)

Activate implicit eigenvalue analysis and define associated input parameters.

Parameters:

number_eigenvaluesint, optional

Number of eigenvalues to extract. The default is 0.

shift_scalefloat, optional

Shift scale. The default is 0.

Returns:

bool

True when successful, False when failed.

set_solution(solution_method=12, iteration_limit=11, stiffness_reformation_limit=55, absolute_convergence_tolerance=1e-10)

Specify whether a linear or nonlinear solution is desired.

Parameters:

solution_methodint, optional

Solution method for implicit analysis. The default is 12.

iteration_limitint, optional

Iteration limit between automatic stiffness reformations. The default is 11.

stiffness_reformation_limitint, optional

Stiffness reformation limit per time step. The default is 55.

absolute_convergence_tolerancefloat, optional

Absolute convergence tolerance. The default is 1e-10.

Returns:

bool

True when successful, False when failed.

set_consistent_mass_matrix()

Use the consistent mass matrix in implicit dynamics and eigenvalue solutions.

create()

Create an implicit analysis.

class ansys.dyna.core.pre.dynabase.ThermalAnalysisType

Bases: enum.Enum

Generic enumeration.

Derive from this class to define new enumerations.

STEADY_STATE = 0

TRANSIENT = 1

class ansys.dyna.core.pre.dynabase.ThermalAnalysisTimestep

Bases: enum.Enum

Generic enumeration.

Derive from this class to define new enumerations.

FIXED = 0

VARIABLE = 1

class ansys.dyna.core.pre.dynabase.ThermalAnalysis

Bases: BaseObj

Activates thermal analysis and defines associated control parameters.

defined_solver = False

defined_timestep = False

defined_nonlinear = False

stub

type = 'analysis_thermal'

set_timestep(timestep_control=ThermalAnalysisTimestep.FIXED, initial_timestep=0)

Set time step controls for the thermal solution in a thermal only or coupled structural/thermal analysis.

Parameters:

timestep_controlThermalAnalysisTimestep

Time step control.

initial_timestepfloat, optional

Initial thermal time step. The default is 0.

set_solver(analysis_type=ThermalAnalysisType.STEADY_STATE)

Set options for the thermal solution in a thermal only or coupled structural-thermal analysis.

Parameters:

analysis_typeImplicitAnalysis

Thermal analysis type.

set_nonlinear(convergence_tol=0.0001, divergence=0.5)

Set parameters for a nonlinear thermal or coupled structural/thermal analysis.

Parameters:

convergence_tolfloat

Convergence tolerance for temperature.

divergencefloat

Divergence control parameter.

create()

Create a thermal analysis.

class ansys.dyna.core.pre.dynabase.ContactCategory

Bases: enum.Enum

Generic enumeration.

Derive from this class to define new enumerations.

SURFACE_TO_SURFACE_CONTACT = 2

SINGLE_SURFACE_CONTACT = 3

SHELL_EDGE_TO_SURFACE_CONTACT = 4

NODES_TO_SURFACE = 5

class ansys.dyna.core.pre.dynabase.ContactType

Bases: enum.Enum

Generic enumeration.

Derive from this class to define new enumerations.

NULL = 0

AUTOMATIC = 1

GENERAL = 2

RIGID = 3

TIED = 4

TIED_WITH_FAILURE = 5

ERODING = 6

EDGE = 7

class ansys.dyna.core.pre.dynabase.OffsetType

Bases: enum.Enum

Generic enumeration.

Derive from this class to define new enumerations.

NULL = ''

OFFSET = 'OFFSET'

BEAM_OFFSET = 'BEAM_OFFSET'

CONSTRAINED_OFFSET = 'CONSTRAINED_OFFSET'

class ansys.dyna.core.pre.dynabase.ContactFormulation

Bases: enum.Enum

Generic enumeration.

Derive from this class to define new enumerations.

STANDARD_PENALTY = 0

SOFT_CONSTRAINT_PENALTY = 1

SEGMENT_BASED_CONTACT_PENALTY = 2

class ansys.dyna.core.pre.dynabase.SBOPT

Bases: enum.Enum

Generic enumeration.

Derive from this class to define new enumerations.

ASSUME_PLANER_SEGMENTS = 2

WRAPED_SEGMENT_CHECKING = 3

SLDING_OPTION = 4

class ansys.dyna.core.pre.dynabase.ContactSurface(set)

Defines a contact interface.

stub

id

thickness = 0

penalty_stiffness = 1.0

set_contact_region(box)

Include in the contact definition only those SURFA nodes/segments within a box.

Parameters:

boxBox

Box-shaped volume.

set_contact_thickness(thickness)

Set the contact thickness for the SURFA surface.

Parameters:

thicknessfloat

Contact thickness.

set_penalty_stiffness_scale_factor(scalefactor=1.0)

Set the scale factor on the default surface penalty stiffness.

Parameters:

scalefactorint, optional

Scale factor. The default is 1.0.

class ansys.dyna.core.pre.dynabase.Contact(type=ContactType.NULL, category=ContactCategory.SINGLE_SURFACE_CONTACT, offset=OffsetType.NULL)

Provide a way of treating interaction between disjoint parts.

stub

rigidwall_penalties_scale_factor = 1

max_penetration_check_multiplier = 4

initial_penetrations = 0

rigidwall_gap_stiffness = 0

category

type

mortar = False

ignore = 0

offset

static_friction_coeff = 0

dynamic_friction_coeff = 0

birth_time = 0

death_time = 1e+20

option_tiebreak = False

optionres = 0

contact_formulation = 0

segment_based_contact_option = 2

set_mortar()

Set the mortar contact.

A mort contact is a segment-to-segment, penalty-based contact.

set_tiebreak()

Set the contact allow for failure.

A tieback is a special case of this. After failure, the contact usually becomes a normal one-way, two-way, or single surface version.

set_friction_coefficient(static=0, dynamic=0)

Set the coefficient of friction.

Parameters:

staticfloat, optional

Static coefficient of friction. The default is 0.

dynamicfloat, optional

Dynamic coefficient of friction. The default is 0.

set_active_time(birth_time=0, death_time=1e+20)

Set the birth and death time to active and deactivate the contact.

Parameters:

birth_timeint, optional

Time to activate the contact. The default is 0.

death_timefloat, optional

Time to deactivate the contact. The default is 1e20.

set_initial_penetration()

Ignore initial penetrations.

set_slave_surface(surface)

Set the slave contact interface.

set_master_surface(surface)

Set the master contact interface.

set_penalty_algorithm(formulation=ContactFormulation.STANDARD_PENALTY, segment_based_contact_option=SBOPT.ASSUME_PLANER_SEGMENTS)

Set the contact formulation.

create()

Create a contact.

class ansys.dyna.core.pre.dynabase.ContactGroup

Create a contact group.

stub

contactlist = []

add(contact)

Add a contact in the group.

create()

Create contacts.

num()

Get the number of contact objects.

class ansys.dyna.core.pre.dynabase.Constraint

Provides a way of constraining degrees of freedom to move together in some way.

spotweldlist = []

cnrbsetidlist = []

jointsphericallist = []

mergerigidlist = []

create_spotweld(nodeid1, nodeid2)

Define massless spot welds between non-contiguous nodal pairs.

Parameters:

nodeid1int

ID for the first node.

nodeid2int

ID for the second node.

Returns:

bool

True when successful, False when failed.

create_cnrb(nodeset)

Create a nodal rigid body, which is a rigid body that consists of defined nodes.

Parameters:

nodesetNodeSet

Node set that defines the rigid body.

Returns:

bool

True when successful, False when failed.

create_joint_spherical(nodes, relative_penalty_stiffness=1.0, damping_scale_factor=1.0)

Create a joint between two rigid bodies.

Parameters:

nodeslist

List of nodes for creating the joint.

relative_penalty_stiffnessint, optional

Relative penalty stiffness. The default is 1.0.

damping_scale_factorint, optional

Damping scale factor on the default damping value. The default is 1.0.

merge_two_rigid_bodies(lead_rigidbody=0, constrained_rigidbody=0)

Merge two rigid bodies.

One rigid body, called the constrained rigid body, is merged into another rigid body, called the lead rigid body.

Parameters:

lead_rigidbodyint, optional

Part ID for the lead rigid body. The default is 0.

constrained_rigidbodyint

Part ID for the constrained rigid body. The default is 0.

create()

Create a constraint.

class ansys.dyna.core.pre.dynabase.BoundaryCondition

Provides a way of defining imposed motions on boundary nodes.

stub

spclist = []

imposedmotionlist = []

templist = []

convectionlist = []

assign_model(model)

create_spc(nodeset, tx=True, ty=True, tz=True, rx=True, ry=True, rz=True, cid=0, birth=0, death=1e+20)

Define nodal single point constraints.

Parameters:

nodesetNodeSet.

Node set.

contraint_x/y/z_directionint

Translational constraint in local x/y/z-direction.

contraint_x/y/zaxis_rotateint

Rotational constraint about local x/y/z-axis.

create_imposed_motion(set, curve, motion=Motion.DISPLACEMENT, dof=DOF.X_TRANSLATIONAL, scalefactor=1, birthtime=0)

Create an imposed nodal motion on a node or set of nodes.

An imposed nodal motion can be a velocity, acceleration, or displacement.

Parameters:

partsetPartSet.

Part set.

curveCurve

Curve ID or function ID to describe the motion value as a function of time.

motionenum

Velocity/Acceleration/Displacement flag.

dofenum

Applicable degrees of freedom.

scalefactorint, optional

Load curve scale factor. The default is 1.

birthtimeint, optional

create_temperature(nodeset, curve=None, scalefactor=1)

Create temperature boundary conditions for a thermal or coupled thermal/structural analysis.

Parameters:

nodesetNodeSet.

Node set.

curveCurve, optional

Temperature, T, specification. The default is None.

scalefactorfloat, optional

Temperature, T, curve multiplier. The default is 1.

create_convection(segmentset=None, convection_heat_transfer_coefficient=None, convection_heat_transfer_coefficient_multiplier=0.0, environment_temperature=None, environment_temperature_multiplier=0.0)

Apply a convection boundary condition on SEGMENT_SET for a thermal analysis.

Parameters:

segmentsetSegmentSet.

Segment set.

convection_heat_transfer_coefficientCurve

Convection heat transfer coefficient.

convection_heat_transfer_coefficient_multiplierfloat

Curve multiplier for convection heat transfer coefficient.

environment_temperatureCurve

Environment temperature.

environment_temperature_multiplierfloat

Curve multiplier for environment temperature.

create()

Create a boundary condition.

class ansys.dyna.core.pre.dynabase.InitialCondition

Provides a way of initializing velocities and detonation points.

stub

velocitylist = []

velocitynodelist = []

temperaturelist = []

assign_model(model)

create_velocity(velocityset, angular_velocity=0, velocity=Velocity(0, 0, 0), direction=Direction(0, 0, 0), stime=0)

Create initial velocities for rotating and/or translating bodies.

create_velocity_node(nodeid, trans=Velocity(0, 0, 0), rot=RotVelocity(0, 0, 0))

Define initial nodal point velocities for a node.

create_temperature(nodeset=None, temperature=0)

Create an initial nodal point temperature.

create()

Create an initial condition.

class ansys.dyna.core.pre.dynabase.RigidwallCylinder(tail=Point(0, 0, 0), head=Point(0, 0, 0), radius=1, length=10)

Bases: BaseObj

Defines a rigid wall with a cylinder form.

Parameters:

tailPoint, optional

Coordinates of the tail of the normal vector. The default is (0, 0, 0).

headPoint, optional

Coordinates of the head of the normal vector. The default is (0, 0, 0).

radiusfloat, optional

Radius of the cylinder. The default is 1.

lengthfloat, optional

Length of cylinder. The default is 10.

stub

tail

head

radius

length

motion

lcid = 0

dir

type = 'rigidwall_cylinder'

set_motion(curve, motion=RWMotion.VELOCITY, dir=Direction(1, 0, 0))

Set the prescribed motion.

get_data() → List

Get the rigidwall data.

create()

Create a rigidwall cylinder.

class ansys.dyna.core.pre.dynabase.RigidwallSphere(center=Point(0, 0, 0), orient=Point(0, 0, 0), radius=1)

Bases: BaseObj

Defines a rigid wall with a sphere form.

Parameters:

centerPoint, optional

The center of sphere. The default is (0, 0, 0).

orientPoint, optional

Vector n determines the orintation of the rigidwall,the center define the tail of normal n, the orient define the head of normal n. The default is (0, 0, 0).

radiusfloat, optional

Radius of the sphere. The default is 1.

stub

center

orient

radius

motion

lcid = 0

dir

type = 'rigidwall_sphere'

set_motion(curve, motion=RWMotion.VELOCITY, dir=Direction(1, 0, 0))

Set the prescribed motion.

get_data() → List

Get the rigidwall data.

create()

Create a rigidwall sphere.

class ansys.dyna.core.pre.dynabase.RigidwallPlanar(tail=Point(0, 0, 0), head=Point(0, 0, 0), coulomb_friction_coefficient=0.5)

Bases: BaseObj

Defines planar rigid walls with either finite or infinite size.

Parameters:

tailPoint

Coordinate of the tail of the normal vector. The default is (0, 0, 0).

headPoint

Coordinate of the head of the normal vector. The default is (0, 0, 0).

coulomb_friction_coefficientfloat, optional

Friction coefficieint in coulomb units. The default is 0.5.

stub

tail

head

fric

type = 'rigidwall_planar'

get_data() → List

Get the rigidwall data.

create()

Create planar rigid walls.

class ansys.dyna.core.pre.dynabase.GravityOption

Bases: enum.Enum

Generic enumeration.

Derive from this class to define new enumerations.

DIR_X = 'X'

DIR_Y = 'Y'

DIR_Z = 'Z'

class ansys.dyna.core.pre.dynabase.Gravity(dir=GravityOption.DIR_Z, load=Curve(x=[0, 0], y=[0, 0]))

Bases: BaseObj

Defines body force loads using global axes directions.

Body force loads are due to a prescribed base acceleration or angular velocity.

stub

dir

load

type = 'gravity'

create()

Define a body force.