mirror of
https://github.com/acamarata/pray-calc-ml.git
synced 2026-07-02 03:40:39 +00:00
Replaces the original JS calibration library with a pure Python pipeline for collecting and back-calculating solar depression angles from human-verified Fajr and Isha prayer sightings. What this does: - src/pipeline.py: master pipeline; fetches iCal + manual records, back-calculates angles via PyEphem, applies quality filters, exports two clean CSVs - src/collect/openfajr.py: parses the OpenFajr Birmingham iCal feed (~4,018 records) - src/collect/verified_sightings.py: manually compiled records from peer-reviewed studies (Egypt, Saudi Arabia, Malaysia, Indonesia, UK, USA, Canada, and more) - src/angle_calc.py: PyEphem back-calculation with atmospheric refraction - src/elevation.py: Open-Elevation API batch lookup Datasets generated: - data/processed/fajr_angles.csv: 4,105 confirmed Fajr records, 35 locations, latitude range -37.8 to 53.7 degrees, date range 1985-2026 - data/processed/isha_angles.csv: 43 confirmed Isha records, 20+ locations Also includes: - notebooks/01_exploratory_analysis.ipynb: latitude, TOY, elevation pattern analysis - research/: academic paper summaries (not training data) - data/raw/sources.md: full citation table for all data sources
75 lines
3 KiB
Markdown
75 lines
3 KiB
Markdown
# Malaysia and Indonesia Studies
|
|
|
|
## Kassim Bahali et al. 2018 (DSLR Study)
|
|
|
|
**Paper:** Kassim Bahali, N.F., et al. "Determination of Fajr and Isha prayer times based on
|
|
astronomical observation at low latitude." *Sains Malaysia*, 47(11): 2797-2805, 2018.
|
|
|
|
**Location:** Kuala Lumpur and surrounding Malaysia/Indonesia sites (2°N-7°S range)
|
|
**Method:** DSLR astrophotography + SQM (Sky Quality Meter) sky brightness
|
|
**Data:** 64 observation days, February-December 2017
|
|
|
|
**Key result:** Mean Fajr depression = **16.67°** (range 13.9°-19.8°)
|
|
|
|
The DSLR + SQM combination is methodologically stronger than naked-eye only. The SQM
|
|
provides an objective measure of sky brightness that eliminates observer subjectivity.
|
|
At near-equatorial latitudes (2°-7°), the Sun rises and sets at a steep angle through the
|
|
horizon, producing very short, sharp twilight transitions.
|
|
|
|
---
|
|
|
|
## Saksono 2020 (Depok, Indonesia)
|
|
|
|
**Paper:** Saksono, T. "Fajr prayer time determination using the Sky Quality Meter."
|
|
*NRIAG Journal of Astronomy and Geophysics*, 9(1): 238-244, 2020.
|
|
|
|
**Location:** Depok, West Java, Indonesia (6.4°S, 106.83°E, 65m)
|
|
**Method:** SQM sky brightness monitoring; 26 nights June-July 2015
|
|
**Result:** ~16° mean Fajr depression
|
|
|
|
---
|
|
|
|
## Hamidi 2007-2008 (Malaysia Isha Study)
|
|
|
|
**Source:** Zety Sharizat Hamidi, *Determination of Isha prayer time based on shafaq abyad in
|
|
Malaysia.* Academia.edu, 2008.
|
|
|
|
**Location:** Two sites:
|
|
- Kuala Lipis: 4.183°N, 102.040°E, 76m (east coast)
|
|
- Port Klang: 3.004°N, 101.403°E, 5m (west coast)
|
|
|
|
**Method:** Naked-eye observation of Shafaq al-Abyad disappearance; May 2007 - April 2008
|
|
**Result:** Isha (Shafaq Abyad) consistently at approximately **16°-17°** depression
|
|
|
|
---
|
|
|
|
## OIF UMSU (Medan, North Sumatra 2017-2020)
|
|
|
|
**Location:** OIF (Observatory of Islamic Fajr) at University of Muhammadiyah North Sumatra,
|
|
Medan (3.595°N, 98.672°E, 22m)
|
|
**Method:** SQM photometry; hundreds of observation days
|
|
**Proposed angle:** 16.48° for Indonesian national standard
|
|
|
|
---
|
|
|
|
## Key Pattern: Equatorial Sites Yield Higher Angles
|
|
|
|
All Malaysia/Indonesia studies find Fajr at ~16°-17°, compared to ~13°-14° in Birmingham
|
|
and the UK. This is a systematic and significant pattern:
|
|
|
|
| Latitude | Representative Site | Mean Fajr Angle |
|
|
| --- | --- | --- |
|
|
| 52°N | Birmingham, UK | ~13° |
|
|
| 40°N | Ankara, Turkey | ~15° |
|
|
| 30°N | Egypt (desert) | ~13.5°-14.5° |
|
|
| 27°N | Hail, Saudi Arabia (1020m) | ~14.4° |
|
|
| 3°-7°N | Malaysia/Indonesia | ~16°-17° |
|
|
| 3°-7°S | Indonesia (Java) | ~16°-17° |
|
|
| 33°-37°S | Cape Town / Auckland | ~15°-16° |
|
|
|
|
This counter-intuitive result (equatorial sites have *higher* angles than mid-latitude sites)
|
|
is likely caused by the geometry of the Earth's atmosphere: at equatorial latitudes, the Sun
|
|
rises at a steeper angle through the horizon, so morning twilight is briefer and more intense.
|
|
The same absolute angle corresponds to a later moment relative to sunrise at lower latitudes.
|
|
|
|
The ML model should capture this latitude-dependent pattern.
|