← All samples

Walkthrough

Decide whether Zarr, NetCDF, or HDF5 is ready

A preview-only maturity review for multidimensional formats. It is deliberately non-runnable and non-GA: server source evidence exists, but no JavaScript adapter or public end-to-end canary closes the path.

Server contract first

Review multidimensional format maturity before choosing an executable coverage workflow

source-preview
Fixture endpoint
No runnable endpoint admitted
Service manifest key
Not admitted
Evidence
unavailable at honua-server:61b7038e1887c98131aa217b6f0ae7869356a1f3 + 639d37449fb8da5e9df4b12b7641ba4c6c5ac581
Server version
Pinned source evidence only; no admitted public deployment
Owner
honua-server owns server maturity; honua-sdk-js owns any future public client; honua-samples owns this truthful curriculum projection
Support
Preview-only architecture guidance; not a support claim

Authentication

No runnable request is admitted. Existing registration evidence is administrative and must not be presented as anonymous read support.

Cancellation

Not applicable because this page executes no request.

Errors

Treat unavailable, metadata-only, experimental, and missing-canary states as release blockers; never fall back to a browser full-file download.

Server capability IDs

Multidimensional Coverage (NetCDF/HDF5/Zarr) (raster.multidim-coverage)

contract-only

zarr-v2-v3

N/A No public endpoint admitted by this walkthrough

Registration, bounded subset internals, CoverageJSON, WCS fixtures, and datacube components are source evidence only. They do not create a public client workflow.

Raw request
{
  "method": "N/A",
  "endpoint": "No public endpoint admitted by this walkthrough",
  "payload": {
    "state": "withheld",
    "reason": "No bounded JavaScript client or positive public Zarr canary"
  }
}

Expected response
{
  "client": "unavailable",
  "server": "experimental",
  "endToEnd": "unavailable"
}

contract-only

netcdf4

N/A Administrative registration and build-optional conversion evidence only

Registration metadata and optional GDAL conversion do not prove readable NetCDF variables or subsets.

Raw request
{
  "method": "N/A",
  "endpoint": "Administrative registration and build-optional conversion evidence only",
  "payload": {
    "state": "withheld",
    "reason": "No stable public variable or bounded subset operation"
  }
}

Expected response
{
  "client": "unavailable",
  "server": "metadata-only",
  "endToEnd": "unavailable"
}

contract-only

geospatial-hdf5

N/A Administrative registration and conversion architecture evidence only

HDF5 is not inherently geospatial. Only a future documented coverage mapping could enter scope.

Raw request
{
  "method": "N/A",
  "endpoint": "Administrative registration and conversion architecture evidence only",
  "payload": {
    "state": "withheld",
    "reason": "No pinned HDF5 driver matrix or bounded public read contract"
  }
}

Expected response
{
  "client": "unavailable",
  "server": "metadata-only",
  "endToEnd": "unavailable"
}

Normalized semantics

Normalized request
{
  "operation": "maturity-review",
  "formats": [
    "zarr-v2-v3",
    "netcdf4",
    "geospatial-hdf5"
  ],
  "runtime": "none"
}

Expected result
{
  "zarr": {
    "client": "unavailable",
    "server": "experimental",
    "endToEnd": "unavailable"
  },
  "netcdf4": {
    "client": "unavailable",
    "server": "metadata-only",
    "endToEnd": "unavailable"
  },
  "geospatialHdf5": {
    "client": "unavailable",
    "server": "metadata-only",
    "endToEnd": "unavailable"
  }
}

Semantic assertionThe page offers no Run action, executable code, live claim, GA badge, invented API, or full-file browser fallback; use the supported Coverages/WCS recipe for current runnable multidimensional curriculum.

Evidence

  • honua-sdk-js@d68f221a3ee49b86f06f0d587faf2c627263283d/config/multidimensional-format-maturity.v1.json
  • Zarr server evidence pinned to honua-server@639d37449fb8da5e9df4b12b7641ba4c6c5ac581
  • NetCDF-4 and geospatial HDF5 server evidence pinned to honua-server@61b7038e1887c98131aa217b6f0ae7869356a1f3

Limits and blockers

  • Zarr client and end-to-end states are unavailable; the server state is experimental and lacks a positive public canary.
  • NetCDF-4 and geospatial HDF5 client and end-to-end states are unavailable; server evidence is metadata-only and build-optional.
  • There is no public JavaScript adapter, runnable sample, stable bounded variable/subset contract, immutable live fixture, Studio action, or CLI command for these formats.
  • Geospatial HDF5 means only datasets that map to a documented coverage model; arbitrary HDF5 group browsing is out of scope.

Server references

Ordered job walkthrough

Complete the lifecycle deliberately.

  1. contract-onlySeparate client, server, and end-to-end maturity

    Read each layer independently; do not promote server source evidence into a client or deployed compatibility claim.

    Expected: Zarr resolves to unavailable / experimental / unavailable; NetCDF-4 and geospatial HDF5 resolve to unavailable / metadata-only / unavailable.

  2. contract-onlyCheck the publication gates

    Require immutable fixtures, stable versioned metadata and bounded subset operations, deployed canaries, resource budgets, typed client errors, and reviewed package exports.

    Expected: Every missing gate remains visible and prevents a runnable or GA claim.

  3. availableChoose the current executable path

    Use the separate fixture-backed OGC API Coverages / WCS quickstart when the learning task is a bounded coverage subset and MapLibre handoff.

    Expected: A runnable standards-based coverage example without implying native Zarr, NetCDF, or HDF5 client support.

  4. plannedRevisit only after evidence lands

    Add format-specific executable curriculum only after the corresponding SDK export, fixture, live service, error, cancellation, and budget receipts pass.

    Expected: A future runnable walkthrough is evidence-gated rather than inferred from architecture.

Final assertionThe page offers no Run action, executable code, live claim, GA badge, invented API, or full-file browser fallback; use the supported Coverages/WCS recipe for current runnable multidimensional curriculum.

Equivalent client surfaces

Choose a language without changing the job.

No public symbol
Unavailable - no pseudocode shown.

No Zarr connector, NetCDF adapter, HDF5 adapter, metadata reader, slice reader, tile client, or package export is public.

Exact reference matrix

Raw contract and public symbols

SurfaceOperation or symbolPackage and versionOwnership and behavior
Raw HTTPsource-previewconfig/multidimensional-format-maturity.v1.jsonHonua Server source evidence
min No public runtime version admitted - Preview only
honua-server
Auth: Administrative source evidence only; no request is shown.
Cancel: Not applicable.
Errors: Missing public contract or canary keeps the operation unavailable.
CLIgapGap: No admitted Zarr, NetCDF-4, or geospatial HDF5 CLI workflow exists.Not applicable
min n/a - Unavailable
Honua CLI
Auth: Not applicable.
Cancel: Not applicable.
Errors: Not applicable.
JavaScriptgapGap: No Zarr connector, NetCDF adapter, HDF5 adapter, metadata reader, slice reader, tile client, or package export is public.@honua/sdk-js
min n/a - Unavailable
honua-sdk-js
Auth: Not applicable.
Cancel: Not applicable.
Errors: Not applicable.
PythongapGap: This JavaScript SDK maturity handoff provides no evidence for a supported Python format adapter.Not applicable
min n/a - Not claimed
honua-sdk-python
Auth: Not applicable.
Cancel: Not applicable.
Errors: Not applicable.
.NETgapGap: This JavaScript SDK maturity handoff provides no evidence for a supported .NET format adapter.Not applicable
min n/a - Not claimed
honua-sdk-dotnet
Auth: Not applicable.
Cancel: Not applicable.
Errors: Not applicable.

Console configuration

Planned UI, raw contract only

Route
Not implemented
Required role
Not defined
Visual receipt
Not captured
Searchable equivalent configuration
{
  "runtime": "none",
  "reason": "Preview-only maturity guidance"
}

No screenshot published.

No console or runtime screenshot is published for this preview-only walkthrough. This remains not-applicable until a real route and golden receipt exist.

Optional AI context - not-applicable

No executable Honua AI surface admitted

Allowed drafting tasks

    Context inputs

      Provider and data boundary

      No AI provider or model is involved.

      Injection and privacy boundary

      No data, credentials, endpoints, or source objects are submitted.

      Deterministic validation

      Schema and gallery tests verify the static maturity contract.

      Approval boundary

      Any future runtime or support promotion requires normal product review and evidence admission.

      Prohibited autonomous actions

      • execute without required human approval

      Fallback and provenance

      Use the pinned maturity manifest and the runnable Coverages/WCS recipe.

      All maturity statements are bound to the exact SDK and server source revisions named above.