Teem: unrrdu / unu

		unrrdu / unu
teem

The Many Diverse Nrrd Utilities from the Great Nation of Deseret

Utah Nrrd Utilities

The command-line unu tool is by far the fastest and simplest way to enjoy the benefits of the Nrrd library, and time has shown that you can often get a surprising amount of work with unu alone, without writing a speck of code (compiled or interpreted). Seeking to continue a tradition in effective command-line line tools like the Utah Raster Toolkit and NetPBM, you can chain unu commands together by piping ("|") from one unu invocation to another. The default input and output for unu are stdin and stdout, so no intermediate files are every written to disk.

The architecture of unu is as follows:

For nearly all the significant functions in the Nrrd library, there is a corresponding command in the Unrrdu library.
Commands in the Unrrdu library have an argc,argv API like C/C++'s main(), and internally use Hest to parse argc,argv into Nrrd function arguments and parameters.
The command-line unu program is just a minimal wrapper around the Unrrdu library.
As with tools like cvs, separate commands are invoked by the first word after unu, for example: "unu slice", "unu crop", "unu resample", etc.
All the available commands are listed (see below) if you type "unu" with no other options.
Per-command usage info is generated by typing unu cmd with no further options, for example, "unu slice".
The general unu info documents the mapping between unu commands and Nrrd functions, as well as describing commonalities between the unu commands.
Strictly speaking, these pages describe the unu program, not the Unrrdu library it links with, but they are practically the same.

          --- unu: Utah Nrrd Utilities command-line interface ---
     unu about ... Information about this program and its use
      unu make ... Create a nrrd (or nrrd header) from scratch
      unu head ... Print header of one or more nrrd files
      unu data ... Print data segment of a nrrd file
   unu convert ... Convert nrrd to another type (as if by per-value cast)
  unu resample ... Filtering and {up,down}sampling with a seperable kernel
   unu cmedian ... Cheap histogram-based median/mode filtering
    unu minmax ... Print out min and max values in one or more nrrds
  unu quantize ... Quantize values to 8, 16, or 32 bits
unu unquantize ... Recover floating point values from quantized data
   unu project ... Collapse scanlines to scalars along some axis
     unu slice ... Slice at a position along an axis
      unu dice ... Save all slices along one axis into separate files
    unu splice ... Replace a slice with a different nrrd
      unu join ... Connect slices and/or slabs into a bigger nrrd
      unu crop ... Crop along each axis to make a smaller nrrd
     unu inset ... Replace a sub-region with a different nrrd
       unu pad ... Pad along each axis to make a bigger nrrd
   unu reshape ... Superficially change dimension and/or axes sizes
   unu permute ... Permute scan-line ordering of axes
      unu swap ... Interchange scan-line ordering of two axes
   unu shuffle ... Permute slices along one axis
      unu flip ... Reverse order of slices along one axis
  unu unorient ... make image orientation be axis-aligned
    unu axinfo ... Modify attributes of an axis
  unu axinsert ... Add a "stub" (length 1) axis to a nrrd
   unu axsplit ... Split one axis into two axes
  unu axdelete ... Remove one or more singleton axes from a nrrd
   unu axmerge ... Merge two adjacent axes into one
      unu tile ... Tile slices of one axis into two other axes
    unu untile ... Undo "unu tile": merge slow parts of two axis splits
     unu histo ... Create 1-D histogram of values in a nrrd
    unu dhisto ... Create (PGM) image of 1-D value histogram
    unu jhisto ... Create joint histogram of two or more nrrds
    unu histax ... Replace each scanline along an axis with its histogram
       unu heq ... Perform histogram equalization
     unu gamma ... Brighten or darken values with a gamma
       unu 1op ... Unary operation on a nrrd
       unu 2op ... Binary operation on two nrrds, or on a nrrd and a constant
       unu 3op ... Ternary operation on three nrrds or constants
       unu lut ... Map nrrd through one univariate lookup table
      unu mlut ... Map nrrd through whole nrrd of univariate lookup tables
     unu subst ... Map nrrd through a univariate substitution table
      unu rmap ... Map nrrd through one *regular* univariate map ("colormap")
     unu mrmap ... Map nrrd through a whole nrrd of regular univariate maps
      unu imap ... Map nrrd through *irregular* univariate map ("colormap")
      unu lut2 ... Map nrrd through a bivariate lookup table
    unu ccfind ... Find connected components (CCs)
     unu ccadj ... Form adjecency matrix of connected components
   unu ccmerge ... Merge CCs with their neighbors, under various contraints
  unu ccsettle ... Remap CC values down to lowest contiguous values
      unu save ... Write nrrd with specific format, encoding, or endianness

The command line is dead, long live the command line.