hm_appendmark

Appends entities on a mark based on user supplied options.

Syntax

hm_appendmark entity_type mark_id ?"by model" <model_name>? ?"option"? "list"

Type

HyperMesh Tcl Query Command

Description

Appends entities on a mark based on user supplied options.

In addition to the options below, all of the options for hm_createmark are also supported. See that topic for more details on those options, and general behaviors of both commands.

Inputs

entity_type: Entity type to use. Depending on the options specified, the supported entity types will change.
mark_id: The ID of the mark. Valid values are 1 and 2.
"by model" <model_name>: The optional model to append the mark from. If not specified, the current model is used.
?"options"?

Supported Options

"advanced" "by adjacent": Starting with entities already on the mark, find entities adjacent to them. The search is performed once.
"advanced" "by attached": Starting with entities already on the mark, find entities adjacent to them. This search is repeated until all adjacent entities are found.
"advanced" "by face": 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.
"advanced" "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.
"advanced" "by opposite": Starting with surfaces already on the mark, find entities on the opposite side of thin solids.

Examples

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

hm_createmark elems 1 "by comp name" "FRONT SIDE"
hm_createmark elems 2 "[hm_getmark elems 1]"
hm_appendmark elems 1 "advanced" "by adjacent"
*markdifference elems 1 elems 2
*deletemark elems 1

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

hm_createmark elems 1 40404
hm_appendmark elems 1 "advanced" "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:

hm_createmark elems 1 "50 100"
hm_appendmark elems 1 "advanced" "by face"

To mark elements that share a face with elements 50 and 100 for model model-2:

hm_createmark elems 1 "by model" model-2 "50 100"
hm_appendmark elems 1 "by model" model-2 "advanced" "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
}

Version History

2017.1 - Added new "by topology" method.

2020 - Added new methods "by list", "by list id", "by list name" and "by opposite". Added new option "by model".

2020.1 - Added new methods "by subsystem", "by subsystem id" and "by subsystem name".