.. _scil_volume_reshape:

scil_volume_reshape
===================

::

	usage: __main__.py [-h]
	                   (--ref REF | --volume_size VOLUME_SIZE [VOLUME_SIZE ...])
	                   [--mode {constant,edge,wrap,reflect}]
	                   [--constant_value CONSTANT_VALUE] [--data_type DATA_TYPE]
	                   [-v [{DEBUG,INFO,WARNING,ERROR}]] [-f]
	                   in_image out_image
	
	Script to reshape a volume to match the resolution of another
	reference volume or to the resolution specified as in argument. The resulting
	volume will be centered in world space with respect to the reference volume or
	the specified resolution.
	
	This script will pad or crop the volume to match the desired shape.
	To
	    - interpolate/reslice to an arbitrary voxel size, use
	      scil_volume_resample.
	    - reslice a volume to match the shape of another, use
	      scil_volume_reshape.
	    - crop a volume to constrain the field of view, use scil_volume_crop.
	
	We usually use this script to reshape the freesurfer output (ex: wmparc.nii.gz)
	with your orig data (rawavg.nii.gz).
	
	positional arguments:
	  in_image              Path of the input volume.
	  out_image             Path of the resampled volume.
	
	options:
	  -h, --help            show this help message and exit
	  --ref REF             Reference volume to resample to.
	  --volume_size VOLUME_SIZE [VOLUME_SIZE ...]
	                        Sets the size for the volume. If the value is set to is Y, it will resample to a shape of Y x Y x Y.
	  --mode {constant,edge,wrap,reflect}
	                        Padding mode.
	                        constant: pads with a constant value.
	                        edge: repeats the edge value.
	                        Defaults to [constant].
	  --constant_value CONSTANT_VALUE
	                        Value to use for padding when mode is constant.
	  --data_type DATA_TYPE
	                        Data type of the output image. Use the format: 
	                        uint8, int16, int/float32, int/float64.
	  -v [{DEBUG,INFO,WARNING,ERROR}]
	                        Produces verbose output depending on the provided level. 
	                        Default level is warning, default when using -v is info.
	  -f                    Force overwriting of the output files.
	
	2.2.2