average-images <output> -images <images.lst> [options] average-images <output> -image <image1> [<w1>] [-dof <dof1>...] -image <image2> [<w2>] [-dof <dof2>...]... [options] average-images <output> <image1> [<dof1>...] <image2> [<dof2>...]... [options] average-images <output> <sequence> [options]
Computes voxel-wise average image of the given (transformed) input images.
The input images are optionally transformed by one or more image-to-average space
average-images -dof) or its inverse (
average-images -dof_i), respectively.
When more than one transformation is given, these are concatenated via funtion
A single input image.
Text file with N lines containing the file name of each input image, optionally a transformation file name (see
-dof_i), followed by an optional weight for a weighted output average (default weight is 1). The first line of the text file must specify the common base directory of all relative image and transformation file paths occurring on the subsequent N lines. A path starting with ‘./’ must be relative to the directory containing the input text file itself. Each transformation file path may be prefixed with ‘inv:’ or ‘dof:’ to indicate whether the inverse of the given transformation file maps points from the image world space to the common average world space or not. When omitted from a file path, ‘dof:’ is implied, i.e., the transformation is assumed to map points from input image to average image world space (see
Delimiter used in
-imagesfile. (default: ‘,’ for .csv, ‘t’ for .tsv, and ‘ ‘ otherwise)
Specifies a transformation to be applied to the preceeding image. (default: none)
When <file> name specified, use the attributes of this reference image for average image. When “max-size” is specified, the input image with the most number of voxels is used as reference, whereas “max-space” selects the image which occupies the largest amount world space. By default, an “average” voxel size and image orientation is computed from the input images and the image size adjusted such that the image bounding boxes of all (affinely transformed) input images are contained within the average image space. (default: average)
<dx> [<dy> [<dz>]]¶
Voxel size of intensity average image. (default:
Input padding and output background value. No input padding if not specified. Output background value zero by default or minimum average intensity minus 1. (default: 0)
Replace average value by
-paddingvalue when cumulative normalized weight is below the specified threshold in [0, 1). (default: 0)
Input intensity normalization:
none: Use input intensities unmodified. (default)
mean: Divide by mean foreground value.
median: Divide by median foreground value.
z-score: Subtract mean and divide by standard deviation.
unit: Rescale input intensities to [0, 1].
dist: Rescale input intensities to average mean and standard deviation of input images.
Linear rescaling of average intensity values:
none: No rescaling of averaged intensities. (default)
unit: Rescale average intensities to [0, 1].
dist: Rescale average intensities to average mean and standard deviation of input images.
<min> <max>: Rescale average intensities to specified output range.
Crop/pad average image and ensure a margin of <n> voxels at each boundary. (default: -1/off)
Interpolation mode, e.g., NN, Linear, BSpline, Cubic, Sinc. (default: Linear)
Segmentation label(s) of which to create an average probability map. When multiple labels are given, the corresponding segments are merged. This option can be given multiple times to create more than one average image for each segment. When only one <output> file name is given, it is modified to include the index of the segment corresponding to the order of the -label(s) options. Otherwise, specify a different output <path> as argument. A suffix corresponding to the respective label is appended to the output file path before the file name extension. When no argument is given the <output> path is used.
Data type of output image. The intermediate average image always has floating point data type. When this option is given, this average is cast to the respective output type before writing the result to the output image file. (default: float)
Increase/Set verbosity of output messages. (default: 0)
Increase/Set debug level for output of intermediate results. (default: 0)
Print version and exit or set version to emulate.
Print revision (or version) number only and exit.
Print help and exit.