ISS ShadowTrace is a precision, browser-based tool for predicting and planning transits
of the International Space Station (ISS) across the solar and lunar disks. No installation
is required — all calculations run locally in your browser using real orbital mechanics.
Core Calculations
- Solar transits & close passes — detected by ray-casting the ISS→Sun direction onto the WGS84 ellipsoid, finding the exact ground point (center-line) from which the ISS would appear in front of the Sun
- Lunar transits & close passes — two-phase approach: coarse center-line filter for speed, then angular-separation minimisation (identical to transit-finder.com) for the accurate center-time and geometry
- Topocentric Moon parallax (Meeus, Ch. 40) — corrects the Moon's apparent position for the observer's location on Earth's surface; without this, errors of up to 57 arcminutes occur
- Atmospheric refraction (Bennett formula) — raises the apparent altitude of the Sun and Moon by up to 20 arcminutes at low elevations
- Physical ISS dimensions — an effective angular radius of 67 m is used, derived from the ISS wingspan and habitable module length, consistent with transit-finder.com values
- Sub-second timing precision — 45-iteration bisection search for ingress and egress times
- TLE orbit propagation via satellite.js (SGP4/SDP4), with colour-coded TLE age indicator and staleness warnings
Results & Display
- UTC and local time shown side by side for every event, with timezone offset
- ISS apparent angular diameter, slant range, azimuth, elevation and angular speed (arcsec/s)
- Angular separation from the disk centre of the Sun or Moon
- Ground center-line distance and visibility path width in kilometres
- Transit duration from ingress to egress in seconds (where applicable)
- Sky thumbnail showing the ISS track relative to the solar or lunar disk, with Moon phase rendered per event
- Elevation profile chart covering ±5 minutes around the transit time
- Hourly cloud-cover forecast (%) fetched from the Open-Meteo API
- Confidence rating — High / Medium / Low — based on TLE age and event geometry
Map, Planning & Tools
- Interactive Leaflet map with transit corridors, center-lines and path-width bands; solar corridors in red, lunar in blue
- Observer marker with a reference circle matching the search radius
- Live countdown timer to the next upcoming event
- Stellarium Web integration — opens the sky view at the exact event time and your coordinates
- Astrophotography calculator: field of view, plate scale (arcsec/px) and maximum exposure time before ISS motion blurs across one pixel
- Embedded real-time ISS tracker (isstracker.pl widget, optional load)
- Automatic GPS location detection with terrain elevation lookup via Open-Meteo
Export & Sharing
- Calendar export (.ics) for a single event or all results at once
- CSV export with all orbital and geometric parameters for offline analysis
- Shareable URL — all search settings are encoded in the URL hash and restored automatically on page load
- Full bilingual interface: English and Bosnian, switchable at any time
- Light and dark theme, remembered between sessions
Accuracy note: With a fresh TLE (<12 h old), results agree
with transit-finder.com to within 1–3 km (center-line distance) and 2–5 seconds (center-time).
For lunar events with a TLE older than 24 h, deviations of 50–100 km are expected due to
ISS orbital drift. Always fetch a fresh TLE before planning an observation session.
ISS ShadowTrace je precizni alat koji radi u browseru i služi za predviđanje i planiranje
tranzita Međunarodne svemirske stanice (ISS) ispred solarnog i lunarnog diska. Instalacija
nije potrebna — svi proračuni izvršavaju se lokalno u vašem browseru, koristeći stvarnu
orbitalnu mehaniku.
Osnovni proračuni
- Solarni tranziti i bliski prolazi — detektuju se metodom ray-castinga u smjeru ISS→Sunce, projicirajući tačku na WGS84 elipsoidu (center-linija) s koje bi ISS bio vidljiv ispred Sunca
- Lunarni tranziti i bliski prolazi — dvofazni pristup: brzi filter na osnovu center-linije, a potom minimizacija kutnog rastojanja (identično s transit-finder.com) za tačno centralno vrijeme i geometriju
- Topocentrička paralaksa Mjeseca (Meeus, pogl. 40) — korigira prividni položaj Mjeseca za poziciju posmatrača na Zemljinoj površini; bez ove korekcije greška može iznositi do 57 lučnih minuta
- Atmosferska refrakcija (Bennettova formula) — podiže prividnu visinu Sunca i Mjeseca za do 20 lučnih minuta pri niskim elevacijama
- Fizičke dimenzije ISS-a — koristi se efektivni kutni polumjer od 67 m, izveden iz raspona solarnih panela i dužine stambenih modula ISS-a, konzistentno s vrijednostima na transit-finder.com
- Preciznost ispod sekunde — bisekcijska pretraga s 45 iteracija za određivanje ingress i egress vremena
- Propagacija orbite putem TLE-a — koristi biblioteku satellite.js (SGP4/SDP4), s indikatorom starosti TLE-a i upozorenjima u boji
Rezultati i prikaz
- UTC i lokalno vrijeme prikazani jedan pored drugog za svaki događaj, s oznakom pomaka vremenske zone
- Kutni prečnik ISS-a, kosa udaljenost, azimut, elevacija i kutna brzina (lučne sekunde/s)
- Kutno rastojanje od centra diska Sunca ili Mjeseca
- Udaljenost center-linije i širina puta vidljivosti na tlu, u kilometrima
- Trajanje tranzita od ingressa do egressа u sekundama (gdje je primjenjivo)
- Minijaturni prikaz neba s putanjom ISS-a u odnosu na solarni ili lunarni disk, s prikazom faze Mjeseca za svaki događaj
- Graf elevacijske putanje ISS-a u periodu ±5 minuta oko tranzita
- Satna prognoza oblačnosti (%) preuzeta iz Open-Meteo API-ja
- Ocjena pouzdanosti — Visoka / Srednja / Niska — na osnovu starosti TLE-a i geometrije događaja
Mapa, planiranje i alati
- Interaktivna Leaflet mapa s koridorima tranzita, center-linijama i trakama puta vidljivosti; solarni koridori su crveni, lunarni plavi
- Marker posmatrača s referentnim krugom koji odgovara polumjeru pretrage
- Odbrojavanje do sljedećeg predstojećeg događaja u realnom vremenu
- Integracija sa Stellarium Web — otvara prikaz neba u tačno vrijeme događaja i za vaše koordinate
- Astrofotografski kalkulator: vidno polje teleskopa, plate scale (arcsec/piksel) i maksimalni exposure prije nego ISS zamuće za jedan piksel
- Ugrađeni ISS tracker u realnom vremenu (widget isstracker.pl, učitava se na zahtjev)
- Automatska detekcija GPS lokacije s dohvatanjem nadmorske visine terena putem Open-Meteo
Izvoz i dijeljenje
- Izvoz u kalendar (.ics) — pojedinačni događaj ili svi rezultati odjednom
- CSV izvoz sa svim orbitalnim i geometrijskim parametrima za analizu van mreže
- Dijeljivi URL — svi parametri pretrage enkodiraju se u URL hash i automatski se obnavljaju pri otvaranju stranice
- Potpuno dvojezično sučelje: engleski i bosanski jezik, s mogućnošću prebacivanja u bilo kojem trenutku
- Svijetla i tamna tema, koje se pamte između sesija
Napomena o tačnosti: Uz svježi TLE (<12 h), rezultati se
poklapaju s transit-finder.com unutar 1–3 km (center-linija) i 2–5 sekundi (centralno
vrijeme). Za lunarne događaje s TLE-om starijim od 24 sata moguća su odstupanja od
50–100 km zbog drifta ISS orbite. Preporučuje se uvijek preuzeti svježi TLE prije planiranja
posmatranja.