Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Clarify dimension order in the specs #197

Open
jkh1 opened this issue May 9, 2023 · 2 comments
Open

Clarify dimension order in the specs #197

jkh1 opened this issue May 9, 2023 · 2 comments

Comments

@jkh1
Copy link

jkh1 commented May 9, 2023

There is some confusion about what the specs say about image dimension order. It's been understood either to be arbitrary as defined in the metadata or fixed at t,c,z,y,x. Now I'm told that the specs should read first t, then c, then arbitrary space dimensions order which is indeed what careful reading of the specs would lead to.
I would suggest to amend the sentence:
"All image arrays must be up to 5-dimensional with the axis of type time before type channel, before spatial axes."
to make it clear it's independent from the t,c,z,y,x example.
maybe something like:
"All image arrays must be up to 5-dimensional with the axis of type time before type channel, before spatial axes which can be in arbitrary order".
Also make it clearer in the multiscale metadata section, in particular the following sentence:
"If there are three spatial axes where two correspond to the image plane ("yx") and images are stacked along the other (anisotropic) axis ("z"), the spatial axes SHOULD be ordered as "zyx"."
should also mention that in the case of two spatial dimensions, order is arbitrary or should/must be "yx".
Alternatively, since so far all examples I've seen use t,c,z,y,x, maybe the specs should simply fix the spatial dimensions order to z,y,x.

@jkh1 jkh1 changed the title Clarify order dimension order in the specs Clarify dimension order in the specs May 9, 2023
@will-moore
Copy link
Member

My understanding is that if there are 2 dimensions then they SHOULD be yx, which I see is not explicitly stated in the spec.
This could be stated more clearly after the "If there are three spatial axes..." sentence.

Therefore I don't think that we should add "...which can be in arbitrary order" to describe the spatial axes in the t,c,z,y,x example.
Does that make sense?

@jkh1
Copy link
Author

jkh1 commented May 9, 2023

Yes so I think this is equivalent to saying the order SHOULD be t,c,z,y,x. In this case it should also say either that any dimension is optional or there MUST be at least two spatial dimensions (i.e. can we store just one dimension only e.g. or any two e.g. t,x though we can debate whether this is still an image?)

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

No branches or pull requests

2 participants