Browsers know how to interpret XML files from the file's
Document Type Description (DTD). Our DTDs are:
A sample MRML file, of two volumes (registered using a transform)
and a couple of surface models, is shown here.
Key |
Value |
name |
Name displayed on the user interface. |
filePattern |
The pattern for naming the files, expressed in C language syntax. For example, a file named skin.001 has a pattern of %s.%03d, and a file named skin.1 has %s.%d for a pattern. |
filePrefix |
Prefix of the image files. For example, the prefix of /d/skin.001 is /d/skin . |
rasToIjkMatrix |
The matrix that transforms a point in RAS space to IJK space. The 4x4 matrix is listed as a string of 16 numbers in row-major order. |
rasToVtkMatrix |
Same as the rasToIjkMatrix, except that the y-axis is directed up instead of down, which is the convention in VTK. |
positionMatrix |
A scaled IJK-to-RAS matrix, formed by accounting for the position and orientation of the volume, but not the voxel size. |
colorLUT |
Numerical ID of the color lookup table to use for rendering the volume. |
description |
Optional text description of the data. |
scalarType |
The type of data in the file. Either Char, UnsignedChar, Short, UnsignedShort, Int, UnsignedInt, Long, UnsignedLong, Float, or Double. |
numScalars |
The number of scalar components for each voxel. Gray-level data has 1. Color data has 3. |
littleEndian |
Describes the order of bytes for each voxel. Little-endian positions the least-significant byte on the rightmost end, and is true of data generated on a PC or SGI. |
interpolate |
Determines whether to interpolate when reformatting slices of this volume. |
labelMap |
Indicates if this volume is a label map, which is the output of segmentation that labels each voxel according to its tissue type. The alternative is a gray-level or color image. |
tilt |
The gantry tilt, in degrees, for CT slices. |
autoWindowLevel |
Specifies whether windowing and leveling are to be performed automatically. |
window |
The window value to use when autoWindowLevel is 'no'. |
level |
The level value to use when autoWindowLevel is 'no'. |
applyThreshold |
Specifies whether to apply the threshold. |
autoThreshold |
Specifies whether the threshold should be set automatically. |
lowerThreshold |
The lower threshold value to use when autoThreshold is 'no'. |
upperThreshold |
The upper threshold value to use when autoThreshold is 'no'. |
imageRange |
Two numbers: the first and last image numbers in the volume. For example, 1 124. |
dimensions |
Two numbers: the number of columns and rows of pixels in each image. |
spacing |
Three numbers for the dimensions of each voxel, in millimeters. |
scanOrder |
The order of slices in the volume. Either LR (left-to-right), RL, AP, PA, IS, or SI. This information is encoded in rasToIjkMatrix, so it is only stated here as a convenience to people reading the file. |
Key |
Value |
name |
Name displayed on the user interface. |
fileName |
Path of the data file. |
colorName |
Name of the model's color, which is defined by a Color node in a MRML file. |
description |
Optional text description of the data. |
opacity |
Opacity of the surface expressed as a number from 0 to 1. |
visibility |
Indicates if the surface is visible. |
clipping |
Specifies whether to clip the surface with the slice planes. |
backfaceCulling |
Indicates whether to cull (not render) the backface of the surface. |
scalarVisibility |
Indicates whether to render the scalar value associated with each polygon vertex. |
scalarRange |
Range of scalar values to render rather than the single color designated by colorName. |
Key |
Value |
name |
Required, the name displayed on the user interface. |
description |
Optional text description of the color. |
diffuseColor |
Diffuse component of color expressed as 3 RGB (Red Green Blue) values in the range of 0 to 1. |
ambient |
Factor of the effect of ambient light from 0 to 1. |
diffuse |
Factor of the effect of diffuse reflection from 0 to 1. |
specular |
Factor of the effect of specular reflection from 0 to 1. |
power |
Specular power in the range of 1 to 100. |
labels |
List of label values associated with this color. |