.. _scil_volume_reslice_to_reference:

scil_volume_reslice_to_reference
================================

::

	usage: __main__.py [-h] [--interpolation {linear,nearest}] [--keep_dtype]
	                   [-v [{DEBUG,INFO,WARNING,ERROR}]] [-f]
	                   in_file in_ref_file out_file
	
	Reshape / reslice / resample *.nii or *.nii.gz using a reference.
	This script can be used to align freesurfer/civet output, as .mgz,
	to the original input image.
	
	>>> scil_volume_reslice_to_reference wmparc.mgz t1.nii.gz wmparc_t1.nii.gz\
	    --interpolation nearest
	
	To
	    - pad or crop the volume to match the desired shape, use
	      scil_volume_reshape.
	    - interpolate/reslice to an arbitrary voxel size, use
	      scil_volume_resample.
	    - crop a volume to remove empty space, use scil_volume_crop.
	
	positional arguments:
	  in_file               Path of the image (.nii or .mgz) to be reshaped.
	  in_ref_file           Path of the reference image (.nii).
	  out_file              Output filename of the reshaped image (.nii).
	
	options:
	  -h, --help            show this help message and exit
	  --interpolation {linear,nearest}
	                        Interpolation: "linear" or "nearest". [linear]
	  --keep_dtype          If True, keeps the data_type of the input image (in_file) when saving the output image (out_file).
	  -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