Orbis.Encounter (Orbis v0.8.0)

Copy Markdown View Source

Encounter geometry helpers for conjunction assessment.

This module builds the relative frame used by collision-probability calculations and projects states and covariance into the encounter plane.

It is the geometry layer beneath Orbis.Collision.

Summary

Functions

Project a 3x3 ECI covariance matrix into the 2D encounter plane (x, z).

Build an orthonormal encounter frame from two objects' states.

Types

vec3()

@type vec3() :: {float(), float(), float()}

Functions

encounter_plane_covariance(frame, cov_eci_3x3)

@spec encounter_plane_covariance(Orbis.Encounter.Frame.t(), [[float()]]) :: [
  [float()]
]

Project a 3x3 ECI covariance matrix into the 2D encounter plane (x, z).

frame(r1, v1, r2, v2)

@spec frame(vec3(), vec3(), vec3(), vec3()) ::
  {:ok, Orbis.Encounter.Frame.t()} | {:error, String.t()}

Build an orthonormal encounter frame from two objects' states.

Returns {:ok, %Frame{}} or {:error, reason}.