# Between-Volumes Motion Correction

This tutorial walks through the steps to perform Between-Volumes Motion Correction using DIPY.

You can try this using your own data; we will be using the data in DIPY. You can check how to fetch the DIPY data.

## Motion Correction

During a dMRI acquisition, the subject motion inevitable. This motion implies a misalignment between N volumes on a dMRI dataset. A common way to solve this issue is to perform a registration on each acquired volume to a reference b = 0 [1].

This preprocessing is an highly recommended step that should be executed before any dMRI dataset analysis.

We will use the `sherbrooke_3shell` dataset in DIPY to showcase the motion correction process. As with any other workflow in DIPY, you can also use your own data!

You may want to create an output directory to save the resulting corrected dataset:

    mkdir motion_output

To run the motion correction method, we need to specify the path of the input data, b-vectors file and b-values file. This path may contain wildcards to process multiple inputs at once. You can also specify the optional arguments. In this case, we will be just specifying the output directory (`out_dir`). For more information, use the help option (-h) to obtain all optional arguments.

To run the motion correction on the data it suffices to execute the `dipy_correct_motion` command, e.g.:

    dipy_correct_motion data/sherbrooke_3shell/HARDI193.nii.gz  data/sherbrooke_3shell/HARDI193.bval data/sherbrooke_3shell/HARDI193.bvec --out_dir "motion_output"

This command will apply the motion correction procedure to the input MR image and write the artefact-free result to the `motion_output` directory.

In case no output directory is specified, the corrected output volume is saved to the current directory by default.

## References

[1]

Mark Jenkinson and Stephen Smith. A global optimisation method for robust affine registration of brain images. Medical Image Analysis, 5(2):143–156, 2001. URL: https://doi.org/10.1016/S1361-8415(01)00036-6, doi:10.1016/S1361-8415(01)00036-6.