salat 0.0.0

Tool to calculate accurate salat (prayer) times

salat

One of the pillars of Islam is salat, which is the act of praying five times a day. Each prayer has a specific time interval, defined in terms of the Sun's position so anyone anywhere in the world can know when it is time to pray.

However with modern computation most Muslims use calculated prayer times to determine when to pray instead of watching the Sun. This package performs accurate calculations using orbital dynamics equations instead of common approximations, and native Python tools like datetime to calculate these times.

Prayer Times

In general terms, the time range of a prayer is from it's start until the start of the next prayer, except for Fajr which ends at sunrise and Isha which is recommended to end before midnight. The start of the prayer time intervals are the following:

Name	Start of Time Range
Fajr	Beginning of twilight
Sunrise	Sunrise. Note that this marks the end of Fajr
Dhuhr	When the Sun passes its zenith
Asr	When the length of a shadow is the same as the length of the object (or with Hanafi method, twice the length of the object) plus its length when the Sun is at zenith
Maghrib	Sunset
Isha	When the red light of sunset is gone
Midnight	Halfway point of the night. Note that this marks the recommended end of Isha

However there are various methods and standards for what exact times these general terms correspond to. For example, according to the Muslim World League, Fajr starts when the altitude of the Sun is 18 degrees below the horizon, while the Islamic Society of North America determined it's when the sun is 15 degrees below the horizon.

Motivation

There are many websites with prayer time tables and apps that show automatically updating prayer times for your location for each day. However there are not many Python ones, and they either query the websites for time tables or use approximate methods.

This package has the following goals:

1. Accurate calculations using exact equations and high precision parameters where possible
2. Use developer friendly interface including datetimes and typehints
3. Support several calculation methods

Supported methods

This package supports the following calculation methods:

1. ISNA (Islamic Society of North America)
2. MWL (Muslim World League)
3. Egypt (Egyptian General Authority of Survey)
4. Tehran (Institute of Geophysics, University of Tehran)
5. Jafari (Shia Ithna Ashari, Leva Research Institute, Qum)

There are many more methods in use around the world, so if there's any missing that you would like to see please submit an issue.

Installation

pip install salat

Example code

import salat
import pytz
from datetime import datetime

pt = salat.PrayerTimes(salat.CalculationMethod.ISNA)
eastern = pytz.timezone('US/Eastern')
# address of NYC
longitude = -74.0060 # degrees East
latitude = 40.7128 # degrees North

prayer_times = pt.calc_times(datetime.now().date(), eastern, longitude, latitude)
for name, prayer_time in prayer_times.items():
    print(name, prayer_time)

Planned features

1. Adjustment for higher altitudes
2. Options for Isha/Fajr calculation in high altitudes based on "middle of the night" and "sevent of the night" methods
3. Add additional calculation methods like Makkah method by Umm al-Qura University, Makkah