apsis-rs/docs/design
ApsisRS contributors f5b1952555 docs: record the benchmark method and the measurements
Three measurements, each answering a different question: what one call
costs, how the cost grows with size, and what the other cores save. The
method states the three rules the tools follow, no warm-up, best of several
runs, and cost per unit rather than an absolute figure, so a reader can
reproduce and judge.

The findings are that the numerical kernels are linear and parallelise
well, a day over two thousand satellites costs 0.7 seconds on one core and
81 milliseconds on sixteen, and that interpolation is about ten times
cheaper than propagation. Two combined operations are limited by their
algorithm: greedy planning is quadratically serial, and the duplicate
check on edge insertion squares that quadratic, so threading helps neither.
Eight threads is recommended, since efficiency falls to about half at
sixteen.
2026-10-02 00:57:20 +08:00
..
README.md docs: record the benchmark method and the measurements 2026-10-02 00:57:20 +08:00
README.zh.md docs: record the benchmark method and the measurements 2026-10-02 00:57:20 +08:00
bench.md docs: record the benchmark method and the measurements 2026-10-02 00:57:20 +08:00
bench.zh.md docs: record the benchmark method and the measurements 2026-10-02 00:57:20 +08:00
errors.md docs: give every note an English and a Chinese version 2026-09-30 19:23:26 +08:00
errors.zh.md docs: give every note an English and a Chinese version 2026-09-30 19:23:26 +08:00
glossary.md docs: add the bilingual glossary 2026-10-02 00:13:34 +08:00
glossary.zh.md docs: add the bilingual glossary 2026-10-02 00:13:34 +08:00
layers.md docs: give every note an English and a Chinese version 2026-09-30 19:23:26 +08:00
layers.zh.md docs: give every note an English and a Chinese version 2026-09-30 19:23:26 +08:00
parallel.md docs: give every note an English and a Chinese version 2026-09-30 19:23:26 +08:00
parallel.zh.md docs: give every note an English and a Chinese version 2026-09-30 19:23:26 +08:00
sim.md docs: give every note an English and a Chinese version 2026-09-30 19:23:26 +08:00
sim.zh.md docs: give every note an English and a Chinese version 2026-09-30 19:23:26 +08:00
units.md docs: give every note an English and a Chinese version 2026-09-30 19:23:26 +08:00
units.zh.md docs: give every note an English and a Chinese version 2026-09-30 19:23:26 +08:00

README.md

Design notes

English | 简体中文

This directory records the cross-crate design decisions of ApsisRS, such as the coordinate and unit conventions, the error and tolerance strategy, the layer boundaries and the parallelism. The design inside a single crate is documented in that crate's module documentation.

A note is self-contained and refers only to code in this repository or to a public standard.

Cross-layer conventions

Per-layer design