zone attach command

Syntax

zone attach keyword

Primary keywords:

delete    by-face    gridpointid    group    list

Create attached gridpoints. Gridpoints on one zone may be rigidly attached (or slaved) to master gridpoints, edges, or faces of other zones. This allows grids that do not exactly topologically match to behave as a single grid. Each gridpoint so attached results in the creation of an internal data structure (an Attach Point) that is accessible by command and by FISH.

Note that faces with interface elements attached and faces connected to embedded liners will not be considered.

The attach logic is fully general in that it will successfully attach any distribution of gridpoints or faces on both sides. However, it works best if there is always a integral increase in the number of points from one edge to another (for example, three gridpoints for every two) and if one side of the attached surface consistently has smaller faces than the other.

See Connecting Adjoining Primitive Shapes for an example application and further discussion of limitations.

One of the following keywords is required to create, destroy, or manipulate attach conditions.

delete <range>

Removes attach conditions on all slaved gridpoints within the given range. All attach conditions are removed if no range is present.

by-face keyword ... <range>

Searches the mesh for all surface faces in the range. For this purpose a surface face is defined to be a face that is not perfectly topologically connected to a zone on the other side. For faces that are coplanar and touching (within a tolerance), attach conditions are automatically generated between gridpoints on one side and faces on the other. The side with the smaller faces will be selected to be attached (the slave).

The following optional keywords are available to control which faces and gridpoints are selected to attach.

snap b

If snap is set to on (the default), then turns slave gridpoint locations are moved to correspond to the locations they are slaved to on the master, both immediately and during cycling. If snap is set to off, slave gridpoints will move along with the master relatively, but their positions might be different.

tolerance-absolute f

If specified, f is the maximum absolute distance between the slave gridpoint and the target face for an attach condition to be created. The default value is 0.0, meaning a relative tolerance scheme is used instead.

tolerance-angle f

Faces are attached only if the angle between them is less than f in degrees. By default this value is 5 degrees. It is sometimes necessary to increase this tolerance for complex surfaces that create non-planar faces.

tolerance-relative f

Gridpoints are attached to faces only if the distance is within a distance of f times the absolute value of the position of the face centroid. The default value is 1x10^-5. It may be necessary to increase this value if there was additional error in grid creation. [CS: check this out; usage here is fuzzy (past tense? when “was” the error]

gridpointid ids keyword

Attaches a single gridpoint with ID number ids to: another gridpoint, an edge between two gridpoints, or a zone face. One of the following keywords is required to indicate the target of the attach condition.

to-gridpointid idm <snap b >

Attaches the gridpoint to the gridpoint with ID idm. By default snap is on and will cause gridpoint ids to move to the same location as gridpoint idm, both immediately and during cycling.

to-edgeids id1 id2 keyword ...

The gridpoint with ID number ids is attached to the edge defined as the line between gridpoints i1 and i2.

One of the following optional keywords may be applied.

weight f

The optional keyword weight can be given to define the location of gridpoint ids between gridpoints i1 and i2. If weight = 0.0, then ids is located at i1; if weight = 1.0, then ids is located at i2. If not specified, this weighting is calculated automatically based on the position of gridpoint ids.

snap b

By default snap is on and will cause gridpoint ids to move to the location given by the weighting between i1 and i2 automatically, both immediately and during cycling.

to-faceid idz iside keyword ...

The gridpoint with ID number ids is attached to the face identified as side iside of zone with ID idz. URGENT: CS: section referred to here appears to be absent (Refer to :flag2:-Command Reference Section 1.1.4 Orientation of Nodes and Faces within a Zone-).]

One of the following optional keywords may be applied.

weight f1 f2 f3 f4

The optional keyword weight can be given to define the location of gridpoint ids on face idz, iside1 with respect to the face vertices. Each of the four value given must be between 0.0 and 1.0, and the sum should add to 1.0 (assuming the slave location is on the face). For example, the location of the first vertex would correspond to 1.0, 0.0, 0.0, 0.0, and the center of the face would correspond to 0.25, 0.25, 0.25, 0.25.

snap b

By default snap is on and will cause gridpoint ids to move to the location given by the weighting on zone face idz, iside1 automatically, both immediately and during cycling.

group s keyword ... <range>

Group gridpoint attach data structures within the given range, if specified. One of the following optional keywords may be applied.

slot s

Assign the group to slot s.

remove

Remove the group s from all attach conditions in the range. If slot is not specified, it will be removed from all slots it is found in.

list <range>

List information on all attach conditions in the range. This information includes the slave gridpoints, the master targets, and the weighting factors if appropriate.