mincconcat man page on DragonFly

Man page or keyword search:  
man Server   44335 pages
apropos Keyword Search (all sections)
Output format
DragonFly logo
[printable version]

MINCCONCAT(1)		       MINC User's Guide		 MINCCONCAT(1)

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

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 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
	      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	dimen‐
	      sion.

       -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 neces‐
	      sary (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, 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

AUTHOR
       Peter Neelin

COPYRIGHTS
       Copyright © 1995 by Peter Neelin

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

List of man pages available for DragonFly

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net