quran

📖 An R package for the complete text of the Qur'an

https://github.com/andrewheiss/quran

Science Score: 10.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
  • .zenodo.json file
  • DOI references
  • Academic publication links
    Links to: zenodo.org
  • Committers with academic emails
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (11.9%) to scientific vocabulary

Keywords

islam quran r text-mining tidytext
Last synced: 6 months ago · JSON representation

Repository

📖 An R package for the complete text of the Qur'an

Basic Info
  • Host: GitHub
  • Owner: andrewheiss
  • License: other
  • Language: R
  • Default Branch: master
  • Size: 2.71 MB
Statistics
  • Stars: 30
  • Watchers: 4
  • Forks: 7
  • Open Issues: 1
  • Releases: 0
Topics
islam quran r text-mining tidytext
Created about 7 years ago · Last pushed over 5 years ago
Metadata Files
Readme License

README.md

quRan

CRAN_Status_Badge DOI

Downloads Downloads lifecycle

An R package for the full text of the Qur'an

This package contains the complete text of the Qur'an in Arabic (with and without vowels) and in English (the Yusuf Ali and Saheeh International translations).

The text for each volume or translation was sourced from Tanzil and Al Quran Cloud.

Each volume is in a data frame with a row for each ayah, along with 18 columns of detailed metadata (including ayah number, surah number, surah name in Arabic and English, juz', hizb, and so on), ready for text analysis.

The package contains:

  • quran_ar: The Qur'an in Arabic (with vowels)
  • quran_ar_min: The Qur'an in Arabic (without vowels)
  • quran_en_yusufali: The Yusuf Ali English translation of the Qur'an
  • quran_en_sahih: The Saheeh International English translation of the Qur'an

Surah titles in Arabic, transliterated English, and translated English are all factors to preserve the correct order.

Installation

To install the current stable version of the package, type the following:

r install.packages("quRan") library(quRan)

Alternatively, you can install the development version from Github:

r library(remotes) install_github("andrewheiss/quRan") library(quRan)

Usage

For some ideas on getting started with analyzing these texts, see Text Mining with R by Julia Silge and David Robinson, or Julia Silge's blog post on sentiment analysis of Jane Austen's novels. For help within R, try ?quran_ar or similar for getting started with the datasets.

Here's how to do some basic data manipulation with the data:

``` r library(dplyr) library(quRan)

quranar %>% groupby(surahtitleen) %>% summarize(total_ayat = n())

> # A tibble: 114 x 2

> surahtitleen total_ayat

>

> 1 Al-Faatiha 7

> 2 Al-Baqara 286

> 3 Aal-i-Imraan 200

> 4 An-Nisaa 176

> 5 Al-Maaida 120

> 6 Al-An'aam 165

> 7 Al-A'raaf 206

> 8 Al-Anfaal 75

> 9 At-Tawba 129

> 10 Yunus 109

> # ... with 104 more rows

quranar %>% filter(surahtitle_en == "Al-Faatiha") %>% select(surah, ayah, text)

> # A tibble: 7 x 3

> surah ayah text

>

> 1 1 1 بِسْمِ اللَّهِ الرَّحْمَٰنِ الرَّحِيمِ

> 2 1 2 الْحَمْدُ لِلَّهِ رَبِّ الْعَالَمِينَ

> 3 1 3 الرَّحْمَٰنِ الرَّحِيمِ

> 4 1 4 مَالِكِ يَوْمِ الدِّينِ

> 5 1 5 إِيَّاكَ نَعْبُدُ وَإِيَّاكَ نَسْتَعِينُ

> 6 1 6 اهْدِنَا الصِّرَاطَ الْمُسْتَقِيمَ

> 7 1 7 صِرَاطَ الَّذِينَ أَنْعَمْتَ عَلَيْهِمْ غَيْرِ الْمَغْضُوبِ عَلَيْهِمْ وَلَا الضَّالِّينَ

```

Code of Conduct

This project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.

Credits

The text and translations are all open source or licensed under Creative Commons by Tanzil and Al Quran Cloud. The licenses have been converted to MIT here, due to CRAN's policy that the entire package use the same license throughout.


Tanzil Quran License

  • This quran text is distributed under the terms of a Creative Commons Attribution 3.0 License.

  • Permission is granted to copy and distribute verbatim copies of this text, but CHANGING IT IS NOT ALLOWED.

  • This quran text can be used in any website or application, provided its source (Tanzil.net) is clearly indicated, and a link is made to http://tanzil.net to enable users to keep track of changes.

  • This copyright notice shall be included in all verbatim copies of the text, and shall be reproduced appropriately in all files derived from or containing substantial portion of this text.


Text taken from AlQuran.cloud and the Islamic Network is open source

https://alquran.cloud/terms-and-conditions


Saheeh International Translation provided by the Qur'an Project with no rights reserved

See https://archive.org/stream/QuranTranslationBySaheehInternational/Quran%20-%20Translation%20by%20Saheeh%20International_djvu.txt


Fatihah background in hex icon from seeklogo.

Owner

  • Name: Andrew Heiss
  • Login: andrewheiss
  • Kind: user
  • Location: Atlanta, GA
  • Company: Georgia State University

Assistant professor at @aysps at GSU. Study philanthropy, nonprofits, authoritarianism, & legal restrictions on civil society. R + Stan + sometimes Python.

GitHub Events

Total
  • Watch event: 1
Last Year
  • Watch event: 1

Committers

Last synced: 8 months ago

All Time
  • Total Commits: 11
  • Total Committers: 1
  • Avg Commits per committer: 11.0
  • Development Distribution Score (DDS): 0.0
Past Year
  • Commits: 0
  • Committers: 0
  • Avg Commits per committer: 0.0
  • Development Distribution Score (DDS): 0.0
Top Committers
Name Email Commits
Andrew Heiss a****w@a****m 11
Committer Domains (Top 20 + Academic)

Issues and Pull Requests

Last synced: 8 months ago

All Time
  • Total issues: 0
  • Total pull requests: 1
  • Average time to close issues: N/A
  • Average time to close pull requests: N/A
  • Total issue authors: 0
  • Total pull request authors: 1
  • Average comments per issue: 0
  • Average comments per pull request: 1.0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 0
  • Pull requests: 0
  • Average time to close issues: N/A
  • Average time to close pull requests: N/A
  • Issue authors: 0
  • Pull request authors: 0
  • Average comments per issue: 0
  • Average comments per pull request: 0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
Pull Request Authors
  • mcnakhaee (1)
Top Labels
Issue Labels
Pull Request Labels

Packages

  • Total packages: 1
  • Total downloads:
    • cran 200 last-month
  • Total dependent packages: 0
  • Total dependent repositories: 0
  • Total versions: 1
  • Total maintainers: 1
cran.r-project.org: quRan

Complete Text of the Qur'an

  • Versions: 1
  • Dependent Packages: 0
  • Dependent Repositories: 0
  • Downloads: 200 Last month
Rankings
Forks count: 9.1%
Stargazers count: 10.0%
Dependent packages count: 29.8%
Average: 33.6%
Dependent repos count: 35.5%
Downloads: 83.8%
Maintainers (1)
Last synced: 6 months ago

Dependencies

DESCRIPTION cran
  • R >= 3.0.0 depends
  • dplyr * suggests
  • testthat * suggests