[ENH] Annotations in dss_line_iter plots and specification of a saving path

[eliasbenyahia]

Modified annotations of dss_line_iter plots when show=True:

• added a legend to the mean PSD across trials and sensors plot
• rotated the Residuals plot
• changed title of the Iterations plot to "Aggregated residuals"
• added x and y labels to all plots

In dss_line_iter function:

• removed the 'prefix' parameter
• added a 'dirname' parameter
• added an 'extension' parameter

[nbara]

Tip: in your base directory, run make pep in the terminal and it will list linting errors before you commit

[Copilot]

Pull Request Overview

This PR enhances the dss_line_iter plotting annotations and refactors how output figures are saved, as well as updates tests and examples to match the new API.

• Improved plot labels, titles, and added a legend for clarity.
• Removed the prefix parameter; introduced dirname and extension for saving control.
• Updated tests and example script to use the new dirname argument.

Reviewed Changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 4 comments.

File	Description
tests/test_dss.py	Switched from prefix to dirname, adjusted fline, and updated test calls.
meegkit/dss.py	Modified dss_line_iter signature, plotting annotations, and save logic.
examples/example_dss_line.py	Reordered keyword args and added show=True; needs updating for dirname.

Comments suppressed due to low confidence (1)

tests/test_dss.py:152

• Add a test case to verify that files are saved correctly with the specified extension and naming pattern when dirname is provided.

out, _ = dss.dss_line_iter(x, fline + 1, sr, show=True, dirname=tmpdir)

[eliasbenyahia]

Tip: in your base directory, run make pep in the terminal and it will list linting errors before you commit

Ok thanks ! Sorry I don't contribute a lot

[nbara]

No worries at all, happy to help!

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 82.97%. Comparing base (5a9a826) to head (5f0ea01).
Report is 1 commits behind head on master.

Additional details and impacted files

@@            Coverage Diff             @@
##           master      #89      +/-   ##
==========================================
+ Coverage   82.87%   82.97%   +0.10%     
==========================================
  Files          25       25              
  Lines        2815     2826      +11     
==========================================
+ Hits         2333     2345      +12     
+ Misses        482      481       -1     

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

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[eliasbenyahia]

Hey @nbara,
I think that the code is now fine. What are the next steps ?

Elias

[nbara]

Thanks @eliasbenyahia !