glyph

Synopsis

produce a geometric object (glyphs) at nodal locations of an input field

Input Port

in_field	Mesh + Node_Data
in_glyph	Grid mesh used as geometry of a glyph
ui_parent	user interface parent object

Parameters

glyph component	UIradioBoxLabel	select component to scale glyph
map component	UIradioBoxLabel	select component to color glyph
Mode	UIradioBoxLabel	how glyphs portray data values
Normalize	UItoggle	normalizes glyph size
scale	UIslider	scale factor for glyph
Scale X	UItoggle	select X dimension to be scaled
Scale Y	UItoggle	select Y dimension to be scaled
Scale Z	UItoggle	select Z dimension to be scaled

Output Port

out_fld	Mesh + Node_Data
out_obj	output renderable object

Description

glyph places a geometrical object at each node of an input field so that node locations are easily identified. The glyph can be sized and colored according to the selected data component at each node. If the glyph is an arrow in a vector field, for example, it generates a hedgehog.

Input

in_field

The input must contain any type of mesh plus Node_Data.

in_glyph

Grid. This is simply a mesh describing the geometry of the glyph. Any mesh can be used (for example, that of a teapot) but for convenience you can use the Geometries such as Arrow1 (wireframe arrow), Arrow2 (solid arrow), or Cross3D (XYZ crosshairs) to generate the glyph.

ui_parent

A port to connect to a user interface object that contains the macro's widgets. By default, it is connected to the default user interface object in the application in which the macro is instanced. (This default connection is not drawn.)

Parameters

glyph component

UIradioBoxLabel. Radio buttons to pick which input Node_Data component to use to scale and distort the glyph, as controlled by Mode. The default is the

first (0th) component. If node data labels are present, they are displayed.

map component

UIradioBoxLabel. Radio buttons to pick which input Node_Data component to use to color the glyph. If map component is equal to glyph component and the map component is a vector, the color represents the magnitude of the vector. If node data labels are present, they are displayed. The default is the first (0th) component.

Mode

UIradioBoxLabel. A radio box that establishes how glyphs are rendered to represent the data values. The choices are:

scalar

Scale the glyph set by glyph component by the magnitude of the vector at that position.

vector (default)

Scale the glyph set by glyph component by the magnitude of the vector at that position. Also rotate the glyph in X, Y, (and Z) by the first, second, (and third) vector subcomponent values at that position. For example, a Cross3D in_probe would be rotated to reflect the vector values.

component

Scale the glyph set by glyph component in X, Y, (and Z) by the first, second, (and third) vector subcomponent values at that position. For example, a Cross3D in_probe's three lines would be individually scaled to match the vector values.

Normalize

UItoggle. If off, the sizes of the glyphs are proportional to the magnitude of the data component values at each node. If on, all glyphs are the same size. The default is off.

scale

UIslider. A float slider to adjust the sizes of the glyphs. The default is 1.0. The range is -10 to 10.

Scale X

UItoggle. If on, the X dimension of the glyphs are adjusted according to scale. The default is on.

Scale Y

UItoggle. If on, the Y dimension of the glyphs are adjusted according to scale. The default is on.

Scale Z

UItoggle. If on, the Z dimension of the glyphs are adjusted according to scale. The default is on.

Output Port

out_fld

The output field contains a new unstructured mesh (mesh type Mesh) that is the meshes of all the glyphs. It also contains a new Node_Data consisting of the magnitude of the selected component's data values if map component is a vector, or the value of the map component if the map component is a scalar.

.

out_obj

This is a renderable version of the output field

Example

Libraries.Examples.Visualization.Glyph_Interp
v/dv_examp/glh_intp.v
Libraries.Examples.Visualization.Advect
v/dv_examp/advect.v
Libraries.Examples.Visualization.Probe
v/dv_examp/probe.v

File

v/modules.v

See also related modules

Related geometries