hm_getprincipalaxes

Returns the principal axes direction cosines for the selected entities.

Syntax

hm_getprincipalaxes entity_type mark_id ?location_flag?

Type

HyperMesh Tcl Query Command

Description

Returns the principal axes direction cosine values for the selected entities. The values are always returned relative to the global axes. The values are returned as 1st_direction_x 1st_direction_y 1st_direction_z 2nd_direction_x 2nd_direction_y 2nd_direction_z 3rd_direction_x 3rd_direction_y 3rd_direction_z.

Inputs

entity_type: The type of entity to query. Currently supported for comps and elems.
mark_id: The ID of the mark containing the entities. Valid values are 1 and 2.
location_flag: Optional. Specifies the location about which the principal axes are calculated. Valid values are:; 0 - Global (0,0,0). Default.; 1 - COG location.

Example

To get the principal axes for components 1-5:

*createmark comps 1 1-5
hm_getprincipalaxes comps 1

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

11.0.101