`block list`

command

Syntax

- block list keyword <range>
Primary keywords:

apply at brick cell concave contacts energy extra flaw group information limits master memory moment poly position profile slave 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.

- 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.

- origin v
Specify the origin of sphere if radius is used.

- 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 master-slave status (this is the default).

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

- master
List master 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 not specified, the file is named spoly.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.

- 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`

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.

- stress-strength-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

- 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`

, `stress`

, `stress-effective`

, `stress-strength-ratio`

, `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.

- 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.

- 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

segmentingthe 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.

Was this helpful? ... | 3DEC © 2019, Itasca | Updated: Apr 17, 2022 |