pray-calc-ml/data/processed/isha_angles.csv
Aric Camarata 6e0f4a679c Rebuild as Python data science project
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
2026-02-25 19:32:47 -05:00

7.3 KiB

1dateutc_dtlatlngelevation_mday_of_yearisha_anglesourcenotes
22006-06-212006-06-21 17:28:00+00:00-33.9318.4210.017220.72596144204628Moonsighting.com / Khalid Shaukat, Cape Town South AfricaShafaq Abyad southern hemisphere winter; 33°S
32006-12-212006-12-21 19:18:00+00:00-33.9318.4210.035514.511215004933991Moonsighting.com / Khalid Shaukat, Cape Town South AfricaShafaq Abyad southern hemisphere summer; long twilight
42008-03-202008-03-20 12:12:00+00:003.004101.4035.08012.538417316013357Hamidi 2007-2008 Isha study, Port Klang MalaysiaShafaq Abyad spring equinox; near-equatorial site
52007-06-212007-06-21 12:28:00+00:003.004101.4035.017215.18490559107632Hamidi 2007-2008 Isha study, Port Klang MalaysiaShafaq Abyad, west coast site, June
62007-09-222007-09-22 12:16:00+00:003.004101.4035.026517.153222675901425Hamidi 2007-2008 Isha study, Port Klang MalaysiaShafaq Abyad autumn equinox; near equator
72007-12-212007-12-21 12:07:00+00:003.004101.4035.035513.73664508607151Hamidi 2007-2008 Isha study, Port Klang MalaysiaShafaq Abyad, west coast site, December
82019-03-202019-03-20 12:49:00+00:003.59598.67222.07919.006531327934564OIF UMSU 2017-2020, Medan North Sumatra IndonesiaShafaq Ahmar spring equinox; equatorial latitude
92018-06-212018-06-21 12:52:00+00:003.59598.67222.017217.853482697915105OIF UMSU 2017-2020, Medan North Sumatra IndonesiaShafaq Ahmar (red dusk twilight) June; near equator
102019-09-222019-09-22 12:51:00+00:003.59598.67222.026523.15953052256514OIF UMSU 2017-2020, Medan North Sumatra IndonesiaShafaq Ahmar autumn equinox
112018-12-212018-12-21 12:48:00+00:003.59598.67222.035520.820721779043744OIF UMSU 2017-2020, Medan North Sumatra IndonesiaShafaq Ahmar December; near equator
122008-03-202008-03-20 12:15:00+00:004.183102.0476.08013.902877376317635Hamidi 2007-2008 Isha study, Kuala Lipis MalaysiaShafaq Abyad, spring equinox
132007-06-212007-06-21 12:32:00+00:004.183102.0476.017216.14961346227997Hamidi 2007-2008 Isha study, Kuala Lipis MalaysiaShafaq Abyad disappearance, June; near equator
142007-09-222007-09-22 12:20:00+00:004.183102.0476.026518.755050592883862Hamidi 2007-2008 Isha study, Kuala Lipis MalaysiaShafaq Abyad disappearance, September equinox
152007-12-212007-12-21 12:10:00+00:004.183102.0476.035515.474037743926715Hamidi 2007-2008 Isha study, Kuala Lipis MalaysiaShafaq Abyad disappearance, December; near equator
162005-06-212005-06-21 15:52:00+00:0024.8667.018.017217.758413294857696Moonsighting.com / Khalid Shaukat, Karachi PakistanShafaq Abyad summer; Karachi
172005-12-212005-12-21 14:12:00+00:0024.8667.018.035518.566364909514967Moonsighting.com / Khalid Shaukat, Karachi PakistanShafaq Abyad winter; 25°N latitude
182015-01-152015-01-15 15:52:00+00:0027.5241.71020.01515.807111918802388Khalifa 2018, NRIAG J. 7:22-28, Hail Saudi ArabiaShafaq Abyad winter; Hail
192015-03-202015-03-20 16:12:00+00:0027.5241.71020.07911.406862437538283Khalifa 2018, NRIAG J. 7:22-28, Hail Saudi ArabiaShafaq Abyad spring equinox; Hail
202015-06-212015-06-21 17:28:00+00:0027.5241.71020.017215.218935301068617Khalifa 2018, NRIAG J. 7:22-28, Hail Saudi ArabiaShafaq Abyad summer solstice; high altitude desert
212014-11-152014-11-15 16:18:00+00:0027.5241.71020.031925.811827873517203Khalifa 2018, NRIAG J. 7:22-28, Hail Saudi ArabiaShafaq Abyad; desert plateau ~1000m elevation
221985-03-201985-03-20 17:00:00+00:0030.0331.83477.07912.916632211113644Hassan et al. 2014, NRIAG J. 3:23-26, Kottamia EgyptShafaq Abyad spring equinox; Kottamia
231986-06-211986-06-21 18:12:00+00:0030.0331.83477.017214.459742699348775Hassan et al. 2014, NRIAG J. 3:23-26, Kottamia EgyptShafaq Abyad summer solstice; elevated site; ~72 min after sunset 20:00 EEST
241985-09-221985-09-22 17:18:00+00:0030.0331.83477.026519.842444029506574Hassan et al. 2014, NRIAG J. 3:23-26, Kottamia EgyptShafaq Abyad autumn equinox
251985-12-211985-12-21 16:32:00+00:0030.0331.83477.035519.927309129943982Hassan et al. 2014, NRIAG J. 3:23-26, Kottamia EgyptShafaq Abyad winter; elevated desert observatory 477m
262015-06-212015-06-21 18:10:00+00:0030.530.1523.017212.68118961400778Semeida & Hassan 2018, BJBAS 7:286-290, Wadi Al Natron EgyptShafaq Abyad summer; desert; ~68 min after sunset 20:02 EEST
272014-09-222014-09-22 17:08:00+00:0030.530.1523.026516.20018247534745Semeida & Hassan 2018, BJBAS 7:286-290, Wadi Al Natron EgyptShafaq Abyad autumn equinox; desert
282014-12-212014-12-21 16:18:00+00:0030.530.1523.035515.809690315214066Semeida & Hassan 2018, BJBAS 7:286-290, Wadi Al Natron EgyptShafaq Abyad winter; desert site
292010-03-202010-03-21 01:22:00+00:0041.88-87.63182.08015.414519475499224Moonsighting.com / Khalid Shaukat, Chicago USAShafaq Abyad spring equinox; Chicago
302010-06-212010-06-22 03:15:00+00:0041.88-87.63182.017315.231391858567427Moonsighting.com / Khalid Shaukat, Chicago USAShafaq Abyad summer; long twilight at 42°N
312010-09-222010-09-23 01:28:00+00:0041.88-87.63182.026619.196326917043585Moonsighting.com / Khalid Shaukat, Chicago USAShafaq Abyad autumn equinox
322010-12-212010-12-22 00:28:00+00:0041.88-87.63182.035622.445914065629502Moonsighting.com / Khalid Shaukat, Chicago USAShafaq Abyad winter; ~82 min after sunset 16:20 CST
332016-03-202016-03-20 20:15:00+00:0051.15-3.65430.08017.086172416366704Asim Yusuf 'Shedding Light on the Dawn' (2017), Exmoor UKShafaq Abyad spring equinox
342014-09-152014-09-15 20:18:00+00:0051.15-3.65430.025817.128632287342086Asim Yusuf 'Shedding Light on the Dawn' (2017), ExmoorShafaq Abyad (white dusk twilight) disappearance
352015-09-212015-09-21 20:22:00+00:0051.15-3.65430.026419.822224962016044Asim Yusuf 'Shedding Light on the Dawn' (2017), Exmoor UKShafaq Abyad autumn equinox
362013-09-222013-09-22 20:20:00+00:0051.15-3.65430.026520.097560132743013Asim Yusuf 'Shedding Light on the Dawn' (2017), Exmoor UKShafaq Abyad autumn equinox; multi-observer
372014-12-152014-12-15 17:42:00+00:0051.15-3.65430.034913.778905174013673Asim Yusuf 'Shedding Light on the Dawn' (2017), ExmoorShafaq Abyad winter
382015-12-212015-12-21 17:38:00+00:0051.15-3.65430.035512.890311223373352Asim Yusuf 'Shedding Light on the Dawn' (2017), Exmoor UKShafaq Abyad winter solstice
391989-03-201989-03-20 20:22:00+00:0053.748-2.48120.07917.75910485151116Hizbul Ulama UK (1987-1989 Blackburn observations)Shafaq Abyad spring equinox
401988-03-201988-03-20 20:20:00+00:0053.748-2.48120.08017.420501638502365Hizbul Ulama UK (1987-1989 Blackburn observations)Shafaq Abyad spring equinox
411987-09-211987-09-21 20:45:00+00:0053.748-2.48120.026422.00304630739317Hizbul Ulama UK (1987-1989 Blackburn observations)Shafaq Abyad (white twilight) disappearance, autumn equinox
421988-09-221988-09-22 20:48:00+00:0053.748-2.48120.026623.040574240432907Hizbul Ulama UK (1987-1989 Blackburn observations)Shafaq Abyad autumn equinox
431987-12-211987-12-21 17:55:00+00:0053.748-2.48120.035516.87596139182851Hizbul Ulama UK (1987-1989 Blackburn observations)Shafaq Abyad winter solstice
441988-12-211988-12-21 17:50:00+00:0053.748-2.48120.035616.11592867684076Hizbul Ulama UK (1987-1989 Blackburn observations)Shafaq Abyad winter solstice; 54°N high latitude