block list command

Syntax

block list keyword <range>

Primary keywords:

apply    at    brick    cell    concave    contacts    energy    extra    flaw    group    information    limits    leader    memory    moment    poly    position    profile    follower    unbalanced-force    velocity    wall    water-table

List block information. Output is limited to block that fall within the given range, if specified.

apply

List information on blocks with applied velocities or applied thermal conditions.

at v

Print zone stresses, vertex displacements and velocities nearest to specified location

brick

This command provides an alternative to the LIST boundary reactions command. It is used when the stresses inside a global model are to be transferred as boundary conditions to a smaller model. The smaller model must be defined as a brick-shaped polyhedron. The command creates a file with BOUNDARY point, BOUNDARY xload, BOUNDARY yload and BOUNDARY zload, which are used as input in the smaller model data file. The global model need not have joints corresponding to the boundaries of the smaller model, as required by the LIST boundary reactions command. The forces are calculated by sampling stresses in a regular grid located on the brick faces. The grid size may be defined by the user. The forces are corrected so that the force sums balance the gravity forces acting inside the brick region. It is assumed that no holes exist inside the brick. The default file name is “BRICK.PRN.” The default grid-spacing is 0.1 × largest brick dimension.

cell

List cell space data.

concave <angle f >

List block edges that have a face-to-face angle of 180◦ or greater. Face-to-face angles greater than 180◦ are concave, and may cause problems when zoning or sliding. Block information is printed if face-to-face angle is greater than value (default = 210◦).

contacts

List block contact list data.

energy

List summary of strain-energy calculation.

extra i

List the contents of extra variable i for blocks in the range.

flaw <keyword ...>

List normal and shear tractions on a hypothetical plane, specified by dip, dip direction (dip-direction) and origin coordinates. The area of output may be limited by the radius keyword. This is used to assess slip potential in different orientations.

dip f

Specify the dip angle.

dip-direction f

Specify the dip direction.

file s

Specify that output will be sent to the text file s.

origin v

Specify the origin of sphere if radius is used.

radius f

Specify that output is limited to a sphere of radius f.

screen

Specify that output is sent to the screen than to a file.

group

List block group names.

information

List general block information, including ID, material number, constitutive number, region, type and leader-follower status (this is the default).

limits

List the largest and smallest positions, displacements, and velocities in the model.

leader

List leader blocks.

memory

List amount of memory that is actively being used by 3DEC.

moment

List block moments of inertia.

poly <s >

Create a file that contains block create polyhedron face commands that will recreate the block. This file can be called directly as a data file. This is used to extract portions of a model (only visible blocks are printed). This may also be used to reduce the amount of memory required by a model in which many blocks were deleted during the construction process. If s is not specified, the file is named poly.txt. The number of significant digits is equal to the 12 or the global model precision, whichever is greater. To increase the precision above 12 digits, use the model precision command.

position

List the position of each block in the range.

profile keyword

List values of a specified quantity at points spaced equally over a line.

Only one of the following quantities is specified for the profile. See block list profile Keyword Block below for other keywords to define the line start and end point, number of segments, etc.

acceleration [blocklistprofileoptions]

acceleration magnitude at the gridpoint (only available in if model configure dynamic has been specified)

acceleration-x [blocklistprofileoptions]

\(x\)-acceleration at the gridpoint (only available in if model configure dynamic has been specified)

acceleration-y [blocklistprofileoptions]

\(y\)-acceleration at the gridpoint (only available in if model configure dynamic has been specified)

acceleration-z [blocklistprofileoptions]

\(z\)-acceleration at the gridpoint (only available in if model configure dynamic has been specified)

condition [blocklistprofileoptions]

a measure of how badly deformed a zone is. [URGENT: CS: content required for link here appears to need adding to doc set: Link to wherever the contents of section 1.1.5 in the Command Reference end up

density [blocklistprofileoptions]

The density of the zone.

displacement [blocklistprofileoptions]

displacement magnitude at the gridpoint

displacement-x [blocklistprofileoptions]

\(x\)-displacement at the gridpoint

displacement-y [blocklistprofileoptions]

\(y\)-displacement at the gridpoint

displacement-z [blocklistprofileoptions]

\(z\)-displacement at the gridpoint

extra [blocklistprofileoptions]

extra variable value. The extra variable index used will default to 1 and can be changed with the index modifier keyword. The value will by default come from the grid point extra variables, but this can be specified using the source modifier keyword. The value will by default be treated as a scalar floating point type, but this can be specified using the type modifier keyword.

pore-pressure [blocklistprofileoptions]

pore pressure in zone. By default this will be the grid point pore pressure, but the zone average pore pressure can be specified by using the source keyword modifier.

property [blocklistprofileoptions]

a property of the mechanical constitutive model of the zone. The property name must be specified using the name keyword modifier. By default it will be assumed the property is a floating point scalar, but this can be specified using the type modifier keyword.

property-fluid [blocklistprofileoptions]

a property of the fluid constitutive model of the zone. The property name must be specified using the name keyword modifier. By default it will be assumed the property is a floating point scalar, but this can be specified using the type modifier keyword.

property-thermal [blocklistprofileoptions]

a property of the thermal constitutive model of the zone. The property name must be specified using the name keyword modifier. By default it will be assumed the property is a floating point scalar, but this can be specified using the type modifier keyword.

ratio-local [blocklistprofileoptions]

the local unbalanced force ratio at each gridpoint. Like all results, this can be changed to the logarithm of the value by using the :lkwd:’log’ keyword modifier.

saturation [blocklistprofileoptions]

the saturation at the gridpoint (only available in if model configure fluid-flow has been specified)

strain-increment [blocklistprofileoptions]

the strain increment tensor of the zone, determined by the current displacement field. Use the quantity keyword to specify which scalar value to retrieve from the tensor.

strain-rate [blocklistprofileoptions]

the strain rate tensor of the zone, determined by the current velocity field. Use the quantity keyword to specify which scalar value to retrieve from the tensor.

stress [blocklistprofileoptions]

the stress tensor of the zone, determined by the weighted average of the subzone stresses. Use the quantity keyword to specify which scalar value to retrieve from the tensor.

strength-stress-ratio [blocklistprofileoptions]

the ratio of the current stress to a failure surface of the zone, as determined by the current zone constitutive model. Not all constitutive models support this calculation. If unsupported, the value returned will be 10. The value returned is generally held to a maximum of 10.

stress-effective [blocklistprofileoptions]

the effective stress tensor of the zone, determined by the weighted average of the subzone stresses minus the zone averaged pore pressure. Use the quantity keyword to specify which scalar value to retrieve from the tensor.

temperature [blocklistprofileoptions]

the temperature at the gridpoints. The source modifier keyword can be used to specify that zone based temperature should be used instead.

timestep-dynamic [blocklistprofileoptions]

the local critical dynamic time step of that particular gridpoint. (only available in if model configure dynamic has been specified)

unbalanced-force [blocklistprofileoptions]

the unbalanced force magnitude at the gridpoint.

unbalanced-force-x [blocklistprofileoptions]

\(x\)-unbalanced force at the gridpoint.

unbalanced-force-y [blocklistprofileoptions]

\(y\)-unbalanced force at the gridpoint

unbalanced-force-z [blocklistprofileoptions]

\(z\)-unbalanced force at the gridpoint

velocity [blocklistprofileoptions]

the velocity magnitude at the gridpoint

velocity-x [blocklistprofileoptions]

\(x\)-velocity at the gridpoint

velocity-y [blocklistprofileoptions]

\(y\)-velocity at the gridpoint

velocity-z [blocklistprofileoptions]

\(z\)-velocity at the gridpoint

follower i

List the blocks that are followers to block ID i.

unbalanced-force

List rigid-block unbalanced forces.

velocity

List block translational and rotational velocities.

wall

List wall-typed blocks.

water-table

List the water table definition.


block list profile Keyword Block

The modifiers below may be used to specify additional information for each of the following block list profile keywords: acceleration, acceleration-x, acceleration-y, acceleration-z, condition, density, displacement, displacement-x, displacement-y, displacement-z, extra, pore-pressure, property, property-fluid, property-thermal, ratio-local, saturation, strain-increment, strain-rate, strength-stress-ratio, stress, stress-effective, temperature, timestep-dynamic, unbalanced-force, unbalanced-force-x, unbalanced-force-y, unbalanced-force-z, velocity, velocity-x, velocity-y and velocity-z.

begin v

Set the beginning point of the profile line. If not supplied, this value is set to the origin by default. See also the c end and c segments keywords.

component keyword

This keyword selects which scalar to retrieve from a vector type value, such as velocity or displacement. If the value type is not vector, this setting is ignored. The available options are:

x

\(x\)-component of the vector

y

\(y\)-component of the vector

z

\(z\)-component of the vector

magnitude

vector magnitude

end v

Set the end point of the profile line. If not supplied, this value is set to (1,1,1) by default. See also the c begin and c segments keywords.

filename s

Specify a filename to output the profile. If not given, the output will go to the screen.

index i

For keywords that require it (most notably extra), this specifies the index that should be used. The default value will be 1.

gravity b

If on, then gravitational forces are included in the returned applied force. The default is off.

gridpoint-id i

Specifies the location of the history by the location of the gridpoint with ID number i.

log b

If on, the returned number is the base 10 log of the absolute value of the original value. The default is off.

method

This specifies the method of calculation used to bring zone-based quantities to arbitrary locations in space (including at gridpoint positions).

constant

Assumes values are constant inside zones. This is the default option. Values at gridpoints or at zone boundaries will pick one adjacent zone to use.

average

This uses an volume weighted average of all the zones connected to the gridpoint.

inverse-distance-weight

This uses an weighted average of up to 32 zones in the immediate vicinity of the point. The weighting is determined by a power of the distance of the zone centroid from the specified point.

power f

Specifies the power of the distance used to weight values. The default power is 3.0.

radius-ratio f

Specifies the ratio of the maximum distance from the point of the zones selected, to the ratio used to calculate weighted values. Zones farther from this value are discounted. The default value is 0.75.

polynomial <tolerance f >

Uses a fit to a polynomial function based on the zones in the vicinity of the point. Degenerate degrees of freedom are detected and removed. The optional tolerance can be used to change the value used to detect a degenerancy. The default value is 1e-7.

name s

Certain keywords (most notably property) require a name value to be fully specified. This will determine the specific property name retrieved.

quantity keyword

This keyword selects which scalar to retrieve from a symmetric tensor type value, such as stress or strain. If the value type is not a tensor, this setting is ignored. The available options are:

intermediate

intermediate principal stress

maximum

the maximum (most positive) value of principal stress. Note that in 3DEC compressive stresses are negative.

mean

The mean pressure value, defined as the trace of the tensor divided by 3. For stresses this is most often referred to as the pressure.

minimum

The minimum (most negative) principal stress. Note that in 3DEC compressive stresses are negative.

norm

The norm of the strain rate; see the equation in Zone Field Data Names

octahedral

octahedral stress; see the equation in Zone Field Data Names

shear-maximum

maximum shear stress

total-measure

distance of tensor value to the origin in principal space

volumetric

volumetric change, or trace

von-mises

Von Mises measure; see the equation in Zone Field Data Names

xx

xx-component of the tensor

xy

xy-component of the tensor

xz

xz-component of the tensor

yy

yy-component of the tensor

yz

yz-component of the tensor

zz

zz-component of the tensor

segments i

Specify, by segmenting the profile line, the number of points to distribute evenly along the line from c begin to c end (where the number of points will be i + 1). If not supplied, this value is set to 2 by default.

source keyword

Certain keywords (like extra and pore-pressure) can be retrieved either from the zone structure or from the gridpoint structure. The default value is gridpoint.

gridpoint

Values are retrieved directly from the gridpoint.

zone

Values are retrieved from the zone.

stress b

A few of the tensor type quantity options do different things depending if the value is considered a stress. When coming from a value like extra, this cannot be determined automatically. This allows the user to specify that the incoming tensor value should be considered a stress quantity.

type keyword

In certain cases the type (scalar, vector, ro tensor) of the value cannot necessarily be determined ahead of time. Extra variables, for example, can hold values of all three types. This keyword allows one to specify which type it is assumed to be. If the original value type does not match, 0.0 is returned.

scalar

A scalar float type. This is the default.

vector

A vector type.

tensor

A tensor type.

zone-id i

Specifies the location of the history is at the centroid of zone with ID i.