structure pile cmodel command

Syntax

structure pile cmodel keyword

Primary keywords:

assign    list    plastic-integration

Assign or get information about beam constitutive models. This command allows one to assign a constitutive model to a specified beam-type element, query properties and states of constitutive models, and assign and query the integration scheme for plastic elements.

assign keyword <range>

Assigns the specified constitutive model (CM) to all elements in the range. If a CM has already been assigned, then replaces the existing CM with the new CM. If either an elastic or plastic CM is replaced by an elastic CM, then the nodal forces acting on the element remain the same. If a plastic CM is replaced by another plastic CM, then both the integration scheme and the stress at each integration point remain the same. The case of an elastic CM being replaced by a plastic CM is not yet implemented. The properties of the newly assigned constitutive model will be default values, and should be set with the structure pile property command. The integration scheme for elements with a plastic material model is set with the structure pile cmodel plastic-integration command.

Beam Elastic Constitutive Model

elastic

isotropic elastic model: (see the Beam Elastic Constitutive Model description).

Beam Elastic-Plastic Constitutive Models

mohr-coulomb

Mohr Coulomb elasto-plasticity model in one-dimensional mode (see the Mohr Coulomb model description). Plastic material behavior is supported by the Euler-Bernoulli finite element.

strain-softening

Strain-softening/hardening Mohr Coulomb elasto-plasticity model in one-dimensional mode (see the Mohr Coulomb strain softening model description). Plastic material behavior is supported by the Euler-Bernoulli finite element. The softening properties vary over the integration points.

von-mises

von Mises elasto-plasticity model in one-dimensional mode (see the von Mises model description). Plastic material behavior by the Euler-Bernoulli finite element.

list keyword

names <s >

Outputs available beam constitutive model keywords and full names. Output is restricted to the model named s if supplied.

properties <s >

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

states <s >

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

plastic-integration <integration-point ind > <range>

Integration data. Data for all integration points is listed, unless integration-point is specified, in which case the following data for integration point ind is listed. For a beam with rectangular cross section (shown here): the Gauss abscissae \(( \xi, \eta, \zeta )\) and composite weight factor \(a_x a_y a_z\). For a beam with circular cross section (shown here): the abscissae \(( \xi, r, \theta )\) and composite weight factor \(a_x a_r a_\theta\).

plastic-integration keyword ... <range>

Assign the integration scheme consisting of the shape and size of the beam cross section and the integration-point layout. Both keywords (cross-section and layout) must be specified. There is no default integration scheme; this command must be executed before cycling the model.

cross-section keyword

circular f

assign the cross-sectional shape to be circular (as shown here) with a radius (\(R\), f)

rectangular f1 f2

assign the cross-sectional shape to be rectangular (as shown here) with a length (\(l_y\), f1) in the \(y\) direction, and a length (\(l_z\), f2) in the \(z\) direction.

layout i1 i2 i3

number of cross sections along the beam length (\(n_x\), i1). For a beam with rectangular cross section (shown here): number of integration points in the \(y\) direction (\(n_y\), i2) and number of integration points in the \(z\) direction (\(n_z\), i3). For a beam with circular cross section (shown here): number of integration points in the radial direction (\(n_r\), i2) and number of integration points in the circumferential direction (\(n_\theta\), i3). The allowable values are as follows: \(n_x = \{ 1,2,\dots,12 \}\); \(n_y = n_z = \{ 2,3,\dots,12 \}\); \(n_r = \{ 2,4,6,8 \}\); and \(n_\theta = \{ 7,9,11 \}\). Integration-point layouts for the two cross-sectional types are shown here and here.

There must be at least two integration points along the beam axis \((n_x \geq 2)\) and two integration points across the rectangular cross section \((n_y \geq 2, n_z \geq 2)\) and seven integration points in the circumferential direction of the circular cross section \((n_r \geq 2, n_\theta \geq 7)\) to resist bending deformation. A suggested minimal layout is \((n_x = n_y = n_z = 2)\) for a beam with rectangular cross section, and \((n_x = 2, n_r = 2, n_\theta = 7)\) for a beam with circular cross section. Adding more integration points across the cross section will enhance the ability to trace the gradual progression of the bending-induced yielding inward from the outer surfaces. See Beam Plastic Constitutive Models for additional discussion of the integration scheme, and see this Figure for guidance on choosing the integration-point layout.

The integration scheme cannot be modified after cycling has occurred. When the integration scheme is set, then the beam constitutive model properties are reset to their default values; thus, the beam constitutive model properties should be set AFTER setting the integration scheme. Plastic integration data can be queried with the structure beam cmodel list plastic-integration command.