cluster_probe

cluster_probe_edit

Synopsis

The cluster_probe and cluster_probe_edit macros input two glyphs and replicate the second glyph at each of the coordinates in the first grid, using that point as the origin of each instance of the second glyph. The cluster_probe_edit user macro also contains a user interface allowing the glyph transformation to be edited with the standard xform editor.

Input Ports

Name Type Description

&in_base Grid+Xform Input glyph containing base coordinates
&in_glyph Grid+Xform Input glyph containing glyph to be replicated

Output Ports

Name Type Description

out Mesh (Cell_Set+Point) Output mesh containing replicated coordinates and a Point cell set

Description

Inputs two Grids and Xforms (glyphs) and replicates the second glyph at each coordinate of the first glyph. This allows clustered probes (glyphs) to be generated and used as a single input to modules such as streamlines and advect.

The xform of the second glyph is applied to each coordinate of the second glyph, so that it can be transformed (usually scaled) relative to the base (first) glyph. For example this allows a box glyph to replicated at each point on a plane object, producing an array of boxes, or a sphere glyph could be repeated along a multi-segment line object. Such clustered glyphs can be used as probes for use with modules such as streamlines and advect. The module also generates a Point mesh, so that each point may be rendered.

The cluster_probe_edit user macro also contains a user interface allowing the glyph transformation to be edited with the standard xform editor.

Input Ports

&in_base

Input Grid (coordinates) and a corresponding Xform. Each coordinate is used as the origin for each instance of the replicated glyph.

&in_glyph

Input Grid (coordinates) and a corresponding Xform. Each coordinate is transformed by its local xform and then replicated at each origin point in the in_base input grid.

Output Ports

out

Output field containing all the coordinates and a Point Mesh.

Utility Macros

The low-level ClusterProbeCreate module is used in this User Macros cluster_probe and cluster_probe_edit.

Example

An example application ClusterProbeEg is provided, which shows a Plane and a Box glyph combined to form a single probe. The Box glyph is replicated at each point within Plane. The example uses the cluster_probe_edit user macro which includes the Transformation Editor UI, and the scale of the Box has been set to 0.05.

Files

iac_proj/cprobe/cprbmacs.v contains the cluster_probe and cluster_probe_edit User Macros and the example application ClusterProbeEg V definitions.

Other Notes

The ClusterProbeMacs library inherits its process. As this library contains no procedural code, the process is not important. The low-level ClusterProbeCreate module, executes under the process specified in its library, not the process defined in the high-level library.

Author

Paul G. Lever
International AVS Centre

Contact

International AVS Centre
Manchester Visualization Centre
Manchester Computing
University of Manchester
Oxford Road
Manchester
United Kingdom
M13 9PL

See Also

ClusterProbeCreate and ClusterProbeUI.