*appendmark

Appends entities on a mark based on user supplied options.

Syntax

*appendmark entity_type mark_id "?option?" list

Type

HyperMesh Tcl Modify

Description

This command will place entities of entity_type onto mark mark_id. Valid mark_ids are 1 and 2. Depending on the options specified, the supported entity_types will change.

All options only return entities that are defined as active in the database, unless otherwise noted.

If no ?option? is specified, "by name only" is used for entities with names. Otherwise, "by id only" is used. This can be specified using the command hm_marksearchmode.

If no ?option? is specified, both active and inactive entities may be selected.

For options that allow both "ids or names" in the list, entities are found first using names. Entities not found using names are then found using IDs. This order can be specified using the command hm_marksearchmode.

When specifying entity names that contain spaces, group the name using brackets, e.g., {Comp name with spaces}, or use a Tcl list.

Negative values can be used to find recently created entities.

In addition to the options below, all of the options for *createmark are also supported.

Inputs

by adjacent (optional)
Starting with entities already on the mark, find entities adjacent to them. The search is performed once.
by attached (optional)
Starting with entities already on the mark, find entities adjacent to them. This search is repeated until all adjacent entities are found.
by face (optional)
Starting with entities already on the mark, find entities on the same face.
For elements and nodes, the current feature angle (from the options panel) is used. In addition, any displayed plot elements are considered boundaries for finding by face.
For surfaces, the connectivity of the geometry is used.
by face across t junctions
Starting with entities already on the mark, find entities on the same face, including those across t-junctions.
For elements and nodes, the current feature angle (from the options panel) is used.
For surfaces, the connectivity of the geometry is used.

Examples

To delete the elements adjacent to the elements in components with names FRONT and SIDE:

*createmark elems 1 "by comp name" FRONT SIDE
*createmark elems 2 "[hm_getmark elems 1]"
*appendmark elems 1 "by adjacent"
*markdifference elems 1 elems 2
*deletemark elems 1

To translate all of the elements attached to element 40404 by (5,0,0):

*createmark elems 1 40404
*appendmark elems 1 "by attached"
*createvector 1 1.0 0.0 0.0
*translatemark elements 1 1 5

To mark elements that share a face with elements 50 and 100:

*createmark elems 1 50 100
*appendmark elems 1 "by face"

Errors

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