*morphmapedgestoequationoffset

Maps selected morph volume edges to the surface of an equation.

Syntax

*morphmapedgestoequationoffset user_mark_id equation origin origin_id use_symmetry use_constraints project vector_id number_of_mid_handles offset

Type

HyperMesh Tcl Modify Command

Description

This command maps the handles on the marked morph volume edges to a function along the specified vector, equation surface normal, or normal to any attached shell elements (unusual for morph volume edges).

Inputs

user_mark_id
The ID of the user mark containing the morph edges. Valid values are 0-3.
equation
String containing an equation f(x,y,z). The equation can contain x, y, and z variables but should not contain an equals sign. The surface of the function is located where the value of the function equals zero.
origin
0 - Use global origin and system
1 - Use global system with node ID = origin_id as the origin
2 - Use local system with ID = origin_id as the origin and system
origin_id
The ID of node or system specified in origin. Ignored if origin is 0.
use_symmetry
0 - Do not use symmetry links
1 - Use symmetry links
use_constraints
0 - Do not use constraints
1 - Use constraints
project
0 or 10 - Project along vector defined by vector_id
1 or 11 - Project normal to surface of equation
2 or 12 - Project normal to attached shell elements
If offset is non-zero, the offset will be measured from the closest point on the equation for values of 0, 1 and 2. The offset will be measured along the projection vector or normal for values of 10, 11, and 12.
vector_id
The ID of vector created using *createvector for the projection direction. Must be set to 1.
number_of_mid_handles
-1 - Do not change the handles on the edges
0 - 5 - Update the number of mid-handles on the edges to this number
offset
The distance to offset nodes from the target.
The offset will be measured from the closest point on the equation for values of project of 0, 1, and 2. The offset will be measured along the projection vector normal for values of project of 10, 11, and 12.

Examples

To map edges on mark 0 to an equation (sphere of radius 10) with an offset of 1.2 using the global system along a vector leaving the handles unchanged:

*morphmanageedgemark 0 0 3
*morphmanageedgemark 2 0 1
*morphmanageedgemark 4 0 1
*createvector 1 1.0 0.0 0.0
*morphmapedgestoequationoffset 0 "x*x+y*y+z*z-100.0" 0 0 1 1 0 1 -1 1.2
*morphmanageedgemark 0 0 3

To map edges on mark 1 to an equation (sphere of radius 10) using a local system along the line normal with 3 mid-handles per edge:

*morphmanageedgemark 0 1 3
*morphmanageedgemark 2 1 1
*morphmanageedgemark 4 1 1
*createvector 1 1.0 0.0 0.0
*morphmapedgestoequationoffset 1 "x*x+y*y+z*z-100.0" 2 1 1 1 1 1 3 0.0
*morphmanageedgemark 0 1 3

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

14.0.110