[DOC] Improve warnings for BIDS folders

[Remi-Gau]

• Closes improve warning for data folder in first_level_from_bids #4252

Changes proposed in this pull request:

• indicate folder where subjects were not found
• increase stack level of several warnings
• add error when no subject was found
• use absolute path

[github-actions]

👋 @Remi-Gau Thanks for creating a PR!

Until this PR is ready for review, you can include the [WIP] tag in its title, or leave it as a github draft.

Please make sure it is compliant with our contributing guidelines. In particular, be sure it checks the boxes listed below.

• PR has an interpretable title.
• PR links to Github issue with mention Closes #XXXX (see our documentation on PR structure)
• Code is PEP8-compliant (see our documentation on coding style)
• Changelog or what's new entry in doc/changes/latest.rst (see our documentation on PR structure)

For new features:

• There is at least one unit test per new function / class (see our documentation on testing)
• The new feature is demoed in at least one relevant example.

For bug fixes:

• There is at least one test that would fail under the original bug conditions.

We will review it as quick as possible, feel free to ping us with questions if needed.

[Remi-Gau]

@michellewang

let me know if this makes sense

[Remi-Gau]

example output of a failed run

/home/remi/github/origami/cohort_creator/demo/code/run_glm.py:16: UserWarning: 
Subject label aa is not present in the following dataset and cannot be processed:
 /home/remi/github/origami/cohort_creator/demo/outputs/study-ds000208/derivatives/fmriprep-21.0.2
  ) = first_level_from_bids(
Traceback (most recent call last):
  File "/home/remi/github/origami/cohort_creator/demo/code/run_glm.py", line 16, in <module>
    ) = first_level_from_bids(
        ^^^^^^^^^^^^^^^^^^^^^^
  File "/home/remi/github/nilearn/nilearn/nilearn/glm/first_level/first_level.py", line 1403, in first_level_from_bids
    raise RuntimeError(f"\nNo subject found in:\n {derivatives_path}")
RuntimeError: 
No subject found in:
 /home/remi/github/origami/cohort_creator/demo/outputs/study-ds000208/derivatives/fmriprep-21.0.2

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Comparison is base (8d0ef5b) 92.06% compared to head (fade2c8) 92.06%.
Report is 1 commits behind head on main.

Additional details and impacted files

@@           Coverage Diff           @@
##             main    #4253   +/-   ##
=======================================
  Coverage   92.06%   92.06%           
=======================================
  Files         144      144           
  Lines       16419    16423    +4     
  Branches     3434     3435    +1     
=======================================
+ Hits        15116    15120    +4     
  Misses        761      761           
  Partials      542      542           

Flag	Coverage Δ
macos-latest_3.10_test_plotting	91.85% <100.00%> (?)
macos-latest_3.11_test_plotting	91.85% <100.00%> (+<0.01%)	⬆️
macos-latest_3.12_test_plotting	?
macos-latest_3.8_test_plotting	91.81% <100.00%> (+<0.01%)	⬆️
macos-latest_3.9_test_plotting	91.82% <100.00%> (+<0.01%)	⬆️
ubuntu-latest_3.10_test_plotting	91.85% <100.00%> (+<0.01%)	⬆️
ubuntu-latest_3.11_test_plotting	91.85% <100.00%> (+<0.01%)	⬆️
ubuntu-latest_3.12_test_plotting	91.85% <100.00%> (+<0.01%)	⬆️
ubuntu-latest_3.12_test_pre	91.85% <100.00%> (+<0.01%)	⬆️
ubuntu-latest_3.8_test_min	68.95% <100.00%> (+<0.01%)	⬆️
ubuntu-latest_3.8_test_plot_min	91.56% <100.00%> (+<0.01%)	⬆️
ubuntu-latest_3.8_test_plotting	91.81% <100.00%> (+<0.01%)	⬆️
ubuntu-latest_3.9_test_plotting	91.82% <100.00%> (+<0.01%)	⬆️
windows-latest_3.10_test_plotting	91.83% <100.00%> (+<0.01%)	⬆️
windows-latest_3.11_test_plotting	91.83% <100.00%> (+<0.01%)	⬆️
windows-latest_3.12_test_plotting	91.83% <100.00%> (+<0.01%)	⬆️
windows-latest_3.8_test_plotting	91.79% <100.00%> (+<0.01%)	⬆️
windows-latest_3.9_test_plotting	91.80% <100.00%> (+<0.01%)	⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[bthirion]

Did not sport any issue. Thx !

[michellewang]

@michellewang
let me know if this makes sense

Realized that I forgot to get back to you 😅 but yes the error message looks good to me!