*spatialrenumbering

Renumbers the solver IDs for the specified entity type based on spatial locations.

Syntax

*spatialrenumbering entity_type <option1>=<value1> <option2>=<value2> ... <optionN.=<valueN>

Type

HyperMesh Tcl Modify Command

Description

Renumbers the solver IDs for nodes or elements based on spatial locations. First, it sorts all selected entities based on the preference axis and then it renumbers them. The input for preference axis can be given by specifying the axis or by selecting nodes/elements in the direction of preference axis. The sorted nodes/elements can be renumbered in continuous or non-continuous way.

Inputs

entity_type
The type of entity selected for renumbering. Valid values are nodes and elements.
mark=<mark_id>
The mark that contains the entities. Valid values are 1 and 2.
type=<value>
The type of renumbering.
axis - Primary, secondary, and ternary axis defined by a system axis.
adjacent - Primary, secondary, and ternary axis defined by an entity. Only supported for quad4 or quad8 elements and their associated nodes.
renumbering_type=<value>
The renumbering method.
0 = Rectangular grid (non-continuous) renumbering
1 = Spatial (continuous) renumbering

The following options apply to type=axis only:

system_id=<value>
The ID of the system. For the global system, a value of 0 must be used.
start_id=<value>
The ID to be assigned to the first entity. The value must be an unsigned integer.
primary_axis=<value>
The primary axis followed by the renumbering. +x=1, -x=-1, +y=2, -y=-2, +z=+3, -z=-3, none=0.
primary_tolerance=<value>
The primary tolerance value.
primaryid_increment=<value>
The renumbering increment in the primary direction.
secondary_axis=<value>
The secondary axis followed by the renumbering. +x=1, -x=-1, +y=2, -y=-2, +z=+3, -z=-3, none=0.
secondary_tolerance=<value>
The secondary tolerance value.
secondaryid_increment=<value>
The renumbering increment in the secondary direction.
ternary_axis=<value>
The ternary axis followed by the renumbering. +x=1, -x=-1, +y=2, -y=-2, +z=+3, -z=-3, none=0.
ternary_tolerance=<value>
The ternary tolerance value.
ternaryid_increment=<value>
The renumbering increment in the secondary direction.

The following options apply to type=adjacent only:

start_entity_id=<value>
The entity ID from which renumbering starts. The ID should be from the input mark only.
primary_entity_id=<value>
The entity ID defining the direction of the primary axis. The direction is given by taking the start entity as the starting point and pointing towards the primary entity ID. The ID should be from the input mark only.
secondary_entity_id=<value>
The entity ID defining the direction of the primary axis. The direction is given by taking the start entity as the starting point and pointing towards the secondary entity ID. The ID should be from the input mark only. Set to 0 if not specified.
ternary_entity_id=<value>
The entity ID defining the direction of the primary axis. The direction is given by taking the start entity as starting point and pointing towards the ternary entity ID. The ID should be from input mark only. Set to 0 if not specified.

Examples

To renumber the solver IDs of the displayed elements with type set as axis and renumbering type as spatial with the starting ID equal to 1 with an increment of 1 and a tolerance value of 0.5 in all directions, using x direction of the global system as the primary axis, y direction as the secondary axis, and z direction as the ternary axis:
*createmark elems 1 displayed
*spatialrenumbering elems mark=1 type=axis renumberingtype=1 systemid=0 startid=1 primaryaxis=1 primarytolerance=0.5 primaryidincrement=1 secondaryaxis=2 secondarytolerance=0.5 secondaryidincrement=1 ternaryaxis=3 ternarytolerance=0.5 ternaryidincrement=1
To renumber the solver IDs of the displayed elements with type set as adjacent, starting from 1 with an increment of 1 in the primary axis, an increment of 10 in the secondary axis, an increment of 100 in ternary axis, start entity ID as 349, primary entity ID as 351, secondary entity ID as 2, and ternary entity ID not specified:
*createmark elems 1 displayed
*spatialrenumbering elems mark=1 type=adjacent startentityid=349 primaryentityid=351 secondaryentityid=2 ternaryentityid=0 startid=1 primaryidincrement=1 secondaryidincrement=10 ternaryidincrement=100

Errors

Incorrect usage results in a Tcl error. To detect errors, you can use the catch command:
if { [ catch {command_name...} ] } {
   # Handle error
}

Version History

14.0.120

2021.2 - Added new arguments renumbering_type, ternary_axis, ternary_tolerance, ternaryid_increment, and ternary_entity_id.