NISEXPAND(1)                     NIS 3.4                September 8, 2000

NAME 
	nisexpand - expands X and Y dimensions of an image by an integer multiplier

SYNOPSIS 
	nisexpand [-hv] [-o output_filename] [-p plane] scale [input_filename]

DESCRIPTION 
	Creates an image whose X and Y dimensions are scale times larger than its input.
	Conversely, the X and Y pixel sizes (in mm) will be scale times smaller.
	The Z dimensions remain unchanged. 
	Expansion is performed by simple duplication of all pixel values.
	
	This allows one to equate images of differing dimensions for purposes 
	of direct comparison, e.g. for overlaying small functional images onto 
	large structural images having the same field-of-view. 
	
	Along with the output image file, nisexpand also writes the name of that
	file to stdout, for use in a command pipeline.
	
OPTIONS 
	-h              Help: print usage statement
	-v              verbose mode
	-o name         output image filename (w/complete path if not ./);
					defaults to naming the output file by adding a ".exp"
					extension to the func_file name.
	-p n            slice plane to read from (z-dim); 
					defaults to overlaying the whole volume
	
	ARGUMENTS:
	scale           integer scaling multiplier
	input_file		(w/complete path if not ./);
					can be provided as third argument, 
					or read from stdin

EXAMPLES 
	To expand a 64x64x8 functional image named "func"for overlaying onto a 
	256x256x8 structural image having the same field-of-view:

		nisexpand -z 4 func
		
	This will create a compressed 256x256x8 file called "func.exp".

FILES


SEE ALSO 
	nisover, nisshift

NOTES
	Written by Leigh Nystrom, CMU.