mirror of
https://github.com/acamarata/pray-calc-ml.git
synced 2026-07-01 11:24:26 +00:00
6abc976bb9
- Regenerate fajr_angles.csv with current collection state - Update wiki docs to reflect current dataset stats - Add missing requirements and minor pipeline fixes
87 lines
2.5 KiB
Python
87 lines
2.5 KiB
Python
"""
|
|
Collect verified Fajr sightings from the OpenFajr project (Birmingham, UK).
|
|
|
|
OpenFajr is a year-long (and ongoing) astrophotography project in which
|
|
scholars and community members reviewed ~25,000 sky photographs and voted
|
|
on when true dawn appeared each day. The resulting Fajr times are published
|
|
as a Google Calendar iCal feed.
|
|
|
|
Source: https://openfajr.org/
|
|
Location: Birmingham, UK — 52.4862°N, 1.8904°W, elevation 141 m
|
|
"""
|
|
|
|
from datetime import datetime, timezone
|
|
|
|
import pandas as pd
|
|
import requests
|
|
|
|
ICAL_URL = (
|
|
"https://calendar.google.com/calendar/ical/"
|
|
"qmho4v5896ki2mc5supv0ikgfs%40group.calendar.google.com/public/basic.ics"
|
|
)
|
|
|
|
# Fixed location for all Birmingham observations
|
|
BIRMINGHAM_LAT = 52.4862
|
|
BIRMINGHAM_LNG = -1.8904
|
|
BIRMINGHAM_ELEV_M = 141.0
|
|
BIRMINGHAM_SOURCE = "OpenFajr (openfajr.org)"
|
|
|
|
|
|
def fetch_openfajr(url: str = ICAL_URL) -> pd.DataFrame:
|
|
"""
|
|
Download the OpenFajr iCal feed and return a DataFrame of confirmed Fajr
|
|
sightings.
|
|
|
|
Columns:
|
|
date : date (local calendar date in Europe/London)
|
|
utc_dt : datetime (UTC, timezone-aware)
|
|
lat : float
|
|
lng : float
|
|
elevation_m : float
|
|
prayer : str ("fajr")
|
|
source : str
|
|
notes : str
|
|
"""
|
|
resp = requests.get(url, timeout=30)
|
|
resp.raise_for_status()
|
|
text = resp.text
|
|
|
|
records = []
|
|
for block in text.split("BEGIN:VEVENT")[1:]:
|
|
data: dict[str, str] = {}
|
|
for line in block.splitlines():
|
|
if ":" in line:
|
|
k, _, v = line.partition(":")
|
|
data[k.strip()] = v.strip()
|
|
|
|
summary = data.get("SUMMARY", "")
|
|
if "Fajr" not in summary:
|
|
continue
|
|
|
|
dt_raw = data.get("DTSTART", "")
|
|
if not dt_raw.endswith("Z"):
|
|
continue # skip local-time entries (there are none, but guard anyway)
|
|
|
|
try:
|
|
utc_dt = datetime.strptime(dt_raw, "%Y%m%dT%H%M%SZ").replace(
|
|
tzinfo=timezone.utc
|
|
)
|
|
except ValueError:
|
|
continue
|
|
|
|
records.append(
|
|
{
|
|
"date": utc_dt.date(),
|
|
"utc_dt": utc_dt,
|
|
"lat": BIRMINGHAM_LAT,
|
|
"lng": BIRMINGHAM_LNG,
|
|
"elevation_m": BIRMINGHAM_ELEV_M,
|
|
"prayer": "fajr",
|
|
"source": BIRMINGHAM_SOURCE,
|
|
"notes": "",
|
|
}
|
|
)
|
|
|
|
df = pd.DataFrame(records)
|
|
df = df.sort_values("utc_dt").reset_index(drop=True)
|
|
return df
|