combine-images <input>... <output> [options]
combine-images <input>... -output <output> [options]
combine-images -input <volume> -image <slice> -output <volume> [options]
combine-images [options]


Concatenate two or more either 2D images to form a 3D volume, or 3D volumes to form a 3D+t temporal sequence. All input images must have the same image attributes, except in either the third (2D) or the third and fourth (3D) image dimension.

Moreover, given an combine-images -input volume (sequence), additional slices (volumes) can be appended to it. Note that when combine-images -sort is enabled, the additional slices (volumes) can be interleaved with the existing volume (sequence), allowing inserting a slice (volume) anywhere not only after the last slice (volume) of the input volume (sequence).

Note that the slice thickness of the output volume when concatenating slices is set equal the average slice thickness of the input images, unless it is overridden by the combine-images -spacing value.

Command options

-input <file>

Read input -images from given volume/sequence.

-output <path>

Output image file path. Last positional argument when option missing.

-image <file>

Add one input image. Option can be given multiple times.

-images <file>...

Add one or more input images. Option can be given multiple times.

-sort [on|off]

Automatically determine correct order of input images based on the distance along the third or fourth image axis.


Disable sorting of input images, same as -sort off. (default)

-start <float>

Position of first slice/frame of output volume/sequence.

-spacing <float>

Slice/Temporal spacing of output volume/sequence.

Standard options

-v, -verbose [n]

Increase/Set verbosity of output messages. (default: 0)

-debug [level]

Increase/Set debug level for output of intermediate results. (default: 0)

-version [major.minor]

Print version and exit or set version to emulate.


Print revision (or version) number only and exit.

-h, -help

Print help and exit.