/hindu-temples

a database containing data of Hindu temples

Primary LanguagePython

Hindu Temples

This project delves into the rich tapestry of Hindu temples, showcasing their architectural grandeur, cultural significance, and spiritual importance. Through two JSON data files located in the 'data' directory, this project provides detailed information about temples dedicated to various deities and the states in which they reside. Additionally, two helper Python scripts assist in parsing and presenting the temple data.

JSON Data Files

ALL DATA IS IN DATA/

  1. deities.json: This file contains a comprehensive list of Hindu deities, along with their associated temples. For each deity, the file provides the following information:

    • name: The name of the deity
    • temples: A list of temples dedicated to the deity
    • info: A brief introduction to the deity and its temples
    • story: The origin story or history associated with the deity
    • visiting_guide: A guide for visiting temples dedicated to the deity
    • architecture: A description of the architectural features of temples dedicated to the deity
    • mention_in_scripture: References to the deity in Hindu scriptures
  2. states.json: This file presents an overview of states in India that are known for their Hindu temples. For each state, the file includes the following data:

    • name: The name of the state
    • temples: A list of temples located in the state
    • info: A brief introduction to the state and its temples
    • story: Historical or history anecdotes related to the temples and the state
    • visiting_guide: A guide for visiting temples in the state
    • architecture: A description of the architectural styles found in temples in the state
    • mention_in_scripture: References to temples in the state in Hindu scriptures

Helper Scripts

In addition to the JSON data files, this repository also includes two Python helper scripts:

  • states_helper.py: This script provides functions to access and manipulate the data in the states.json file.
  • deities_helper.py: This script provides functions to access and manipulate the data in the deities.json file.

Usage

To use this repository, you can follow these steps:

  1. Clone the repository to your local machine.
  2. Install the required Python packages.
  3. Open a Python console and import the helper scripts.
  4. Use the functions in the helper scripts to access and manipulate the data.

You can then utilize the obtained data to display information about Hindu temples and deities in your own applications or visualizations.

Note

Both JSON data files are large and may take a few seconds to load. Please be patient while the data is being processed.

Accessibility and Usage

The JSON data files in this repository are easily accessible and can be employed for various purposes, including research, educational projects, and personal exploration:

  1. Research: Researchers and scholars can use the data to conduct studies on Hindu temples, their distribution across states, deities associated with them, and their architectural styles.

  2. Educational Projects: Educators and students can utilize the data to create interactive projects, presentations, and educational materials that explore the significance of Hindu temples and their cultural importance.

  3. Personal Exploration: Individuals interested in Hindu temples can use the data to plan temple visits, learn about their history and significance, and discover the diversity of worship practices across various deities.

Key Features of the JSON Data

The JSON data files in this repository offer several key features that enhance their usefulness and value:

  1. Detailed Information: Each temple entry includes comprehensive information such as its name, location, state, deity, and a brief description, providing a concise overview of the temple's significance.

  2. Categorization: Temples are categorized by state and deity, making it easy for users to find specific temples or explore temples associated with particular deities or located in specific states.

  3. Flexibility: The JSON format allows for easy parsing and integration with various programming languages, enabling developers to incorporate the data into their projects and applications.

Contribution Guidelines

This repository encourages contributions from the community to expand and enrich the information about Hindu temples. If you have additional data or insights, please consider contributing to the repository by submitting a pull request.

License

The data in this repository is licensed under the terms of the MIT License. You are free to use, modify, and distribute the data for non-commercial and commercial purposes, with attribution to the original source.