geometry generate command

Syntax

geometry generate keyword ...

Primary keywords:

box    circle    cone    cylinder    disk    from-edges    from-faces    group    set    sphere

Generate objects with specified shapes. The polygons are created in the current geometry set and, if the optional group keyword is specified, then the group name is applied to the generated polygons. The shapes include: box, cone, cylinder, disk and sphere. If the set keyword is not given, then the current set is used.

Note

The group keyword must be given prior to any additional keywords.

box fxmin fxmax fymin fymax fzmin fzmax

Generate a closed box. If fxmin and fxmax are specified alone, then the box is a cube with equal sides.

circle keyword ... (2D only)

Generate a circle in 2D.

position v

Center of the circle.

radius f

Radius of the circle.

resolution f

Resolution of the edges of the circle. By default, f = 0.1.

cone keyword ... (3D only)

Generate a cone in 3D. Either a cone or a conic frustum (i.e., cone with the tip cut off, such as a funnel if the caps are absent) can be generated.

axis v3

Direction of the symmetry axis of the cone pointing from the base position that points in the positive z-direction, by default.

base v3

Position of the base of the cone (i.e., the center of the bottom end) that is the origin, by default.

cap bbottom <btop >

Indicate the inclusion status of the end caps. If one Boolean is specified, then this state is given to both end caps. If two Booleans are specified, then the first one applies to the bottom cap and the second to the top cap. By default, the bottom cap is created. No top cap is created unless fradtop is specified and is nonzero.

height fheight

Height of the cone. This is the distance from the base position to the point or, if a frustum, to the center of the top end. By default, fheight = 1.

radius fradbot <fradtop >

Radius of the cone. By default, fradbot = 1.0 and fradtop = 0.0, meaning that a cone is created. If fradtop > 0.0, then a conic frustum (i.e., cone with the tip cut off) is created. In this case, fradbot is the bottom radius at the base location, and fradtop is the radius of the top of the frustum at a distance fheight from the base location along the symmetry axis.

resolution fres

Resolution of the edges of the cone ends. The number of end edges is set so that the edge is smaller than fres * fradbot. If a frustum is to be generated with fradtop > 0, then the end edge lengths are less than fres * min(fradbot, fradtop). By default, fres = 0.1.

cylinder keyword ...

Generate a cylinder in 3D.

axis v3

Direction of the symmetry axis of the cylinder pointing from the base position.

base v3

Position of the base of the cylinder (i.e., the center of the bottom end) that is the origin, by default.

cap bbottom <btop >

Indicate the inclusion status of the end caps. If one Boolean is specified, then this state is given to both end caps. If two Booleans are specified, then the first one applies to the bottom cap and the second to the top cap. By default, both caps are created.

height fheight

Height of the cylinder. This is the distance from the base position to the center of the top end. By default, fheight = 1.

radius frad

Radius of the cylinder, or the distance from the axis of symmetry to the side.

resolution fres

Resolution of the edges of the cylinder ends. The number of end edges is set so that the edge is smaller than fres * frad. By default, fres = 0.1.

disk keyword ...

Generate a disk in 3D.

dip fdip

Dip angle of the disk in degrees in the range [0,90]. Dip is the angle from the dip direction projected on the xy-plane to the disk surface measured in the negative z-direction. By default, fdip = 0.

ddir fddir

Dip direction of the disk in degrees, as measured in a clockwise fashion from the positive y-axis in the range [0,360]. By default, fddir = 0.

position v3

Position of the center of the disk that is the origin, by default.

radius frad

Radius of the disk that is 1.0, by default.

resolution fres

Resolution of the disk edges. The number of disk edges is set so that the edge is smaller than fres * frad. By default, fres = 0.1.

from-edges keyword ... <range>

Generate polygons by extruding from all edges in the range. The edges must be in the same set. All edges matching the range given are selected.

The following keywords are available:

extrude v

The direction and length to extrude from the given edges. The default value is (0,0,1).

segments i

The number of segments to divide the extruded direction into. The default value is 1.

from-faces keyword ... <range> (FLAC3D-specific)

Generate polygons from the list of all zone faces in the range. By default only surface faces are considered.

The following keywords are available:

internal

Internal as well as external faces will be considered.

group s <slot slot >

Assigns the group name to all polygons created.

split-nonplanar b

By default, quadrilateral faces that are non-planar are split into two triangular polygons. By setting split-nonplanar to false, the polygons will remain non-planar quadrilaterals. Be aware that non-planar polygons can cause errors when performing geometry operations.

group s keyword ...

Specify that the created polygons are given the group name s. Use of the group logic is described in Groups. If the slot keyword is not specified, then the group name is assigned to the slot Default.

slot slot

Set the group slot slot to s. By default, the slot Default is assigned.

set s

Specify the geometry set.

sphere keyword ...

Generate a closed sphere in 3D. The sphere is generated by refining an icosahedron (i.e., a sphere composed of 20 identical equilateral triangles) so that the edge lengths are smaller than a length defined by the resolution keyword.

position v3

Position of the sphere centroid that is the origin, by default.

radius frad

Radius of the sphere that is 1.0, by default.

resolution fres

Resolution of the edges. The number of edges is set so that the edge length is smaller than fres * frad. By default, fres = 0.1.