groundtrack
groundtrack is a Python library for discovering and analyzing seismic signals produced when space debris or spacecraft re-enter the atmosphere. When an object re-enters at hypersonic speeds, it generates sonic booms that couple into the ground and are recorded by seismic stations. groundtrack automates everything from fetching the orbital data to downloading and processing the waveforms.
The library was developed at Johns Hopkins University in collaboration with Dr. Benjamin Fernando (Department of Earth and Planetary Sciences) and was validated against the Shenzhou-15 re-entry event, reproducing published results from a peer-reviewed Science paper.
Source code is available on GitHub.
pip install groundtrack
from groundtrack import run_pipeline
results = run_pipeline(
norad_id=56873,
start="2024-04-02T08:40:00Z",
end="2024-04-02T09:00:00Z",
cache_dir="data/cache",
output_dir="data/outputs",
event_name="shenzhou15_reentry",
)
Getting Started
API Reference
About