*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
}