*spatialrenumbering

Syntax

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

Type

HyperMesh Tcl Modify Command

Description

Renumbers nodes and elements based on spatial locations.

Inputs

entity_type

The type of entity to renumber. Valid values are nodes and elements.

type=<type>

The type of renumbering, axis or adjacent.

Adjacent only works with quad4 or quad8 elements and associated nodes.

startid=<startid>

The ID to be assigned to the first entity. The value must be an unsigned integer. This option also works with parameters of integer type.

primaryidincrement=<primaryidincrement>

The ID increment in the primary direction. The value must be an unsigned integer. This option also works with parameters of integer type.

secondaryidincrement=<secondaryidincrement>

The ID increment in the secondary direction. The value must be an unsigned integer. This option also works with parameters of integer type.

The following options apply to type=axis only:

systemid =<systemid>

The ID of system. For global system, a value of 0 must be used. The system should be either Cartesian or cylindrical.

primaryaxis=<primaryaxis>

The primary axis of the system. x=1, y=2 and z=3 for Cartesian systems. r=1, θ=2 and z=3 for cylindrical systems.

primarytolerance=<primarytolerance>

The allowed tolerance between entities in the primary direction. The value must be a double. This option also works with parameters of double type.

secondaryaxis=<secondaryaxis>

The secondary axis of the system. x=1, y=2 and z=3 for Cartesian systems. r=1, θ=2 and z=3 for cylindrical systems. This must not be equal to primaryaxis.

secondarytolerance=<secondarytolerance>

The allowed tolerance between entities in the secondary direction. The value must be a double. This option also works with parameters of double type.

The following options apply to type=adjacent only:

startentityid=<startentityid>

The ID of the start entity. This entity must be same as entity_type.

primaryentityid=<primaryentityid>

The ID of the primary entity. This entity must be same as entity_type and must be adjacent to the start entity.

secondaryentityid=<secondaryentityid>

The ID of the secondary entity. This entity must be same as entity_type and must be adjacent to the start entity.

A few notes about type=adjacent:

• If the entity type for all three options is nodes, all three entities must belong to a common element apart from being adjacent to each other.
• For quad8 elements, only provide ids of corner nodes of a common element as start, primary and secondary entity ID. Mid nodes as prime inputs are not supported.
• The IDs of non-selected entities will be renumbered if any conflict arises during renumbering.
• A single entity cannot be renumbered using this method.
• If a secondary entity is not specified, or set as 0, the row/column containing the start and primary entities will be renumbered.

Examples

Renumber nodes using axis type and local system 1 with primary axis 1 and secondary axis 2:

*createmark nodes 1 all
*spatialrenumbering nodes mark=1 type=axis systemid=1 startid=100 primaryaxis=1 primarytolerance=0.2 primaryidincrement=1000 secondaryaxis=2 secondarytolerance=0.2 secondaryidincrement=1

Renumber elements using adjacent type and integer parameter named priInc (parameter value 100) used as primary ID increment by name:

*createmark elems 1 all
*spatialrenumbering elems mark=1 type=adjacent startentityid=555 startid=1 primaryentityid=557 primaryidincrement={parameter name=priInc} secondaryentityid=556 secondaryidincrement=1

Renumber a single column/row of nodes using adjacent type. Only a single column/row of entities will be renumbered:

*createmark elems 1 all
*spatialrenumbering elems mark=1 type=adjacent startentityid=41 startid=1 primaryentityid=40 primaryidincrement={parameter id=5} secondaryentityid=0 secondaryidincrement=1

Errors

if { [ catch {command_name...} ] } {
   # Handle error
}

Version History

14.0.120