developmentseed / developmentseed/titiler-covjson

Support TiledNdArray range encoding for large coverages

Open
#66 0 comments 0 reactions 0 assignees View on GitHub
deferred
Dominant language
Python
Stars
1
Forks
1
Avg merge
2d 1h
Merged PRs (30d)
12

Description

When a Grid coverage's values array is impractically large to send inline, deliver the range as a CoverageJSON `TiledNdArray` (a `TileSet` with a URL template) instead of an inline `NdArray`, so clients can fetch tiles progressively.

ADR-0004 names `TiledNdArray` as the standard mechanism for tiled delivery of a large coverage -- and as the reason a separate XYZ `/tiles` route was dropped -- but no issue tracked it, so this files it (found by the roadmap-realignment audit; was Story 12).

## Scope

- `TileSet` URL-template generation for a coverage's range.
- A threshold at which the modeler emits `TiledNdArray` instead of `NdArray` (e.g., output cells above a configurable ceiling).
- Optionally, a per-tile backing resource that the URL template points at.
- Tests, including schema validation of the tiled range.

`covjson-pydantic` 0.8.0 already ships `TiledNdArrayFloat` / `TiledNdArrayInt` and `TileSet`.

## Status

Deferred (P3): no consumer needs it yet. No milestone -- a deferred remainder, filed so ADR-0004's reference is not dangling. Schedule when a concrete large-coverage need arises.

Contributor guide

No contributing guide indexed for this repository

Research direction

Start with ADR-0004 and locate the Grid coverage modeler that serializes the range, then inspect existing schema-validation tests and the available covjson-pydantic TiledNdArray and TileSet types. Done means a configurable size threshold selects a valid tiled range representation, with URL-template backing and tests covering schema validation.

Written by the indexing model from the issue text.

Assessment

Tech stack
python
Domain
api
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.