Synopsis
create "height surfaces" of a 2D field that are continuous along one axis but discontinuous along the other
Input Ports
|
in_field |
Mesh_Unif+Node_Data |
|
ui_parent |
user interface parent object |
Output Ports
|
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 Ports
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 Ports
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
examples/rib_plot.v
File
v/modules.v
See also