NAME
mincconcat - concatenate minc files along a specific dimension
SYNOPSIS
mincconcat [<options>] <infile1>.mnc [<infile2>.mnc ...] <outfile>.mnc
DESCRIPTION
Mincconcat will concatenate a number of minc files together, producing
a single output file. The concatenation is done along a specified
dimension, with the slices being sorted into ascending order. The
concatenation dimension can either be a dimension in the file, in which
case coordinates for sorting are taken directly from the input files,
or it can be a new dimension and the coordinates are specified with a
command-line option.
OPTIONS
Note that options can be specified in abbreviated form (as long as they
are unique) and can be given anywhere on the command line.
General options
-2 Create a MINC 2.0 format output file.
-clobber
Overwrite an existing file.
-noclobber
Don’t overwrite an existing file (default).
-verbose
Print out progress information for each chunk of data copied
(default).
-quiet Do not print out progress information.
-max_chunk_size_in_kb size
Specify the maximum size of the copy buffer (in kbytes). Default
is 4096 kbytes.
-filelist filename
Specify a file containing a list of input file names. If "-" is
given, then file names are read from stdin. If this option is
given, then there should be no input file names specified on the
command line. Empty lines in the input file are ignored.
Output type options
-filetype
Don’t do any type conversion (default).
-byte Write out 8-bit integer voxels.
-short Write out 16-bit integer voxels.
-int Write out 32-bit integer voxels.
-long Superseded by -int.
-float Write out single-precision floating point values.
-double
Write out double-precision floating point values.
-signed
Write out values as signed integers (default for short and
long). Ignored for floating point types.
-unsigned
Write out values as unsigned integers (default for byte).
Ignored for floating point types.
-valid_range min max
Specifies the valid range of output voxel values in their
integer representation. Default is the full range for the type
and sign. This option is ignored for floating point values.
Concatenation options
-concat_dimension name
Specifies the name of concatenation dimension. If the dimension
exists in the input files, then coordinates are taken from those
files. If not, then a new dimension is created and the
coordinate for each input file is taken from command-line
options. The default is to use the slowest varying dimension of
the first file.
-start start
Specifies the starting coordinate for the new dimension (default
= 0.0).
-step step
Specifies the separation between voxels for the new dimension
(default = 1.0).
-width width
Specifies the (constant) width of each sample along the new
dimension (default = none).
-coordlist c1,c2,...
Specifies a comma-separated list of coordinates along the new
dimension.
-widthlist w1,w2,...
Specifies a comma-separated list of widths along the new
dimension.
-filestarts s1,s2,...
Specifies a comma-separated list of offsets to the coordinate
origins for each of the files listed on the command line. This
option is useful for concatenating files along an existing
dimension, for example for concatenating multiple functional
runs along a time dimension.
-check_dimensions
Check that all input files have matching sampling in world
dimensions (default).
-nocheck_dimensions
Ignore any differences between input files in world dimensions
sampling.
-ascending
Sort coordinates in ascending order (default).
-descending
Sort coordinates in descending order.
-interleaved
Sort slabs by their dimension coordinate, interleaving if
necessary (default).
-sequential
Don’t sort slabs, just concatenate them together. WARNING - this
will destroy the dimension information along the concatenating
dimension, replacing the start and step with zero and one.
Generic options for all commands:
-help Print summary of command-line options and exit.
-version
Print the program’s version number and exit.
EXAMPLES
To concatenate two volumes with dimensions zspace, yspace, xspace,
having interleaved slices along zspace, we can simply use
mincconcat input1.mnc input2.mnc output.mnc
If we have a bunch of compressed (yspace, xspace) images that we wish
to concatenate into an evenly spaced volume, then we can type
mincconcat input1.mnc.gz input2.mnc.gz input3.mnc.gz \
input4.mnc.gz output.mnc \
-concat_dimension zspace -start -23 -step 2
AUTHOR
Peter Neelin
COPYRIGHTS
Copyright © 1995 by Peter Neelin
$Date: 2005-07-15 17:38:08 $