Technical documentation
Use the visual gallery to browse the release first. This page is the compact route into building, projection mathematics, pass semantics, browser integration, verification, and preservation.
The gallery serves the selected image backend: the committed top-of-tree
snapshot under assets.tot/ (the live default) or the immutable v14 AAO
release, both containing 217 standard products across 33 pass IDs, including
the Network Groundstations pass and the dual-year Anthropocene
particulate/temperature families. The backend switch is build-time only and
recorded in .github/deploy-backend; Stage 15/16 research products remain
local and are documented without claiming they have been uploaded into an
AAO prefix.
Start, build, and generate
| Need | Documentation |
|---|---|
| Install compilers, libraries, data tools, and optional WebAssembly support | Prerequisites |
| Read the complete build graph, released artifact catalog, and resource metric classes | Build and generated artifacts |
| Map repository directories and individual source files | Source layout conventions |
| Generate SVG, PDF, PNG, thumbnails, slices, and projection families | Generation guide |
| Understand the selected profile, pass evaluation, and exact versus family workflows | Generation methods and decision record |
| Review the complete Stage 13 development manifest | Stage 13 convergence notes |
| Follow the Stage 14 plan, implementation changes, and verification evidence | Stage 14 convergence ledger |
| Review the closed GPU controls, Majuro full pass, and Anthropocene experiments | Stage 15 closed ledger, atoll report, and water-debris report |
| Plan compressed GPU evidence, additional consumers, atoll expansion, and agentic research iteration | Stage 16 development ledger |
| Inspect the implemented Equal Earth control, Africa-centered variant, and one-to-five slice queue | Stage 16J positioning comparisons |
| Authorize and generate credentialed external products | Configured generation, Cloud-atmosphere generation, and P-Tree production download |
Pass catalog and lifecycle
The resources metric catalog is the visible
index of all 59 resource metrics. It states both subject meaning and release
status; resources-profile.json
is the machine-readable authority.
| Class | Meaning |
|---|---|
| Standard pass | Reproducible without a credential or special acceptance, included in make all, and eligible for the next generated-assets release. A sealed older gallery may have a different standard composition. |
| Optional pass | Implemented but deliberately gated by credentials, license acceptance, or an operator decision. Authorization makes it eligible for subsequent configured generation. |
| Exploration only | Cataloged, proposed, or source-tested without a released production output. It is not silently generated and is not a missing release artifact. |
The current resource profile has 14 standard passes, no optional resource passes, and 45 exploration-only metrics. Project-wide optional products include the credentialed P-Tree Cloud-atmosphere pass and licensed network topology; NASA FIRMS remains an exploration input rather than a released optional pass. Pass maturity is a separate axis: the four current dual-year Anthropocene pass IDs are standard and default-generated with accepted-experimental maturity. The synthetic PurpleAir interface, bounded water-debris, and Majuro evidence products remain exploration-only. See the generation-pass overview and machine-readable pass-status manifest.
| Family | Documentation |
|---|---|
| Energy, food, fauna, flora, mineral, and human resources | Stage 12 resource implementation, metric catalog, and enrichment plan |
| Astronomy and observer instruments | Astronomy implementation |
| Orbital Technosphere | Orbital Technosphere implementation |
| Climate, weather, fire, smoke, and air quality | Anthropocene implementation and accepted-experimental status, source expansion, and enrichment plan |
| JAXA physical atmosphere | Cloud-atmosphere implementation |
| Network swarm and infrastructure | Network swarm and network infrastructure |
| Cleaned submarine-fiber union | Fiber Synthesized implementation |
| Bathymetry art systems | Bathymetry Roulette and Bathymetry Hamonshū |
Projection mathematics
Each projection has context, implementation, and source documents. Its contact sheet provides a visual test across very different data and path structures: 32 plates on the top-of-tree snapshot (31 standard passes plus the preview-only Cloud-atmosphere snapshot) and 31 standard passes on the immutable AAO backend.
Equal Earth is listed separately as a Stage 16J exploration control; it has five local comparison plates rather than a standard release gallery.
| Projection | Context | Implementation | Sources | Contact sheet |
|---|---|---|---|---|
| AuthaGraph | Context | Notes | Bibliography | Contact sheet |
| Cahill–Keyes | Context | Notes | Bibliography | Contact sheet |
| Dymaxion | Context | Notes | Bibliography | Contact sheet |
| Myriahedral | Context | Notes | Bibliography | Contact sheet |
| Star-X | Context | Notes | Bibliography | Contact sheet |
| Icosahedral Voronoi | Context | Notes | Bibliography | Contact sheet |
| Equal Earth (exploration only) | Context | Notes | Bibliography | Five comparisons |
Browser and embedding
| Need | Documentation |
|---|---|
| Use all six projections in WebAssembly, workers, SVG, Canvas, or D3 | WebAssembly quick start and runtime reference |
| Consume portable numeric cases or compare independent reverse implementations | Projection fixtures and reverse oracles |
| Check the standalone Equal Earth forward/reverse control and PROJ/D3 oracle bundle | Equal Earth implementation and Stage 16J comparisons |
| Select one standard artifact deterministically and retain a decision receipt | Artifact catalog and selection |
| Resolve a published artifact ID to a URL, verify a release, or follow the consumer workflows | v14 consumer release usage |
| Use structured forward points and face-qualified reverse candidates | Forward/reverse projection API |
| Plan machine-readable agent discovery and 1080p/Three.js derivatives without changing archive/art/print masters | AI Workflows assessment and 1080p gaming improvement plan |
| Review the approved Marshall Islands-to-new-experiment agent workflow | Stage 16 agentic atlas research plan |
| Understand the Stage 10 browser architecture and checks | Stage 10 WebAssembly notes |
| Follow a raster-backed overlay workflow | Web workflow and complete example |
| Inspect the immutable generated release without checking it into Git | Visual gallery, v14 AAO release record, and release marker |
Releases and preservation
| Need | Documentation |
|---|---|
| Publish a GitHub source release without invoking S3 | Release runbook and v20260811 |
| Deposit generated assets in UCB AAO through the separate human-invoked S3 target | Release runbook |
| Inspect v14 paths, formats, metadata, and verification | v14 AAO release record |
| Inspect the historical v13 deposit | v13 AAO publication |
| Read the corrected source and generated-assets release notes | v20260808.1 |
| Review source-data acquisition and attribution | Natural Earth data note and the family-specific implementation notes above |