reunite

• purpose
• usage
• examples
• comments
• error messages
• see also

Purpose:

Usage:

where the following definitions apply:

output

name of the output image file (.hdr or .img suffix optional)

overwrite?(y/n)

the letter 'y' if you want to allow a preexisting file with the nameoutput to be overwritten

input[s]

name(s) of the input image file(s) (.hdr or .img suffix optional)

Examples:

• If files petslicej.img petslicev.img and petsliceb.img have compatible dimensions and each contains only a single plane of data, this command will combine them into a single 3-dimensional file called pet.img. The first plane in this file will consist of data from petslicej.img, etc.

• On a UNIX system, this command will combine a series of files numbered petslice001 (or petslice000 if you like) through petslice999 (or more likely a smaller number) into a single file called pet.img. Note that the presence of a file petslicexyz.hdr (where xyz is not a number) will result in an attempt to incorporate that file as well. The use of the .hdr or .img suffix is mandatory in this context--if you use petslice*, you will end up with twice as many planes as you expect because each file will be entered twice (once as petslice*.img and once as petslice*.hdr).

Comments:

• All input files must have identical matrix dimensions.
• Each input file must consist of a single plane of data.
• The voxel dimensions of the first input file are used for the output file. No error checking for voxel dimension compatibility is performed.
• Compressed files cannot be read by this program.
• If you are trying to import headerless single plane data into a 3D volume, you can choose between the following choices:
  1. Rename each data file with a .img suffix, create the corresponding header file for each plane using makeaheader, and use this program to join all of the individual files together.
  2. On UNIX systems, use the cat command to concatenate all of the image files into a single file with a .img suffix, and then use makeaheader only once to make the appropriate header file.

Error messages: (alphabetical)

dimensions incompatibility for file _____...

• The matrix dimensions of the designated file differ from those of the first input file. The matrix dimensions of each file will be printed.
• Use scanheader to check the file's x- and y-dimensions.
• If you used a wildcard (* or ?) in your command line, try performing a directory listing with the same name and wildcard to see if an attempt is being made to incorporate data that you didn't want or expect.

This program will only accept single plane input

• The input files must have a matrix z-dimension of one.
• Use scanheader to check the file's z-dimensions.
• If you used a wildcard (* or ?) in your command line, try performing a directory listing with the same name and wildcard to see if an attempt is being made to incorporate data that you didn't want or expect.

See also:

• reunite
• makeaheader