[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!