hm_excludebeyond
Removes entities from the base mark which are beyond the given distance or number of element rows from the entities on the target mark.
Syntax
hm_excludebeyond entity_type_base mark_id_base entity_type_target mark_id_target dist_or_rows_flag dist_or_rows_value
Type
HyperMesh Tcl Query Command
Description
This API removes entities from the base mark which are beyond the given distance (in model units) or the given number of element rows from the entities on the target mark. If the base mark is empty, it will be filled with every entity in the model that is not a part of the target mark before the entities are excluded.
The exclusion distance can be measured in either model units or in element rows. If dist_or_rows_flag is set to dist, the base entities will be excluded based on the absolute distance away from the target entities measured in model units. If dist_or_rows_flag is set to rows, the base entities will be excluded based on the number of rows of elements they are away from the target entities. Note that for the rows option, the elements used to count the rows must be connected to the target entities and all base entities not attached to the rows of elements will be excluded.
This is very useful for creating morph constraints for boundary layers. It allows you to first select all the nodes in the fluid layer and then use this API to exclude all the elements which lie a certain distance or number of element rows away from the cavity, leaving you with only the nodes inside your boundary layer envelope.
Inputs
- entity_type_base
- The base entity type. Must be set to nodes.
- mark_id_base
- The ID of the mark containing the base entities. Valid values are 1 and 2.
- entity_type_target
- The target entity type. Valid values are nodes and elems.
- mark_id_target
- The ID of the mark containing the target entities. Valid values are 1 and 2.
- dist_or_rows_flag
- dist - Exclude based on the absolute distance measured in model units
- dist_or_rows_value
- The number of model units or elements rows, depending on dist_or_rows_flag.
Examples
To exclude all nodes from mark 1 which are beyond 500.0 model units away from the elements on mark 1:
*createmark nodes 1 "by comp id" 89
*createmark elems 1 "by comp id" 25
hm_excludebeyond nodes 1 elems 1 dist 500.0
*createmark nodes 1 "by comp id" 89
*createmark nodes 2 "by comp id" 25
hm_excludebeyond nodes 1 nodes 2 rows 5
Errors
if { [ catch {command_name...} ] } {
# Handle error
}
Version History
14.0.130