[ENH] Add possibility to use a label mask with two values to cut streamlines

[arnaudbore]

Quick description

New way of cutting streamlines. Use a label image and select your IDs to cut streamlines ...

Type of change

Check the relevant options.

• [ ] Bug fix (non-breaking change which fixes an issue)
• [x] New feature (non-breaking change which adds functionality)
• [ ] Breaking change (fix or feature that would cause existing functionality to not work as expected)
• [ ] This change requires a documentation update

Provide data, screenshots, command line to test (if relevant)

...

Checklist

• [x] My code follows the style guidelines of this project (run autopep8)
• [x] I added relevant citations to scripts, modules and functions docstrings and descriptions
• [x] I have performed a self-review of my code
• [x] I have commented my code, particularly in hard-to-understand areas
• [x] I have made corresponding changes to the documentation
• [x] My changes generate no new warnings
• [x] I moved all functions from the script file (except the argparser and main) to scilpy modules
• [ ] I have added tests that prove my fix is effective or that my feature works
• [ ] New and existing unit tests pass locally with my changes

[codecov[bot]]

Codecov Report

Attention: Patch coverage is 44.68085% with 26 lines in your changes are missing coverage. Please review.

Project coverage is 67.99%. Comparing base (173f70b) to head (9c0c7b3). Report is 42 commits behind head on master.

Additional details and impacted files

```diff @@ Coverage Diff @@ ## master #945 +/- ## ========================================== + Coverage 66.98% 67.99% +1.00% ========================================== Files 396 397 +1 Lines 21396 21396 Branches 3251 3239 -12 ========================================== + Hits 14333 14549 +216 + Misses 5749 5532 -217 - Partials 1314 1315 +1 ``` | [Components](https://app.codecov.io/gh/scilus/scilpy/pull/945/components?src=pr&el=components&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=scilus) | Coverage Δ | | |---|---|---| | [Scripts](https://app.codecov.io/gh/scilus/scilpy/pull/945/components?src=pr&el=component&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=scilus) | `68.98% <45.23%> (+0.92%)` | :arrow_up: | | [Library](https://app.codecov.io/gh/scilus/scilpy/pull/945/components?src=pr&el=component&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=scilus) | `66.48% <40.00%> (+1.16%)` | :arrow_up: |

[pep8speaks]

Hello @arnaudbore, Thank you for updating !

• In the file scripts/scil_tractogram_cut_streamlines.py:

Line 164:80: E501 line too long (84 > 79 characters)

Comment last updated at 2024-04-10 18:58:04 UTC

[frheault]

It works well!

Could you add the parameters to use in the error message (--label_ids) parser.error('More than two values in the label file.')