Skip to content

fix: describe byDimension axes as indices, and a typo in image.schema - #195

Merged
jo-mueller merged 2 commits into
ome:mainfrom
vboussot:fix-bydimension-axes-description
Aug 28, 2026
Merged

fix: describe byDimension axes as indices, and a typo in image.schema#195
jo-mueller merged 2 commits into
ome:mainfrom
vboussot:fix-bydimension-axes-description

Conversation

@vboussot

Copy link
Copy Markdown
Contributor

Two description fixes in the schemas, against 0.9dev as suggested in fideus-labs/ngff-zarr#686.

coordinate_transformations.schema

The byDimension child transformations describe inputAxes and outputAxes as "Names of the ... axes", while both arrays are typed number. The spec text is already unambiguous that these are positions:

  • the transformation table (index.md:474) gives "inputAxes": List[number] and "outputAxes": List[number]
  • index.md:1229: "The values of inputAxes and outputAxes are arrays of integers."
  • index.md:1234 requires every axis index of the parent output coordinate system to appear in exactly one child outputAxes array
  • tests/attributes/spec/invalid/transforms/bad_byDimension_wrong axes_type.json uses ["x"] and ["y"] precisely so that it is rejected

So it is the description that is out of sync, not the item type. That is #179, answered in its thread by @jo-mueller.

image.schema

"A sequence of a ingle scale followed by a single translation" now reads "a single scale".

Both changes are description text only, so no document changes validity.

Noticed while vendoring the 0.9.dev1 schemas into ngff-zarr, where they are used verbatim to back validate=True.

Closes #179

@github-actions

Copy link
Copy Markdown

Automated Review URLs

@vboussot vboussot changed the title fix: describe byDimension inputAxes and outputAxes as indices fix: describe byDimension axes as indices, and a typo in image.schema Aug 26, 2026
@jo-mueller

Copy link
Copy Markdown
Contributor

@vboussot thanks for the fix. I think this can go into the main branch. Also, feel free to add your name to the authors! (see contrib section on how/where to make the change).

vboussot added a commit to fideus-labs/ngff-zarr that referenced this pull request Aug 27, 2026
Both are description text, so no document changes validity.

"A sequence of a ingle scale followed by a single translation" in
image.schema, present since 0.6rc0. And byDimension describing inputAxes and
outputAxes as names of axes, while both arrays are typed number: the spec
text says positions in three places, and ngff-spec ships an invalid fixture
using ["x"] so that names are rejected.

Both are proposed upstream in ome/ngff-spec#195 against the 0.9dev branch;
these copies carry them until a later tag brings them back.
The two descriptions read "Names of the input axes" and "Names of the
output axes" while both arrays hold numbers. The spec text is already
explicit that these are positions: the transformation table gives
"inputAxes": List[number], the byDimension section states that the
values are arrays of integers, and tests/attributes/spec/invalid holds
a fixture that uses axis names precisely so it is rejected.

Also fixes a typo in the sequence description of image.schema.

Closes ome#179
CITATION.cff regenerated with `jupyter book build --cff`, as the
contribution guide asks.
@vboussot
vboussot force-pushed the fix-bydimension-axes-description branch from 4f59cae to 8ffd84e Compare August 27, 2026 09:38
@vboussot
vboussot changed the base branch from 0.9dev to main August 27, 2026 09:38
vboussot added a commit to fideus-labs/ngff-zarr that referenced this pull request Aug 27, 2026
"Indices", which is what ome/ngff-spec#195 settles on, rather than the
"Positions" this copy carried: a later tag then brings the same sentence
back instead of a second wording.
@vboussot

vboussot commented Aug 27, 2026

Copy link
Copy Markdown
Contributor Author

Thanks @jo-mueller. Retargeted to main, and added myself to authors.yml

@jo-mueller
jo-mueller merged commit eb227a4 into ome:main Aug 28, 2026
2 checks passed
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.

[Issue]: byDimension schema and description may be out of sync

3 participants