*morphmaptoequationvecoffset

Maps nodes to the surface of an equation along a vector.

Syntax

*morphmaptoequationvecoffset entity_type_nodes mark_id_nodes entity_type_handles mark_id_handles equation origin origin_id use_symmetry use_constraints project vector_id mode offset

Type

HyperMesh Tcl Modify

Description

Maps nodes to, or offset from, an equation using the temporary shape created by *morphmaptshp and *morphmaptshpedge as a guide. Selected handles can optionally follow behind the morphing operation.

Nodes can be projected on to the equation along a vector, normal to the surface of the equation, or normal to the shell elements attached to the nodes.

Inputs

entity_type_nodes
Must be set to nodes.
mark_id_nodes
The ID of the mark containing the nodes. Valid values are 1 and 2.
entity_type_handles
Must be set to handles.
mark_id_handles
The ID of the mark containing any following handles. Valid values are 1 and 2.
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.
mode
0 - If *morphmaprecalc has been used to calculate new influences
1 - To recalculate new influences inside this command
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 all nodes to a sphere of radius 10.0 with an offset of 1.2, when not using *morphmaprecalc:

*createmark nodes 1 "all"
*createmark handles 1
*createvector 1 1.0 0.0 0.0
*morphmaptoequationvecoffset nodes 1 handles 1 "x*x+y*y+z*z-100.0" 0 0 1 1 1 1 1 1.2

To map all nodes to a sphere of radius 10.0 positioned at a system along a vector:

*createmark nodes 1 "all"
*createmark handles 1
*createvector 1 1.0 0.0 0.0
*morphmaptoequationvecoffset nodes 1 handles 1 "x*x+y*y+z*z-100.0" 2 1 1 1 0 1 1 0.0

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