Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
MINCCONCAT(1)		       MINC User's Guide		 MINCCONCAT(1)

       mincconcat - concatenate	minc files along a specific dimension

       mincconcat [<options>] <infile1>.mnc [<infile2>.mnc ...]	<outfile>.mnc

       Mincconcat  will	concatenate a number of	minc files together, producing
       a single	output file. The concatenation is done along a	specified  di-
       mension,	 with  the slices being	sorted into ascending order.  The con-
       catenation 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.

       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.

	      Overwrite	an existing file.

	      Don't overwrite an existing file (default).

	      Print out	progress information for each  chunk  of  data	copied

       -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
	      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.

	      Write out	double-precision floating point	values.

	      Write  out  values  as  signed  integers	(default for short and
	      long). Ignored for floating point	types.

	      Write out	values as unsigned integers (default  for  byte).  Ig-
	      nored for	floating point types.

       -valid_range min	max
	      Specifies	 the valid range of output voxel values	in their inte-
	      ger 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 coordi-
	      nate for each input file is taken	from command-line options. The
	      default  is  to  use  the	slowest	varying	dimension of the first

       -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  di-
	      mension (default = none).

       -coordlist c1,c2,...
	      Specifies	 a  comma-separated  list of coordinates along the new

       -widthlist w1,w2,...
	      Specifies	a comma-separated list of widths along the new	dimen-

       -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 di-
	      mension, for example for concatenating multiple functional  runs
	      along a time dimension.

	      Check  that  all input files have	matching sampling in world di-
	      mensions (default).

	      Ignore any differences between input files in  world  dimensions

	      Sort coordinates in ascending order (default).

	      Sort coordinates in descending order.

	      Sort slabs by their dimension coordinate,	interleaving if	neces-
	      sary (default).

	      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.

	      Print the	program's version number and exit.

       To concatenate two volumes with dimensions zspace, yspace, xspace, hav-
       ing 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

       Peter Neelin

       Copyright (C) 1995 by Peter Neelin

			 $Date:	2005-07-15 17:38:08 $		 MINCCONCAT(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | General options | Output type options | Concatenation options | Generic options for all commands: | EXAMPLES | AUTHOR | COPYRIGHTS

Want to link to this manual page? Use this URL:

home | help