*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 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. attached_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.

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
}

Version History

2020 - Added new function Bit2 value..