hm_getlinetangentatcoordinate

Returns the closest point, the components of the tangent vector and the angle between the tangent vector and the z-axis at the point on the line closest to the input coordinates.

Syntax

hm_getlinetangentatcoordinate line_id x y z

Type

HyperMesh Tcl Query

Description

Returns the closest point, components of the tangent vector and the angle between the tangent vector and the z-axis at the point on the line closest to the input coordinates.. The first 3 return values are the closest point coordinates, the next 3 are the tangent vector components, and the last return value is the angle.

Inputs

line_id: The ID of the line.
x, y, z: The (x,y,z) coordinates of the point.

Example

To get the components of the tangent vector and the angle between the tangent vector and the z-axis nearest the coordinates (100,50,25) for the line with ID 341:

foreach {x y z tg_x tg_y tg_z ang}[hm_getlinetangentatcoordinate 341 100 50 25{}

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

12.0.110