Added a comparison panel to the CycleBlock for displaying multiple files for comparison

[be-smith]

Adds a panel for comparison - handles legends and different colourmaps for different files etc.

Future add-ons

1. Add a mass for each file (probably needs to be its own analysis block or page for this - could grab the mass from each sample or cell you select for analysis
2. Different cycle plotting per file - I haven't played around with selecting different cycles for analysis from each file yet.
3. dQ/dV analysis where you can sum two profiles together to see how they fit to a full cell (again a much more complicated block)

[Copilot]

Pull Request Overview

This PR adds a comparison panel to the CycleBlock for displaying multiple files for comparison. The changes replace the binary toggle between single and multi-file modes with a three-option button group and implement proper comparison functionality with distinct colormaps and legends for each file.

• Replaced binary mode toggle with three-mode selection: Single File, Multi File Stitch, and Comparison
• Added comparison plotting functionality with unique colormaps per file and proper legends
• Enhanced hover tooltips to include filename information in comparison mode

Reviewed Changes

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

File	Description
webapp/src/components/datablocks/CycleBlock.vue	Replaces binary toggle with three-mode button group and updates logic to handle comparison mode
pydatalab/src/pydatalab/bokeh_plots.py	Adds comparison mode support with unique colormaps per file and enhanced legends/tooltips
pydatalab/src/pydatalab/apps/echem/utils.py	Adds .copy() calls to prevent DataFrame mutation warnings
pydatalab/src/pydatalab/apps/echem/blocks.py	Implements comparison mode data loading and processing logic

Comments suppressed due to low confidence (1)

pydatalab/src/pydatalab/apps/echem/blocks.py:1

• The variable 'cycle_summary' is not defined in this scope. This appears to be a leftover from the old single DataFrame approach. Should check 'cycle_summary_dfs' instead.

import os

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

[Copilot]

The hover source uses 'cycle index' from cycle_summary but maps it to 'full cycle' key. This is inconsistent with other parts of the code that use 'full cycle' column. Should use cycle_summary['full cycle'] instead of cycle_summary['cycle index'].

[cypress]

datalab    Run #3939

Run Properties:   Passed #3939  •  743e771f52 ℹ️: Merge bf98500d3ccdbc3db03d48f6793b3b3fc1da4a5e into b121182e7a2c4ca1eebd268ed0b8...

Project	datalab
Branch Review	bes/echem_analysis_panel
Run status	Passed #3939
Run duration	07m 09s
Commit	743e771f52 ℹ️: Merge bf98500d3ccdbc3db03d48f6793b3b3fc1da4a5e into b121182e7a2c4ca1eebd268ed0b8...
Committer	Ben Smith
View all properties for this run ↗︎

---

Test results
Failures	0
Flaky	0
Pending	0
Skipped	0
Passing	336
View all changes introduced in this branch ↗︎

[codecov]

Codecov Report

❌ Patch coverage is 62.80992% with 45 lines in your changes missing coverage. Please review.
✅ Project coverage is 79.79%. Comparing base (b121182) to head (bf98500).

Files with missing lines	Patch %	Lines
pydatalab/src/pydatalab/bokeh_plots.py	52.85%	33 Missing ⚠️
pydatalab/src/pydatalab/apps/echem/blocks.py	77.55%	11 Missing ⚠️
pydatalab/src/pydatalab/apps/echem/utils.py	50.00%	1 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #1353      +/-   ##
==========================================
- Coverage   80.10%   79.79%   -0.32%     
==========================================
  Files          70       70              
  Lines        4755     4825      +70     
==========================================
+ Hits         3809     3850      +41     
- Misses        946      975      +29     

Files with missing lines	Coverage Δ
pydatalab/src/pydatalab/apps/echem/utils.py	80.76% <50.00%> (ø)
pydatalab/src/pydatalab/apps/echem/blocks.py	78.84% <77.55%> (+2.61%)	⬆️
pydatalab/src/pydatalab/bokeh_plots.py	79.32% <52.85%> (-6.78%)	⬇️

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[jdbocarsly]

This is a cool step forward. I would like to maintain a differentiation in the UI between the one (or multiple stiched) data sets that the block is keeping track of, and the one or more samples that are being compared to it. So, instead of having it as a tabbed option, I think we should have an option on the main tab to add additional comparisons to the graph only. The block itself is in charge of keeping track of the main experiment along with any experimental details/metadata, and displaying additional comparisons is a helpful additional feature.

This is the same thing we discussed with the XRD block, which currently has a similar issue.

[be-smith]

I've split up the "main" block files and the comparison files into different file selectors. They are also stored as different fields:
file_ids
comparison_file_ids

The UI could use some work still but is this approach a good response to your comments @jdbocarsly ?

The next entension is I think a sample selector rather than a file selector so you're grabbing files from other samples or blocks like we discussed in the meeting

[jdbocarsly]

yeah, that's exactly what I was imagining! And yes, agree that some way of grabbing the trace from another sample would be good (and that way you can normalize by the correct mass, ideally).

By the way, while you are at this-- would it be easy to add a second x- axis to the echem capacity vs voltage plot, which has capacity in units of Li (or Na) transferred per mol? We store the molar mass if the user has put in a formula, so I think in principle this should be pretty straightforward. For generality, I would probably call it something like "e– transferred/mol". We would often express it as "x in LixCoO2," but that gets hard to generalize since there are different starting points. This could be in a separate PR if that is cleaner.

[be-smith]

Yeah that should be doable, but yes might be a future PR

[Copilot]

Pull Request Overview

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

Comments suppressed due to low confidence (1)

pydatalab/src/pydatalab/bokeh_plots.py:844

• Variable cycle_summary is undefined in this context. It should be cycle_summary_dfs to match the updated function signature.

        if cycle_summary is not None:

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}