From 99673abb42eacff3eff60da44090bcc8aafc3efb Mon Sep 17 00:00:00 2001
From: Antoine Theberge <antoine.theberge@usherbrooke.ca>
Date: Wed, 21 Aug 2024 10:28:32 -0400
Subject: [PATCH] ENH: scil_volume description

---
 scripts/scil_volume_crop.py                 |  8 ++++++++
 scripts/scil_volume_resample.py             | 11 ++++++++---
 scripts/scil_volume_reshape.py              |  7 ++++++-
 scripts/scil_volume_reslice_to_reference.py |  7 +++++++
 4 files changed, 29 insertions(+), 4 deletions(-)

diff --git a/scripts/scil_volume_crop.py b/scripts/scil_volume_crop.py
index 74aadfd19..1f8ffb657 100755
--- a/scripts/scil_volume_crop.py
+++ b/scripts/scil_volume_crop.py
@@ -10,6 +10,14 @@
 it's looking for non-zero data. Therefore, you should validate the results on
 other types of images that haven't been masked.
 
+To:
+    - interpolate/reslice to an arbitrary voxel size, use
+      scil_volume_resample.py.
+    - pad or crop the volume to match the desired shape, use
+      scil_volume_reshape.py.
+    - reshape a volume to match the resolution of another, use
+      scil_volume_reslice_to_reference.py.
+
 Formerly: scil_crop_volume.py
 """
 
diff --git a/scripts/scil_volume_resample.py b/scripts/scil_volume_resample.py
index 5cf48c145..cf1f74d64 100755
--- a/scripts/scil_volume_resample.py
+++ b/scripts/scil_volume_resample.py
@@ -5,9 +5,14 @@
 Script to resample a dataset to match the resolution of another
 reference dataset or to the resolution specified as in argument.
 
-This script will reslice the volume to match the desired shape. To pad or crop,
-use scil_volume_reshape.py.
-
+This script will reslice the volume to match the desired shape.
+
+To:
+    - pad or crop the volume to match the desired shape, use
+      scil_volume_reshape.py.
+    - reslice a volume to match the shape of another, use
+      scil_volume_reslice_to_reference.py.
+    - crop a volume to remove empty space, use scil_volume_crop.py.
 Formerly: scil_resample_volume.py
 """
 
diff --git a/scripts/scil_volume_reshape.py b/scripts/scil_volume_reshape.py
index 7fb8b79b5..c6d655412 100644
--- a/scripts/scil_volume_reshape.py
+++ b/scripts/scil_volume_reshape.py
@@ -8,7 +8,12 @@
 specified resolution.
 
 This script will pad or crop the volume to match the desired shape.
-To interpolate, use scil_volume_resample.py.
+To
+    - interpolate/reslice to an arbitrary voxel size, use
+      scil_volume_resample.py.
+    - reslice a volume to match the shape of another, use
+      scil_volume_reslice_to_reference.py.
+    - crop a volume to constrain the field of view, use scil_volume_crop.py.
 """
 
 import argparse
diff --git a/scripts/scil_volume_reslice_to_reference.py b/scripts/scil_volume_reslice_to_reference.py
index bb96a0775..36bdc1d56 100755
--- a/scripts/scil_volume_reslice_to_reference.py
+++ b/scripts/scil_volume_reslice_to_reference.py
@@ -9,6 +9,13 @@
 >>> scil_volume_reshape_to_reference.py 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.py.
+    - interpolate/reslice to an arbitrary voxel size, use
+      scil_volume_resample.py.
+    - crop a volume to remove empty space, use scil_volume_crop.py.
+
 Formerly: scil_reshape_to_reference.py
 """