Converts raw or voxel format streamlines to VTK polydata. These can be loaded into
Paraview or other programs that read VTK data. Scalar data can be associated with the
streamlines, this can be used to scale or colour the data within VTK.
The options for scalar data are:
No scalars - the default.
Colour by orientation - colour the streamline points by local orientation.
Seed ROI - the scalar value for each point on the streamline is the ROI index of its seed point.
target ROI - the scalar value for each point on the streamline is the index of the first target ROI
that it intersects. Each segment (either side of the seed) is treated separately, unless one segment
intersects a target and the other does not, in which case the entire streamline has the scalar of the
intersected target.
Custom scalars - pass any Analyze image that is in the same physical space as the tracts. Each point
of the streamline has the scalar value from the corresponding point in the image.
With the exception of orientation RGB encoding, the mapping of scalars to colours is
handled by a VTK lookup table, which is provided at run time. Streamlines coloured by
orientation have 24-bit RGB scalars, which are interpreted directly as colours.
Input data must be raw binary tracts (the output of track and
procstreamlines). These tracts are described in the same physical space as the
scalar image passed to this program.
Use the ROI index of the target as the scalar. This produces one colour per target ROI.
Streamlines that do not intersect any target have zero scalars.
Each point on the streamline is coloured by the local orientation. The colour coding
scheme is the same as described in pdview(1).
-scalarfile
An image that is in the same physical space as the tracts. Each point of the streamline
has the scalar value from the corresponding point in the image.
-interpolatescalars, -interpolate
With this option, the scalar value at each point on the streamline is calculated by
trilinear interpolation. By default, nearest-neighbour interpolation is used. Smoothness
of the scalar values may be increased by using this option and by running the streamlines
through procstreamlines with resampling enabled.
-seedfile
Seed ROI used to generate the tracts, as defined in track(1).
-targetfile
An image containing integer-valued target regions, as defined in track(1).
-voxeldims <x> <y> <z>
The x, y, and z dimension of each voxel, in millimetres. Not required if any image file
is used or a header is passed with -header.
