zone attach
command
Syntax
- zone attach keyword
-
Create attached gridpoints.
Note
[1] Zone nomenclature in FLAC varies from 2D to 3D.
Gridpoints on one zone (follower gridpoints) may be rigidly attached to leader gridpoints, edges (3D only), 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 hosting interface elements and faces connected to embedded liners are skipped.
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 an integral increase in the number of points from one attach side 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 a 3D example application and further discussion of limitations (2D attach logic and limitations are equivalent).
One of the following keywords is required to create, destroy, or manipulate attach conditions.
- delete <range>
Remove attach conditions on all follower gridpoints within the given range. All attach conditions are removed if no range is present.
- by-face keyword ... <range>
Search the mesh for all boundary faces in the range. For this purpose a boundary 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 (will become a follower).
The following optional keywords are available to control which faces and gridpoints are selected to attach.
- snap b
Set follower gridpoint snapping.
If
snap
is set toon
(the default), follower gridpoint parameters are fully synchronized with (snapped to) the leaders with corresponding weights (calculated automatically).If
snap
is set tooff
, follower gridpoint new displacement and position are calculated based on the previous values while using weighted velocities from the leaders (relative movement).
- tolerance-absolute f
Set maximum attachment tolerance for gridpoints.
If specified, f is the maximum absolute distance between the follower 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
Set the limiting angle for face attachment.
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 (in 3D only).
- tolerance-relative f
Set relative attachment tolerance for gridpoints.
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
Attach a single gridpoint with ID number ids to: another gridpoint, a zone edge (3D only), 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
ison
and will cause gridpoint ids to move to the same location as gridpoint idm, both immediately and during cycling.
- to-edgeids id1 id2 keyword ... (3D ONLY)
- 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 (3D ONLY)
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 between0.0
and1.0
, and the sum should add to1.0
(assuming the follower location is on the face). For example, the location of the first vertex would correspond to1.0
,0.0
,0.0
,0.0
, and the center of the face would correspond to0.25
,0.25
,0.25
,0.25
.
- weight f1 (2D ONLY)
The optional keyword
weight
can be given to define the location of gridpoint ids on face idz, iside1 with respect to the face vertices. Remember that zone face in 2D is an line connecting two neighboring zone gridpoints. Threrefore, ifweight
=0.0
, then ids is located at one of the face gridpoints; ifweight
=1.0
, then ids is located at another face gridpoint. If not specified, this weighting is calculated automatically based on the position of gridpoint ids.
- group s keyword ... <range>
Group gridpoint attach data structures within the given range, if specified. One of the following optional keywords may be applied.
- 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 follower gridpoints, the leader targets, and the weighting factors if appropriate.
Endnote
Was this helpful? ... | Itasca Software © 2024, Itasca | Updated: Oct 31, 2024 |