Skip to content

README.md

Latest commit

 

History

History
69 lines (47 loc) · 1.9 KB

README.md

File metadata and controls

69 lines (47 loc) · 1.9 KB
Raw

🛰️ GNSS Observations

Map GNSS satellite IDs from Android logs to NORAD catalog IDs This project links GNSS satellite identifiers reported by Android devices with real-world NORAD catalog IDs using Two-Line Element sets (TLEs). It helps bridge raw GNSS observations with publicly available orbital data—useful for research, geolocation analysis, or satellite tracking.

📊 Dataset

Kaggle dataset:

🔗 GNSS Satellites

Sources used:

⚙️ Getting Started

Prerequisites

  • A free account on Space-Track.org
  • Android device with GNSSLogger installed
    • Make sure Status logging is enabled
  • GNSS logs stored on your personal Google Drive

🚀 Running the Pipeline

# 1. Set up a virtual environment
make venv

# 2. Install dependencies
make install

# 3. Initialize project with your credentials
make init

# 4. Download GNSS satellite IDs from CelesTrak
make ids

# 5. Filter satellite IDs to active satellites (launched in the last 15 years)
make active

# 6. Download current TLEs from Space-Track
make tle

# 7. Download GNSSLogger logs from your Google Drive
make log

# 8. Match observed GNSS satellites to closest NORAD satellites in TLEs
make match

# 9. Upload the matched dataset to Kaggle
make upload

📁 Project Structure

GNSS-Observations/
├── logs/           # GNSSLogger logs from Android devices
├── tle/            # TLE files from Space-Track
├── ids/            # Satellite IDs from CelesTrak
├── scripts/        # Matching and processing logic
├── Makefile        # Automation for all steps
└── README.md