*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 ?recursive?

Type

HyperMesh Tcl Modify Command

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. adjacent_entity_type must be specified.
Bit1
Find connectors and realized FE.
0 - Find connectors only.
1 - Find both connectors and realized FE.
Bit2
Find tied contact entities.
0 - Do not find tied contact entities.
1 - Find tied contact entities.
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.
Bit9
Consider Constraints when finding Elements/Components attached to other Elements/Components.
0 – Do not consider Constraints.
1 – Consider Constraints.
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 adjacent_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.
recursive
The recursive flag will work only if both input and output entity types are the same.
0 - Do not execute the find operation recursively. (default)
1 - Execute the find operation recursively.

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
}

Version History

2020 - Added new function Bit2 value.

2022.3 - Added new function Bit9 value and new option recursive.