fuse

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

Purpose:

Joins files with identical dimensions at their edges so that each z-plane shows a composite of all of the input files

Usage:

fuse output overwrite?(y/n) width height input-file1 [...input-fileN]

use 'null' as an input_file to control blank space

where the following definitions apply:

output

the name of the output file

overwrite?(y/n)

'y' grands permission to overwrite output

width

the width (x dimension) of output in images

height

the height (y dimension) of output in images

input-file1

the name of the first input file

...input-fileN

the names of additional input files

Examples:

• If identical in dimensions and voxels sizes (and presumably registered to one another) , the files T1image and T2 image will be joined to create composite. Each z plane of composite will display corresponding slices of T1img and T2image simultaneously

Comments:

• if the number of files is less than the product of width*height, the composite will be padded with zeros
• 'null' can be used as a file name to control the positioning of black space

Error messages: (alphabetical by case)

height cannot be zero

• use a positive integer

height must be a positive integer, not ____

• use a positive integer

width cannot be zero

• use a positive integer

width must be a positive integer, not ____

• use a positive integer

See also:

• layout
• reunite