mirror of
https://github.com/bilawalsidhu/gods-eye-view.git
synced 2026-11-20 18:22:25 +00:00
- scripts/build-tiangong-model.py is the Blender script the model README cites, with its paths made repository-relative (output to a folder given after --, the ISS reference read from public/models/). Not re-run in this commit: only its paths changed. - The ISS textures carry the NASA insignia and the ESA, Columbus, JAXA and Nanoracks marks as flown; the model README and DATA_SOURCES say they are kept as flown and imply no endorsement.
117 lines
7.4 KiB
Markdown
117 lines
7.4 KiB
Markdown
# Bundled 3D Models
|
||
|
||
Every 3D model shipped in this directory but two is one of the project's procedural
|
||
fleet models under [`fleet/`](fleet/): aircraft, helicopters, ships, buoys,
|
||
transit and rail vehicles, and a few other airborne and ground objects. They
|
||
are generated from code by the project maintainers, contain no third-party
|
||
artwork, and are covered by the repository's [MIT license](../../LICENSE)
|
||
like the source code. The exceptions are the two space stations: NASA's model
|
||
of the ISS, described in [its own section](#the-iss-model-issglb) below, and
|
||
the project's own Tiangong model, [after it](#the-tiangong-model-tiangongglb).
|
||
|
||
| Path | What it holds |
|
||
|---|---|
|
||
| `fleet/catalog.json` | Every model by name: its file, category, built length, beam and bounds (metres, in Cesium's Z-up model frame: x along the length with the nose toward −X, y across the beam, z up), the clearance below its origin, and its 2D icon class. |
|
||
| `fleet/types.json` | Which model draws which vehicle, and at what length: ICAO aircraft and helicopter type codes, ADS-B emitter categories, AIS ship-type and length ranges, GTFS route types, transit modes and rail categories, with the defaults. |
|
||
| `fleet/aircraft/`, `fleet/helicopters/`, `fleet/ships/`, `fleet/buoys/`, `fleet/transit/`, `fleet/other/` | The models, one GLB each (EXT_meshopt_compression and KHR_mesh_quantization, vertex colours, no textures). |
|
||
|
||
How the layers use them:
|
||
|
||
- Each layer draws a vehicle with the model its type selects, scaled to the
|
||
type's published length (a vessel to its reported AIS length and beam), so
|
||
every model is drawn life size. Ground objects, balloons and obstacles in
|
||
the `other` category are drawn at the size they are built.
|
||
- An aid to navigation (a vessel record whose type names a buoy, beacon, IALA
|
||
mark, RACON or light, or whose MMSI is an aid station's `99MIDxxxx`) is
|
||
drawn as the `buoys` model of its mark (cardinal north, east, south or west,
|
||
port or starboard hand, safe water, isolated danger, special mark), a red
|
||
can when its type names no mark, at its built size and with no heading
|
||
(`vesselModelSpec`, `aidToNavigationModel`).
|
||
- An aircraft model's origin is its axis; it stands that model's scaled
|
||
clearance above the ground. A ship's origin is its waterline, and a transit
|
||
or rail vehicle's the road or rail top (a monorail or gondola is raised by
|
||
its `transit.elevation` entry, for a source that names those modes).
|
||
- Transit and rail models carry a `_TINT` vertex attribute that marks where
|
||
the route or category colour is painted.
|
||
- The whole set loads once, up front, when a layer that draws it starts; no
|
||
model is fetched while a session runs.
|
||
|
||
`src/data/fleetModels.js` reads the set and chooses each vehicle's model;
|
||
`src/data/fleetModels.test.mjs` checks that every model `types.json` names is
|
||
in the catalog and on disk, and that no GLB exceeds 3 MB.
|
||
|
||
## The ISS model (`iss.glb`)
|
||
|
||
Two models sit outside the fleet set. The first is `iss.glb`, the International
|
||
Space Station drawn by the satellites layer up close. It is not procedural and not
|
||
covered by the MIT license. It is NASA's own model of the station, which is
|
||
not subject to copyright in the United States
|
||
([NASA Images and Media Usage Guidelines](https://www.nasa.gov/nasa-brand-center/images-and-media));
|
||
its use does not imply endorsement by NASA. It loads only when the camera
|
||
nears the station.
|
||
|
||
- **Original work:** “International Space Station (ISS) (D) (IGOAL)”, NASA
|
||
Johnson Space Center, Integrated Graphics, Operations and Analysis
|
||
Laboratory, on
|
||
[NASA 3D Resources](https://science.nasa.gov/3d-resources/international-space-station-iss-d-igoal/).
|
||
- **Reduction:** from the 96 MB original (2.7 M triangles) to 3 MB (314 k
|
||
triangles): handrails left out; geometry simplified within 15 cm
|
||
(structure) or 40 cm (small details) of the original surface, normals
|
||
rebuilt; normal maps dropped; textures resized to 512 px WebP;
|
||
Draco-compressed.
|
||
- **Frame:** every part is baked into one frame in meters (glTF +Y zenith,
|
||
+X port, +Z forward), and the scene root moves the bounding-box centre to
|
||
the origin.
|
||
- **Corrections:** NASA's file is a mirror image of the station (port and
|
||
starboard swapped), which is undone; 15 materials NASA marks as blended
|
||
are made opaque, because blended they draw see-through.
|
||
- **Marks on the textures:** the station's textures carry the marks it flies
|
||
with: the NASA insignia and the ESA, Columbus, JAXA and Nanoracks marks on
|
||
the partners' modules. They are kept as flown, to show the station as it
|
||
is; their presence implies no endorsement by NASA or by any partner.
|
||
- **Moving parts:** parts that move stay separate nodes at the joints NASA
|
||
names (two alpha joints, eight array beta joints, two radiator joints,
|
||
Canadarm2's seven joints, two joints on each Dextre arm, three on the
|
||
Japanese arm). The two Ku-band dishes and three of the four power-module
|
||
radiators, welded into the truss in NASA's file, are cut out by position.
|
||
|
||
## The Tiangong model (`tiangong.glb`)
|
||
|
||
The second model outside the fleet set is `tiangong.glb`, China's Tiangong
|
||
station in its T configuration (Tianhe, Wentian, Mengtian, a Shenzhou forward
|
||
and nadir, a Tianzhou aft), drawn by the satellites layer up close. It is an
|
||
original model made for God's Eye View and, unlike the ISS model, it is the
|
||
project's own work under the repository's [MIT license](../../LICENSE): no
|
||
third-party geometry, texture or image is in it. It loads only when the camera
|
||
nears the station.
|
||
|
||
- **Built:** in Blender 5.3 from primitives only (cylinders, cones, spheres,
|
||
tori, boxes), every texture generated procedurally by the build script,
|
||
[`scripts/build-tiangong-model.py`](../../scripts/build-tiangong-model.py)
|
||
(`blender -b --python scripts/build-tiangong-model.py -- <out_dir>`).
|
||
26,460 triangles, 12 materials, 15 WebP textures (`EXT_texture_webp`),
|
||
Draco-compressed, 382 KB.
|
||
- **Dimensions, as published:** Wang, Zhang & Wang 2023, "Design and
|
||
Application Prospect of China's Tiangong Space Station", *Space: Science &
|
||
Technology*, [doi:10.34133/space.0035](https://doi.org/10.34133/space.0035)
|
||
(CC BY 4.0), and [eoPortal's Tiangong page](https://www.eoportal.org/satellite-missions/tiangong):
|
||
Tianhe 16.6 m × 4.2 m with its port layout; Wentian and Mengtian 17.9 m ×
|
||
4.2 m, one each side of the node; lab wings 27 × ~4 m, two per lab,
|
||
two-axis; Tianhe wings 12.6 m per wing (the paper's figure; eoPortal gives
|
||
a 60 m total span), one-axis; the Tianhe arm ~10 m and the Wentian arm
|
||
~5 m, seven joints each; Shenzhou 9.25 × 2.8 m (17 m span), Tianzhou
|
||
10.6 × 3.35 m (14.9 m span) and their docking ports.
|
||
- **Approximate (the author's estimates):** the node sphere, small-cylinder
|
||
and resource-section diameters, section lengths and cones, hatch and port
|
||
tubes; wing widths, root offsets, masts and drive housings; the airlocks,
|
||
radiators, high-gain antenna and node antennas; both arms entirely (bases,
|
||
booms, joint spacing, rest pose); the ships' module proportions and arrays.
|
||
- **Frame:** meters, glTF +X port, +Y zenith, +Z forward (the ISS file's);
|
||
the scene root `tiangong` is translated so the station's bounding-box
|
||
centre (without the ships) is at the origin.
|
||
- **Moving parts:** joints are nodes with identity rest transforms and the
|
||
pivot, axis, kind and range in their `extras` (also in
|
||
`src/layers/satellites/tiangongJoints.js`): two Tianhe wing drives, four
|
||
lab wing alpha + beta pairs, the antenna gimbal, seven joints per arm, two
|
||
drives per ship, six dock markers.
|