# zone cmodel command

Syntax

zone cmodel keyword

Primary keywords:

Assign, load, or get information on a zone constitutive model. This command associates a constitutive model with specified zones in the grid. It also allows querying of properties and states of constitutive models, and dynamic loading of user-defined mechanical models as DLLs.

assign keyword <overlay i > <range>

assigns a mechanical material model to all zones in the range.

The optional keyword overlay assigns either two overlaid sets of five constant-strain tetrahedral elements to each zone ( i =2 ), or one set of five tetrahedral elements to each zone ( i =1 ). The default is set to double-overlaid elements. Use of zones with a single overlay for mechanical calculations is not recommended.

The mechanical constitutive models are described in Constitutive Models, and the creep models are in Creep Constitutive Models.

Null Mechanical Models

null

null model — for most purposes null models are ignored by default, and zones adjacent to them are treated as surfaces (see the Null model description).

Elastic Mechanical Models

anisotropic

transversely-anisotropic elastic model (see the Anisotropic model description).

elastic

isotropic elastic model (see the Elastic Model description).

orthotropic

orthotropic elastic model (see the Orthotropic model description).

Elastic-Plastic Mechanical Models

cap-yield

cap-yield elasto-plasticity model, known also as CYSoil model (see the CYSoil model description).

cap-yield-simplified

simplified cap yield elasto-plasticity model, known also as CHSoil model (see the CHSoil model description).

double-yield

double-yield (cap) elasto-plasticity model (see the Double-Yield model description).

drucker-prager

Drucker-Prager elasto-plasticity model (see the Drucker-Prager model description).

hoek-brown

Hoek-Brown elasto-plasticity model (see the Hoek-Brown model description).

hoek-brown-pac

Hoek-Brown-PAC elasto-plasticity model (see the Hoek-Brow-PAC model description).

modified-cam-clay

modified Cam-Clay elasto-plasticity model (see the modified Cam-Clay model description).

mohr-coulomb

Mohr-Coulomb elasto-plasticity model (see the Mohr-Coulomb model description).

mohr-coulomb-tension

Mohr-Coulomb elasto-plasticity model with tensile strain crack tracking, known also as the MohrT model (see the Mohr-Coulomb-Tension model description).

norsand

norsand is a critical state model applicable to soils in which particle to particle interactions are controlled by contact forces and slips rather than bonds (see the NorSand model description).

ubiquitous-joint

Mohr-Coulomb elasto-plasticity model with a plane of weakness, known also as UBI model (see the Ubiquitous-Joint model description).

ubiquitous-anisotropic

model with a plane of weakness and with anisotropic elasticity (see the Ubiquitous-Anisotropic model description).

plastic-hardening

elasto-plasticity model with shear and volumetric hardening, known also as PH model (see the Plastic-Hardening model description).

soft-soil

soft-soil model for soil with significant compression (see the Soft-Soil model description).

softening-ubiquitous

strain-softening/hardening elasto-plasticity model with bilinear failure and ubiquitous joints, known also as the SUBI model (see the Softening-Ubiquitous model description).

strain-softening

strain-softening/hardening elasto-plasticity model (see the Strain-Softening model description).

swell

Mohr-Coulomb elasto-plasticity model considering wetting-induced deformation (see the Swell model description).

Dynamic Option Model

finn

dynamic pore-pressure generation elasto-plasticity model (only available for the dynamic option; see the Finn model description).

p2psand

p2psand model refers to a Practical TWO-surface Plastic SAND constitutive model for general 3D geotechnical earthquake engineering application (see the P2PSand model description).

Creep Option Model

burgers

classical viscoelastic model known as the Burgers substance which composed of a Kelvin model and a Maxwell model (only available for the creep option; see the Burgers model description).

burgers-mohr

viscoplastic model combining the Burgers model and the Mohr-Coulomb model (only available for the creep option; see the Burgers-Mohr model description).

maxwell

classical viscoelastic model known as the Maxwell substance, known also as Maxwell model (only available for the creep option; see the Maxwell model description).

power

two-component power law model used for mining applications (only available for the creep option; see the Power model description).

power-mohr

viscoplastic model combining the two-component Power model and the Mohr-Coulomb model (only available for the creep option; see the Power-Mohr model description).

power-ubiquitous

viscoplastic model combining the two-component Power model and the Ubiquitous-Joint model (only available for the creep option; see the Power-Ubiqitous mdoel description).

soft-soil-creep

soft-soil-creep model for soil with time-dependent behavior such as the creep that develops during the secondary compression (see the Soft-Soil-Creep model description).

wipp

a reference creep model commonly used in thermomechanical analyses associated with studies for the underground isolation of nuclear waste in salt (only available for the creep option; see the WIPP model description).

wipp-drucker

a viscoplastic model combining the WIPP model and the Drucker-Prager model (only available for the creep option, see the WIPP-Drucker model description).

wipp-salt

viscoplastic model modified from the WIPP model, and includes volumetric and deviatoric compaction behavior for salt-like materials (only available for the creep option; see the WIPP-Salt model description).

Thermal Option Model

hydration-drucker-prager

modified Drucker-Prager for hydration (only available for the thermal option; see see the Hydration-Drucker-Prager model description).

list keyword
names <s >

Outputs available mechanical model keywords, names and version numbers. Output is restricted to the model named s if supplied.

properties <s >

Outputs the property list for each mechanical model. Output is restricted to the model named s if supplied.

states <s >

Outputs the possible state flags for each mechanical model. Output is restricted to the model named s if supplied.

attempts to dynamically load a DLL version of a constitutive model, identified by s. Once loaded, the DLL model can be assigned to zones in the grid using the zone cmodel assign command and range keywords. See Writing New Constitutive Models for a guide to creating user-defined models as DLLs. zone cmodel load can only be applied if model configure plugins is invoked. Also see the zone cmodel load command.