This repository contains a backup and preservation of Dr. Shady Nasser's EV3 Database, which went down unexpectedly. The original EV3 database was a comprehensive compilation of Quranic textual variants that was publicly accessible until recently.

⚠️ This repository serves as a community preservation effort to maintain access to this valuable research resource.

The EV3 Database was created by Dr. Shady Nasser and contained comprehensive data on Quranic textual variants, including:

• 27,914 entries of Quranic textual variants
• All 114 chapters of the Quran covered
• 3,598 unique chapter:verse pairs with variants
• 5,667 entries with footnotes and additional notes
• Multiple transmission chains and manuscript traditions
• Reference to classical works like Shāṭibiyya, Mukhtaṣar, Itḥāf, etc.

• Textual Criticism: Compare variants across different transmissions
• Transmission Studies: Analyze chains of transmission for different readings
• Regional Variations: Study how readings varied across different regions
• Manuscript Studies: Reference to various manuscript traditions

• Modern UI with glass morphism design and animations
• Verse-grouped display - all variants for each verse in organized blocks
• Advanced search across all fields (Arabic text, manuals, transmissions)
• Real-time statistics and database overview
• Responsive design that works on all devices

• Data cleaning and validation scripts
• Arabic text encoding fixes for proper display
• Statistics generation and analysis tools
• Sample data creation for testing

• RESTful API for programmatic access
• Search endpoints with pagination
• Statistics endpoints for data analysis
• Individual entry access by ID

The simplest way to access the data is through the raw JSON file:

• File: scraped_data(1).json (5.3MB)
• Format: JSON array of objects with Arabic text, transmissions, manuals, etc.
• No setup required - just open the file in any text editor or JSON viewer

If you want to run the interactive web interface locally:

# Clone this repository
git clone [repository-url]
cd EV3-Database

# Run the setup script
python setup.py

python web_interface.py

Then open: http://localhost:5000

⚠️ Note: The web interface may have some functionality issues. If you encounter problems, the raw JSON data is always available as a reliable fallback.

• Browse all entries grouped by verse
• Search for specific variants (e.g., "basmala", "Shāṭibiyya")
• View transmission chains and manuscript sources
• Compare different readings of the same verse

1. Shāṭibiyya: 8,152 entries
2. Mukhtaṣar: 5,342 entries
3. Itḥāf: 4,272 entries
4. Durra: 3,552 entries
5. Muḥtasab: 1,247 entries

1. Ibn Muḥayṣin: 2,386 entries
2. al-Ḥasan al-Baṣrī: 2,131 entries
3. Abū Jaʿfar al-Madanī: 1,442 entries
4. Ibn Kathīr: 1,171 entries

Each entry in scraped_data(1).json contains:

{
  "Ch:Vrs": "1 : 1",
  "Arabic": "بِسْمِ اللَّهِ الرَّحْمَٰنِ الرَّحِيمِ",
  "Transmission": "[X]",
  "Manual": "Shāṭibiyya",
  "Page": "2:75",
  "Footnotes": ""
}

• Ch:Vrs: Chapter and verse number (e.g., "1 : 1" for Al-Fatiha verse 1)
• Arabic: The Arabic text of the variant (may have encoding issues)
• Transmission: Transmission chain identifier
• Manual: Source manual/treatise (e.g., "Shāṭibiyya", "Mukhtaṣar")
• Page: Reference page in the source
• Footnotes: Additional notes or comments

5. Yaʿqūb: 1,165 entries

• Search for "basmala" to find opening verse variants
• Search for "Shāṭibiyya" to find entries from that manual
• Search for "Ibn Muḥayṣin" to find his transmissions
• Search for "1 : 1" to find Chapter 1, Verse 1 variants

import requests

# Search for basmala
response = requests.get("http://localhost:5000/search", params={
    "q": "basmala",
    "field": "all"
})
data = response.json()
print(f"Found {data['total']} results")

# Get statistics
stats = requests.get("http://localhost:5000/statistics").json()
print(f"Total entries: {stats['total_entries']}")

EV3-Database/
├── scraped_data(1).json     # Original scraped data (5.3MB)
├── README.md                # This file
├── EV3_DATABASE_INFO.md     # Detailed academic documentation
├── API_DOCUMENTATION.md     # Complete API reference
├── QUICK_START.md          # 5-minute setup guide
├── setup.py                # Automated setup script
├── data_processor.py       # Data processing and statistics
├── encoding_fixer.py       # Arabic text encoding fixes
├── web_interface.py        # High-tech web interface
├── requirements.txt        # Python dependencies
├── .gitignore             # Git ignore rules
├── sample_data.json       # Sample data (generated)
└── processed_data.json    # Processed data (generated)

• Textual Criticism: Compare variants across transmissions
• Transmission Studies: Analyze chains of transmission
• Regional Analysis: Study how readings varied by region
• Manuscript Studies: Reference to various traditions

• API Integration: Use the REST API for applications
• Data Analysis: Process the data programmatically
• Web Applications: Build interfaces using the API
• Research Tools: Create specialized analysis tools

• Learning: Understand Quranic textual variants
• Research: Use for academic papers and studies
• Exploration: Browse different readings and transmissions
• Reference: Cross-reference with other sources

• This is archival data from a snapshot before the original site went down
• Encoding issues may exist in Arabic text (tools provided to fix)
• Verify information against authoritative sources for serious research
• Cross-reference with other Quranic databases

• Respect the original work of Dr. Shady Nasser
• Use responsibly and ethically
• Follow academic citation practices
• Contribute improvements to data quality

• Original database: No longer accessible
• This archive: Community preservation effort
• Data snapshot: From before the site went down
• Future updates: Dependent on community contributions

• Corpus Coranicum - Another important Quranic research resource
• Quranic Arabic Corpus - Morphological analysis
• Tanzil Project - Quran text with different readings

• Jeffery, Arthur. Materials for the History of the Text of the Qur'an
• al-Suyūṭī, Jalāl al-Dīn. al-Itqān fī ʿulūm al-Qurʾān
• Ibn al-Jazarī, Muḥammad. al-Nashr fī al-qirāʾāt al-ʿashr

• Original Database: Dr. Shady Nasser
• Data Preservation: Community effort to maintain access
• Academic Community: Scholars who continue this work
• Contributors: Anyone who helps improve this archive

This repository is provided for educational and research purposes. Users should:

• Respect the original work of Dr. Shady Nasser
• Use the data responsibly and ethically
• Verify information against authoritative sources
• Follow academic citation practices
• Contribute improvements to data quality

This repository will be made private once the original EV3 database is restored or a permanent solution is established. This is a temporary preservation effort to ensure access to this valuable research resource.

This documentation is part of the EV3 Database Archive project, created to preserve access to Dr. Shady Nasser's valuable compilation of Quranic textual variants.