mirror of
https://github.com/bilawalsidhu/gods-eye-view.git
synced 2026-11-16 08:12:24 +00:00
62 lines
2.1 KiB
JavaScript
62 lines
2.1 KiB
JavaScript
/**
|
|
* @file The bundled UCS Satellite Database pack: the purpose of each active
|
|
* satellite, keyed by NORAD catalog number.
|
|
*
|
|
* Data: `local_data/ucs_satellites/ucs_satellites.json`, built by
|
|
* `scripts/build-ucs-satellites.py` from UCS-Satellite-Database 5-1-2023
|
|
* (https://www.ucsusa.org/satellite_database; free, unrestricted use, with an
|
|
* acknowledgement). Loaded once, on demand, by the satellites layer; a failed
|
|
* load is retried after a cooldown rather than remembered for the session.
|
|
*
|
|
* @module data/ucsSatellites
|
|
*/
|
|
|
|
import { loadBundledJson } from './bundledJson.js';
|
|
import { createRetryableLoader } from './retryableLoad.js';
|
|
|
|
const PACK_URL = new URL(
|
|
'./local_data/ucs_satellites/ucs_satellites.json',
|
|
import.meta.url,
|
|
);
|
|
|
|
/**
|
|
* One UCS row: what UCS says a satellite is for.
|
|
* @typedef {{noradId: number, purpose: string|null}} UcsSatellite
|
|
*/
|
|
|
|
/**
|
|
* Expand the pack's string-table rows into records keyed by NORAD number.
|
|
* A pack of the wrong shape throws: read as an empty pack it would be kept
|
|
* for the session, and every satellite would quietly lose its UCS evidence.
|
|
* A malformed row is skipped.
|
|
* @param {{fields: string[], strings: Record<string, string[]>,
|
|
* records: Array<number[]>}} pack Parsed `ucs_satellites.json`.
|
|
* @returns {Map<number, UcsSatellite>}
|
|
*/
|
|
export function indexUcsPack(pack) {
|
|
const byNorad = new Map();
|
|
const fields = pack?.fields;
|
|
if (
|
|
!Array.isArray(fields) ||
|
|
fields[0] !== 'noradId' ||
|
|
!Array.isArray(pack.records)
|
|
)
|
|
throw new TypeError('UCS pack has an unexpected shape');
|
|
for (const row of pack.records) {
|
|
const noradId = row?.[0];
|
|
if (!Number.isInteger(noradId) || noradId <= 0) continue;
|
|
const record = { noradId };
|
|
for (let i = 1; i < fields.length; i++) {
|
|
const text = pack.strings?.[fields[i]]?.[row[i]];
|
|
record[fields[i]] = text ? text : null;
|
|
}
|
|
byNorad.set(noradId, record);
|
|
}
|
|
return byNorad;
|
|
}
|
|
|
|
/** The pack, loaded and indexed once. */
|
|
export const loadUcsSatellites = createRetryableLoader(async () =>
|
|
indexUcsPack(await loadBundledJson(PACK_URL)),
|
|
);
|