Browsers know how to interpret XML files from the file's Document Type Description (DTD). Our DTDs are: They are also in SLICER_HOME/slicer/dtd/.

A sample MRML file, of two volumes (registered using a transform) and a couple of surface models, is shown here.

In this section, we expand on the description of nodes given in the Basic Nodes section.

Volume node details

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.

Model node details

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.

Color node details

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.

Matrix node details

Key Value
name Name displayed on the user interface.
matrix 16 numbers that form a 4x4 matrix. The matrix is multiplied by a point (M*P) to compute the transformed point.

Options node details

Key Value
program A required attribute, the name of the program that should recognize these options.
content Short description of the contents of this node. For example, 'presets'.
options List of options expressed in this form: key1='value1' key2='value2'.