https://github.com/evgeniyarbatov/gnss
Map GNSS Android IDs to NORAD IDs
https://github.com/evgeniyarbatov/gnss
android dotenv-secrets gnss gnss-data kaggle-api pandas python-data-processing satellite
Last synced: about 1 month ago
JSON representation
Map GNSS Android IDs to NORAD IDs
- Host: GitHub
- URL: https://github.com/evgeniyarbatov/gnss
- Owner: evgeniyarbatov
- License: mit
- Created: 2025-03-01T14:56:56.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-12-18T05:12:54.000Z (6 months ago)
- Last Synced: 2025-12-21T13:55:28.414Z (6 months ago)
- Topics: android, dotenv-secrets, gnss, gnss-data, kaggle-api, pandas, python-data-processing, satellite
- Language: Python
- Homepage: https://www.kaggle.com/datasets/evgenyarbatov/gnss-satellites/
- Size: 472 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🛰️ 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](https://www.kaggle.com/datasets/evgenyarbatov/gnss-satellites/)
Sources used:
- [GNSSLogger app](https://play.google.com/store/apps/details?id=com.google.android.apps.location.gps.gnsslogger&hl=en) for raw data
- [CelesTrak](https://celestrak.org) for GNSS satellite IDs
- [Space-Track.org](https://www.space-track.org/auth/login) for TLE data
## ⚙️ 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
```sh
# 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
```