Skip to main content

spacelab_constellation/
lib.rs

1//! Constellation design — generators that turn a family's parameters into the circular Keplerian
2//! element sets a coverage or conjunction analysis consumes.
3//!
4//! spacelab has a coverage engine (`spacelab_coverage`) and a collision-probability engine, but no
5//! way to *build* a standard constellation to feed them. This crate closes that loop: a family
6//! generator emits [`spacelab_elements::KeplerianElements`] (plane-major), which the caller
7//! propagates and hands to the coverage / conjunction machinery — *generate → propagate → coverage /
8//! revisit / conjunctions*.
9//!
10//! Generators are `no_std` and allocation-free: each satellite is delivered through a `FnMut`
11//! callback (as `spacelab_coverage` and the halo families do), so the caller decides whether to
12//! collect into a `Vec`, stream, or filter.
13//!
14//! Families:
15//! - [`Walker`] — Delta/Star, the standard `i: T/P/F` symmetric pattern (Walker 1984).
16//! - [`StreetOfCoverage`] — near-polar streets tiled for continuous coverage (Lüders / Adams–Rider).
17//! - [`FlowerConstellation`] — satellites on one repeating space track (Mortari et al. 2004).
18//! - [`LatticeFlower`] — the 2-D integer-lattice unification of Walker and Flower (Avendaño, Davis &
19//!   Mortari 2013).
20//! - [`KinematicallyRegular`] — a constellation as the orbit of a seed under a finite rotation group
21//!   (Mozhaev): cyclic (= Walker), dihedral, and tetrahedral symmetry.
22//! - [`DraimTetrahedral`] — the four-satellite continuous global coverage constellation (Draim 1987).
23//! - [`TwoTierShell`] — two-tier surveillance of a spherical shell of near-Earth space (SSA), with the
24//!   space-visibility geometry and the launch-cost objective.
25//!
26//! Plus the Mozhaev classification of symmetry groups ([`PointGroup`], [`MozhaevSymbol`]) and, behind
27//! the `std` feature, the α-characteristic coverage figure of merit ([`alpha_characteristic`]).
28
29#![cfg_attr(not(any(test, feature = "std")), no_std)]
30
31#[cfg(any(feature = "std", test))]
32pub mod analysis;
33pub mod draim;
34pub mod flower;
35pub mod lattice;
36pub mod mozhaev;
37pub mod shell;
38pub mod soc;
39pub mod symmetric;
40pub mod walker;
41
42#[cfg(any(feature = "std", test))]
43pub use analysis::{alpha_characteristic, minimum_walker};
44pub use draim::DraimTetrahedral;
45pub use flower::FlowerConstellation;
46pub use lattice::LatticeFlower;
47pub use mozhaev::{GroupType, MozhaevSymbol, PointGroup};
48pub use shell::{ShellTier, TwoTierShell, characteristic_velocity, observes};
49pub use soc::{SocGeometry, StreetOfCoverage};
50pub use symmetric::{KinematicallyRegular, Symmetry};
51pub use walker::{Walker, WalkerPattern};