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

FreeBSD Manual Pages

  
 
  

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

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

       -check_dimensions
	      Check  that  all input files have	matching sampling in world di-
	      mensions (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 (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:
<https://www.freebsd.org/cgi/man.cgi?query=mincconcat&sektion=1&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help