empyrean.compute_b_planes

compute_b_planes(orbits, end_epoch, methods, body_filter=None)[source]

Run B-plane breakdown extraction over a propagation window with one full propagation per supplied UncertaintyMethod.

Same call shape as compute_impact_probabilities(), but the output table carries the B-plane geometry (B·R, B·T, miss distance, 3σ ellipse, projected covariance) for every detected close approach instead of the IP record.

methods follows the same contract: a SigmaPoint / MonteCarlo / GaussianMixture dataclass carries its own parameters through to the engine for that method, while the UncertaintyMethod enum, its wire string, and a raw integer tag select the method with engine defaults. A non-default SigmaPoint(n_sigma=...) / SigmaPoint(samples_per_plane=...) is rejected by the engine — the canonical 2N+1 unscented set is parameter-free.

Return type:

BPlanes

Returns:

BPlanes – Quivr table — one row per (method × orbit × body) close approach. See the class for the full column list. method takes "first_order" / "second_order" / "sigma_point" / "monte_carlo" / "auto" / "gaussian_mixture".

Parameters:

  • orbits (CartesianOrbits | KeplerianOrbits | CometaryOrbits | SphericalOrbits)

  • end_epoch (float | Epochs)

  • methods (Sequence[UncertaintyMethod | SigmaPoint | MonteCarlo | GaussianMixture | str | int])

  • body_filter (Sequence[Origin | str] | None)