*findmark

Finds and displays entities or finds and displays adjacent entities.

Syntax

*findmark entity_type mark_id function adjacent adjacent_entity_type numbers output_mark_id

Type

HyperMesh Tcl Modify

Description

This command finds and displays entities or finds and displays adjacent entities.

Inputs

entity_type
The entity types to find or to use for finding entities adjacent to.
mark_id
The mark ID containing the entities. Valid values are 1 and 2.
function
A flag that indicates the find function to perform. Bit values are used and the value is calculated as (1*Bit0 + 2*Bit1 + 4*Bit2 + 8*Bit3 + 16*Bit4 + 32*Bit5 + 64*Bit6 + 128*Bit7).
Bit0
Find mode.
0 – Find the entities on the mark.
1 – Find entities attached to those on the mark. attached_entity_type must be specified.
Bit1
Find connectors and realized FE.
0 – Find connectors only.
1 – Find both connectors and realized FE.
Bit2
Unused
Bit3
Unused
Bit4
Find free surface edges when finding lines.
0 – Do not find free surface edges.
1 – Find free surface edges
Bit5
Find shared surface edges when finding lines.
0 – Do not find shared surface edges.
1 – Find shared surface edges.
Bit6
Find non-manifold surface edges when finding lines.
0 – Do not find non-manifold surface edges.
1 – Find non-manifold surface edges.
Bit7
Find suppressed surface edges when finding lines.
0 – Do not find suppressed surface edges.
1 – Find suppressed surface edges.
Bit8
Exclude group elements when finding elements.
0 – Also find group elements.
1 – Exclude group elements.
adjacent
0 - Add both entities on mark_id and those found to output_mark_id.
1 - Do not add entities on mark_id to output_mark_id.
This is ignored when function is set to 0.
adjacent_entity_type
If function is 0, this should be the same as entity_type. Otherwise, it is the type of entity to find. The found entities will also be displayed. If set to undefined, all supported adjacent entities will be found.
numbers
0 - Do not turn on numbers for the found entities.
1 - Turn on numbers for the found entities.
output_mark_id
The mark ID to put the found entities on.
If specified as 0 and attached_entity_type is set to nodes, temporary nodes are created at the found node locations.
For other entity types, valid values are 1 and 2.

Example

To find the elements adjacent to element 12:
*createmark elements 1 12
*findmark elements 1 1 1 elements 0 2
To find all connectors:
*createmark connectors 1 all
*findmark connectors 1 0 1 connectors 0 2
To find all surface edges (free, shared, non-manifold and suppressed):
*createmark lines 1 all
*findmark lines 1 240 1 lines 0 2

Errors

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