pray-calc-ml/research
Aric Camarata c1eeef53c4 Expand dataset to 5,871 Fajr / 46 Isha across 114 locations
Major additions:
- Extract all 1,621 Basthoni 2022 SQM records (46 Indonesian sites,
  Lampiran 2-5) via precomputed_angles.py
- Add 9 new raw sighting CSVs: Abdel-Hadi Malaysia, BRIN multistation,
  Kassim Bahali (2017+2019), Khalifa Saudi, Moonsighting.com,
  Shaukat 2015 Blackburn UK, Walisongo Sulawesi
- Curate aggregate D0 database (115 entries) in research/

Pipeline improvements:
- Open-Topo-Data SRTM30m primary elevation API with fallback
- APPROVED_RAW_CSVS allowlist prevents circular data ingestion
- Pre-computed angle merge path (bypasses back-calculation for SQM data)
- BAD_NOTE_MARKERS quality filter for excluded sources

Collection tools:
- BRIN multistation SQM processors
- PDF/HTML table extractor for academic papers
- Source tracking database (collection_manifest.json)

Documentation:
- Rewrite .wiki/Data.md and .wiki/Research.md from scratch
- Expand Data-Sources.md with full Basthoni Lampiran breakdown
- Add 14 researcher outreach drafts
- Update .gitignore to exclude bulk/experimental files
2026-02-28 10:51:01 -05:00
..
outreach Expand dataset to 5,871 Fajr / 46 Isha across 114 locations 2026-02-28 10:51:01 -05:00
aggregate_comparison.md Expand dataset to 5,871 Fajr / 46 Isha across 114 locations 2026-02-28 10:51:01 -05:00
aggregate_d0_values.csv Expand dataset to 5,871 Fajr / 46 Isha across 114 locations 2026-02-28 10:51:01 -05:00
birmingham-openfajr.md Rebuild as Python data science project 2026-02-25 19:32:47 -05:00
hail-saudi-2018.md Rebuild as Python data science project 2026-02-25 19:32:47 -05:00
malaysia-indonesia-2018.md Rebuild as Python data science project 2026-02-25 19:32:47 -05:00
nriag-egypt-1984-2014.md Rebuild as Python data science project 2026-02-25 19:32:47 -05:00
README.md Rebuild as Python data science project 2026-02-25 19:32:47 -05:00
uk-observations.md Rebuild as Python data science project 2026-02-25 19:32:47 -05:00

Research Archive

This folder contains summaries of academic and institutional research on Islamic twilight angles. These papers describe other researchers' conclusions about the solar depression angle at Fajr and Isha. They are useful for understanding the scientific landscape but are not used as ML training data — only raw per-date observations with explicit timestamps feed the data/processed/ datasets.

Summary: What the research says

Most peer-reviewed naked-eye studies find Fajr (true dawn / Subh Sadiq) corresponds to a solar depression of roughly 13°16° depending on site, season, and atmospheric conditions. Isha (Shafaq al-Abyad, white dusk twilight) corresponds to roughly 14°18°.

The classic convention of 18° Fajr (used by ISNA, MWL, and others) is based on astronomical twilight (the sky becoming fully dark), not the first appearance of dawn light. Observations consistently show true dawn appears while the sun is 12°15° below the horizon, not 18°.

Papers Summarized

File Authors Year Site Finding
nriag-egypt-1984-2014.md Hassan et al. 1984-2014 Egypt (6 sites) 13°-15° Fajr
nriag-egypt-2022-2025.md Rashed et al. 2018-2025 Egypt (Fayum, Alex) 13°-14° Fajr
hail-saudi-2018.md Khalifa 2014-2015 Hail, Saudi Arabia 14° mean Fajr
malaysia-indonesia-2018.md Kassim Bahali 2017 KL + Indonesia 16.67° Fajr
depok-indonesia-2020.md Saksono 2015 Depok, Java ~16° Fajr
uk-observations.md Yusuf, Hizbul Ulama 1987-2017 UK (3 sites) 12°-14° Fajr
birmingham-openfajr.md OpenFajr project 2016-2026 Birmingham 12.5°-14° Fajr
moonsighting-global.md Khalid Shaukat 2000s Multiple global 15°-18° Fajr