Provided by: mitools_1.8.5-2ubuntu1_amd64 bug

NAME

       micalc -  Performs basic mathematics with data sets

DESCRIPTION

       micalc:  Performs basic mathematics with data sets

              File formats are automatically identified by their file extension.

   micalc can be used in one of the following modes:
              Binary operation with data sets and/or scalar numbers:

              micalc  [-if1  <input-file1>  |  -in1  <input-number1>] -op <operation(+,-,*,/,lcorr,kcorr)> [-if2
              <input-file2> | -in2 <input-number1>] -of <output-file>

              Accumulation of one data set:

              micalc -if <input-file> -op <operation(+,*)>

              Transformation (magnitude, logarithm, negation, inversion, or acos) of one data set:

              micalc -if <input-file> -op <operation(abs,log,-,/,acos)> -of <output-file>

              Statistics of one data set:

              micalc   -if   <input-file>   [-mean   <time-mean-file>]   [-stdev   <time-stdev-file>]    [-fluct
              <relative-time-stdev-file>]  [-tcourse  <average  time  course  of all voxels>] [-hist <histogram>
              -histmin <minval> -histmax <maxval> -histslots <numofslots> -rightstairs -histfract]

   Extra options:

       -mask <Binary mask file: voxels with zeroes are discarded>

       -weightmask <Multiply input file(s) with this file>

   File read options:

       -date: Date of scan [yyyymmdd] (default=20120328yyyymmdd)

       -fp: FOV in phase direction [mm] (default=220.0mm)

       -fr: FOV in read direction [mm] (default=220.0mm)

       -fs: FOV in slice direction [mm] (default=5.0mm)

       -nr: Number of consecutive measurements (default=1)

       -nx: Number of points in read direction (default=128)

       -ny: Number of points in phase direction (default=128)

       -nz: Number of points in slice direction (default=1)

       -pbirth: Patients date of birth [yyyymmdd] (default=00000000yyyymmdd)

       -pid: Unique patient identifier (default=Unknown)

       -pname: Full patient name (default=Unknown)

       -psex: Patients sex (options=M F O , default=O)

       -pweight: Patients weight [kg] (default=50.0kg)

       -scient: Scientist Name (default=Unknown)

       -sd: Inter-slice distance (from center to center) [mm] (default=10.0mm)

       -serd: Series Description (default=Unknown)

       -serno: Series Number (default=1)

       -st: Slice thickness [mm] (default=5.0mm)

       -stud: Study Description (default=Unknown)

       -tcname: Name of transmit coil (default=Unknown)

       -te: Time-to-echo of the sequence [ms] (default=80.0ms)

       -time: Time of scan [hhmmss] (default=165641hhmmss)

       -tr: Time between consecutive excitations [ms] (default=1000.0ms)

       -cplx: Treat data as complex  and  extract  the  given  component  (options=none  abs  pha  real  imag  ,
              default=none)

       -ds: Dataset index to extract if multiple datasets are read

       -filter:  Read  only  those datasets which protocol parameter 'key' contains the string 'value' (given in
              the format 'key=value')

       -fmap: For reduced memory usage, keep filemapping after reading (raw) data, but writing  into  the  array
              will result in a crash

       -jdx: If multiple JDX arrays are present, select this

       -rdialect: Read data using given dialect of the format. (default is no dialect)

       -rf:  Read format, use it to override file extension (options=autodetect 3db asc coi dat dcm double float
              gz hdr idx ima jdx mag mhd nii ph png pos pro reg s16bit s32bit s8bit smp u16bit u32bit u8bit  vtk
              , default=autodetect)

       -skip: Skip this amount of bytes before reading the raw data (default=0)

   File write options:

       -append: Append to existing file, only for raw data

       -fnamepar: Space-separated list of protocol parameters to include when creating unique file names

       -split: Force splitting of protocol-data pairs into separate files.

       -type:  Image representation type (options=automatic float double s32bit u32bit s16bit u16bit s8bit u8bit
              , default=automatic)

       -wdialect: Write data using given dialect of the format. (default is no dialect)

       -wf: Write format, use it to override file extension (options=autodetect 3db asc coi dat dcm double float
              gz hdr idx ima jdx mag mhd nii ph png pos pro reg s16bit s32bit s8bit smp u16bit u32bit u8bit  vtk
              , default=autodetect)

       -wp: Store the protocol separately to this file.

   Filters applied to input file(s):

       -align  <filename,In-plane  blowup  factor> : Align data to the geometry (voxel locations) of an external
              file

       -automask : Create mask using automatic histogram-based threshold

       -detrend <Number of low frequency components to be removed,Zero mean of resulting  timecourse>  :  Remove
              slow drift over time

       -genmask <lower threshold,upper threshold> : Create mask including all voxels with value in given range

       -isotrop <voxelsize> : make image voxels isotrop through interpolation (image geometry will not change)

       -lowpass <Cut-off frequency [Hz]> : Lowpass filtering

       -max <Maximum value> : Clip all values above maximum value

       -maxip  <direction  (time  slice  phase  read  none  )> : Perform maximum intensity projection over given
              direction

       -merge : Merge datasets into a single dataset by expanding the time dimension

       -min <Minumum value> : Clip all values below mininum value

       -minip <direction (time slice phase read none )>  :  Perform  minimum  intensity  projection  over  given
              direction

       -noNaN <Replacement value> : Replaces every NaN by the given value

       -pflip : Flip data in phase direction

       -prange  <Single  value  or  range,  optionally  with  increment  (e.g.  1-10:3)> : Select range in phase
              direction

       -proj <direction (time slice phase read none )> : Perform projection over given direction

       -quantilmask <quantil> : Create mask including all voxels above the given fractional threshold

       -resample <new size> : Temporal resize of image data

       -resize <slice-size,phase-size,read-size> : Spatial resize of image data

       -reslice <requested orientation (sagittal coronal axial )> : reslices the image to a given orientation

       -rflip : Flip data in read direction

       -rot <angle [deg],kernel size [pixel]> : In-plane rotation

       -rrange <Single value or range, optionally with increment (e.g. 1-10:3)> : Select range in read direction

       -scale <Slope,Offset> : Rescale image values

       -sflip : Flip data in slice direction

       -shift <readDirection shift [pixel],phaseDirection shift [pixel],sliceDirection shift  [pixel]>  :  Shift
              data spatially

       -splice  <dimension  of  the data to be spliced (time slice phase read none )> : splices the image in the
              given direction

       -srange <Single value or range, optionally  with  increment  (e.g.  1-10:3)>  :  Select  range  in  slice
              direction

       -swapdim  <[rps][-],[rps][-],[rps][-]>  :  swap/reflect  dimensions by specifying a direction triple with
              optional reflection sign appended

       -tile <columns> : Combine slices into a square 2D image

       -trange <Single value or range, optionally with increment (e.g. 1-10:3)> : Select range in time direction

       -typemax <Datatype> : Clip all values above maximum of a specific datatype

       -typemin <Datatype> : Clip all values below mininum of a specific datatype

       -usemask <filename> : Create 1D dataset including all values within mask from file

   Other options:

       -v <loglevel> or <component:loglevel>  for  debugging/tracing  all  components  or  a  single  component,
              respectively.  Possible values for loglevel are: 0(noLog), 1(errorLog), 2(warningLog), 3(infoLog).

       -h, --help, -help, --version : Print help text or version information

   Supported file extensions(formats):
       3db    (Iris3D binary data)

       asc    (ASCII, dialects: tcourse )

       coi    (JCAMP-DX data sets)

       dat    (Matlab ascii 2D data matrix)

       dcm    (DICOM, dialects: siemens )

       double (double raw data)

       float  (float raw data)

       gz     (GNU-Zip container for other formats)

       hdr    (NIFTI/ANALYZE, dialects: fsl )

       idx    (3D-indices of non-zeroes in ASCII)

       ima    (DICOM, dialects: siemens )

       jdx    (JCAMP-DX image format)

       mag    (DICOM, dialects: siemens )

       mhd    (MetaImage)

       nii    (NIFTI/ANALYZE, dialects: fsl )

       ph     (DICOM, dialects: siemens )

       png    (Portable Network Graphics)

       pos    (x-y positions of non-zeroes in ASCII)

       pro    (ODIN measurement protocols)

       reg    (Ansoft HFSS ASCII)

       s16bit (signed 16 bit raw data)

       s32bit (signed 32 bit raw data)

       s8bit  (signed 8 bit raw data)

       smp    (JCAMP-DX data sets)

       u16bit (unsigned 16 bit raw data)

       u32bit (unsigned 32 bit raw data)

       u8bit  (unsigned 8 bit raw data)

       vtk    (Visualization Toolkit)

micalc 1.8.5                                       March 2012                                          MICALC(1)