Aggregated Signal Figure

Aggregated Signal Figure Skill

Rules (project-specific)

• Create one plot per script: script/vis_<plotname>.py.
• Use polars for all data IO/processing (do not use pandas).
• Keep visualization style parameters inside each script (top-level VizConfig/CONSTANTS).
• Read only the following from config.yaml:
  • data paths / join keys: data.*
  • EMG muscle/channel order: signal_groups.emg.columns
  • channel-grid layout: signal_groups.<group>.grid_layout
  • analysis windows: windows.definitions (when needed)
  • summary-grid layout: figure_layout.summary_plots.<plot_type>.max_cols
  • output base dir: output.base_dir
• Do not read config.yaml: plot_style in new vis_*.py scripts (keep style in the script).
• Always include a legend inside each subplot (use ax.legend(...), not fig.legend(...)).

Grid policy

• Channel plots (EMG/forceplate):
  • Build rows, cols = config["signal_groups"][group]["grid_layout"].
  • Create plt.subplots(rows, cols, ...), flatten axes, fill per channel order.
  • Hide unused subplots with ax.axis("off").
  • Include subplot legend in each subplot.
• Summary plots (onset/boxplot/etc):
  • Build a panel list (e.g., facet values).
  • Read max_cols = config["figure_layout"]["summary_plots"][plot_type]["max_cols"].
  • Compute cols = min(max_cols, n_panels) and rows = ceil(n_panels / cols).
  • Create a grid and hide unused axes (same off-policy).
  • Include subplot legend for each panel when labels exist.

Output policy

• Save under Path(config["output"]["base_dir"]) / <plot_type> / <filename>.png.
• Always save as png with dpi=300, bbox_inches="tight", facecolor="white".
• Use deterministic naming (include the main grouping/facet/hue conditions in filename).

Refactor validation (MD5)

• Before refactoring an existing script, generate a reference output and record its MD5.
• After refactoring, rerun with the same inputs and compare MD5.
• If MD5 differs unexpectedly, treat it as a regression and fix (unless an intentional change is approved).

Templates

• Summary grid template: templates/summary_grid_template.py
• Channel grid template: templates/channel_grid_template.py
• Matplotlib style template (copy into each vis script): templates/mpl_style_template.py
• Vis script skeleton (copy/modify per plot): templates/vis_script_skeleton.py

Example PNGs (visual check)

• Summary plot example: assets/examples/example_onset_summary.png
• Channel-grid example: assets/examples/example_emg_channel_grid.png