Module: Plot 3D Orientation ()

Description:

This display module plots 3D orientations on a half sphere or on a sphere.

The orientations are represented as a set of 3D columns. Properties of the input data can be mapped on height or color. The property may also be weighted to scale the contribution of each sample to the height.

This module uses the following angular representation convention.

• Theta represents the angle formed with the Z-axis and varies in the range [0, 90] degrees.
• Phi is the angle in the xy plane, measured from the x-axis towards the y-axis in the range [0, 360[ degrees.

Connections:

Data [required]
The input data. Supported input types are HxSpatialGraph and HxSpreadSheet. The spatial graph must contain at least 2 edge properties, the first one called OrientationPhi and the second one called OrientationTheta. The spreadsheet must contain at least 2 numeric columns.

Colormap
Colormap used to map scalar values to colors.

Ports:

Table

Only visible if the input data is a spreadsheet. Sets the source table in the input spreadsheet.

Orientation Theta

Only visible if the input data is a spreadsheet. Sets the column to use as theta orientation in the input spreadsheet.

Orientation Phi

Only visible if the input data is a spreadsheet. Sets the column to use as phi orientation in the input spreadsheet.

Height Property

Property to use to compute height. The first property called "Fibers Count" is not linked with input properties and counts the number of fiber with the same orientation. All the other entries are extracted from the input data. If the "Fibers Count" property is selected the weight computation will be ignored.

Weight Property

Sets the property to weight. No Weight disables the weight computation. If enabled the weight is used during the height field computation to scale the contribution of each sample. It will be hidden if the height property is Fibers count as the weight scaling is disabled for this property.

Weight Computation

Sets the weight computation method:

• Standard: Standard weight computation method, e.g. a sample of small length should not account as much as a sample of high length on height mapping.
• Averaged: The weight of each sample with the same orientation is the averaged weight of the samples. For example if the Weight Property is length, and there are 5 samples of a given orientation. The weight assigned should be based on "total length (cumulated length of each 5 samples)"/5.

This port is displayed only if a property is selected in the Weight Property port.

Colormap

Sets colormap used to map color field values to colors.

Representation Type

Sets the representation type.
There are two choices:

• Half sphere: Samples are mapped on a half sphere.
• Sphere: Samples are mapped on a full sphere. For each (phi, theta) element in the north hemisphere, an element with the same value exists in the south hemisphere at the coordinates ( (phi+PI) modulo 2PI, -theta).

Color Property

Property to use to compute color field. The first property called "Fibers Count" is not linked with input properties and counts the number of fiber with the same orientation. All the other entries are extracted from the input data.

Viewer

The Show button allows displaying the data in an external viewer.

Export to Lattice

Exports both height and color field as Uniform Scalar Field. Each field is exported in a 360x91 grid containing the accumulated values from samples with the same orientation. Each cell of the grid correspond to a (theta, phi) coordinate.