How satyamprakash09/iss_tracker works
Project Type and Purpose
• Type: A lightweight Python utility (open‐source tool) that continuously fetches ISS position data from an external API, renders it on a Turtle‐graphics world map, and logs each data point to CSV.
• Purpose: Real‐time visualization plus persistent logging of ISS telemetry.
File Structure
• Top‐level files only:
• main.py (the “iss_tracker.py” or “main.py” script driving everything)
• iss_data.csv (persistent storage)
• iss.gif, world.png (static assets for visualization)
• stations.txt (unused or reference data)
• No frontend/backend split—everything runs in one process.
• External config: none beyond hard‐coded API URL and file names.
README Insights
• Core modules implicitly described:
• API Client (requests to wheretheiss.at)
• Data Logger (writes CSV)
• Visual Renderer (Turtle Graphics)
• Update loop frequency: every 3 seconds
• Error‐retry logic: on API failure, wait 10 seconds, then retry.
Main Components & Their Interactions
a. External Service
• wheretheiss.at API
• Data format: JSON (latitude, longitude, velocity, timestamp)
b. API Client Module (inside main.py)
• Sends HTTP GET → receives JSON
• Error handling / retry back-off
c. Data Processor / Logger
• Parses JSON fields
• Appends a new row to iss_data.csv
d. Visualization Module
• Loads world.png as background
• Converts lat/long → screen coordinates
e. Core Control Loop
• Sleeps 3 seconds between iterations
• Coordinates API call → parse → log → render
Architectural Patterns & Principles
• Single‐process, event loop pattern
• Separation of concerns within main.py:
• Networking vs. Parsing vs. UI vs. Persistence
• Extensibility point: you could swap out the CSV logger for a database adapter or add additional visualization widgets.