mirror of
https://github.com/bilawalsidhu/gods-eye-view.git
synced 2026-11-20 18:22:25 +00:00
Builds on the ISS 3D model (PR #1690) and brings it onto main's renderer seam: the station models are items of a `models` draw set, posed by heading, pitch and roll from the station's flight axes (`headingPitchRollOfAxes`), with the camera, canvas and clicks read from the renderer's ports; no satellites file reaches Cesium. The joint drivers write column-major matrices into node poses the model part keeps, for a renderer that can pose nodes; until the draw contract has that member the models draw rigid. - ISS joints take their angles from NASA's ISSLive telemetry, relayed by the server behind ISS_TELEMETRY_ENABLED. - STATION and LIVE sections of Context replace the floating command panel and player; both collapse like the Radio section. - Cockpit rides the ISS from mounts on its model; the LIVE page in the Cockpit briefing. - Tiangong as a second station model, with computed joints. - Installations: a label-box click selects the site.
184 lines
7.5 KiB
JavaScript
184 lines
7.5 KiB
JavaScript
import assert from 'node:assert/strict';
|
||
import test from 'node:test';
|
||
import {
|
||
ISS_MOUNTS,
|
||
ISS_MOUNT_CARDS,
|
||
ISS_MOUNT_ORDER,
|
||
ISS_NAUKA_NORAD,
|
||
ISS_POISK_NORAD,
|
||
issMountLabel,
|
||
issMountView,
|
||
issMountViews,
|
||
issMountWorld,
|
||
issNextMountView,
|
||
issPreviousMountView,
|
||
} from './issMounts.js';
|
||
import { ISS_MODEL_NATIVE_SPAN, ISS_NORAD } from './policy.js';
|
||
|
||
const dot = (a, b) => a.x * b.x + a.y * b.y + a.z * b.z;
|
||
const length = (a) => Math.hypot(a.x, a.y, a.z);
|
||
|
||
/** Key, label and entry of each view: what the Cockpit steps through. */
|
||
const summary = (views) =>
|
||
views.map(({ key, label, noradId }) => ({ key, label, noradId }));
|
||
|
||
test('the station offers its views in order, Nauka first', () => {
|
||
assert.deepEqual(
|
||
[...ISS_MOUNT_ORDER],
|
||
['nauka', 'zarya', 'poisk', 'cupola', 'kibo', 'docked'],
|
||
);
|
||
for (const key of ISS_MOUNT_ORDER) assert.ok(ISS_MOUNTS[key]);
|
||
assert.equal(new Set([ISS_NORAD, ISS_NAUKA_NORAD, ISS_POISK_NORAD]).size, 3);
|
||
// Each view names the entry it belongs to, for the Cockpit to ride. The
|
||
// Cupola and Kibo have no entries of their own: they ride the ISS's.
|
||
const views = issMountViews({
|
||
naukaName: 'ISS (NAUKA)',
|
||
zaryaName: 'ISS (ZARYA)',
|
||
poiskName: 'POISK',
|
||
dockedName: 'PROGRESS-MS 34',
|
||
naukaNorad: ISS_NAUKA_NORAD,
|
||
zaryaNorad: ISS_NORAD,
|
||
poiskNorad: ISS_POISK_NORAD,
|
||
dockedNorad: 68837,
|
||
});
|
||
assert.deepEqual(summary(views), [
|
||
{ key: 'nauka', label: 'NAUKA', noradId: ISS_NAUKA_NORAD },
|
||
{ key: 'zarya', label: 'ZARYA', noradId: ISS_NORAD },
|
||
{ key: 'poisk', label: 'POISK', noradId: ISS_POISK_NORAD },
|
||
{ key: 'cupola', label: 'CUPOLA', noradId: ISS_NORAD },
|
||
{ key: 'kibo', label: 'KIBO', noradId: ISS_NORAD },
|
||
{ key: 'docked', label: 'PROGRESS-MS 34', noradId: 68837 },
|
||
]);
|
||
// Only the modules without an entry carry cards of their own.
|
||
assert.deepEqual(
|
||
views.filter((view) => view.card).map((view) => view.key),
|
||
['cupola', 'kibo'],
|
||
);
|
||
// No vehicle docked: no view from one. The modules are part of the model,
|
||
// so they are offered even when the catalog has no entry for them; such a
|
||
// view has no entry to ride.
|
||
assert.deepEqual(summary(issMountViews({ zaryaName: 'ISS (ZARYA)' })), [
|
||
{ key: 'nauka', label: 'NAUKA', noradId: null },
|
||
{ key: 'zarya', label: 'ZARYA', noradId: null },
|
||
{ key: 'poisk', label: 'POISK', noradId: null },
|
||
{ key: 'cupola', label: 'CUPOLA', noradId: null },
|
||
{ key: 'kibo', label: 'KIBO', noradId: null },
|
||
]);
|
||
assert.deepEqual(
|
||
issMountViews().map(({ key }) => key),
|
||
['nauka', 'zarya', 'poisk', 'cupola', 'kibo'],
|
||
);
|
||
});
|
||
|
||
test('the Cupola’s card names it and gives its facts, marked for translation', () => {
|
||
const card = ISS_MOUNT_CARDS.cupola;
|
||
assert.equal(card.name, 'CUPOLA');
|
||
assert.equal(card.classLabel, 'OBSERVATION MODULE · ISS');
|
||
assert.equal(card.operator, 'European Space Agency (ESA)');
|
||
assert.deepEqual(
|
||
[...card.facts],
|
||
[
|
||
'7 WINDOWS',
|
||
'LAUNCHED 8 FEB 2010 · STS-130',
|
||
'TRANQUILITY · EARTH-FACING PORT',
|
||
],
|
||
);
|
||
});
|
||
|
||
test('Kibo’s card names it and gives its facts, marked for translation', () => {
|
||
const card = ISS_MOUNT_CARDS.kibo;
|
||
assert.equal(card.name, 'KIBO');
|
||
assert.equal(card.classLabel, 'LABORATORY MODULE · ISS');
|
||
assert.equal(card.operator, 'Japan Aerospace Exploration Agency (JAXA)');
|
||
assert.deepEqual(
|
||
[...card.facts],
|
||
['2 WINDOWS', 'LAUNCHED 31 MAY 2008 · STS-124', 'HARMONY · PORT SIDE'],
|
||
);
|
||
});
|
||
|
||
test('the view shown is the one asked for, else the first; the next wraps round', () => {
|
||
const views = issMountViews({ dockedName: 'SOYUZ-MS 28' });
|
||
assert.equal(issMountView(views, null).key, 'nauka');
|
||
assert.equal(issMountView(views, undefined).key, 'nauka');
|
||
assert.equal(issMountView(views, 'zarya').key, 'zarya');
|
||
assert.equal(issMountView(views, 'docked').label, 'SOYUZ-MS 28');
|
||
// A view no longer on offer (the vehicle undocked) falls back to the first.
|
||
assert.equal(issMountView(issMountViews(), 'docked').key, 'nauka');
|
||
|
||
assert.equal(issNextMountView(views, 'nauka').key, 'zarya');
|
||
assert.equal(issNextMountView(views, 'zarya').key, 'poisk');
|
||
assert.equal(issNextMountView(views, 'poisk').key, 'cupola');
|
||
assert.equal(issNextMountView(views, 'cupola').key, 'kibo');
|
||
assert.equal(issNextMountView(views, 'kibo').key, 'docked');
|
||
assert.equal(issNextMountView(views, 'docked').key, 'nauka');
|
||
assert.equal(issNextMountView(views, 'unknown').key, 'nauka');
|
||
assert.equal(issNextMountView(views.slice(0, 1), 'nauka'), null);
|
||
assert.equal(issNextMountView(null, 'nauka'), null);
|
||
|
||
assert.equal(issPreviousMountView(views, 'nauka').key, 'docked');
|
||
assert.equal(issPreviousMountView(views, 'docked').key, 'kibo');
|
||
assert.equal(issPreviousMountView(views, 'zarya').key, 'nauka');
|
||
assert.equal(issPreviousMountView(views, 'unknown').key, 'docked');
|
||
assert.equal(issPreviousMountView(views.slice(0, 1), 'nauka'), null);
|
||
assert.equal(issPreviousMountView(null, 'nauka'), null);
|
||
});
|
||
|
||
test('the view is named after the entry, without the catalog’s "ISS (…)"', () => {
|
||
assert.equal(issMountLabel('ISS (ZARYA)'), 'ZARYA');
|
||
assert.equal(issMountLabel(' ISS (NAUKA) '), 'NAUKA');
|
||
assert.equal(issMountLabel('PROGRESS-MS 34'), 'PROGRESS-MS 34');
|
||
assert.equal(issMountLabel(null), '');
|
||
});
|
||
|
||
test('every mount is on or beside the model, with a usable view frame', () => {
|
||
for (const [key, { eye, forward, up }] of Object.entries(ISS_MOUNTS)) {
|
||
// Within the station's own size of its centre: on it or just off its end.
|
||
assert.ok(Math.hypot(...eye) < ISS_MODEL_NATIVE_SPAN / 2, key);
|
||
assert.ok(Math.hypot(...forward) > 0.5, key);
|
||
// Up is not along the view, so the frame can be squared.
|
||
const cos =
|
||
(forward[0] * up[0] + forward[1] * up[1] + forward[2] * up[2]) /
|
||
(Math.hypot(...forward) * Math.hypot(...up));
|
||
assert.ok(Math.abs(cos) < 0.9, key);
|
||
}
|
||
});
|
||
|
||
test('a mount goes to the world on the axes the model is placed with', () => {
|
||
// Flight axes: x along-track, y the orbit normal, z zenith.
|
||
const axes = { x: [0, 1, 0], y: [0, 0, 1], z: [1, 0, 0] };
|
||
const centre = { x: 6_800_000, y: 0, z: 0 };
|
||
// Model axes are [port, zenith, forward]: forward is along-track, zenith
|
||
// is away from the Earth, port is the orbit normal.
|
||
const world = issMountWorld(
|
||
{ eye: [3, 5, -7], forward: [0, 0, 1], up: [0, 1, 0] },
|
||
centre,
|
||
axes,
|
||
);
|
||
assert.deepEqual(world.position, { x: 6_800_005, y: -7, z: 3 });
|
||
assert.deepEqual(world.direction, { x: 0, y: 1, z: 0 });
|
||
assert.deepEqual(world.up, { x: 1, y: 0, z: 0 });
|
||
// right = direction × up.
|
||
assert.deepEqual(world.right, { x: 0, y: 0, z: -1 });
|
||
});
|
||
|
||
test('the view frame is unit and square whatever the mount says', () => {
|
||
const axes = { x: [0, 1, 0], y: [0, 0, 1], z: [1, 0, 0] };
|
||
const centre = { x: 1, y: 2, z: 3 };
|
||
for (const mount of [
|
||
...Object.values(ISS_MOUNTS),
|
||
// Lengths off, and an up that leans into the view.
|
||
{ eye: [0, 0, 0], forward: [0, -3, 4], up: [0, 2, 1] },
|
||
]) {
|
||
const { direction, up, right } = issMountWorld(mount, centre, axes);
|
||
for (const v of [direction, up, right])
|
||
assert.ok(Math.abs(length(v) - 1) < 1e-12);
|
||
assert.ok(Math.abs(dot(direction, up)) < 1e-12);
|
||
assert.ok(Math.abs(dot(direction, right)) < 1e-12);
|
||
assert.ok(Math.abs(dot(up, right)) < 1e-12);
|
||
}
|
||
// The eye is the mount's distance from the centre.
|
||
const { position } = issMountWorld(ISS_MOUNTS.docked, centre, axes);
|
||
const offset = Math.hypot(position.x - 1, position.y - 2, position.z - 3);
|
||
assert.ok(Math.abs(offset - Math.hypot(...ISS_MOUNTS.docked.eye)) < 1e-9);
|
||
});
|