SYNOPSIS

mincsample [<options>] <in1.mnc> [<in2.mnc> [<..>]]

DESCRIPTION

Mincsample produces a data sampling on STDOUT from an input series of minc files. The output can be either ascii (-ascii) or as a raw binary stream of doubles (-double). The output data is ordered first by file then voxel. When -ascii is used the data values from each file are separated by a tab and the sampling points with a newline. When using -double, no separators are used.

If -coords is also specified, the world co-ordinate at each sampling point will precede the data from each of the files. An optional -outfile argument can also be used to direct the output to a file and -append used to append the data to the file as opposed to overwriting the file.

By default all data points are written out (-all) the output of points can also be constrained to be points within a mask (-mask and -mask_val) and further by a random sampling of a sub-set of points via the -random_samples and -random_seed arguments

OPTIONS

-verbose

Print extra information during processing.

-quiet

Print only the ouput sampling data.

-clobber

Overwrite existing output files (when used with -outfile)

-max_buffer size

Specify the maximum size of the internal buffers (in kbytes). Default is 4096 (4MB).

-mask mask.mnc

Specify and input mask, only sampling points within this mask will be used.

-mask_val value

Specify the value to use from the mask (Default: 1).

-all

Sample all the data points.

-random_seed value

Specify the random seed value to use during random sampling, this is to enable reproducible runs. If no seed is given a semi-random seed will be chosen (from time).

-random_samples value

Specify the number of random samples to take from the input files. This value must be smaller than the maximum possible number of samples.

-sample sample.mnc

Output a mask file that corresponds to where samples were taken from.

-outfile file

Output sampling data to a file. (Default: STDOUT).

-append

Append output data to an existing file.

-ascii

Write out data as ascii strings (Default).

-ascii

Write out data as double precision floating-point values.

-coords

Write out world co-ordinates as well as sampling values.

-help

Print summary of command-line options and exit.

-version

Print the program's version number and exit.

AUTHOR

Andrew Janke and Mark Griffin

COPYRIGHTS

Copyright © 2004 by Andrew Janke and Mark Griffin