structure pile list command

Syntax

structure pile list keyword <range>

Primary keywords:

apply    coupling-confinement    coupling-normal    coupling-shear    coupling-yield    element-type    force-node    group    information    length    model    plastic-state    plastic-strain    plastic-stress    plastic-stress-bounds    property    system-local

Lists properties and responses of pile elements in the range. If no keyword is given, the default output of the command is that associated with the information keyword.

apply

uniform applied distributed load acting on the element

coupling-confinement

confining stress acting perpendicular to the element, values acting on the local y and z directions

coupling-normal

information about the normal coupling springs connecting the pile to the target object (zones in FLAC3D and 3DEC, and particles in PFC3D): displacement, stress and normal direction

coupling-shear

information about the shear coupling springs connecting the pile to the target object (zones in FLAC3D and 3DEC, and particles in PFC3D): displacement, stress and shear direction

coupling-yield

yield state of the coupling springs in the normal and shear directions, and the current gap values

element-type

finite element type

force-node <keyword>

generalized nodal forces (force and moment) acting on the element. These are the generalized forces exerted by the nodes on the element.

local

express the values in the element coordinate system (the default)

global

express the values in the global coordinate system

group <slot s >

group assignment(s). If slot is specified, then list the group assignment, if any, in slot s.

information

general element information: nodal connectivity, centroid, surface area, volume, and hide/select status

length

length of the element

model

constitutive model

plastic-state <integration-point ind > (3D ONLY)

Plasticity state indicators for beam-type elements with a plastic material model. Each beam-type element with a plastic material model has a number of integration points distributed throughout its volume, and each of them tracks its plasticity state. The plasticity states at all integration points are listed, unless integration-point is specified. The integration point locations are shown here and here. The plasticity states of the plastic constitutive models can be listed by the structure pile cmodel list states command.

plastic-strain <integration-point ind > (3D ONLY)

Strain (axial component \(\varepsilon_{xx}\) in element coordinate system) for beam-type elements with a plastic material model. Each beam-type element with a plastic material model has a number of integration points distributed throughout its volume, and each of them tracks its axial strain. The axial strain at all integration points is listed, unless integration-point is specified. The integration point locations are shown here and here. The strain can be initialized with the struct.beam.plastic.ipstrain function.

plastic-stress <integration-point ind > (3D ONLY)

Stress (axial component \(\sigma_{xx}\) in element coordinate system) for beam-type elements with a plastic material model. Each beam-type element with a plastic material model has a number of integration points distributed throughout its volume, and each of them tracks its axial stress. The axial stress at all integration points is listed, unless integration-point is specified. The integration point locations are shown here and here.

plastic-stress-bounds (3D ONLY)

Minimum and maximum axial stress for beam elements with a plastic material model.

property <integration-point ind > keyword <scaled b >

The properties consist of constitutive model properties, beam-type properties, coupling-spring properties and rockbolt properties. The constitutive model properties are listed by specifying the constitutive property name; these names are not listed here. Elastic-plastic constitutive model properties are stored at each integration point. Such properties are the same at all integration points, except for the softening properties of the strain-softening/hardening Mohr Coulomb constitutive model. The value at a particular integration point is listed by specifying the integration-point keyword — the integration point locations are shown here and here.

Scaled properties are returned if the scaled keyword (FLAC2D ONLY) is set to true (the default is false). If the property cannot be scaled, an error is emitted.

Beam-Type Properties

cross-sectional-area

cross-sectional area

density

mass density

direction-y

direction-y vector whose projection onto the element cross-section defines the \(y\)-axis of the element coordinate system

moi-y

moment of inertia with respect to element \(y\)-axis

moi-z

moment of inertia with respect to element \(z\)-axis

plastic-moment

plastic moment capacity in Y and Z

plastic-moment-y

plastic moment capacity in Y

plastic-moment-z

plastic moment capacity in Z

plastic-shear

plastic shear capacity in Y and Z

plastic-shear-y

plastic shear capacity in Y

plastic-shear-z

plastic shear capacity in Z

shear-coefficient-y

shear coefficient for transverse shear deformation in the \(y\)-direction (Timoshenko beam only)

shear-coefficient-z

shear coefficient for transverse shear deformation in the \(z\)-direction (Timoshenko beam only)

thermal-expansion

thermal-expansion coefficient

torsion-constant

torsion constant

Coupling-Spring Properties

coupling-cohesion-normal

normal coupling spring cohesion per unit length

coupling-cohesion-shear

shear coupling spring cohesion per unit length

coupling-friction-normal

normal coupling spring friction angle

coupling-friction-shear

shear coupling spring friction angle

coupling-gap-normal

normal coupling spring gap-use flag

coupling-stiffness-normal

normal coupling spring stiffness

coupling-stiffness-shear

shear coupling spring stiffness

perimeter

exposed perimeter

slide

large-strain sliding flag

slide-tolerance

large-strain sliding tolerance

Rockbolt Properties

coupling-cohesion-table

name of the table relating cohesion of shear coupling spring to relative shear displacement

coupling-confining-flag

flag to activate incremental confining stress logic

coupling-confining-table

name of the table relating effective confining stress factor to deviatoric stress

coupling-friction-table

name of the table relating friction angle of shear coupling spring to relative shear displacement

rockbolt-flag

flag to activate rockbolt logic

tensile-failure-strain

tensile failure strain (non-dimensional, only active if rockbolt-flag is on)

yield-compression

axial compressive yield strength (force unit, only active if rockbolt-flag is on)

yield-tension

axial tensile yield strength (force unit, only active if rockbolt-flag is on)

system-local

element local coordinate system