Skip to content

Change Default join_method in BaseConsolidator from concat to stack - #52

Draft
genematx wants to merge 2 commits into
bluesky:mainfrom
genematx:default-stacking
Draft

Change Default join_method in BaseConsolidator from concat to stack#52
genematx wants to merge 2 commits into
bluesky:mainfrom
genematx:default-stacking

Conversation

@genematx

Copy link
Copy Markdown
Contributor
  1. Changes the default joining method.
  2. Issues a warning that concat is deprecated; CSVConsolidator, for which concat` is the only naturally suitable option remains unchanged.

To be merged and released following #51.

genematx added 2 commits July 24, 2026 14:52
When a StreamResource does not set join_method explicitly, the Consolidator
falls back to the class default, which is currently 'concat'. Emit a
DeprecationWarning in that case announcing that the default will change to
'stack' in a future version -- which alters the shape of the consolidated
dataset (a new leading dimension is added when stacking) -- so users can set
join_method explicitly and update their declared descriptor shapes in
advance.

The override of join_method/join_chunks from the StreamResource parameters
is moved ahead of the datum-shape computation, which depends on it.

Silence the (expected) warning at module level in the test modules whose
fixtures rely on the default, so the strict filterwarnings=["error"] policy
does not turn expected usage into errors.
Change the default join_method on ConsolidatorBase from 'concat' to
'stack'. 'concat' remains fully supported and can still be requested
explicitly via the StreamResource "join_method" parameter.

Preserve join_method through export: the exporter now infers the layout
from the total/datum shape relationship and persists it on the emitted
stream_resource so a round-trip reproduces the original structure.

Tests and example fixtures updated for the new default: concat-layout
fixtures either declare join_method='concat' explicitly (legacy /
multipart-hdf5) or are converted to stack-native descriptors so their
resulting shapes are unchanged; scalar 'stack' expectations collapse to
(N,) as before.
@genematx
genematx requested a review from thopkins32 July 24, 2026 20:26
@codecov

codecov Bot commented Jul 24, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 77.85%. Comparing base (913738a) to head (9cb0c0b).

Additional details and impacted files
@@            Coverage Diff             @@
##             main      #52      +/-   ##
==========================================
+ Coverage   77.74%   77.85%   +0.10%     
==========================================
  Files          15       15              
  Lines        2301     2303       +2     
==========================================
+ Hits         1789     1793       +4     
+ Misses        512      510       -2     

☔ View full report in Codecov by Harness.
📢 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.

@genematx genematx changed the title Change DEfault join_method in BaseConsolidator from concat to stack Change Default join_method in BaseConsolidator from concat to stack Aug 11, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant