Skip to content

Rename CoordinateOutputMode.SINGLE_OUTPUT to MERGED (4.2.0)#152

Merged
clemsgrs merged 1 commit into
mainfrom
rename-single-output-mode
Jun 22, 2026
Merged

Rename CoordinateOutputMode.SINGLE_OUTPUT to MERGED (4.2.0)#152
clemsgrs merged 1 commit into
mainfrom
rename-single-output-mode

Conversation

@clemsgrs

@clemsgrs clemsgrs commented Jun 22, 2026

Copy link
Copy Markdown
Owner

What

Rename the coordinate output-mode value single_outputmerged, and the constant CoordinateOutputMode.SINGLE_OUTPUTCoordinateOutputMode.MERGED, across code, tests, and docs. Bumps version 4.1.04.2.0.

Why

single_output was the odd one out: hs2p's internals already speak "merged" (merged_coords, _merge_*, and the merged process-list row label). Aligning the public name with that vocabulary reads more clearly.

Breaking change

CoordinateOutputMode.SINGLE_OUTPUT and the config value tiling.masks.output_mode: single_output are removed with no backward-compat alias.

Migration: use CoordinateOutputMode.MERGED / output_mode: merged.

A merged artifact now carries output_mode="merged" and the process-list label annotation="merged" — the two intentionally coincide ("merged-mode row, labeled merged").

Verification

  • All sampling / output-mode tests pass (110/110).
  • Full suite: 318 passed. The only failures (20, in tests/test_standalone_mask_pyramid.py) are pre-existing and unrelated — a missing scripts/generate_tissue_mask_pyramid.py in the environment; that file is byte-identical to main.

Downstream

Unblocks slide2vec's annotation-aware feature extraction (slide2vec issue #154 targets the 4.2.0 release and uses output_mode: merged).

Rename the coordinate output-mode value `single_output` -> `merged`
(and the constant `CoordinateOutputMode.SINGLE_OUTPUT` ->
`CoordinateOutputMode.MERGED`) so the public name matches hs2p's existing
internal vocabulary (`merged_coords`, `_merge_*`, the `merged` process-list
row label) and reads more clearly than `single_output`.

BREAKING CHANGE: `CoordinateOutputMode.SINGLE_OUTPUT` and the config value
`tiling.masks.output_mode: single_output` are removed with no alias.
Migration: use `CoordinateOutputMode.MERGED` / `output_mode: merged`.

A merged artifact now carries `output_mode="merged"` and the process-list
label `annotation="merged"` (the two intentionally coincide).

Bumps version 4.1.0 -> 4.2.0.

Co-Authored-By: Claude Opus 4.8 <[email protected]>
@clemsgrs
clemsgrs merged commit f2b312f into main Jun 22, 2026
1 check passed
@clemsgrs
clemsgrs deleted the rename-single-output-mode branch June 22, 2026 21:11
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