VedicAstro


NameVedicAstro JSON
Version 0.1.4 PyPI version JSON
download
home_pagehttps://github.com/diliprk/VedicAstro
SummaryA python package for Vedic Astrology, with a particular focus on the Krishnamurthi Paddhati system
upload_time2024-02-27 13:34:41
maintainer
docs_urlNone
authorDilip Rajkumar
requires_python>=3.11
license
keywords
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            <p align="center">
    <img src="https://raw.githubusercontent.com/diliprk/VedicAstro/main/VedicAstroLogo.png?raw=True" alt="Logo">
    <p align="center">
    <img src="https://img.shields.io/pypi/v/VedicAstro" alt="PyPi Latest Release"> <img src="https://img.shields.io/badge/python-3.11-limegreen" alt="Python Version"> <img src="https://img.shields.io/badge/License-MIT-blue" alt="License">
    </p> 
</p>

<b>`VedicAstro`</b> is a python library built for the study, practise, research and application of traditional Vedic Astrology. The goal of this package is to generate chart and planetary position data for Vedic Astrology systems , particularly `Krishnamurthi Paddhati` (KP) system. This package, primarily uses the `sidereal` branch of the [flatlib](https://github.com/flatangle/flatlib/tree/sidereal) library to obtain data from the swiss ephemeris (`pyswisseph`)

## Installation
Create a virtual environment in this project directory and install the required packages:
**From PyPi**
```bash
pip install VedicAstro
```
**NOTE**: PyPI no longer supports specifying external packages (eg:git repo URLs) in `install_requires`. ([Read this](https://github.com/pypi/warehouse/issues/9404)) Packages specified in `dependency_links` will also not get automatically installed([Read this](https://setuptools.pypa.io/en/latest/deprecated/dependency_links.html)). To install the required package `flatlib` from the `sidereal` branch, run the following command, after completion of above `pip install VedicAstro` command:
```bash
pip install git+https://github.com/flatangle/flatlib.git@sidereal#egg=flatlib
```

**From local clone of Git Repo**
```bash
python -m venv astrovenv
source astrovenv/bin/activate
pip install --upgrade  pip
pip install -r requirements.txt
```
In `Windows`: `source astrovenv/bin/activate` does not work, so you have to do `cd astrovenv\Scripts && activate` in command prompt, 

Alternatively, you can also use `miniconda` as your virtual environment manager:

```bash
conda create -n astrovenv python=3.11
conda activate astrovenv
pip install -r requirements.txt
```

## Study and Reference
The main class in this package is the `VedicHoroscopeData` class, which has the following methods:

 1. `generate_chart` - Generates a `flatlib.Chart` object for the given time and location data
 2. `get_planets_data_from_chart` - Generate the planets data table from a `flatlib.Chart` object
 3. `get_houses_data_from_chart` -  Generates the houses data table from a `flatlib.Chart` object
 4. `get_planet_wise_significators` - Generate the ABCD significators table for each planet
 5. `get_house_wise_significators` - Generate the ABCD significators table for each house
 6. `compute_vimshottari_dasa` - Computes the Vimshottari Dasa for the chart
 7. `get_planetary_aspects` - Computes aspects (like `Trine`, `Sextile` , `Square` , `Conjunction` etc.) between planets. This method is more popular in Western Astrology systems

You can run the  below notebook, to get a handle of the above basic operations.<br>[![ipynb file](https://img.shields.io/badge/VedicAstroStudy-notebook-brightgreen?logo=jupyter)](https://github.com/diliprk/VedicAstro/blob/main/VedicAstroStudy.ipynb)

## API Development
You can deploy this `VedicAstro` package using `FastAPI` on your local machine or remote server. Just run the below command from this directory where you have this `VedicAstroAPI.py` file

```bash
uvicorn VedicAstroAPI:app --reload --port 8088
```

Thereafter, you can test the API service at `http://127.0.0.1:8088/docs` in your browser

## Dedicatations
This package is a dedication to the following great personalities, following in their footsteps:
- [Parasara MahaRishi](https://en.wikipedia.org/wiki/Parashara)
- [K.S. Krishnamurti](http://kpastrologys.net/about-us/)
- numerous great souls and teachers, who have shared this divine knowledge for free


## Glossary
| Term             | Definition                                                                                            |
|------------------|-------------------------------------------------------------------------------------------------------|
| Rasi             | Means one of the 12 signs of the zodiac, where each sign spans 30°, in the 360° sky                   |
| Nakshatra        | Lunar mansion which typically spans 13.32° (or about 800` degree-mins).                               |
| SubLord          | One of the 249 subdivisions of the KP Astrology system.                                               |
| SubSubLord       | Further divisions of the sublord.                                                                     |
| Vimshottari Dasha| [Vimshottari Dasha](https://en.wikipedia.org/wiki/Dasha_(astrology)) - A system of planetary periods. |


## Contributions
This project is always on the lookout for aspiring students of astrology with programming skills to take this open source contribution further.

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/diliprk/VedicAstro",
    "name": "VedicAstro",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.11",
    "maintainer_email": "",
    "keywords": "",
    "author": "Dilip Rajkumar",
    "author_email": "diliprajkumar@gmail.com",
    "download_url": "https://files.pythonhosted.org/packages/6b/9e/655197e67f1ee633cd8a7144474f9be37647161c75d126a048151b1e0419/VedicAstro-0.1.4.tar.gz",
    "platform": null,
    "description": "<p align=\"center\">\r\n    <img src=\"https://raw.githubusercontent.com/diliprk/VedicAstro/main/VedicAstroLogo.png?raw=True\" alt=\"Logo\">\r\n    <p align=\"center\">\r\n    <img src=\"https://img.shields.io/pypi/v/VedicAstro\" alt=\"PyPi Latest Release\"> <img src=\"https://img.shields.io/badge/python-3.11-limegreen\" alt=\"Python Version\"> <img src=\"https://img.shields.io/badge/License-MIT-blue\" alt=\"License\">\r\n    </p> \r\n</p>\r\n\r\n<b>`VedicAstro`</b> is a python library built for the study, practise, research and application of traditional Vedic Astrology. The goal of this package is to generate chart and planetary position data for Vedic Astrology systems , particularly `Krishnamurthi Paddhati` (KP) system. This package, primarily uses the `sidereal` branch of the [flatlib](https://github.com/flatangle/flatlib/tree/sidereal) library to obtain data from the swiss ephemeris (`pyswisseph`)\r\n\r\n## Installation\r\nCreate a virtual environment in this project directory and install the required packages:\r\n**From PyPi**\r\n```bash\r\npip install VedicAstro\r\n```\r\n**NOTE**: PyPI no longer supports specifying external packages (eg:git repo URLs) in `install_requires`. ([Read this](https://github.com/pypi/warehouse/issues/9404)) Packages specified in `dependency_links` will also not get automatically installed([Read this](https://setuptools.pypa.io/en/latest/deprecated/dependency_links.html)). To install the required package `flatlib` from the `sidereal` branch, run the following command, after completion of above `pip install VedicAstro` command:\r\n```bash\r\npip install git+https://github.com/flatangle/flatlib.git@sidereal#egg=flatlib\r\n```\r\n\r\n**From local clone of Git Repo**\r\n```bash\r\npython -m venv astrovenv\r\nsource astrovenv/bin/activate\r\npip install --upgrade  pip\r\npip install -r requirements.txt\r\n```\r\nIn `Windows`: `source astrovenv/bin/activate` does not work, so you have to do `cd astrovenv\\Scripts && activate` in command prompt, \r\n\r\nAlternatively, you can also use `miniconda` as your virtual environment manager:\r\n\r\n```bash\r\nconda create -n astrovenv python=3.11\r\nconda activate astrovenv\r\npip install -r requirements.txt\r\n```\r\n\r\n## Study and Reference\r\nThe main class in this package is the `VedicHoroscopeData` class, which has the following methods:\r\n\r\n 1. `generate_chart` - Generates a `flatlib.Chart` object for the given time and location data\r\n 2. `get_planets_data_from_chart` - Generate the planets data table from a `flatlib.Chart` object\r\n 3. `get_houses_data_from_chart` -  Generates the houses data table from a `flatlib.Chart` object\r\n 4. `get_planet_wise_significators` - Generate the ABCD significators table for each planet\r\n 5. `get_house_wise_significators` - Generate the ABCD significators table for each house\r\n 6. `compute_vimshottari_dasa` - Computes the Vimshottari Dasa for the chart\r\n 7. `get_planetary_aspects` - Computes aspects (like `Trine`, `Sextile` , `Square` , `Conjunction` etc.) between planets. This method is more popular in Western Astrology systems\r\n\r\nYou can run the  below notebook, to get a handle of the above basic operations.<br>[![ipynb file](https://img.shields.io/badge/VedicAstroStudy-notebook-brightgreen?logo=jupyter)](https://github.com/diliprk/VedicAstro/blob/main/VedicAstroStudy.ipynb)\r\n\r\n## API Development\r\nYou can deploy this `VedicAstro` package using `FastAPI` on your local machine or remote server. Just run the below command from this directory where you have this `VedicAstroAPI.py` file\r\n\r\n```bash\r\nuvicorn VedicAstroAPI:app --reload --port 8088\r\n```\r\n\r\nThereafter, you can test the API service at `http://127.0.0.1:8088/docs` in your browser\r\n\r\n## Dedicatations\r\nThis package is a dedication to the following great personalities, following in their footsteps:\r\n- [Parasara MahaRishi](https://en.wikipedia.org/wiki/Parashara)\r\n- [K.S. Krishnamurti](http://kpastrologys.net/about-us/)\r\n- numerous great souls and teachers, who have shared this divine knowledge for free\r\n\r\n\r\n## Glossary\r\n| Term             | Definition                                                                                            |\r\n|------------------|-------------------------------------------------------------------------------------------------------|\r\n| Rasi             | Means one of the 12 signs of the zodiac, where each sign spans 30\u00b0, in the 360\u00b0 sky                   |\r\n| Nakshatra        | Lunar mansion which typically spans 13.32\u00b0 (or about 800` degree-mins).                               |\r\n| SubLord          | One of the 249 subdivisions of the KP Astrology system.                                               |\r\n| SubSubLord       | Further divisions of the sublord.                                                                     |\r\n| Vimshottari Dasha| [Vimshottari Dasha](https://en.wikipedia.org/wiki/Dasha_(astrology)) - A system of planetary periods. |\r\n\r\n\r\n## Contributions\r\nThis project is always on the lookout for aspiring students of astrology with programming skills to take this open source contribution further.\r\n",
    "bugtrack_url": null,
    "license": "",
    "summary": "A python package for Vedic Astrology, with a particular focus on the Krishnamurthi Paddhati system",
    "version": "0.1.4",
    "project_urls": {
        "Homepage": "https://github.com/diliprk/VedicAstro"
    },
    "split_keywords": [],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "694e5659d4bb71874956f3109973a580a98447c087f1f0303de5252804460ebb",
                "md5": "7ad18c27fedf63abee42c51a493c13f6",
                "sha256": "32b733253aaac48e54456f75574b1c3b524fca6ca1ebbcbd0bb30582c2d8e7bb"
            },
            "downloads": -1,
            "filename": "VedicAstro-0.1.4-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "7ad18c27fedf63abee42c51a493c13f6",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.11",
            "size": 12246,
            "upload_time": "2024-02-27T13:34:39",
            "upload_time_iso_8601": "2024-02-27T13:34:39.195844Z",
            "url": "https://files.pythonhosted.org/packages/69/4e/5659d4bb71874956f3109973a580a98447c087f1f0303de5252804460ebb/VedicAstro-0.1.4-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "6b9e655197e67f1ee633cd8a7144474f9be37647161c75d126a048151b1e0419",
                "md5": "377b80d29dff837ec077ce6f7780bdf3",
                "sha256": "4f555c4460d318706acab5c72803cf9b5c9665c8704a3e3c19f374c2db75b127"
            },
            "downloads": -1,
            "filename": "VedicAstro-0.1.4.tar.gz",
            "has_sig": false,
            "md5_digest": "377b80d29dff837ec077ce6f7780bdf3",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.11",
            "size": 13785,
            "upload_time": "2024-02-27T13:34:41",
            "upload_time_iso_8601": "2024-02-27T13:34:41.031317Z",
            "url": "https://files.pythonhosted.org/packages/6b/9e/655197e67f1ee633cd8a7144474f9be37647161c75d126a048151b1e0419/VedicAstro-0.1.4.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-02-27 13:34:41",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "diliprk",
    "github_project": "VedicAstro",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "requirements": [],
    "lcname": "vedicastro"
}
        
Elapsed time: 6.54671s