zone interface create command


zone interface <s > create keyword ...

Primary keywords:

by-face    element    node

Create nodes or elements on interface s. If the interface name is not given then the command operates on all interfaces.

There are two techniques for creating an interface. The first is to derive an interface or interfaces from a range of zone faces using the by-face keyword. The second is to specify a triangular interface element from three points. Lastly, this command may also be used to construct an interface node that may, in turn, be used with the element keyword.

If an interface name s is given an interface with that name is created if it does not already exist. The elements and nodes created will be added to that interface. If a name is not specified a new interface using a default name will be created automatically.

by-face <keyword ...> <range>

Interface elements are created on all surface zone faces that are within the specified range. An error will occur if interface elements from that interface already exist on the selected faces.

break-angle f

When interface elements are applied to faces, by default nodes at shared corners are shared. If the angle between the interface elements (or zone faces) is greater than this angle then duplicate nodes will be created at the same point. This behaves better because two different nodes using two different normal vectors will be in action at a corner.

The default break angle is 30 degrees. The angle is input in degrees.

break-slot s

In addition to the break-angle and merge-nodes keywords the user may indicate a slot to detect when interface nodes should not be shared across elements. If the break-slot keyword is used interface nodes are not shared if the face or zone groups that host the interface elements are different in the slot indicated.

Note that Any may be specified indicating that any difference in group assignments will indicate that nodes should not be shared.

group s <slot slot >

The newly created interface will be assigned group the s. Use of the group logic is described in Groups. This command may take the form zone interface node "slotname = groupname" — quotation marks required, spaces at equals sign ignored — where slotname is the slot assignment and groupname is the group name.

Note that interface nodes and elements participate in a group heirarchy – so nodes and elements can be selected using the group name assigned to the interface.

An interface node may belong to many groups in different slots, up to a maximum of 128. The group range element can be used to select objects by group name.

The slot keyword may be used to specify a slot to use for the new group. The default slot is Default.

Note that by default a group string that matches the interface name will be assigned in slot Default.

merge-nodes b

If set to false, this causes each face to have separate interface nodes created on each corner. So a typical quadilateral surface will have four separate interface nodes at the same surface. This has advantages and disadvantages.

Advantages are that sharp corners are handled automatically so separate interfaces do not have to be created. Another is The increased interface node density gives more reliable results under large-strain motion (especially along edges).

Disadvantages are that the computational overhead is about 4x larger, and because each node is calculating penetration independently (and will in general choose different target faces) the normal penetration tends to be discontinous. On average this tends to work out, but plots of penetration and dependent quantities (normal stress, shear stress if at the friction limit, etc.) will be much less smooth.

The default value is true.

separate <keyword>

If the optional separate keyword is used, then internal zone faces are selected by the range. The list of selected faces is then automatically separated (as with zone separate) and interface elements placed on one side. The following keywords are available follwing the separate keyword:

new-side-origin v

Specifies which side of the separate faces the interfaces are placed on. It chooses the side with face normal vectors pointing toward v. If not specified, the value used will be the origin (0,0,0).

new-side-group s

Specifies which side of the separate faces the interfaces are placed on. It chooses the side with zones belonging to the specified group.


If specified, causes any attach conditions on the boundary to be cleared. By default an existing attach condition causes an error.

element point i keyword ...

Create a triangular interface element by specifying three points. Three vertices point 1, point 2 ,and point 3 must be specified following the element keyword. Each point can be created and located in space using the position keyword, or an existing interface node with ID i may be specified. The interface element that is created is not attached to a grid face even if the location corresponds to that of the face. The element is fixed in space. The active side of the element is defined by walking around the edge of the element, from point 1 to point 2 to point 3; the active side is up when walking in a clockwise direction.

For each point of the element, one of the following two keywords must be supplied.

node i

Identify the point with a previously created interface node with ID i.

position v

Identify the point with a new interface node created at position v.

node v

This creates an interface node at position v. If a node already exists at the selected location, an error is reported. The created node is fixed in space.