[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)
• 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

• My code follows the style guidelines of this project (run autopep8)
• I added relevant citations to scripts, modules and functions docstrings and descriptions
• I have performed a self-review of my code
• I have commented my code, particularly in hard-to-understand areas
• I have made corresponding changes to the documentation
• My changes generate no new warnings
• 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]

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

@@            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	Coverage Δ
Scripts	68.98% <45.23%> (+0.92%)	⬆️
Library	66.48% <40.00%> (+1.16%)	⬆️

[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.')