zone create command

Syntax

zone create keyword

The zone.create command fills primitive shapes ( brick, cylinder, etc.) with a predefined grid pattern.

See Primitive-Based Grids for further discussion and examples of the process of creating a mesh using primitive shapes.

To create zones from a 2D cross section that is then extruded into a third dimension, see the extrude command and the Extruder Pane in the GUI, along with the command zone generate from-extruder.

To create zones from an interactive assembly of blocks, with control over curved edges, see the building-blocks command and the Building Blocks Pane in the GUI along with the command zone generate from-building-blocks.

To create individual gridpoints see zone gridpoint create.

Individual zones may be created with this command using the brick keyword and the size set to (1,1,1).

FLAC3D may also read in externally generated grids in several formats, see the zone import command.

On meshing with zone create

Note

Thumbnails of primitives are links (may be clicked) to enlargements that indicate the shapes’ reference points.

After each shape keyword is a block of modifiers that control its position, shape, and zone distribution. These are marked [zonecreateblock] in the commands, with definitions found in the “Keyword Block” section at the end of this topic.

IMPORTANT: image setup below works for CHM output ONLY; clicking a thumbnail in HTML output will result in a “Page can’t be displayed” error. DO NOT TRY TO FIX.

to do: the full size images for the primitives should be redone for html format; the numbers are too hard to read

brick [zonecreateblock]
Create a hexahedral brick-shaped mesh with eight vertices: brick

8 reference points, 3 size entries, 0 dimension entries, not fill-able.

cylindrical-shell [zonecreateblock]
Create a cylindrical shell mesh: cshell

10 reference points, 4 size entries, 4 dimension entries, fill-able.

cylinder [zonecreateblock]
Create a cylindrical-shaped mesh: cylinder

6 reference points, 3 size entries, 0 dimension entries, not fill-able.

cylindrical-intersection [zonecreateblock]
Create an intersection of two cylinders: cylint

14 reference points, 5 size entries, 7 dimension entries, fill-able.

degenerate-brick [zonecreateblock]
Create a degenerate brick mesh, with two vertices merged: dbrick

7 reference points, 3 size entries, 0 dimension entries, not fill-able.

pyramid [zonecreateblock]
Create a pyramid-shaped mesh: pyramid

5 reference points, 3 size entries, 0 dimension entries, not fill-able.

radial-brick [zonecreateblock]
Create a radially graded mesh around brick: radbrick

15 reference points, 4 size entries, 3 dimension entries, fill-able.

radial-cylinder [zonecreateblock]
Create a radially graded mesh around cylindrical-shaped tunnel radcylinder

12 reference points, 4 size entries, 4 dimension entries, fill-able.

radial-tunnel [zonecreateblock]
Create a radially graded mesh around parallelepiped-shaped tunnel: radtunnel

14 reference points, 4 size entries, 4 dimension entries, fill-able.

tetrahedron [zonecreateblock]
Create a tetrahedral-shaped mesh: tetrahedron

4 reference points, 3 size entries, 0 dimension entries, not fill-able.

tunnel-intersection [zonecreateblock]
Create a tunnel intersection: tunint

17 reference points, 5 size entries, 7 dimension entries, fill-able.

uniform-wedge [zonecreateblock]
Create a uniform wedge-shaped mesh: uwedge

6 reference points, 3 size entries, 0 dimension entries, not fill-able.

wedge [zonecreateblock]
Create a wedge-shaped mesh: wedge

6 reference points, 3 size entries, 0 dimension entries, not fill-able.

Table 14: Summary of Mesh Shape Properties
Name/Keyword Reference Points Size Entries Dimension Entries Fill
brick 8 3 0 no
degenerate-brick 7 3 0 no
wedge 6 3 0 no
uniform-wedge 6 3 0 no
pyramid 5 3 0 no
tetrahedron 4 3 0 no
cylinder 6 3 0 no
radial-brick 15 4 3 yes
radial-tunnel 14 4 4 yes
radial-cylinder 12 4 4 yes
cylindrical-shell 10 4 4 yes
tunnel-intersection 17 5 7 yes

zone create Keyword Block


Zone Create Modifiers

The characteristics of the created shape (e.g., global coordinate positions, number of zones) are defined by specifying the keywords given below, after the shape keyword. The numerical entries associated with each shape are summarized in the table above and illustrated in the figures (click any thumbnail image above for a reference enlargement). The shape keywords of zone.create shown above will accept the keywords listed in the block below, except where noted otherwise in the descriptions. The major keywords are: brick, cylinder, cylindrical-intersection, cylindrical-shell, degenerate-brick, pyramid, radial-brick, radial-cylinder, radial-tunnel, tetrahedron, tunnel-intersection, uniform-wedge and wedge.

dimension f ...

Specify the dimensions of interior regions for some shapes. These are used if the control point is not specifically given. Up to seven dimension entries may be required for a shape (f1, f2, f3, … , f7). Refer to the figures above for entries and dimensions. If dimension is not given the entries are calculated as 20% of the lengths between reference points.

This keyword can only be used with the following keywords of the zone create command: cylindrical-intersection, cylindrical-shell, radial-brick, radial-cylinder, radial-tunnel, and tunnel-intersection.

edge f

Specify an edge length for the sides of the mesh. If point 1, point 2, and point 3 are not specified, then the magnitude of the distance from point 0 will be defined by edge. By default the edge length is the number of zones specified in that direction.

fill b <group s1 <slot s2 >>

If specified, the interior region for some shapes (see Summary of Mesh Shape Properties above) will be filled with zones. If not specified, the interior region will not contain zones. If the optional group keyword is given with a valid name, the name s1 is assigned to the filled zones.

This keyword can only be used with the following keywords of the zone create command: cylindrical-intersection, radial-brick, radial-cylinder, radial-tunnel, and tunnel-intersection.

group s1 <slot s2 >

Assign a group name s1 to this primitive at creation. By default (when the slot keyword is not supplied), the group is assigned to slot Default. Use of the group logic is described in Groups.

merge b

Gridpoints on the outer faces of the mesh are merged with existing mesh faces if this keyword is set true. During execution of a zone.create command, a check is made for each boundary gridpoint against the boundary gridpoints of zones that already exist. Internal gridpoints are not checked. If two boundary gridpoints fall within a tolerance of 1 × 10-7 (relative to the magnitude of the gridpoints’ position vector) of each other, they are assumed to be the same point, and the first gridpoint is used instead of creating new ones for all subsequent calculations. If merge is set false, two gridpoints are not merged into one.

point i keyword

The keywords point 0, point 1, point 2point 16 specify the reference (corner) points of shapes. By default, point 0 is located at (x = 0, y = 0, z = 0). By default, point 1, point 2, and point 3 are set to the orthogonal distances in the \(x\)-, \(y\)- and \(z\)-directions, with a magnitude equal to the number of zones in that direction. When specifying point 1, point 2, and point 3, the vectors point 0 - point 1, point 0 - point 2, and point 0 - point 3 must form a right-handed coordinate system.

Up to 16 points may be required for a shape. The number required is shown in Summary of Mesh Shape Properties above. The locations of these points are illustrated in the reference images (click on any thumbnail above to access).

The following options are available to define the location of any given point

v <add>

The position is given as a vector v. If the optional keyword add is used, the value of v will be added to the position of point 0.

gridpoint s

The position of the gridpoint with name s is used. See the zone gridpoint create command. This allows to user to create named reference points in space ahead of time, and refer to them when creating primitives.

ratio f1 <f2... >

This specifies a ratio that is used to space zones with an increasing or decreasing geometric ratio. This ratio is defined as creating a zone size distribution such that each zone along the edge is f times the previous. Up to five ratio entries (f5) may be needed for some shapes. For each shape, the entries and their associated zone directions are shown in the reference images (click any thumbnail above). If ratio is not given, all entries default to 1.0.

size i1 <i2 ... >

This specifies the number of zones for each shape. Up to five (i5) may be needed for some shapes. The number required is listed in Summary of Mesh Shape Properties above. The entries and their corresponding directions for each shape are shown in the reference images (click any thumbnail above). If not specified, size values default to 10.

sweep-axis

When this keyword is given, edge point 0 - point 2 is used as an axis about which edges point 1 - point 4 and point 3 - point 5 are swept. Without this keyword, the grid faces fall on the (point 0,point 1,point 3) and (point 2,point 4,point 5) planes.

This keyword can only be used with the following keywords of the zone create command: cylinder, and cylindrical-shell.

../../../../../../_images/brick.png ../../../../../../_images/cshell.png ../../../../../../_images/cylinder.png ../../../../../../_images/cylint.png ../../../../../../_images/dbrick.png ../../../../../../_images/pyramid.png ../../../../../../_images/radbrick.png ../../../../../../_images/radcylinder.png ../../../../../../_images/radtunnel.png ../../../../../../_images/tetrahedron.png ../../../../../../_images/tunint.png ../../../../../../_images/uwedge.png ../../../../../../_images/wwedge.png