astraeus-data 0.7.0 → 0.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (102) hide show
  1. package/CHANGELOG.md +6 -0
  2. package/NOTICE +2 -0
  3. package/README.md +1 -0
  4. package/data/bodies/README.md +33 -0
  5. package/data/bodies/callisto/categories.json +43 -0
  6. package/data/bodies/callisto/features.json +664 -0
  7. package/data/bodies/callisto/map.json +57 -0
  8. package/data/bodies/callisto/overview.json +32 -0
  9. package/data/bodies/catalogue.json +243 -0
  10. package/data/bodies/ceres/categories.json +25 -0
  11. package/data/bodies/ceres/features.json +214 -0
  12. package/data/bodies/ceres/map.json +51 -0
  13. package/data/bodies/ceres/overview.json +28 -0
  14. package/data/bodies/charon/categories.json +43 -0
  15. package/data/bodies/charon/features.json +397 -0
  16. package/data/bodies/charon/map.json +48 -0
  17. package/data/bodies/charon/overview.json +32 -0
  18. package/data/bodies/dione/categories.json +43 -0
  19. package/data/bodies/dione/features.json +415 -0
  20. package/data/bodies/dione/map.json +60 -0
  21. package/data/bodies/dione/overview.json +32 -0
  22. package/data/bodies/earth/categories.json +31 -0
  23. package/data/bodies/earth/features.json +594 -0
  24. package/data/bodies/earth/map.json +49 -0
  25. package/data/bodies/earth/overview.json +32 -0
  26. package/data/bodies/enceladus/categories.json +49 -0
  27. package/data/bodies/enceladus/features.json +485 -0
  28. package/data/bodies/enceladus/map.json +58 -0
  29. package/data/bodies/enceladus/overview.json +32 -0
  30. package/data/bodies/europa/categories.json +49 -0
  31. package/data/bodies/europa/features.json +509 -0
  32. package/data/bodies/europa/map.json +61 -0
  33. package/data/bodies/europa/overview.json +32 -0
  34. package/data/bodies/ganymede/categories.json +55 -0
  35. package/data/bodies/ganymede/features.json +739 -0
  36. package/data/bodies/ganymede/map.json +72 -0
  37. package/data/bodies/ganymede/overview.json +32 -0
  38. package/data/bodies/iapetus/categories.json +37 -0
  39. package/data/bodies/iapetus/features.json +368 -0
  40. package/data/bodies/iapetus/map.json +60 -0
  41. package/data/bodies/iapetus/overview.json +32 -0
  42. package/data/bodies/io/categories.json +31 -0
  43. package/data/bodies/io/features.json +334 -0
  44. package/data/bodies/io/map.json +85 -0
  45. package/data/bodies/io/overview.json +32 -0
  46. package/data/bodies/jupiter/categories.json +43 -0
  47. package/data/bodies/jupiter/features.json +399 -0
  48. package/data/bodies/jupiter/map.json +58 -0
  49. package/data/bodies/jupiter/overview.json +28 -0
  50. package/data/bodies/mars/categories.json +49 -0
  51. package/data/bodies/mars/features.json +712 -0
  52. package/data/bodies/mars/map.json +69 -0
  53. package/data/bodies/mars/overview.json +28 -0
  54. package/data/bodies/mercury/categories.json +43 -0
  55. package/data/bodies/mercury/features.json +402 -0
  56. package/data/bodies/mercury/map.json +70 -0
  57. package/data/bodies/mercury/overview.json +28 -0
  58. package/data/bodies/mimas/categories.json +37 -0
  59. package/data/bodies/mimas/features.json +270 -0
  60. package/data/bodies/mimas/map.json +60 -0
  61. package/data/bodies/mimas/overview.json +32 -0
  62. package/data/bodies/moon/categories.json +37 -0
  63. package/data/bodies/moon/features.json +647 -0
  64. package/data/bodies/moon/map.json +58 -0
  65. package/data/bodies/moon/overview.json +32 -0
  66. package/data/bodies/neptune/categories.json +49 -0
  67. package/data/bodies/neptune/features.json +552 -0
  68. package/data/bodies/neptune/map.json +48 -0
  69. package/data/bodies/neptune/overview.json +28 -0
  70. package/data/bodies/pluto/categories.json +49 -0
  71. package/data/bodies/pluto/features.json +512 -0
  72. package/data/bodies/pluto/map.json +48 -0
  73. package/data/bodies/pluto/overview.json +28 -0
  74. package/data/bodies/rhea/categories.json +43 -0
  75. package/data/bodies/rhea/features.json +386 -0
  76. package/data/bodies/rhea/map.json +59 -0
  77. package/data/bodies/rhea/overview.json +32 -0
  78. package/data/bodies/saturn/categories.json +31 -0
  79. package/data/bodies/saturn/features.json +658 -0
  80. package/data/bodies/saturn/map.json +70 -0
  81. package/data/bodies/saturn/overview.json +28 -0
  82. package/data/bodies/tethys/categories.json +37 -0
  83. package/data/bodies/tethys/features.json +354 -0
  84. package/data/bodies/tethys/map.json +60 -0
  85. package/data/bodies/tethys/overview.json +32 -0
  86. package/data/bodies/titan/categories.json +43 -0
  87. package/data/bodies/titan/features.json +341 -0
  88. package/data/bodies/titan/map.json +61 -0
  89. package/data/bodies/titan/overview.json +32 -0
  90. package/data/bodies/triton/categories.json +43 -0
  91. package/data/bodies/triton/features.json +362 -0
  92. package/data/bodies/triton/map.json +61 -0
  93. package/data/bodies/triton/overview.json +32 -0
  94. package/data/bodies/uranus/categories.json +49 -0
  95. package/data/bodies/uranus/features.json +503 -0
  96. package/data/bodies/uranus/map.json +48 -0
  97. package/data/bodies/uranus/overview.json +28 -0
  98. package/data/bodies/venus/categories.json +43 -0
  99. package/data/bodies/venus/features.json +469 -0
  100. package/data/bodies/venus/map.json +74 -0
  101. package/data/bodies/venus/overview.json +28 -0
  102. package/package.json +5 -3
package/CHANGELOG.md CHANGED
@@ -2,6 +2,12 @@
2
2
 
3
3
  Versions follow [semantic versioning](https://semver.org). It is released together with `astraeus`, with the same version number.
4
4
 
5
+ ## 0.8.0 (2026-11-07)
6
+
7
+ Released with `astraeus` 0.8.0, with the same version number. Every `astraeus-data*` package now peers on `astraeus` `>=0.8.0 <0.9.0`.
8
+
9
+ Added (O-059 T-268): the tagged surface places of 24 bodies, moved from the engine's `data/bodies/` and published for the first time as `astraeus-data/bodies/<body>/{features,categories,overview,map}.json` plus `catalogue.json` (about 840 KB, 98 files), for `scene.addPlaces`. NOTICE credits the lists to Planetary Explorer (the owner's own work) and keeps the overview sources' own credits.
10
+
5
11
  ## 0.7.0 (2026-11-01)
6
12
 
7
13
  No changes to the pictures, data or this package's code. The README now lists the moons the picture pack has pictures for (Io, Europa, Ganymede, Callisto, Mimas, Enceladus, Tethys, Dione, Rhea, Titan, Iapetus, Triton and Charon) and says every other listed moon draws flat-coloured (O-050 T-215, I-127). Released with `astraeus` 0.7.0 to keep the version numbers together.
package/NOTICE CHANGED
@@ -11,3 +11,5 @@ Moon maps:
11
11
  Charon: New Horizons team; NASA, JHUAPL, SwRI, LPI; USGS Astrogeology 2017 (please cite authors).
12
12
  Venus 8k map: USGS Astrogeology / NASA Magellan C3-MDIR mosaic (public domain).
13
13
  Milky Way picture: Milky Way render by Kevinmloch (bsrender) from Gaia EDR3, ESA/Gaia/DPAC, CC BY-SA 4.0 (https://commons.wikimedia.org/wiki/File:Milky_Way_360_equirectangular_rendering_with_foreground_stars_removed.png). Share-alike applies to the picture and adaptations of it, not to the code. The 8000x4000 original was resized to 3840x1920 by Wikimedia Commons and re-encoded as JPEG; no other change.
14
+
15
+ Place lists (data/bodies/<body>/): the names, kinds, descriptions and coordinates of tagged surface places on 24 bodies, and each body's overview facts, come from Planetary Explorer, the project owner's own work (donor commit 84f8d3e), and are carried over exactly as recorded there. The overview facts cite their own sources (NASA Science, NASA NSSDCA and the JPL Planetary Satellite Physical Parameters page); those sources keep their own credits. Where a body's places state west longitudes they are USGS Gazetteer of Planetary Nomenclature values (planetarynames.wr.usgs.gov, IAU names). The map pictures the places refer to are described in each map.json and shipped, with their own licences, only through src/pictures.js. The positions are placed by eye against those pictures, not surveyed (see each body's catalogue entry and the provenance you pass to scene.addPlaces).
package/README.md CHANGED
@@ -5,6 +5,7 @@ Pictures for the [Astraeus](https://github.com/anipatke/Astraeus) engine, kept a
5
5
  - maps of Io, Europa, Ganymede, Callisto, Mimas, Enceladus, Tethys, Dione, Rhea, Titan, Iapetus, Triton, Pluto and Charon;
6
6
  - the 8k Venus map (used on wide screens);
7
7
  - the Milky Way picture (Kevinmloch, from Gaia EDR3, CC BY-SA 4.0), one 3840x1920 image.
8
+ - the tagged surface places of 24 bodies (`astraeus-data/bodies/<body>/features.json`, `categories.json`, `overview.json`, `map.json`, and `bodies/catalogue.json`), the owner's own Planetary Explorer lists, as data for `scene.addPlaces`. They are never loaded unless an app imports them.
8
9
 
9
10
  Moons with pictures: Io, Europa, Ganymede, Callisto, Mimas, Enceladus, Tethys, Dione, Rhea, Titan, Iapetus, Triton and Charon. Every other listed moon, among them Uranus's Miranda, Ariel, Umbriel, Titania and Oberon, draws flat-coloured with this package loaded. Pluto also has a map.
10
11
 
@@ -0,0 +1,33 @@
1
+ # Body packages
2
+
3
+ One directory per body, imported from Planetary Explorer (the owner's own project, read only) by `tools/import/planetary-explorer.mjs`. The packages are data, never engine code. Every package records the donor commit it was read from. `catalogue.json` lists all bodies, feature counts, the source of each map and any donor oddities the importer noticed (reported, never fixed).
4
+
5
+ The owner verified the tagged locations visually over months, so they are carried over exactly: latitude and longitude are never rounded, converted, re-derived or corrected, and `tests/bodyPackages.test.ts` proves bit-for-bit equality with the donor.
6
+
7
+ ## Files in `data/bodies/<body>/`
8
+
9
+ | File | Holds |
10
+ |---|---|
11
+ | `features.json` | `features`: every donor feature object exactly as held (id, name, featureType, category, latitude, longitude, description, tags, details, and the ring-plane fields ringRadius, ringAngle, moonRadius where the donor has them). Ring-plane features have no latitude or longitude. |
12
+ | `categories.json` | `categories`: the donor's category definitions (key, label, colour, isFilterable, alwaysVisible) from the entity config. |
13
+ | `overview.json` | `overview`: the donor's body overview (discovery, diameterKm, facts, sources). |
14
+ | `map.json` | `textures` (donor path, pixel size, bytes, SHA-256, the donor README entry, per variant); `source` (who recorded the map source, licence, credit); `coordinates` (the convention below). Map images are not copied. |
15
+
16
+ Each file starts with `format`, `kind`, `body`, `name`, `parent` and `donor.commit`.
17
+
18
+ ## Coordinate convention (`map.json` `coordinates`)
19
+
20
+ Features are placed by the donor's `latLonToXYZ(lat, lon, radius)` on a Three.js `SphereGeometry`: phi = (phiOffsetDeg - latitude) from +Y, with phiOffsetDeg 90; theta = longitude + thetaOffsetDeg, with thetaOffsetDeg 90; position = (r sin phi sin theta, r cos phi, r sin phi cos theta).
21
+
22
+ - Stored longitudes are already in the donor's own marker frame for that map. Some bodies use -180..180, others 0..360 (`longitudeRange` gives the actual min and max). Use them unchanged.
23
+ - `markerLongitudeFromSource` says how the donor derived a stored longitude from the source (IAU positive-west) value: marker = scale * source + offsetDeg. `null` where the donor states no formula. It is documentation; nothing applies it.
24
+ - `textureRecentringDeg` is a picture shift traced against the original mosaic (Ganymede and Ceres: 180). It is a property of the map picture; stored longitudes already account for it, so it is never added again.
25
+ - `donorReadmeNote` is the donor's own texture README bullet for the body, verbatim.
26
+
27
+ ## Map sources
28
+
29
+ `source.recordedBy` is either the donor `public/textures/README.md` (entries copied verbatim into `textures[].donorReadme`) or `tools/import/planetary-explorer-map-sources.json`, for the eight bodies whose donor texture has no README source (Earth, Moon, Jupiter, Uranus, Neptune, Pluto, Charon, Ceres). Those records cite the Astraeus document that traced them. The importer refuses a body with neither. `donorFileShippable: false` (Ceres) means the donor file itself must not be shipped.
30
+
31
+ ## Running
32
+
33
+ `node tools/import/planetary-explorer.mjs [--dry-run] [--donor <dir>] [--out <dir>]`. It needs Node with built-in type stripping (22.18 or later, or 24) to read the donor's `src/entities/*.ts`. Running it twice on an unchanged donor writes identical files.
@@ -0,0 +1,43 @@
1
+ {
2
+ "format": "astraeus.body-package/1",
3
+ "kind": "categories",
4
+ "body": "callisto",
5
+ "name": "Callisto",
6
+ "parent": "jupiter",
7
+ "donor": {
8
+ "project": "planetary-explorer",
9
+ "commit": "84f8d3ee77aff47f2f36f157b62b97dce7176b95"
10
+ },
11
+ "categories": [
12
+ {
13
+ "key": "craters",
14
+ "label": "Craters",
15
+ "color": "#9090A0",
16
+ "isFilterable": true
17
+ },
18
+ {
19
+ "key": "basins",
20
+ "label": "Ring Features",
21
+ "color": "#7080A0",
22
+ "isFilterable": true
23
+ },
24
+ {
25
+ "key": "catenae",
26
+ "label": "Catenae",
27
+ "color": "#A8A0B8",
28
+ "isFilterable": true
29
+ },
30
+ {
31
+ "key": "faculae",
32
+ "label": "Faculae",
33
+ "color": "#D0D6E0",
34
+ "isFilterable": true
35
+ },
36
+ {
37
+ "key": "poles",
38
+ "label": "Poles",
39
+ "color": "#B8C4D0",
40
+ "alwaysVisible": true
41
+ }
42
+ ]
43
+ }