Skip to content

Add explanation of coverage dimensions in documentation#221

Open
chris-little wants to merge 3 commits intomasterfrom
chris-little-4D
Open

Add explanation of coverage dimensions in documentation#221
chris-little wants to merge 3 commits intomasterfrom
chris-little-4D

Conversation

@chris-little
Copy link
Copy Markdown
Contributor

Clarify the limits of coverage domain dimensions in CoverageJSON. Addresses Issue #220

Clarify the limits of coverage domain dimensions in CoverageJSON.
Addresses Issue #220
@chris-little chris-little added Priority 1 Highly desirable V1.0.1 labels May 5, 2026
@chris-little chris-little requested review from ghobona and jonblower May 5, 2026 16:59
Clarify coverage definition and expand on dimensions and parameters.
@chris-little
Copy link
Copy Markdown
Contributor Author

At CoverageJSON Community Group om 2026-05-06 agree to merge PR.


A sophisticated use case is to use tiling objects, where the data values are partitioned spatially and temporally, so that a single variable’s data values would be split among several documents. A simple example of this use case is encoding each time step of a dataset into a separate file, but the tiles could also be divided spatially in a manner similar to a tiled map server.

The abstract, conceptual, definition of a coverage allows its Domain to have any number of coordinate dimensions, such 1 (e.g. a timeseries), 2 (e.g. an area), 3 (e.g. a volume), 4 (e.g. an animated, multi-band, satellite image) or more. Similarly, a coverage can have multiple ranges or parameters (e.g. pressure, temperature and humidity across a domain). The CoverageJSON Standard supports this definition but the convenient, predefined Domain Types are currently restricted to 4 spatio-temporal dimensions (x,y,z,t).
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should probably say, "... predefined Domain Types are currently restricted to a maximum of 4 spatio-temporal dimensions..."

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Priority 1 Highly desirable V1.0.1

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants