محاسبه‌گر پانچانگا

ابزاری به زبان پایتون برای محاسبه عناصر پانچانگا (تقویم ودیک آسترولوژی) برای تاریخ و زمان مشخص با دقت بالا.

فهرست مطالب

• مقدمه
• وابستگی‌ها
• نصب
• نحوه استفاده
• محاسبات نجومی
• مشارکت
• مجوز

مقدمه

این ابزار عناصر پانچانگا مانند تیتی، ناکشاترا، یوگا، کارانا و راشی را برای تاریخ، زمان و منطقه زمانی مشخص محاسبه می‌کند. از کتابخانه ephem برای محاسبات نجومی استفاده می‌شود.

وابستگی‌ها

• ephem: برای محاسبات نجومی
• datetime: برای دستکاری تاریخ و زمان
• argparse: برای تجزیه آرگومان‌های خط فرمان
• jdatetime: برای تبدیل تاریخ جلالی (اختیاری)

نصب

اطمینان حاصل کنید که پایتون ۳.x نصب شده است. وابستگی‌های مورد نیاز را با pip نصب کنید:

pip install ephem jdatetime

نحوه استفاده

اسکریپت را از خط فرمان با آرگومان‌های لازم اجرا کنید:

python panchanga.py -d DD/MM/YYYY -t HH:MM -z [+/-]HH:MM [--calendar gregorian|jalali]

آرگومان‌ها:

• -d یا --date: تاریخ به فرمت DD/MM/YYYY
• -t یا --time: زمان به فرمت ۲۴ ساعته HH:MM
• -z یا --zone: منطقه زمانی نسبت به GMT به فرمت [+/-]HH:MM
• --calendar: نوع تقویم تاریخ ورودی (پیش‌فرض: gregorian)

مثال‌ها:

• برای تاریخ میلادی:

  python panchanga.py -d 25/12/2023 -t 12:00 -z +05:30

• برای تاریخ شمسی:

    python3 panchanga.py -d 23/09/1402 -t 12:00 -z +03:30 --calendar jalali

خروجی:

Tithi     : Prathame, Shukla Paksha
Nakshatra : Dhanishta
Yoga      : Sadhya
Karana    : Kimstughna
Rashi     : Makara

محاسبات نجومی

تیتی (Tithi)

بر اساس فاصله زاویه‌ای بین ماه و خورشید، تقسیم بر ۱۲ درجه محاسبه می‌شود.

ناکشاترا (Nakshatra)

بر اساس طول دایرة‌البروجی ماه، تقسیم شده به ۲۷ قسمت مساوی تعیین می‌شود.

یوگا (Yoga)

از مجموع طول دایرة‌البروجی خورشید و ماه، تقسیم شده به ۲۷ قسمت مساوی محاسبه می‌شود.

کارانا (Karana)

نصف یک تیتی، بر اساس پیشرفت در تیتی محاسبه می‌شود.

راشی (Rashi)

بر اساس طول دایرة‌البروجی ماه، تقسیم شده به ۱۲ قسمت مساوی تعیین می‌شود.

مشارکت

از مشارکت‌های شما استقبال می‌کنیم! لطفاً یک Issue باز کنید یا Pull Request ارسال نمایید.

ارتباط با ما

Telegram

Panchanga Calculator

A Python tool to calculate Panchanga (Vedic astrological almanac) elements for a given date and time with high precision.

Table of Contents

• Introduction
• Dependencies
• Installation
• Usage
• Astronomical Calculations
• Contributing
• License

Introduction

This tool calculates the Panchanga elements such as Tithi, Nakshatra, Yoga, Karana, and Rashi for a specified date, time, and timezone. It uses the ephem library for astronomical computations.

Dependencies

• ephem: For astronomical calculations.
• datetime: For date and time manipulations.
• argparse: For command-line argument parsing.
• jdatetime: For Jalali date conversion (optional).

Installation

Ensure you have Python 3.x installed. Install the required dependencies using pip:

pip install ephem jdatetime

Usage

Run the script from the command line with the required arguments:

python panchanga.py -d DD/MM/YYYY -t HH:MM -z [+/-]HH:MM [--calendar gregorian|jalali]

Arguments:

• -d or --date: Date in DD/MM/YYYY format.
• -t or --time: Time in HH:MM 24-hour format.
• -z or --zone: Timezone with respect to GMT in [+/-]HH:MM format.
• --calendar: Specifies the calendar type of the input date (default: gregorian).

Examples:

• For Gregorian date:

  python panchanga.py -d 25/12/2023 -t 12:00 -z +05:30

• For Jalali date:

  python panchanga.py -d 23/09/1402 -t 12:00 -z +03:30 --calendar jalali

Output:

Tithi     : <Tithi Name>, <Shukla/Krishna> Paksha
Nakshatra : <Nakshatra Name>
Yoga      : <Yoga Name>
Karana    : <Karana Name>
Rashi     : <Rashi Name>

Astronomical Calculations

Tithi

Calculated based on the angular distance between the Moon and the Sun, divided by 12 degrees.

Nakshatra

Determined by the Moon's ecliptic longitude, divided into 27 equal parts.

Yoga

Calculated from the sum of the ecliptic longitudes of the Sun and the Moon, divided into 27 equal parts.

Karana

Half of a Tithi, calculated based on the progress within the Tithi.

Rashi

Determined by the Moon's ecliptic longitude, divided into 12 equal parts.