Graph3D generates a 3D histogram of blocks, cylinders, or cones, from the data lattice on its input port. The height of the display may be scaled by a height factor; the ground area of the histogram components may be scaled by a surface scale factor. The maximum size of the ground area is such that components touch. Components are centred on the coordinates of the input lattice.

Optionally, the components are colored according to row, column, or height of the data values using the attached color map to set the color coding.


Port: Data In
Type: Lattice
Constraints: 2-D
Constraints: 1-vector
Constraints: uniform
Input data from which the 3D histogram is to be constructed.

Port: ColorMap
Type: Lattice
Optional: This port is optional.
Constraints: 1-D
Constraints: 4-vector
Constraints: float
Color map which may be used for the color coding.

For maximum effect the range of the color map should be equal to the range of values in the input data lattice when the histogram is colored according to magnitude, and 0.0 to 1.0 otherwise.


Port: Graph Type
Type: Option Menu
Menu Item: Blocks
Menu Item: Cylinders
Menu Item: Cones
The shape of the histogram components may be specified as blocks, cylinders, or cones.

Port: Color By What
Type: Option Menu
Menu Item: 1st direction
Menu Item: 2nd direction
Menu Item: magnitude
If a color map is attached, color coding may be according to the position of the components (row, or column), or according to their data value.

Port: Height Scale
Type: Dial
The height of the histogram may be scaled using the height scale factor. The default height scale factor is 1.0.

Port: Surface Scale
Type: Dial
The ground area of the histogram components may be specified using the surface scale factor. By default the size is 80 percent of the smallest distance between nodes (scale factor = 0.8).

If an attempt is made to increase the size to more than the smallest distance between nodes (scale factor > 1.0), then the scale factor is clamped to 1.0, and the widget setting is changed accordingly.

Likewise, the size factor may not be reduced below the value of 0.01.


Port: Graph
Type: Geometry
Geometry containing the histogram.




[Documentation Home]
© The Numerical Algorithms Group Ltd, Oxford UK. 2000