ansys.dyna.core.pre.dynamaterial

Module for creating a material.

Classes

Air	Defines an air material.
Liner	Defines a liner material.
HighExplosive	Defines a high-explosive material.
Vacuum	Defines a vacuum material.
MatNull	Defines a null material.
EMEOSTabulated1	Defines electrical conductivity or permeability.
EMMATTYPE	Generic enumeration.
MatAdditional	Defines additional properties for a material.
MatElastic	Defines an isotropic hypoelastic material.
MatPlasticKinematic	Define material of modelling isotropic and kinematic hardening plasticity.
MatElasticPlasticThermal	Defines temperature-dependent material coefficients.
MatRigid	Defines a rigid material.
MatShapeMemory	Describe the superelastic response present in shape-memory alloys,
MatCrushableFoam	Define material of modelling crushable foam.
MatOgdenRubber	Provides the Ogden rubber model.
MatThermalIsotropic	Defines isotropic thermal properties.
MatThermalOrthotropic	Defines orthotropic thermal properties.
MatRigidDiscrete	Defines a rigid material for shells or solids.
MatPiecewiseLinearPlasticity	Defines an elasto-plastic material with an arbitrary stress.
MatModifiedPiecewiseLinearPlasticity	Defines an elasto-plastic material supporting an arbitrary stress.
MatSpotweld	Defines a spotweld material.
MatFabric	Define an airbag material.
MatSpringNonlinearElastic	Provides a nonlinear elastic translational and rotational spring with an arbitrary force.
MatDamperViscous	Provides a linear translational or rotational damper located between two nodes.
MatDamperNonlinearViscous	Provides a viscous translational damper with an arbitrary force.
MatSPHIncompressibleFluid	Defines an ISPH (incompressible smooth particle hyrodynamics) fluid material.
MatSPHIncompressibleStructure	Defines an ISPH structure material.

Module Contents

class ansys.dyna.core.pre.dynamaterial.Air(mass_density=0.00128, pressure_cutoff=-1e-09, initial_internal_energy=2.5331e-06, initial_relative_volume=1.0, equation_coefficient=[0, 0, 0, 0, 0.4, 0.4, 0])

Defines an air material.

Parameters:

namestr

Material name.

mass_densityfloat, optional

Mass density. The default is 0.00128.

pressure_cutofffloat, optional

pressure cutoff. The default is 1e-09.

initial_internal_energyfloat, optional

Initial internal energy per unit reference volume. The default is 2.5331e-06.

initial_relative_volumefloat, optional

Initial relative volume. The default is 1.0.

equation_coefficientlist, optional

Six polynomial equation coefficient. The default is [0, 0, 0, 0, 0.4, 0.4, 0]).

Returns:

bool

True when successful, False when failed.

mass_density

pressure_cutoff

initial_internal_energy

initial_relative_volume

equation_coefficient

create(stub)

Create an air material.

class ansys.dyna.core.pre.dynamaterial.Liner(mass_density=8.96, shear_modulus=0.46, youngs_modulus=0, poissons_ratio=0.34, constants=[0.0009, 0.00292, 0.31, 0.025, 1.09], melt_temperature=1356, room_temperature=293, strain_rate=1e-06, specific_heat=3.83e-06, tensile_failure_stress=-0.012, spall_type=2, iteration_option=0, failure_parameters=[0.54, 4.89, 3.03, 0.014, 1.12], equation_constants=[0.394, 1.489, 0, 0, 2.02], volume_correction_coefficient=0.47, initial_internal_energy=0)

Defines a liner material.

Parameters:

mass_densityfloat, optional

Mass density. The default is 8.96.

shear_modulusfloat, optional

youngs_modulusfloat, optional

poissons_ratiofloat optional

constantslist, optional

melt_temperatureint, optional

room_temperatureint, optional

strain_ratefloat, optional

specific_heatfloat, optional

tensile_failure_stressfloat, optional

spall_type, int, optional

iteration_option ; int, optional

failure_parameterslist, optional

equation_constants, list, optional

volume_correction_coefficientfloat, optional

initial_internal_energyfloat, optional

Initial internal energy per unit reference volume. The default is 0.

Returns:

bool

True when successful, False when failed.

mass_density

shear_modulus

youngs_modulus

poissons_ratio

constants

melt_temperature

room_temperature

strain_rate

specific_heat

tensile_failure_stress

spall_type

iteration_option

failure_parameters

equation_constants

volume_correction_coefficient

initial_internal_energy

create(stub)

Create a liner material.

class ansys.dyna.core.pre.dynamaterial.HighExplosive(mass_density=1.835, detonation_velocity=0.88, chapman_jouget_pressure=0.37, jwl_equation_parameters=[8.261, 0.1724, 4.55, 1.32, 0.38, 0.102, 1.0])

Defines a high-explosive material.

Parameters:

mass_densityfloat, optional

Mass density. The default is 8.96.

detonation_velocityfloat, optional

chapman_jouget_pressurefloat, optional

jwl_equation_parameterslist, optional

Returns:

bool

True when successful, False when failed.

mass_density

detonation_velocity

chapman_jouget_pressure

jwl_equation_parameters

create(stub)

Create a high-explosive material.

class ansys.dyna.core.pre.dynamaterial.Vacuum(estimated_material_density=1e-09)

Defines a vacuum material.

Parameters:

estimated_material_densityfloat

Estimated material density. The default is 1e-09.

Returns:

bool

True when successful, False when failed.

estimated_material_density

create(stub)

Create a null material.

class ansys.dyna.core.pre.dynamaterial.MatNull(mass_density=0, pressure_cutoff=0)

Defines a null material.

Young’s modulus and Poisson’s ratio are used to set the contact stiffness.

Parameters:

mass_densityfloat, optional

Mass density. The default is 0.

pressure_cutoff

ro

pc

create(stub)

Create a null material.

class ansys.dyna.core.pre.dynamaterial.EMEOSTabulated1(curve=None)

Defines electrical conductivity or permeability.

Parameters:

curveCurve

curve

create(stub)

Create an EM EOS tabulated1.

class ansys.dyna.core.pre.dynamaterial.EMMATTYPE

Bases: ansys.dyna.core.pre.dynabase.Enum

Generic enumeration.

Derive from this class to define new enumerations.

AIR_OR_VACUUM = 0

INSULATOR = 1

CONDUCTOR = 2

class ansys.dyna.core.pre.dynamaterial.MatAdditional

Defines additional properties for a material.

em = False

em_mat_type = 0

em_eos = None

thermal_isotropic = False

set_electromagnetic_property(material_type=EMMATTYPE.CONDUCTOR, initial_conductivity=0, eos=None)

Define the electromagnetic material type and properties for a material whose permeability equals the free space permeability.

Parameters:

material_type

initial_conductivity

eos

set_em_permeability_equal(material_type=EMMATTYPE.CONDUCTOR, initial_conductivity=0, eos=None)

Define the electromagnetic material type and properties for a material whose permeability equals the free space permeability.

Parameters:

material_type

initial_conductivity

eos

set_em_permeability_different(material_type=EMMATTYPE.CONDUCTOR, initial_conductivity=0, eos=None, murel=0)

Define the electromagnetic material type and properties for a material whose permeability equals the free space permeability.

Parameters:

material_type

initial_conductivity

eos

murel

set_em_conducting_shells_3d(material_type=EMMATTYPE.CONDUCTOR, initial_conductivity=0)

Define the electromagnetic material type and properties for a material whose permeability equals the free space permeability.

Parameters:

material_type

initial_conductivity

set_em_resistive_heating_2d(material_type=EMMATTYPE.CONDUCTOR, initial_conductivity=0)

Define the electromagnetic material type and properties for a material whose permeability equals the free space permeability.

Parameters:

material_type

initial_conductivity

set_em_randles_batmac(positive_current_collector_conductivity=0, negative_current_collector_conductivity=0)

Define two conductivities per EM node for special applications (Randles Batmac).

Parameters:

positive_current_collector_conductivityfloat

conductivities of the positive current collector materials

negative_current_collector_conductivityfloat

conductivities of the negative current collector materials

set_thermal_isotropic(density=0, generation_rate=0, generation_rate_multiplier=0, specific_heat=0, conductivity=0)

Define isotropic thermal properties.

Parameters:

density

generation_rate

generation_rate_multiplier

specific_heat

conductivity

create(stub, matid)

Define additional properties for a material.

Parameters:

matid

Material ID.

class ansys.dyna.core.pre.dynamaterial.MatElastic(mass_density=0, young_modulus=0, poisson_ratio=0.3)

Bases: MatAdditional

Defines an isotropic hypoelastic material.

ro

e

pr

create(stub)

Create an elastic material.

class ansys.dyna.core.pre.dynamaterial.MatPlasticKinematic(mass_density=0, young_modulus=0, poisson_ratio=0.3, yield_stress=0, tangent_modulus=0, hardening=0)

Define material of modelling isotropic and kinematic hardening plasticity.

ro

e

pr

sigy

etan

beta

create(stub)

Create plastic kinematic material.

class ansys.dyna.core.pre.dynamaterial.MatElasticPlasticThermal(mass_density=0, temperatures=None, young_modulus=None, poisson_ratio=None, thermal_expansion=None, yield_stress=None)

Bases: MatAdditional

Defines temperature-dependent material coefficients.

ro

ti

ei

pri

alphai

sigyi

create(stub)

Create elastic plastic thermal material.

class ansys.dyna.core.pre.dynamaterial.MatRigid(mass_density=0, young_modulus=0, poisson_ratio=0.3, center_of_mass_constraint=0, translational_constraint=0, rotational_constraint=0)

Bases: MatAdditional

Defines a rigid material.

Parts made from a rigid material are considered to belong to a rigid body.

ro

e

pr

cmo

con1

con2

create(stub)

Create rigid material.

class ansys.dyna.core.pre.dynamaterial.MatShapeMemory(mass_density=0, young_modulus=0, poisson_ratio=0.3, effective_stress=None, forward_phase_transformation_start=None, forward_phase_transformation_final=None, reverse_phase_transformation_start=None, reverse_phase_transformation_final=None, recoverable_strain=0)

Describe the superelastic response present in shape-memory alloys, the peculiar material ability to undergo large deformations with a full recovery in loading-unloading cycles.

ro

e

pr

lcss

params

create(stub)

Create shape memory material.

class ansys.dyna.core.pre.dynamaterial.MatCrushableFoam(mass_density=0, young_modulus=0, poisson_ratio=0.3, yield_stress_curve=None, tensile_stress_cutoff=0)

Bases: MatAdditional

Define material of modelling crushable foam.

ro

e

pr

lcid

tsl

create(stub)

Create crushable foam material.

class ansys.dyna.core.pre.dynamaterial.MatOgdenRubber(mass_density=0, poisson_ratio=0.3, limit_stress=0, shear_modulus=None, exponent=None)

Provides the Ogden rubber model.

ro

pr

sigf

mu

alpha

create(stub)

Create ogden rubber material.

class ansys.dyna.core.pre.dynamaterial.MatThermalIsotropic(density=0, generation_rate=0, generation_rate_multiplier=0, specific_heat=0, conductivity=0)

Defines isotropic thermal properties.

tro

tgrlc

tgmult

hc

tc

create(stub)

Create isotropic thermal material.

class ansys.dyna.core.pre.dynamaterial.MatThermalOrthotropic(specific_heat=0, conductivity_x=0, conductivity_y=0, conductivity_z=0)

Defines orthotropic thermal properties.

hc

k1

k2

k3

create(stub)

Create orthotropic thermal material.

class ansys.dyna.core.pre.dynamaterial.MatRigidDiscrete(mass_density=0, young_modulus=0, poisson_ratio=0.3)

Defines a rigid material for shells or solids.

Parameters:

mass_density

young_modulus

poisson_ratio

ro

e

pr

create(stub)

Create a rigid material.

class ansys.dyna.core.pre.dynamaterial.MatPiecewiseLinearPlasticity(mass_density=0, young_modulus=0, poisson_ratio=0.3, yield_stress=0, tangent_modulus=0)

Defines an elasto-plastic material with an arbitrary stress.

The arbitrary stress is defined as a function of strain curve that can also have an arbitrary strain rate dependency.

Parameters:

mass_density

young_modulus

poisson_ratio

yield_stress

tangent_modulus

ro

e

pr

sigy

etan

create(stub)

Create a piecewise linear plasticity material.

class ansys.dyna.core.pre.dynamaterial.MatModifiedPiecewiseLinearPlasticity(mass_density=0, young_modulus=0, poisson_ratio=0, yield_stress=0, tangent_modulus=0, plastic_strain_to_failure=0, integration_points_number=0)

Defines an elasto-plastic material supporting an arbitrary stress.

The arbitrary stress is defined as a function of strain curve and arbitrary strain rate dependency.

Parameters:

mass_density

young_modulus

poisson_ratio

yield_stress

tangent_modulus

plastic_strain_to_failure

integration_points_number

ro

e

pr

sigy

etan

fail

numint

create(stub)

Create a modified piecewise linear plasticity.

class ansys.dyna.core.pre.dynamaterial.MatSpotweld(mass_density=0, young_modulus=0, poisson_ratio=0, yield_stress=0, plastic_hardening_modulus=0, axial_force_resultant_at_failure=0, force_resultant_nrs_at_failure=0, force_resultant_nrt_at_failure=0)

Defines a spotweld material.

Parameters:

mass_density

young_modulus

poisson_ratio

yield_stress

plastic_hardening_modulus

axial_force_resultant_at_failure

force_resultant_nrs_at_failure

force_resultant_nrt_at_failure

ro

e

pr

sigy

eh

nrr

nrs

nrt

create(stub)

Create a spotweld material.

class ansys.dyna.core.pre.dynamaterial.MatFabric(mass_density=0, young_modulus_longitudinal_direction=0, young_modulus_transverse_direction=0, minor_poisson_ratio=0.35, major_poisson_ratio=0.35, shear_modulus=0)

Define an airbag material.

Parameters:

mass_densityfloat, optional

Mass density. The default is 0.

young_modulus_longitudinal_directionfloat, optional

Young’s modulus-longitudinal direction. The default is 0.

young_modulus_transverse_directionfloat, optional

Young’s modulus-transverse direction. The default is 0.

minor_poisson_ratiofloat, optional

Minor Poisson’s ratio ba direction. The default is 0.35.

major_poisson_ratiofloat, optional

Major Poisson’s ratio ab direction. The default is 0.35.

shear_modulusfloat, optional

Shear modulus in the ab direction. The default is 0.

ro

ea

eb

prba

prab

gab

create(stub)

Create an airbag material.

class ansys.dyna.core.pre.dynamaterial.MatSpringNonlinearElastic(curve)

Provides a nonlinear elastic translational and rotational spring with an arbitrary force.

The arbitrary force is defined as a function of displacement. The moment is defined as a function of rotation.

Parameters:

curveCurve

Load curve describing force as a function of displacement or moment as a function of rotation relationship.

curve

create(stub)

Create material spring nonlinear elastic.

class ansys.dyna.core.pre.dynamaterial.MatDamperViscous(damping_constant=0)

Provides a linear translational or rotational damper located between two nodes.

Parameters:

damping_constant

dc

create(stub)

Create a material damper viscous.

class ansys.dyna.core.pre.dynamaterial.MatDamperNonlinearViscous(curve)

Provides a viscous translational damper with an arbitrary force.

The arbitrary force is defined as a function of velocity dependency or a rotational damper with an arbitrary moment as a function of rotational velocity dependency.

Parameters:

curveCurve

Load curve defining force as a function of rate-of-displacement relationship or a moment as a function of rate-of-rotation relationship.

curve

create(stub)

Create a material damper nonlinear viscous.

class ansys.dyna.core.pre.dynamaterial.MatSPHIncompressibleFluid(mass_density=0, dynamic_viscosity=0, tension_coefficient1=0, tension_coefficient2=0)

Defines an ISPH (incompressible smooth particle hyrodynamics) fluid material.

Parameters:

mass_densityfloat, optional

Mass density. The default is 0.

dynamic_viscosity

tension_coefficient1

tension_coefficient2

ro

mu

gamma1

gamma2

create(stub)

Create an ISPH fluid material.

class ansys.dyna.core.pre.dynamaterial.MatSPHIncompressibleStructure(mass_density=0, adhesion_coefficient=0, roughness_coefficient=0, adhesion_scaling_coefficient=0)

Defines an ISPH structure material.

Parameters:

mass_densityfloat, optional

Mass density. The default is 0.

adhension_coefficient

roughness_coefficient

adhesion_scaling_coefficient

ro

beta

rough

adh

create(stub)

Create an ISPH structure material.