ASTRA-Core documentation

Welcome to astra-core-engine v|release| (Autonomous Space Traffic Risk Analyzer): a Python library for orbit propagation, conjunction screening, collision probability, catalog ingestion (CelesTrak, Space-Track, Spacebook / COMSPOC), and pass prediction—with native support for both TLE and CCSDS OMM.

• Install: Installation

• First steps: Quickstart

• What the models assume: Operational limitations

• Deeper background: KNOWMORE.md in the repository root (TLE, SGP4, P_c, frames, NRLMSISE-00, Cowell, Chebyshev ephemeris, warm-up)

API reference is regenerated on every docs build (sphinx-apidoc stubs under docs/apidoc/, then sphinx-build).

User guide

• Installation
  • Core install
  • Optional: visualization (Plotly)
  • Development and tests
  • Verifying the install
  • JIT warm-up
  • Banner suppression
  • Strict mode (default ON)
  • Type hints (PEP 561)
  • Further reading
• Operational limitations
  • Ephemeris and time
  • Atmosphere and drag
  • Solar radiation pressure
  • Collision probability
  • Network and data providers
  • Numba JIT
  • Validation
  • Strict vs relaxed mode
• Quickstart
  • 0. JIT warm-up (production)
  • 1. Parse a TLE
  • 2. Propagate with SGP4
  • 3. Screen for conjunctions
  • 4. Load a live CelesTrak catalog
  • 5. Ground-station passes
  • 6. High-fidelity Cowell propagation
  • 7. Parse a CDM (Conjunction Data Message)
  • Next steps
• Theoretical Framework
  • 1. Two-Line Elements (TLE)
  • 2. Orbital Propagation (SGP4)
  • 3. Coordinate Systems
  • 4. Conjunction Analysis (Finding Collisions)
  • 5. Covariance & State Transition Matrix
  • 6. Active Collision Avoidance Maneuvers
• Architecture & Physics
  • Two Propagation Tiers
  • Numba JIT Acceleration
  • 6×6 State Transition Matrix (STM) Covariance
  • JIT Warm-Up
  • Data Source Priority
  • Error Hierarchy
• Orbital Maneuvers
  • Mass Depletion (7-DOF)
  • Burn Sequencing
  • Attitude Steering
  • Segmented Orchestration
  • Simulation Workflow
  • Next steps
• API reference
  • Interactive API Discovery (v3.6.2+)
  • Quick API map
    • Data ingestion
    • Parsing
    • Filtering & catalog
    • Orbit propagation
    • Conjunction analysis
    • Maneuvers
    • Visibility
    • Utilities & configuration
    • Key data types
    • Error types
  • Auto-generated API
    • astra

Indices and tables

• Index

• Module Index

• Search Page