1{2 "about": "The grounds every vector names. This is the shape issue #5 §5.4 de-globalizes into a `Ground` descriptor: a case that names its ground here is a case that has declared its inputs. Five grounds are hand-derived — the squares, the sphere every vector was worked out on, and the included Earth volume's own declaration — and two are read from the public corpus bundles under testdata/corpus/bundles/, so the descriptor a test stands on is the declaration a reader really meets. Both lanes consume this file: analysis/test/vectors.test.ts and tests/cells/conformance_test.go.",3 "reads": {4 "tileGridSize": "the volume's tile grid size — the world square, the last fallback for the surface",5 "lens.surface": "the lens's declared surface, preferred when present",6 "lens.bounds": "its raster window, used when no surface is declared",7 "world.attrs": "the semconv geometry keys: atlas.geometry.surface and the projection's px/deg mapping",8 "surfaceExtent": "derived: [minX, minY, maxX, maxY] in OL world coordinates, x east and y negative-down. Recorded so a candidate carrying the ground differently still has to land on these numbers.",9 "systems": "derived: which systems will divide this ground, in the navigator's order."10 },11 "grounds": {12 "test/square-1024": {13 "key": "test/square-1024",14 "about": "The unit square of the hand-derived suite: a 1024 world declaring the whole of itself as its lens surface, and no geometry attributes at all — the plane every geohash number in the suite was halved out of.",15 "tileGridSize": 1024,16 "lens": {17 "surface": {18 "x": 0,19 "y": 0,20 "width": 1024,21 "height": 102422 },23 "bounds": null24 },25 "world": {26 "attrs": {}27 },28 "surfaceExtent": [29 0,30 -1024,31 1024,32 033 ],34 "systems": [35 "geohash"36 ]37 },38 "test/square-1024-bounds": {39 "key": "test/square-1024-bounds",40 "about": "The same world with a lens that declares no surface, only a raster window: the fallback branch of surfaceExtent.",41 "tileGridSize": 1024,42 "lens": {43 "surface": null,44 "bounds": {45 "x": 128,46 "y": 256,47 "width": 512,48 "height": 25649 }50 },51 "world": {52 "attrs": {}53 },54 "surfaceExtent": [55 128,56 -512,57 640,58 -25659 ],60 "systems": [61 "geohash"62 ]63 },64 "test/square-1024-no-lens": {65 "key": "test/square-1024-no-lens",66 "about": "The same world with no lens at all: the last fallback, the whole world square.",67 "tileGridSize": 1024,68 "lens": null,69 "world": {70 "attrs": {}71 },72 "surfaceExtent": [73 0,74 -1024,75 1024,76 077 ],78 "systems": [79 "geohash"80 ]81 },82 "test/sphere-8192x4096": {83 "key": "test/sphere-8192x4096",84 "about": "The hand-derived sphere: the top half of an 8192 world square declared as a whole equirectangular ground. The S2 vectors — leaf 0x47a1cbd595522b39 and its level-10 parent 47a1cb — are the Go library's own, read through this declaration.",85 "tileGridSize": 8192,86 "lens": {87 "surface": {88 "x": 0,89 "y": 0,90 "width": 8192,91 "height": 409692 },93 "bounds": null94 },95 "world": {96 "attrs": {97 "atlas.geometry.surface": "sphere",98 "atlas.geometry.projection": "equirect",99 "atlas.geometry.equirect.px": "0,0,8192,4096",100 "atlas.geometry.equirect.deg": "-180,90,180,-90"101 }102 },103 "surfaceExtent": [104 0,105 -4096,106 8192,107 0108 ],109 "systems": [110 "geohash",111 "s2"112 ]113 },114 "test/earth-8192x4096": {115 "key": "test/earth-8192x4096",116 "about": "The included Earth volume's declaration, hand-derived from the shipped bundle: the same whole-sphere equirectangular window as the sphere above, carried as the lens's raster bounds rather than a declared surface, with the body and its radius named. The extra keys change nothing the systems read: a sphere naming the earth is still divided synthetically, and S2 still takes it.",117 "tileGridSize": 8192,118 "lens": {119 "surface": null,120 "bounds": {121 "x": 0,122 "y": 0,123 "width": 8192,124 "height": 4096125 }126 },127 "world": {128 "attrs": {129 "atlas.geometry.body": "earth",130 "atlas.geometry.equirect.deg": "-180,90,180,-90",131 "atlas.geometry.equirect.px": "0,0,8192,4096",132 "atlas.geometry.projection": "equirect",133 "atlas.geometry.radius_km": "6371.0088",134 "atlas.geometry.surface": "sphere"135 }136 },137 "surfaceExtent": [138 0,139 -4096,140 8192,141 0142 ],143 "systems": [144 "geohash",145 "s2"146 ]147 },148 "bend-or/2026-08-02/0": {149 "key": "bend-or/2026-08-02/0",150 "about": "Bend, Oregon — 2026-08-02, lens \"Basemap\". Read from the public corpus bundle at testdata/corpus/bundles/bend-or: a plane city that declares an earth Mercator window and names its body, so geohash divides it FOR REAL — genuine WGS84 addresses of the pictured ground, base depth 4 and floor 6 from the window's own 0.32909 x 0.23650 degree spans — and nothing else offers to.",151 "tileGridSize": 8192,152 "lens": {153 "surface": {154 "height": 8192,155 "width": 8192,156 "x": 0,157 "y": 0158 },159 "bounds": null160 },161 "world": {162 "attrs": {163 "atlas.geometry.body": "earth",164 "atlas.geometry.mercator.deg": "-121.48204667177453,44.17572950664809,-121.1529533282255,43.93922950850393",165 "atlas.geometry.mercator.px": "0,0,8192,8192",166 "atlas.geometry.surface": "plane"167 }168 },169 "provenance": {170 "volume": "bend-or",171 "world": "2026-08-02",172 "lens": "Basemap",173 "lensIndex": 0174 },175 "surfaceExtent": [176 0,177 -8192,178 8192,179 0180 ],181 "systems": [182 "geohash"183 ]184 },185 "mars/global/0": {186 "key": "mars/global/0",187 "about": "Mars — Global, lens \"Viking MDIM 2.1\". Read from the public corpus bundle at testdata/corpus/bundles/mars: the one shipped sphere, so the S2 answers here are answers about a declaration a reader really meets.",188 "tileGridSize": 8192,189 "lens": {190 "surface": {191 "height": 4096,192 "width": 8192,193 "x": 0,194 "y": 0195 },196 "bounds": {197 "height": 4096,198 "width": 8192,199 "x": 0,200 "y": 0201 }202 },203 "world": {204 "attrs": {205 "atlas.geometry.body": "mars",206 "atlas.geometry.equirect.deg": "-180,90,180,-90",207 "atlas.geometry.equirect.px": "0,0,8192,4096",208 "atlas.geometry.projection": "equirect",209 "atlas.geometry.surface": "sphere",210 "atlas.icon.outset": "dark"211 }212 },213 "provenance": {214 "volume": "mars",215 "world": "global",216 "lens": "Viking MDIM 2.1",217 "lensIndex": 0218 },219 "surfaceExtent": [220 0,221 -4096,222 8192,223 0224 ],225 "systems": [226 "geohash",227 "s2"228 ]229 }230 }231}