PyQuran: The Python package for Quranic Analysis
PyQuran is a package which provides tools for Quranic Analysis and Arabic texts.
It is still a small package which needs a lot of your effort. We believe that it is a seed of a fundamental general package for computations on Quran with Python, even at the most basic level which is simply retrieving Quran text.
Before Islam, Arabic letters were without dots— rasm, which resulted in ambiguty, two or three letters had the same rasm or form.
Muslims have decided to remove this ambiguity by adding dots above or below each letter of the ones which share the same rasm. Now each letter has a unique form. By the way, originally, Quran was written using letters without dots.
To enable researchers to use modern alphabet, old rasm or other, we introduce alphabetical systems, It is a dynamic construction of letters— Alphabetical Systems.
Current Features
- Quran Retrieving.
- Advanced Searching, by Text and Diacritics Patterns.
- Buckwalter Transliteration, back and forth.
- Multiple alphabetical systems.
- Words Frequency Table المعجم الترددى للألفاظ .
Quran Corpus
We use tanzil Quran Corpus (Uthmani Text), it is in UTF-8 encoding. You
can find all unique characters of Uthmanic Corpus
here.
There are special recitation symbols مصطلحات الضبط in the Uthmani Text, they are a guide for the reciter to know the right positions to pause and the rules of tajweed. We provide an interface to filter those symbols, on the fly while fetching from the corpus, we DO NOT change the corpus, NEVER.
For the full details about filtering special recitation symbols مصطلحات الضبط.
Contributing
To contribute and maintain PyQuran, Please read CONTRIBUTING.md.
Dependencies
Install
- From PyPI:
$ pip3 install PyQuran
Citing
@MISC {PyQuran2018,
author = "Waleed A. Yousef and
Taha M. Madbouly and
Omar M. Ibrahime and
Ali H. El-Kassas and
Ali O. Hassan and
Abdallah R. Albohy",
title = "PyQuran: The Python package for Quranic Analysis",
howpublished = "https://hci-lab.github.io/PyQuran-Private",
year = "2018"}