ribbons_plot

Synopsis

create "height surfaces" of a 2D field that are continuous along one axis but discontinuous along the other

Input Port

in_field	Mesh_Unif+Node_Data
ui_parent	user interface parent object

Parameters

Output Port

out_fld	Mesh+Node_Data
out_obj	output renderable object

Description

ribbons_plot creates height surfaces of a 2D field by treating the values of a component of that field as height above the surface of the field, and the values of another component as color to be applied. The surfaces so created are continuous along one axis (selectable as X or Y) and discontinuous along the other axis, so they look like a set of colored ribbons draping over a surface. Each quadrilateral polygon composing a ribbon segment is created as follows:

Two points above a pair of node points along the continuous axis define the left side of the polygon. The polygon is flat (horizontal) along the other axis. The width of the ribbons is scaled by the scale slider, and the offset value is added to their height. Note that the ribbons, in general, extend one grid cell width past the grid in the +X and +Y directions, as shown above.

Input

in_field

Mesh_Unif+Node_Data. The ribbon plot is built on this mesh, using the node data values as heights.

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

ribbon direction

UIradioBoxLabel. Selects which direction the ribbons should run.

height data

UIradioBoxLabel. Which node data component to map to ribbon height.

map data

UIradioBoxLabel. Which node data component to map to ribbon color.

scale

UIslider. This scale factor is applied to the data values to convert them into heights above the mesh.

offset

UIslider. This offset is added to the heights to offset the ribbons from the surface of the field.

Output Port

out_fld

Mesh+Node_Data. The mesh contains the ribbons, with the node data containing the color.

out_obj

Renderable object corresponding to out_fld.

Example

Libraries.Examples.Visualization.Ribbon_Plot
v/dv_examp/rib_plot.v

File

v/modules.v

See also related modules

city_plot

surf_plot