block create command


block create keyword ... <range>

Primary keywords:

brick    drum    polyhedron    group    prism    tetrahedron    tunnel    wall

Create a block. The method for block creation is determined by the first keyword used. The keywords brick, drum, prism, tetrahedron or tunnel will create a block from a bounding-region shape. The polyhedron keyword may be used to create a block from four or more faces of a polyhedron.

brick f1 f2 <f3 f4 <f5 f6 >>

Create a regular six-sided “brick-shaped” region can be created with the brick keyword. The region extends in the \(x\) direction from f1 to f2, and similarly if \(y\) and \(z\) extents are optionally supplied. The \(y\) and \(z\) extents are set equal to \(x\) if not supplied.

drum keyword ...

Create a drum-shaped block from two faces. All keywords are required.

center-1 v

Specify the center of the first face.

center-2 v

Specify the center of the second face.

radius-1 f

Specify the radius of the first face.

radius-2 f

Specify the radius of the second face.

edges i

Specify the number of edges comprising the sides of the drum.

polyhedron keyword

Define a polyhedron by specifying its sides. Multiple face keywords must be used in this command to define all sides of single polyhedron. Note that the line continuation symbol (…) may be used without limit — but do not continue a line from within a vector that defines a vertex.

face <joint-set i > <face-group s1 <slot s2 >> v1 v2 v3 ...

Define a face of the polyhedron. Three to n vertices must be entered per face, in clockwise order (looking at the block face from outside the block). Blocks derived from a face are assigned to joint-set i if supplied. Similarly, blocks derived from a face are assigned to face-group s1 if supplied.

group s1 <slot s2 >

The block is assigned to group s1 when group is used. Group s1 is assigned to slot s2 if the optional slot keyword follows; it is assigned to the slot named Default if not. Use of the group logic is described in the i Group section.

prism keyword ...

Create a prism-shaped block from two faces, both of which must be planar and convex unless nonplanar is set to true. Specify faces using either face-1 and face-2 or the combination of table-1, table-2, and axis.

face-1 v1 v2 v3 ...

Define the first face with n vertices, in either a clockwise or counterclockwise order.

face-2 v1 v2 v3 ...

Define the second face with the same number of vertices as in face-1, and specified in the same order.

axis v1 v2

Specify a line that defines the orientation axis of the prism (used with table-1 and table-2 only).

table-1 s1

Use table s1 to create the first face.

table-2 s2

Use table s2 to create the second face.

nonplanar b

Allow the specified planes to be non-planar if set true; default is false.

tetrahedron v1 v2 v3 v4 <joint-set i1 i2 i3 i4 >

Create a tetrahedral block from four specified vertices. The vertices can be given in any order. This command provides a simpler method for creating 4-sided blocks as compared to polyhedron face commands. Specify joint-set id using joint-set i.

tunnel keyword ...

Generate a circular tunnel model with intact inner and outer blocks. The size of the blocks increases radially outward from the center. The user can control how many blocks are used to create the model.

blocks-radial f

Set the number of annular blocks to generate radially from the tunnel boundary to the edge of the model. (The default = 1.)

blocks-tangential f

Set is the number of blocks to generate in each 45-degree segment of the tunnel circumference. The total for the circumference will be 8 × n. (The default = 1.)

blocks-axial f

Set is the number of blocks to generate along the tunnel axis. (The default = 1.)

boundary f

Set the number of tunnel radii from tunnel boundary to edge of the model a must be greater than 1.0. (The default = 4.0.)

dip f

Set the the dip of tunnel axis. (The default = 0.)

dip-direction f

Set the dip direction of tunnel axis. (The default = 0.)

length f1 f2

Set the the location of the tunnel relative to the tunnel origin along the dip and dip direction. The length of the tunnel will be f1 - f2 along the tunnel center. (The default is f1 = −10, f2 = 10.0.)

origin v

Set is the origin of the center of the tunnel. The tunnel axis will pass through this point. (The default = 0,0,0.)

radius f

Set the radius of the tunnel. (The default = 1.0.)

radius-ratio f

Set the multiplier for size of blocks in radial direction out from center. It is used to grade block sizes out from center. (The default = 1.0.)

wall b

Specify that blocks created should be wall type blocks.