Panchang Core — Advanced Vedic Astrology Engine for PHP

Introduction

Authentic Vedic Panchanga calculation engine with Swiss Ephemeris precision.

System Setup

Configuring PHP FFI and Swiss Ephemeris data files.

1. Enable FFI Extension

sudo apt install php8.3-ffi

sudo dnf install php-ffi

2. Configure php.ini

Add or uncomment high-privilege FFI settings in your php.ini:

extension=ffi
ffi.enable=1

3. Verify Setup

php -r "echo extension_loaded('ffi') ? 'FFI loaded' : 'FFI not loaded';"
php -r "echo ini_get('ffi.enable') ? 'FFI enabled' : 'FFI not enabled';"

📂 Ephemeris Data Files

The calculation engine requires .se1 data files. You can download the verified set from the official release page:

Installation

composer require jayeshmepani/panchang-core

Quick Start

<?php

require 'vendor/autoload.php';

use JayeshMepani\PanchangCore\Traits\CliBootstrap;
use Carbon\CarbonImmutable;

// Initialize standalone environment (loads config & sets up DI)
CliBootstrap::init(__DIR__);

// Create fully wired PanchangService
$panchang = CliBootstrap::makePanchangService();

// Calculate panchanga
$date = CarbonImmutable::parse('2026-03-24');
$details = $panchang->getDayDetails(
    date: $date,
    lat: 23.2472446,
    lon: 69.668339,
    tz: 'Asia/Kolkata'
);

echo "Tithi: " . $details['Tithi']['name'] . "\n";
echo "Nakshatra: " . $details['Nakshatra']['name'] . "\n";

🪐 Ayanamsa Authority

The Ayanamsa defines the starting point of the sidereal zodiac. For Panchanga calculations, this is a fixed religious and legal anchor.

System Core Policy

// The engine automatically applies Lahiri to Sun/Moon longitudes
$details = $panchang->getDayDetails($date, $lat, $lon, $tz);

echo "Ayanamsa Index: " . $details['Ayanamsa']; // "LAHIRI (Chitra Paksha)"
echo "Ayanamsa Value: " . $details['Ayanamsa_Degree']; // e.g. 24.1234
echo "Tithi: " . $details['Tithi']['name']; // Guaranteed Lahiri-aligned

Configuration

Global settings and formatting preferences available in config/panchang.php.

Default Calculation Options

The defaults array configures localization, calendar-system selection, and formatting representations.

Festival Calculation Settings

The festivals array provides defaults for region and tradition if not explicitly supplied.

Cache Settings

The cache array controls package cache behavior in Laravel applications.

// Example: Sunrise at 6:14 AM
// Event at 5:30 AM belongs to NEXT Panchang day
$details = $panchang->getDayDetails($date, $lat, $lon, $tz);
// Times before sunrise in output are dated to next civil date

// Time-only (for display)
$varjyam_start = $details['Varjyam']['varjyam_start']; // "03:31:48 AM"

// Full ISO timestamp (for storage/database)
$varjyam_start_iso = $details['Varjyam']['varjyam_start_iso']; // "28/03/2026 03:31:48 AM"

// ALWAYS use _iso fields when:
// - Storing in database
// - Displaying to users
// - Comparing across timezones

// Check how many windows exist
$windowCount = $details['Varjyam']['window_count']; // 0, 1, or 2

// Access all windows
foreach ($details['Varjyam']['windows'] as $window) {
    echo $window['start'] . " - " . $window['end'];
}

// Top-level keys maintain backward compatibility
$details['Varjyam']['varjyam_start']; // First window start
$details['Varjyam']['varjyam_end'];   // First window end

// Returns both base and effective windows
$pradosha = $details['Pradosha_Kaal'];
$base_window = $pradosha['pradosha_window'];           // Base 1/5th night
$effective = $pradosha['effective_trayodashi_window']; // Overlap with T13

$badTimes   = $details['Rahu_Kaal_Gulika_Yamaganda'];
$abhijit    = $details['Abhijit_Muhurta'];
$praharas   = $details['Prahara_Full_Day'];
$daylight   = $details['Daylight_Fivefold_Division']; // Pratah, Sangava, Madhyahna, Aparahna, Sayahna
$brahma     = $details['Brahma_Muhurta'];
$dur        = $details['Dur_Muhurta_Full_Day'];
$nishita    = $details['Nishita_Muhurta'];            // Night midpoint
$vijaya     = $details['Vijaya_Muhurta'];             // 11th of 15 day muhurtas
$godhuli    = $details['Godhuli_Muhurta'];            // Evening twilight
$sandhya    = $details['Sandhya'];                    // Pratah, Madhyahna, Sayahna
$gowri      = $details['Gowri_Panchangam'];           // Tamil 8-part division
$kalaVela   = $details['Kala_Vela'];                  // Kala, Mrityu, etc.
$karmakala  = $details['Karmakala_Windows'];
$varjyam    = $details['Varjyam'];
$amrita     = $details['Amrita_Kaal'];
$pradosha   = $details['Pradosha_Kaal'];

$specialYogas = $snapshot['Special_Yogas'];
$anandadi     = $snapshot['Anandadi_Yoga'];
$amritadi     = $snapshot['Amritadi_Yoga'];
$panchak      = $snapshot['Panchak'];
$maitreya     = $snapshot['Maitreya_Yoga'];
$gajachchhaya = $snapshot['Gajachchhaya_Yoga'];
$nakShool     = $snapshot['Nakshatra_Shool'];
$dishaShool   = $snapshot['Disha_Shool'];
$rahuVaasa    = $snapshot['Rahu_Vaasa'];
$chandraVaasa = $snapshot['Chandra_Vaasa'];
$shivaVaasa   = $snapshot['Shiva_Vaasa'];
$agniVaasa    = $snapshot['Agni_Vaasa'];
$yoginiVaasa  = $snapshot['Yogini_Vaasa'];
$ekadashi     = $snapshot['Ekadashi_Observance'];

Nakshatra

Enum: JayeshMepani\PanchangCore\Core\Enums\Nakshatra

use JayeshMepani\PanchangCore\Core\Enums\Nakshatra;

// Get nakshatra from moon longitude
$nakshatra = Nakshatra::fromLongitude(125.3); // Magha

echo $nakshatra->getName();          // "Magha"
echo $nakshatra->getDeity();         // "Pitṛs"
echo $nakshatra->getRulingPlanet(); // "Sun"
echo $nakshatra->getSymbol();       // "Royal Throne"

// Get pada (quarter)
$pada = Nakshatra::getPada(125.3);    // 2
echo "Pada: $pada\n";                // Pada: 2

// Get longitude range
$range = Nakshatra::Ashwini->getLongitudeRange();
echo $range['start'] . "° - " . $range['end'] . "°\n"; // 0° - 13.333°

Tithi

Enum: JayeshMepani\PanchangCore\Core\Enums\Tithi

use JayeshMepani\PanchangCore\Core\Enums\Tithi;

// Get tithi by index (1-30)
$tithi = Tithi::from(12); // Shukla Dwadashi

echo $tithi->getName();            // "Dwadashi"
echo $tithi->getPaksha()->name;    // "Shukla"

// Check paksha
if ($tithi->getPaksha() === Paksha::Shukla) {
    echo "Waxing moon phase\n";
}

// Get normalized index (1-15 for both pakshas)
echo $tithi->getNormalizedIndex(); // 12

Paksha

Enum: JayeshMepani\PanchangCore\Core\Enums\Paksha

use JayeshMepani\PanchangCore\Core\Enums\Paksha;

$paksha = Paksha::Shukla;
echo $paksha->getName();        // "Shukla Paksha" (using configured locale)
echo $paksha->getName('hi');    // "शुक्ल पक्ष"

echo Paksha::Shukla->getRawName();  // "Shukla"
echo Paksha::Krishna->getRawName(); // "Krishna"

Yoga

Enum: JayeshMepani\PanchangCore\Core\Enums\Yoga

Karana

Enum: JayeshMepani\PanchangCore\Core\Enums\Karana

Vara

Enum: JayeshMepani\PanchangCore\Core\Enums\Vara

Core Enums

Basic enumeration types used throughout the package.

CalendarType

Enum: JayeshMepani\PanchangCore\Core\Enums\CalendarType

use JayeshMepani\PanchangCore\Core\Enums\CalendarType;

$amanta = CalendarType::Amanta;
echo $amanta->getLocalizedName('hi'); // "अमांत"

PanchangService

Service: JayeshMepani\PanchangCore\Panchanga\PanchangService

FestivalService

Service: JayeshMepani\PanchangCore\Festivals\FestivalService

$today = $panchang->getFestivalSnapshot(CarbonImmutable::parse('2026-03-24'), 23.247, 69.668, 'Asia/Kolkata');
$tomorrow = $panchang->getFestivalSnapshot(CarbonImmutable::parse('2026-03-25'), 23.247, 69.668, 'Asia/Kolkata');

$festivals = $festivalService->resolveFestivalsForDate(
    CarbonImmutable::parse('2026-03-24'),
    $today,
    $tomorrow
);

foreach ($festivals as $festival) {
    echo $festival['name'] . "\n";
}

OutputGeneratorService

Service: JayeshMepani\PanchangCore\Panchanga\OutputGeneratorService

AstronomyService

Service: JayeshMepani\PanchangCore\Astronomy\AstronomyService

SunService

Service: JayeshMepani\PanchangCore\Astronomy\SunService

PanchangaEngine

Service: JayeshMepani\PanchangCore\Panchanga\PanchangaEngine

$tithi = $engine->calculateTithi(350.5, 125.3);
echo $tithi['name']; // "Dwadashi"
                

CliBootstrap

Trait: JayeshMepani\PanchangCore\Traits\CliBootstrap

require __DIR__ . '/vendor/autoload.php';

CliBootstrap::init(__DIR__);
$panchangService = CliBootstrap::makePanchangService();

CliBootstrap::init(__DIR__);

$panchangService = CliBootstrap::makePanchangService();

MuhurtaService

Service: JayeshMepani\PanchangCore\Panchanga\MuhurtaService

EclipseService

Service: JayeshMepani\PanchangCore\Astronomy\EclipseService

BhadraEngine

Service: JayeshMepani\PanchangCore\Festivals\Utils\BhadraEngine

ElectionalEvaluator

Service: JayeshMepani\PanchangCore\Panchanga\ElectionalEvaluator

KalaNirnayaEngine

Service: JayeshMepani\PanchangCore\Panchanga\KalaNirnayaEngine

VimshottariDasha

Enum: JayeshMepani\PanchangCore\Core\Enums\VimshottariDasha

JSON Response Schema

Complete reference of keys returned by the getDayDetails() "God Object".

Auspicious & Inauspicious Windows

CLI Tooling & Scripts

Built-in scripts for rapid data generation, batch processing, and data export.

Available Scripts

Usage Examples

cd scripts
php panchang_today.php

cd scripts
php panchang_festivals.php 2026

cd scripts
php panchang_month_output.php 2026 4 > month_2026_04.json

Localization and Calendar Types

Use environment variables to control output format:

PANCHANG_LOCALE=hi PANCHANG_CALENDAR_TYPE=purnimanta php panchang_today.php

Supported locales: en, hi, gu. Calendar types: amanta, purnimanta.

Configuration

Complete reference for config/panchang.php.

Batch Processing

Efficiently generating large JSON datasets for applications.

use JayeshMepani\PanchangCore\Panchanga\OutputGeneratorService;

$generator = app(OutputGeneratorService::class);

// 1. Export 10 years of eclipses
$eclipses = $generator->generateEclipses(2025, 2035, 23.24, 69.66, 'Asia/Kolkata');

// 2. Export full year of festivals
$festivals = $generator->generateFestivals(2026, 23.24, 69.66, 'Asia/Kolkata');

// 3. One massive unified export
$all = $generator->generateAll(2026, 2026, 2030, 23.24, 69.66, 'Asia/Kolkata');

Localization

Multilingual support for English, Hindi, and Gujarati.

Switching Locales at Runtime

// Using environment variables (Global)
putenv('PANCHANG_LOCALE=gu');

// The output of any service will now use Gujarati script
$details = Panchang::getDayDetails($date, $lat, $lon, $tz);
echo $details['Tithi']['name']; // "વદ તેરસ"

Direct Localization Usage

Use the Localization class directly for custom translations:

use JayeshMepani\PanchangCore\Core\Localization;

// Get translated Nakshatra name
$nakshatraName = Localization::translate('Nakshatra', 'Ashwini', 'hi'); // "अश्विनी"

// Get translated Tithi
$tithiName = Localization::translate('Tithi', 15, 'gu'); // "પૂનમ"

// Available categories: Nakshatra, Vara, Tithi, Rasi, Yoga, Karana, Choghadiya, Muhurta, Masa, Paksha, Ritu, Ayana, Planet, Samvatsara, Vrata, Eclipse, Festival

Supported Languages

• en — English
• hi — Hindi (Devanagari script)
• gu — Gujarati (Gujarati script)

The Localization class contains comprehensive translations for all panchang elements, including festival names, planetary names, and astrological terms.

Usage Patterns (How do I...?)

Practical code snippets for specific needs.

$details = Panchang::getDayDetails($date, $lat, $lon, $tz);
echo "Today is: " . $details['Tithi']['name'];

$eval = Panchang::getDailyMuhurtaEvaluation($date, $lat, $lon, $tz, CarbonImmutable::now());
if ($eval['evaluation_results']['bhadra']['is_active']) {
    echo "Bhadra is active!";
}

$details = Panchang::getDayDetails($date, $lat, $lon, $tz);
echo "Starts: " . $details['Nakshatra']['start_iso'];
echo "Ends: " . $details['Nakshatra']['end_iso'];

Constants & Enums

Available options for calculation parameters.

Laravel Integration

Complete guide for using Panchang Core in Laravel applications.

composer require jayeshmepani/panchang-core

Configuration

Publish the configuration file:

php artisan vendor:publish --provider="JayeshMepani\PanchangCore\PanchangServiceProvider" --tag="panchang-config"

This creates config/panchang.php:

return [
    'ephe_path' => env('PANCHANG_EPHE_PATH', __DIR__ . '/../ephe'),
    'defaults' => [
        'locale' => env('PANCHANG_LOCALE', 'en'),
        'calendar_type' => env('PANCHANG_CALENDAR_TYPE', 'amanta'),
        'measurement_system' => 'indian_metric',
        'date_time_format' => 'indian_12h',
        'time_notation' => '12h',
        'coordinate_format' => 'decimal',
        'angle_unit' => 'degree',
        'duration_format' => 'mixed',
    ],
    'festivals' => [
        'default_tradition' => 'Smarta',
        'default_region' => 'North',
        'supported_traditions' => ['Smarta', 'Vaishnava'],
        'supported_regions' => ['North', 'South', 'Bengal', 'Maharashtra', 'Tamil', 'Gujarat'],
    ],
    'cache' => [
        'enabled' => true,
        'ttl' => 86400,
        'prefix' => 'panchang_',
    ],
];

Using the Facade

use JayeshMepani\PanchangCore\Facades\Panchang;
use Carbon\CarbonImmutable;

// Get complete panchanga
$details = Panchang::getDayDetails(
    date: CarbonImmutable::parse('2026-03-24'),
    lat: 23.2472,
    lon: 69.6683,
    tz: 'Asia/Kolkata'
);

echo $details['Tithi']['name'];    // "Dwadashi"
echo $details['Nakshatra']['name']; // "Magha"

Service Container

Or inject via constructor:

use JayeshMepani\PanchangCore\Panchanga\PanchangService;

class PanchangController extends Controller
{
    public function __construct(
        private PanchangService $panchang
    ) {}

    public function show()
    {
        $details = $this->panchang->getDayDetails(
            date: CarbonImmutable::now(),
            lat: 28.6139,
            lon: 77.2090,
            tz: 'Asia/Kolkata'
        );

        return view('panchang', compact('details'));
    }
}

Return Value Structures

Complete data structures returned by main methods.

getDayDetails() Return Structure

[
  'Display_Settings' => [...],
  'Units' => [...],
  'Tithi' => ['index' => 12, 'name' => 'Dwadashi', 'paksha' => 'Shukla'],
  'Nakshatra' => ['index' => 10, 'name' => 'Magha', 'pada' => 2, 'lord' => 'Sun'],
  'Yoga' => ['index' => 9, 'name' => 'Shula'],
  'Karana' => ['index' => 23, 'name' => 'Bava'],
  'Vara' => ['index' => 2, 'name' => 'Tuesday', 'lord' => 'Mars'],
  'Hindu_Calendar' => [
    'Month_Amanta' => 'Chaitra',
    'Month_Purnimanta' => 'Chaitra',
    'Is_Adhika' => false,
    'Is_Kshaya' => false,
    'Amanta_Index' => 1,
    'Purnimanta_Index' => 1,
  ],
  'Rahu_Kaal_Gulika_Yamaganda' => [...],
  'Abhijit_Muhurta' => [...],
  'Hora_Full_Day' => [...],
  'Chogadiya_Full_Day' => [...],
  'Muhurta_Full_Day' => [...],
  'Prahara_Full_Day' => [...],
  'Lagna_Full_Day' => [...],
  'Dur_Muhurta_Full_Day' => [...],
  'Daylight_Fivefold_Division' => [...],
  'Nishita_Muhurta' => [...],
  'Vijaya_Muhurta' => [...],
  'Godhuli_Muhurta' => [...],
  'Sandhya' => [...],
  'Gowri_Panchangam' => [...],
  'Kala_Vela' => [...],
  'Karmakala_Windows' => [...],
  'Varjyam' => [...],
  'Amrita_Kaal' => [...],
  'Pradosha_Kaal' => [...],
  'Bhadra' => [...],
  'Dharma_Sindhu' => [...],
  'Festivals' => [...],
  'Daily_Observances' => [...],
  'Special_Yogas' => [...],
  'Anandadi_Yoga' => [...],
  'Amritadi_Yoga' => [...],
  'Panchak' => [...],
  'Maitreya_Yoga' => [...],
  'Gajachchhaya_Yoga' => [...],
  'Nakshatra_Shool' => [...],
  'Disha_Shool' => [...],
  'Rahu_Vaasa' => [...],
  'Chandra_Vaasa' => [...],
  'Shiva_Vaasa' => [...],
  'Agni_Vaasa' => [...],
  'Yogini_Vaasa' => [...],
  'Ekadashi_Observance' => [...],
  'Transitions' => [...],
  'Resolution_Context' => [...],
]

getFestivalSnapshot() Return Structure

[
  'Festivals' => [
    [
      'name' => 'Holika Dahan',
      'description' => 'Holika bonfire ritual',
      'deity' => 'Vishnu/Prahlada',
      'fasting' => false,
      'regions' => ['Pan-India'],
      'aliases' => [],
      'observance_note' => null,
      'calculation_basis' => [
        'type' => 'tithi',
        'type_name' => 'tithi',
        'basis' => 'tithi',
        'basis_name' => 'tithi',
        'tithi' => [...],
        'paksha' => 'Shukla',
        'paksha_name' => 'Shukla',
        'month' => [
          'calendar_type' => 'amanta',
          'value' => 'Phalguna',
          'name' => 'Phalguna',
        ],
        'karmakala_type' => 'pradosha',
        'karmakala_type_name' => 'pradosha',
      ],
      'resolution' => [...],
      'rules_applied' => [...],
    ],
  ],
  'Tithi' => [...],
  'Vara' => [...],
  'Nakshatra' => [...],
  'Yoga' => [...],
  'Karana' => [...],
  'Sunrise' => '06:14:00 AM',
  'Sunset' => '06:52:00 PM',
  'Moonrise' => '10:12:35 PM',
  'Moonset' => '09:00:37 AM',
  'Moonrise_Date' => '2026-04-05',
  'Moonset_Date' => '2026-04-06',
  'Moonrise_ISO' => '05/04/2026 10:12:35 PM',
  'Moonset_ISO' => '06/04/2026 09:00:37 AM',
  'Moonset_Day_Relation' => 'next_day',
  'Special_Yogas' => [...],
  'Anandadi_Yoga' => [...],
  'Amritadi_Yoga' => [...],
  'Panchak' => [...],
  'Maitreya_Yoga' => [...],
  'Gajachchhaya_Yoga' => [...],
  'Nakshatra_Shool' => [...],
  'Disha_Shool' => [...],
  'Rahu_Vaasa' => [...],
  'Chandra_Vaasa' => [...],
  'Shiva_Vaasa' => [...],
  'Agni_Vaasa' => [...],
  'Yogini_Vaasa' => [...],
  'Ekadashi_Observance' => [...],
  'Resolution_Context' => [...],
]

Festival metadata keeps canonical values for code and localized companion fields for display. The calculation_basis.month block follows the active calendar_type only; it does not emit both amanta and purnimanta months in the same localized output.

getMonthCalendar() Return Structure

[
  '2026-04-01' => [
    'date' => '2026-04-01',
    'day' => 1,
    'tithi' => [...],
    'nakshatra' => [...],
    'yoga' => [...],
    'karana' => [...],
    'vara' => [...],
    'sun_sign' => [...],
    'moon_sign' => [...],
    'sunrise' => '06:43:00 AM',
    'sunset' => '07:11:00 PM',
    'moonrise' => '...',
    'moonset' => '...',
    'moonrise_date' => '2026-04-01',
    'moonset_date' => '2026-04-02',
    'moonrise_iso' => '01/04/2026 06:26:00 PM',
    'moonset_iso' => '02/04/2026 06:05:00 AM',
    'moonset_day_relation' => 'next_day',
    'moon_visibility' => [
      'starts_at' => '...',
      'starts_on' => '2026-04-01',
      'starts_iso' => '...',
      'ends_at' => '...',
      'ends_on' => '2026-04-02',
      'ends_iso' => '...',
      'ends_day_relation' => 'next_day',
    ],
    'hindu_calendar' => [...],
    'festivals' => [...],
    'daily_observances' => [...],
    'sankranti' => null,
  ],
]

Moon visibility note: month output preserves compact moonrise and moonset display fields, but also includes date-qualified fields because a moonset can occur after midnight on the next civil date.

Real-World Examples

Complete working examples for common use cases.

1. Daily Panchang Display

// Show today's panchang
$today = Panchang::getDayDetails(
    date: CarbonImmutable::now(),
    lat: $userLat,
    lon: $userLon,
    tz: $userTz
);

echo "Tithi: " . $today['Tithi']['name'];
echo "Nakshatra: " . $today['Nakshatra']['name'];

2. Festival Calendar

// Get festivals for entire month
$monthFestivals = [];
for ($day = 1; $day <= 31; $day++) {
    $date = CarbonImmutable::create(2026, 10, $day);
    $fest = Panchang::getFestivalSnapshot($date, $lat, $lon, $tz);
    
    if (!empty($fest['Festivals'])) {
        $monthFestivals[$day] = $fest['Festivals'];
    }
}

3. Tradition-Specific Resolution

// Smarta-style date resolution (date-scoped festivals)
$smarta = Panchang::getDayDetails(
    CarbonImmutable::parse('2026-09-06'),
    28.61, 77.20, 'Asia/Kolkata'
)['Festivals'];

// Next-day festival context (for comparison)
$vaishnava = Panchang::getDayDetails(
    CarbonImmutable::parse('2026-09-07'),
    28.61, 77.20, 'Asia/Kolkata'
)['Festivals'];

4. Planetary Positions for a Timestamp

// Get planetary positions and ascendant for a timestamp/location
$timestampData = [
    'year' => 1990, 'month' => 5, 'day' => 15,
    'hour' => 14, 'minute' => 30, 'second' => 0,
    'tz' => 'Asia/Kolkata', 'lat' => 28.61, 'lon' => 77.20
];

$planets = $astronomy->getPlanets($timestampData);
$ascendant = $astronomy->getAscendant($timestampData);

echo "Sun: " . $planets['Sun'] . "°\n";
echo "Ascendant: " . $ascendant . "°";

5. Comprehensive Full-Day Data

// Get all advanced time divisions for a date
$details = Panchang::getDayDetails($date, $lat, $lon, $tz);

$lagnas   = $details['Lagna_Full_Day'];     // Exact Sign entry times
$horas    = $details['Hora_Full_Day'];       // 24 planetary rulers
$praharas = $details['Prahara_Full_Day'];    // 8 canonical periods
$muhurtas = $details['Muhurta_Full_Day'];    // 30 named Muhurtas
$badTimes = $details['Rahu_Kaal_Gulika_Yamaganda']; // Rahu, Gulika, Yamaganda
$durs     = $details['Dur_Muhurta_Full_Day']; // Inauspicious Muhurtas
$sandhya  = $details['Sandhya'];              // Pratah / Madhyahna / Sayahna
$gowri    = $details['Gowri_Panchangam'];     // Day + night Gowri divisions
$karmakala = $details['Karmakala_Windows'];   // Named daily windows

6. Transit-Only Muhurta Evaluation

$evaluation = Panchang::getDailyMuhurtaEvaluation(
    date: CarbonImmutable::now()->startOfDay(),
    lat: $lat,
    lon: $lon,
    tz: $tz,    currentAt: CarbonImmutable::now($tz)
);

$verdict = $evaluation['rejection_report']['overall_verdict'];
$bhadraActive = $evaluation['evaluation_results']['bhadra']['is_active'];
$varjyamActive = $evaluation['evaluation_results']['varjyam']['is_active'];

7. Raw JSON Exporter

Use this when you want the complete all-in-one package output in a single JSON file:

php scripts/panchang_raw_output.php > output.json

This writes meta, festivals_2026, eclipses_2026_2032, todays_complete_details, and muhurta_evaluation in one file.

Additional standalone exporters are available in scripts/:

php scripts/panchang_today.php
php scripts/panchang_month_output.php 2026 4 > month_2026_04.json
php scripts/panchang_eclipses.php 2026 2032
php scripts/panchang_festivals.php 2026

panchang_today.php writes today_panchang.json automatically and also prints JSON to stdout. panchang_month_output.php prints JSON to stdout only, so choose the filename with shell redirection. panchang_eclipses.php writes eclipses_YYYY_YYYY.json automatically and also prints JSON to stdout. panchang_festivals.php writes festivals_YYYY.json automatically and prints status lines; do not redirect its stdout as raw JSON.

Use PANCHANG_LOCALE=en|hi|gu and PANCHANG_CALENDAR_TYPE=amanta|purnimanta to generate localized/calendar-type variants. For a dedicated output directory, move implicit-output files after generation and redirect stdout-only scripts directly:

cd scripts
dir="output/amanta/gu"
mkdir -p "$dir"

PANCHANG_CALENDAR_TYPE=amanta PANCHANG_LOCALE=gu php panchang_today.php > /tmp/today.log
mv -f today_panchang.json "$dir/today.json"

PANCHANG_CALENDAR_TYPE=amanta PANCHANG_LOCALE=gu php panchang_festivals.php 2026 > /tmp/festivals.log
mv -f festivals_2026.json "$dir/festivals_2026.json"

PANCHANG_CALENDAR_TYPE=amanta PANCHANG_LOCALE=gu php panchang_month_output.php 2026 4 > "$dir/month_2026_04.json"

PANCHANG_CALENDAR_TYPE=amanta PANCHANG_LOCALE=gu php panchang_eclipses.php 2026 2032 > /tmp/eclipses.log
mv -f eclipses_2026_2032.json "$dir/eclipses_2026_2032.json"

Accuracy & Date Range

Technical specifications of the Swiss Ephemeris astronomical engine.

Error Handling

Understanding and handling errors.

Common Exceptions

Best Practices

try {
    $details = Panchang::getDayDetails(
        date: $date,
        lat: $lat, // Validate: -90 to 90
        lon: $lon, // Validate: -180 to 180
        tz: $tz    // Validate: timezone_exists($tz)
    );
} catch (RuntimeException $e) {
    Log::error('Panchang calculation failed', [
        'error' => $e->getMessage(),
        'location' => compact('lat', 'lon', 'tz')
    ]);

    return response()->json([
        'error' => 'Unable to calculate panchang for this location'
    ], 500);
}

FAQ & Troubleshooting

Common questions and solutions.

Breaking Changes in v4.0.0

Important changes when upgrading from v3.x to v4.0.0.

1. Default Configuration Changes

2. Method Signature Changes

All enum getName() methods now accept an optional $locale parameter:

// v3.x
$name = Nakshatra::Ashwini->getName(); // "Ashwini"

// v4.0.0
$name = Nakshatra::Ashwini->getName();              // Uses configured locale
$name = Nakshatra::Ashwini->getName('hi');         // "अश्विनी"
$name = Nakshatra::Ashwini->getName('gu');         // "અશ્વિની"

3. Time Field Structure Changes

Sunrise, Sunset, Moonrise, and Moonset in the Panchanga output now return objects instead of strings:

// v3.x (string)
$details['Panchanga']['Sunrise']; // "06:14:00 AM"

// v4.0.0 (object)
$details['Panchanga']['Sunrise']; // ['jd' => 2461234.5, 'iso' => '2026-04-16T06:14:00+05:30', 'display' => '06:14:00 AM', 'timestamp' => 1234567890]
$details['Panchanga']['Sunrise']['display'];  // "06:14:00 AM"
$details['Panchanga']['Sunrise']['jd'];        // Julian Day
$details['Panchanga']['Sunrise']['iso'];        // ISO timestamp
$details['Panchanga']['Sunrise']['timestamp'];  // Unix timestamp

4. Enum Value Changes

5. Removed Methods

The following methods have been removed:

• Masa::getEnglishApproximation() - removed
• Masa::getRulingNakshatra() - removed
• Ritu::getEnglishName() - removed
• Ritu::getMonths() - removed
• Karana::getType() - removed
• Karana::isVishti() - removed

6. PHP 8.3+ Requirement

This package targets PHP 8.3+ and the current Composer platform config is pinned accordingly.

7. Calendar Type Parameter

Methods like getDayDetails() support an optional calendarType parameter. If omitted, the default remains CalendarType::Amanta:

// v3.x
$details = $panchang->getDayDetails($date, $lat, $lon, $tz);

// Explicit enum
$details = $panchang->getDayDetails($date, $lat, $lon, $tz, 0.0, null, CalendarType::Amanta);

// Or use string
$details = $panchang->getDayDetails($date, $lat, $lon, $tz, 0.0, null, 'amanta');
$details = $panchang->getDayDetails($date, $lat, $lon, $tz, 0.0, null, 'purnimanta');

License

Complete Public API Surface (Live from src)

This section is a direct reflection snapshot of all public methods and public constants currently declared in src/.

Use this as the definitive signature reference when integrating the package.

## JayeshMepani\PanchangCore\Astronomy\AstronomyService
- __construct(SwissEph\FFI\SwissEphFFI $sweph): void
- configure(string $ephePath = ""): void
- getAscendant(array $birth): float
- getAyanamsa(float $jd): float
- getPlanetaryStates(array $birth, string $nodeMode = "mean", float $stationTolerance = 1.0E-6): array
- getPlanets(array $birth): array
- setAyanamsa(float $jd): void
- toJulianDayUtc(array $birth): float

## JayeshMepani\PanchangCore\Astronomy\EclipseService
- __construct(SwissEph\FFI\SwissEphFFI $sweph): void
- configure(string $ephePath = ""): void
- getEclipsesForYear(int $year, float $lat, float $lon, string $tz): array

## JayeshMepani\PanchangCore\Astronomy\SunService
- __construct(SwissEph\FFI\SwissEphFFI $sweph): void
- configure(string $ephePath = ""): void
- getBirthDatetime(array $birth): Carbon\CarbonImmutable
- getIntervalAndStart(array $birth): array
- getMoonriseMoonset(array $birth): array
- getSolarTransits(array $birth): array
- getSunriseSunset(array $birth): array
- getTwilightTimes(array $birth): array
- isDayBirth(array $birth): bool
- jdToCarbonPublic(float $jd, string $timezone): Carbon\CarbonImmutable

## JayeshMepani\PanchangCore\Core\AstroCore
- countSigns(int $targetSign, int $startSign, bool $forward = true): int
- formatAngle(float $angle): string|float
- formatCoordinate(float $coordinate): string|float
- formatDateTime(Carbon\CarbonImmutable $time): string
- formatDuration(float $minutes): string|float
- formatTime(Carbon\CarbonImmutable $time): string
- getAngularDistance(float $a, float $b): float
- getConfig(string $key, mixed $default = null): mixed
- getHouseNumFromLagna(int $signIdx, int $ascSignIdx): int
- getSign(float $lon): int
- getSignLon(float $lon): float
- getTimeDiffMinutesPrecise(DateTimeInterface $target, DateTimeInterface $reference): float
- normalize(float $x): float
- toDms(float $deg): string

## JayeshMepani\PanchangCore\Core\Constants\ClassicalTimeConstants
const SECONDS_PER_DAY
const MINUTES_PER_DAY
const SECONDS_PER_HOUR
const MINUTES_PER_HOUR
const SECONDS_PER_MINUTE
const GHATIKA_IN_MINUTES
const GHATIKA_PER_DAY
const PALA_IN_SECONDS
const MUHURTA_IN_MINUTES
const MUHURTA_PER_DAY
const ARUNODAYA_MINUTES
const ARUNODAYA_PER_DAY
const PRADOSHA_MINUTES
const PRADOSHA_PER_DAY
const BRAHMA_MUHURTA_MINUTES
const BRAHMA_MUHURTA_OFFSET_MINUTES
const DEGREES_PER_SIGN
const DEGREES_PER_NAKSHATRA
const DEGREES_PER_TITHI
const TITHIS_PER_PAKSHA
const NAKSHATRAS_TOTAL
const SIGNS_TOTAL
const CIRCLE_DEGREES
const JD_EPSILON
const BINARY_SEARCH_ITERATIONS
const DEGREE_EPSILON
const JUPITER_CYCLE_YEARS
const KALI_ERA_OFFSET
const VIKRAMA_ERA_OFFSET
const SHAKA_ERA_OFFSET
const BHADRA_TITHIS
const EKADASHI_TITHI
const CHATURDASHI_TITHI
const PURNIMA_TITHI
const SCORE_TITHI_AT_KARMAKALA
const SCORE_TITHI_AT_SUNRISE
const SCORE_TITHI_DURING_DAY
const SCORE_TITHI_DURING_NIGHT
const SCORE_WEEKDAY_MATCH
const SCORE_NAKSHATRA_MATCH
const SCORE_VRIDDHI_FIRST_DAY
const SCORE_KSHAYA_PENALTY

## JayeshMepani\PanchangCore\Core\Enums\CalendarType
const Amanta
const Purnimanta
- cases(): array
- from(string|int $value): static
- getLocalizedName(string $locale = null): string
- isAmanta(): bool
- isPurnimanta(): bool
- tryFrom(string|int $value): static

## JayeshMepani\PanchangCore\Core\Enums\Choghadiya
const Udveg
const Chal
const Labh
const Amrit
const Kaal
const Shubh
const Rog
- cases(): array
- from(string|int $value): static
- fromTime(float $jdSunrise, float $jdSunset, float $jdCurrent, JayeshMepani\PanchangCore\Core\Enums\Vara $vara): self
- getDaySequence(JayeshMepani\PanchangCore\Core\Enums\Vara $vara): array
- getName(string $locale = null): string
- getNature(): string
- getNightSequence(JayeshMepani\PanchangCore\Core\Enums\Vara $vara): array
- isAuspicious(): bool
- tryFrom(string|int $value): static

## JayeshMepani\PanchangCore\Core\Enums\Hora
const Sun
const Venus
const Mercury
const Moon
const Saturn
const Jupiter
const Mars
- cases(): array
- from(string|int $value): static
- getName(string $locale = null): string
- getSequence(JayeshMepani\PanchangCore\Core\Enums\Vara $vara): array
- tryFrom(string|int $value): static

## JayeshMepani\PanchangCore\Core\Enums\Karana
const Bava
const Balava
const Kaulava
const Taitila
const Gara
const Vanija
const Vishti
const Shakuni
const Chatushpada
const Naga
const Kintughna
- cases(): array
- from(string|int $value): static
- fromTithi(int $tithiIndex, float $fraction): self
- getFromLongitudes(float $sunLon, float $moonLon): array
- getName(string $locale = null): string
- tryFrom(string|int $value): static

## JayeshMepani\PanchangCore\Core\Enums\Masa
const Chaitra
const Vaishakha
const Jyeshtha
const Ashadha
const Shravana
const Bhadrapada
const Ashvina
const Kartika
const Margashirsha
const Pausha
const Magha
const Phalguna
- cases(): array
- from(string|int $value): static
- fromAmantaIndex(int $index): self
- fromIndex(int $index): self
- fromSunLongitude(float $sunLon): self
- getName(string $locale = null): string
- tryFrom(string|int $value): static

## JayeshMepani\PanchangCore\Core\Enums\Muhurta
const Rudra
const Sarpa
const Mitra
const Pitri
const Vasu
const Vara
const Vishvedeva
const Vidhi
const Brahma
const Indra
const Indragni
const Daitya
const Varuna
const Aryaman
const Bhaga
const Ishvara
const Ajapada
const Ahirbudhnya
const Pushya
const Nasatya
const Yama
const Vahni
const Dhala
const Shashi
const Aditya
const Guru
const Acyuta
const Arka
const Tvashta
const Vayu
- cases(): array
- from(string|int $value): static
- getDaySequence(): array
- getName(string $locale = null): string
- getNightSequence(): array
- tryFrom(string|int $value): static

## JayeshMepani\PanchangCore\Core\Enums\Nakshatra
const Ashwini
const Bharani
const Krittika
const Rohini
const Mrigashira
const Ardra
const Punarvasu
const Pushya
const Ashlesha
const Magha
const PurvaPhalguni
const UttaraPhalguni
const Hasta
const Chitra
const Swati
const Vishakha
const Anuradha
const Jyeshtha
const Mula
const PurvaAshadha
const UttaraAshadha
const Shravana
const Dhanishta
const Shatabhisha
const PurvaBhadrapada
const UttaraBhadrapada
const Revati
- cases(): array
- from(string|int $value): static
- fromLongitude(float $longitude): self
- getDeity(): string
- getLongitudeRange(): array
- getName(string $locale = null): string
- getPada(float $longitude): int
- getRulingPlanet(): string
- getSymbol(): string
- tryFrom(string|int $value): static

## JayeshMepani\PanchangCore\Core\Enums\Paksha
const Shukla
const Krishna
- cases(): array
- containsTithi(int $tithiIndex): bool
- from(string|int $value): static
- getDescription(): string
- getName(string $locale = null): string
- getRawName(): string
- getTithiRange(): array
- isKrishna(): bool
- isShukla(): bool
- normalizeTithi(int $tithiIndex): int
- opposite(): self
- toAbsoluteTithi(int $normalizedTithi): int
- tryFrom(string|int $value): static

## JayeshMepani\PanchangCore\Core\Enums\Rasi
const Mesha
const Vrishabha
const Mithuna
const Karka
const Simha
const Kanya
const Tula
const Vrischika
const Dhanu
const Makara
const Kumbha
const Meena
- cases(): array
- from(string|int $value): static
- fromLongitude(float $longitude): self
- getElement(): string
- getEnglishName(): string
- getLongitudeRange(): array
- getName(string $locale = null): string
- getRulingPlanet(): string
- getSymbol(): string
- tryFrom(string|int $value): static

## JayeshMepani\PanchangCore\Core\Enums\Ritu
const Vasanta
const Grishma
const Varsha
const Sharad
const Hemanta
const Shishira
- cases(): array
- from(string|int $value): static
- fromMonth(int $monthIndex): self
- fromSunLongitude(float $sunLon): self
- getName(string $locale = null): string
- tryFrom(string|int $value): static

## JayeshMepani\PanchangCore\Core\Enums\Samvatsara
const Prabhava
const Vibhava
const Shukla
const Pramoda
const Prajapati
const Angirasa
const Srimukha
const Bhava
const Yuva
const Dhata
const Ishvara
const Bahudhanya
const Pramathi
const Vikrama
const Vrisha
const Chitrabhanu
const Svabhanu
const Tarana
const Parthiva
const Vyaya
const Sarvajit
const Sarvadhari
const Virodhi
const Vikriti
const Khara
const Nandana
const Vijaya
const Jaya
const Manmatha
const Durmukhi
const Hevilambi
const Vilambi
const Vikari
const Sharvari
const Plava
const Shubhakritu
const Shobhakritu
const Krodhi
const Vishvavasu
const Parabhava
const Plavanga
const Kilaka
const Saumya
const Sadharana
const Virodhikritu
const Paritapi
const Pramadi
const Ananda
const Rakshasa
const Nala
const Pingala
const Kalayukti
const Siddharthi
const Raudri
const Durmati
const Dundubhi
const Rudhirodgari
const Raktakshi
const Krodhana
const Akshaya
- cases(): array
- from(string|int $value): static
- fromGregorianYear(int $gregorianYear): self
- fromYear(int $year): self
- getName(string $locale = null): string
- tryFrom(string|int $value): static

## JayeshMepani\PanchangCore\Core\Enums\Tithi
const ShuklaPratipada
const ShuklaDwitiya
const ShuklaTritiya
const ShuklaChaturthi
const ShuklaPanchami
const ShuklaShashthi
const ShuklaSaptami
const ShuklaAshtami
const ShuklaNavami
const ShuklaDashami
const ShuklaEkadashi
const ShuklaDwadashi
const ShuklaTrayodashi
const ShuklaChaturdashi
const Purnima
const KrishnaPratipada
const KrishnaDwitiya
const KrishnaTritiya
const KrishnaChaturthi
const KrishnaPanchami
const KrishnaShashthi
const KrishnaSaptami
const KrishnaAshtami
const KrishnaNavami
const KrishnaDashami
const KrishnaEkadashi
const KrishnaDwadashi
const KrishnaTrayodashi
const KrishnaChaturdashi
const Amavasya
- cases(): array
- from(string|int $value): static
- fromLongitudes(float $sunLon, float $moonLon): self
- getFractionRemaining(float $sunLon, float $moonLon): float
- getName(string $locale = null): string
- getNormalizedIndex(): int
- getPaksha(): JayeshMepani\PanchangCore\Core\Enums\Paksha
- isChaturdashi(): bool
- isEkadashi(): bool
- isPurnimaOrAmavasya(): bool
- tryFrom(string|int $value): static

## JayeshMepani\PanchangCore\Core\Enums\Vara
const Sunday
const Monday
const Tuesday
const Wednesday
const Thursday
const Friday
const Saturday
- cases(): array
- from(string|int $value): static
- fromDayOfWeek(int $dayOfWeek): self
- fromJulianDay(float $jd): self
- getEnglishName(): string
- getName(string $locale = null): string
- getRulingPlanet(): string
- tryFrom(string|int $value): static

## JayeshMepani\PanchangCore\Core\Enums\VimshottariDasha
const Sun
const Moon
const Mars
const Rahu
const Jupiter
const Saturn
const Mercury
const Ketu
const Venus
- cases(): array
- from(string|int $value): static
- fromNakshatra(JayeshMepani\PanchangCore\Core\Enums\Nakshatra $nakshatra): self
- getDashaYears(): int
- getName(string $locale = null): string
- tryFrom(string|int $value): static

## JayeshMepani\PanchangCore\Core\Enums\Yoga
const Vishkumbha
const Priti
const Ayushman
const Saubhagya
const Shobhana
const Atiganda
const Sukarma
const Dhriti
const Shula
const Ganda
const Vriddhi
const Dhruva
const Vyaghata
const Harshana
const Vajra
const Siddhi
const Vyatipata
const Variyana
const Parigha
const Shiva
const Siddha
const Sadhya
const Shubha
const Shukla
const Brahma
const Indra
const Vaidhriti
- cases(): array
- from(string|int $value): static
- fromLongitudes(float $sunLon, float $moonLon): self
- getFractionRemaining(float $sunLon, float $moonLon): float
- getName(string $locale = null): string
- tryFrom(string|int $value): static

## JayeshMepani\PanchangCore\Core\Localization
- translate(string $type, string|int $key, string $locale = null): string

## JayeshMepani\PanchangCore\Facades\Panchang

## JayeshMepani\PanchangCore\Festivals\FestivalFamilyOrchestrator
const FESTIVAL_FAMILIES
const EXCEPTION_LOGIC
- resolveFestivalFamily(string $familyName, array $baseDate, array $panchangData, string $tradition = null, string $region = null): array

## JayeshMepani\PanchangCore\Festivals\FestivalRuleEngine
- annotateMonthAnomalies(array $dateToDetails): array
- resolveMajorFestival(string $festivalName, array $rule, Carbon\CarbonImmutable $date, array $today, array $tomorrow): array
- resolveNakshatraBasedFestival(string $festivalName, array $rule, Carbon\CarbonImmutable $date, array $today, array $tomorrow): array

## JayeshMepani\PanchangCore\Festivals\FestivalService
const TITHI_VRATAS
const FESTIVALS
const MONTHS
- __construct(JayeshMepani\PanchangCore\Festivals\FestivalRuleEngine $ruleEngine): void
- buildFestivalPayload(string $name, array $rules, array $resolved = null): array
- getDailyObservances(array $panchangDetails): array
- getFestivalsForYear(int $year, string $pakshaSystem = "Amanta"): array
- resolveFestivalsForDate(Carbon\CarbonImmutable $date, array $todayDetails, array $tomorrowDetails, array $yesterdayDetails = null, callable $fetchHistoricalSnapshot = null, bool $includeExtraWinners = false): array
- usesClassicalResolver(array $rules): bool

## JayeshMepani\PanchangCore\Festivals\Utils\BhadraEngine
- calculateBhadra(float $sunriseJd, float $vishtiStartJd, float $vishtiEndJd, int $moonRasiIndex, int $tithiIndex, string $paksha): array

## JayeshMepani\PanchangCore\PanchangServiceProvider
- boot(): void
- register(): void

## JayeshMepani\PanchangCore\Panchanga\ElectionalEvaluator
- calculateAbhijitCancellation(float $sunrise, float $sunset, int $varaNumber, float $currentTime): array
- calculateAmritaKaal(int $varaNumber, float $sunrise, float $sunset, float $nextSunrise, float $currentTime): array
- calculateBhadra(int $moonSignIdx): array
- calculateDagdhaTithi(int $tithiNumber, int $moonSignIdx): array
- calculateDagdhaYoga(int $varaNumber, int $tithiNumber): array
- calculatePanchakaDosha(int $tithiNumber, int $varaNumber, int $nakshatraNumber, int $lagnaNumber): array
- calculateRiktaTithi(int $tithiNumber, bool $isKrishnaPaksha): array
- calculateTransitMoorthy(string $nakshatraName): array
- calculateVarjyam(int $nakshatraNumber, float $nakshatraStartTime, float $nakshatraDurationMinutes): array
- generateRejectionReport(array $evaluationResults): array

## JayeshMepani\PanchangCore\Panchanga\ElectionalRuleBook
const UNIVERSAL_BAD_TITHIS
const UNIVERSAL_BAD_CHOGADIYA
const UNIVERSAL_GOOD_CHOGADIYA
const UNIVERSAL_GOOD_HORAS
const UNIVERSAL_BAD_YOGAS
const UNIVERSAL_GOOD_KARANAS
const UNIVERSAL_BAD_KARANAS
const COMBUSTION_ORBS
const COMBUSTION_ORBS_RETRO
const VARA_TITHI_YOGAS

## JayeshMepani\PanchangCore\Panchanga\KalaNirnayaEngine
const GHATI_IN_MINUTES
const PALA_IN_SECONDS
const GHATIKA_PER_DAY
const ARUNODAYA_GHATIKAS
const ARUNODAYA_MINUTES
const SANKRANTI_PUNYA_KAAL
const TITHI_NAMES
const FESTIVAL_RULES
- __construct(float $latitude, float $longitude): void
- calculatePunyaKaal(string $sankrantiName, float $sankrantiJd, float $sunriseJd, float $sunsetJd): array
- configure(string $ephePath = ""): void
- determineEkadashi(float $ekadashiStartJd, float $ekadashiEndJd, float $dashamiEndJd, float $dvadashiStartJd, float $sunriseJd, float $nextSunriseJd, string $tradition = "Vaishnava"): array
- determineViddhaTithi(int $tithiNumber, float $tithiStartJd, float $tithiEndJd, float $sunriseDay1Jd, float $sunriseDay2Jd, float $prevTithiEndJd): array
- generateKalaNirnayaReport(int $tithiNumber, float $tithiStartJd, float $tithiEndJd, float $prevTithiEndJd, float $sunriseJd, float $sunsetJd, float $nextSunriseJd): array
- resolveFestivalDate(string $festivalName, float $tithiStartJd, float $tithiEndJd, float $sunriseJd, float $sunsetJd, float $nextSunriseJd): array

## JayeshMepani\PanchangCore\Panchanga\MuhurtaService
- __construct(JayeshMepani\PanchangCore\Muhurta\Planetary\HoraCalculator $horaCalculator, JayeshMepani\PanchangCore\Muhurta\Planetary\ChogadiyaCalculator $chogadiyaCalculator, JayeshMepani\PanchangCore\Muhurta\Classical\DailyPeriodsCalculator $dailyPeriodsCalculator, JayeshMepani\PanchangCore\Muhurta\Classical\InauspiciousPeriodsCalculator $inauspiciousPeriodsCalculator, JayeshMepani\PanchangCore\Muhurta\Regional\GowriPanchangamCalculator $gowriPanchangamCalculator, JayeshMepani\PanchangCore\Muhurta\Lagna\LagnaTableCalculator $lagnaTableCalculator): void
- calculateAbhijitMuhurta(Carbon\CarbonImmutable $sunrise, Carbon\CarbonImmutable $sunset): array
- calculateAmritaKaal(Carbon\CarbonImmutable $sunrise, array $varjyam): array
- calculateBadTimes(Carbon\CarbonImmutable $sunrise, Carbon\CarbonImmutable $sunset, int $varaIdx): array
- calculateBrahmaMuhurta(Carbon\CarbonImmutable $sunrise): array
- calculateChogadiya(Carbon\CarbonImmutable $sunrise, Carbon\CarbonImmutable $sunset, Carbon\CarbonImmutable $nextSunrise, Carbon\CarbonImmutable $current, int $varaIdx): array
- calculateChogadiyaTable(Carbon\CarbonImmutable $sunrise, Carbon\CarbonImmutable $sunset, Carbon\CarbonImmutable $nextSunrise, int $varaIdx): array
- calculateDaylightFivefoldDivision(Carbon\CarbonImmutable $sunrise, Carbon\CarbonImmutable $sunset): array
- calculateDurMuhurta(Carbon\CarbonImmutable $sunrise, Carbon\CarbonImmutable $sunset, Carbon\CarbonImmutable $nextSunrise, int $varaIdx): array
- calculateGodhuliMuhurta(Carbon\CarbonImmutable $sunset, Carbon\CarbonImmutable $nextSunrise): array
- calculateGowriPanchangam(Carbon\CarbonImmutable $sunrise, Carbon\CarbonImmutable $sunset, Carbon\CarbonImmutable $nextSunrise, int $varaIdx): array
- calculateHora(Carbon\CarbonImmutable $sunrise, Carbon\CarbonImmutable $sunset, Carbon\CarbonImmutable $nextSunrise, Carbon\CarbonImmutable $current, int $varaIdx): array
- calculateHoraTable(Carbon\CarbonImmutable $sunrise, Carbon\CarbonImmutable $sunset, Carbon\CarbonImmutable $nextSunrise, int $varaIdx): array
- calculateKalaVela(Carbon\CarbonImmutable $sunrise, Carbon\CarbonImmutable $sunset, Carbon\CarbonImmutable $nextSunrise, int $varaIdx): array
- calculateLagna(Carbon\CarbonImmutable $current, Carbon\CarbonImmutable $sunrise, float $sunriseSunLongitude, float $ayanamsaDeg, float $lat, float $lon, SwissEph\FFI\SwissEphFFI $sweph): array
- calculateLagnaTable(Carbon\CarbonImmutable $sunrise, Carbon\CarbonImmutable $sunset, Carbon\CarbonImmutable $nextSunrise, float $sunriseSunLongitude, float $ayanamsaDeg, float $lat, float $lon, SwissEph\FFI\SwissEphFFI $sweph): array
- calculateMuhurtaTable(Carbon\CarbonImmutable $sunrise, Carbon\CarbonImmutable $sunset, Carbon\CarbonImmutable $nextSunrise): array
- calculateNishitaMuhurta(Carbon\CarbonImmutable $sunset, Carbon\CarbonImmutable $nextSunrise): array
- calculatePradoshaKaal(Carbon\CarbonImmutable $sunset, int $tithiNum): array
- calculatePrahara(Carbon\CarbonImmutable $sunrise, Carbon\CarbonImmutable $sunset, Carbon\CarbonImmutable $nextSunrise): array
- calculateSandhya(Carbon\CarbonImmutable $sunrise, Carbon\CarbonImmutable $sunset, Carbon\CarbonImmutable $nextSunrise, Carbon\CarbonImmutable $solarNoon): array
- calculateVarjyam(Carbon\CarbonImmutable $sunrise, Carbon\CarbonImmutable $sunset, Carbon\CarbonImmutable $nextSunrise, int $nakshatraIndex, float $nakshatraStartJd, float $nakshatraEndJd): array
- calculateVijayaMuhurta(Carbon\CarbonImmutable $sunrise, Carbon\CarbonImmutable $sunset): array

## JayeshMepani\PanchangCore\Panchanga\OutputGeneratorService
- __construct(JayeshMepani\PanchangCore\Panchanga\PanchangService $panchangService, JayeshMepani\PanchangCore\Astronomy\EclipseService $eclipseService): void
- generateAll(int $festivalYear, int $eclipseStartYear, int $eclipseEndYear, float $lat, float $lon, string $tz, float $elevation = 0, JayeshMepani\PanchangCore\Core\Enums\CalendarType|string $calendarType = JayeshMepani\PanchangCore\Core\Enums\CalendarType::Amanta): array
- generateEclipses(int $startYear, int $endYear, float $lat, float $lon, string $tz): array
- generateFestivals(int $year, float $lat, float $lon, string $tz, float $elevation = 0, JayeshMepani\PanchangCore\Core\Enums\CalendarType|string $calendarType = JayeshMepani\PanchangCore\Core\Enums\CalendarType::Amanta): array
- generateTodayPanchang(float $lat, float $lon, string $tz, float $elevation = 0, JayeshMepani\PanchangCore\Core\Enums\CalendarType|string $calendarType = JayeshMepani\PanchangCore\Core\Enums\CalendarType::Amanta): array

## JayeshMepani\PanchangCore\Panchanga\PanchangService
- __construct(SwissEph\FFI\SwissEphFFI $sweph, JayeshMepani\PanchangCore\Astronomy\SunService $sunService, JayeshMepani\PanchangCore\Astronomy\AstronomyService $astronomy, JayeshMepani\PanchangCore\Panchanga\PanchangaEngine $panchanga, JayeshMepani\PanchangCore\Panchanga\MuhurtaService $muhurta, JayeshMepani\PanchangCore\Festivals\FestivalService $festivalService, JayeshMepani\PanchangCore\Festivals\Utils\BhadraEngine $bhadraEngine, mixed $unusedTransitEngine = null, mixed $unusedIntervalTracker = null, JayeshMepani\PanchangCore\Panchanga\Residences\VaasaCalculator|null $vaasaCalculator = null, JayeshMepani\PanchangCore\Panchanga\Residences\ShoolaCalculator|null $shoolaCalculator = null, JayeshMepani\PanchangCore\Panchanga\Yogas\SpecialYogaCalculator|null $specialYogaCalculator = null, JayeshMepani\PanchangCore\Panchanga\Doshas\PanchakCalculator|null $panchakCalculator = null, JayeshMepani\PanchangCore\Panchanga\Doshas\BhadraCalculator|null $bhadraCalculator = null, mixed $unusedVarjyamWindowCalculator = null, JayeshMepani\PanchangCore\Panchanga\Vrata\EkadashiParanaCalculator|null $ekadashiParanaCalculator = null, mixed ...$unusedExtractedCalculators): void
- configure(string $ephePath = ""): void
- getDailyMuhurtaEvaluation(Carbon\CarbonImmutable $date, float $lat, float $lon, string $tz, Carbon\CarbonImmutable $currentAt = null, float $elevation = 0, array $options = []): array
- getDayDetails(Carbon\CarbonImmutable $date, float $lat, float $lon, string $tz, float $elevation = 0, Carbon\CarbonImmutable $calculationAt = null, JayeshMepani\PanchangCore\Core\Enums\CalendarType|string $calendarType = JayeshMepani\PanchangCore\Core\Enums\CalendarType::Amanta, array $options = []): array
- getElectionalSnapshot(Carbon\CarbonImmutable $date, float $lat, float $lon, string $tz, float $elevation = 0, array $options = []): array
- getFestivalSnapshot(Carbon\CarbonImmutable $date, float $lat, float $lon, string $tz, float $elevation = 0, Carbon\CarbonImmutable $calculationAt = null, JayeshMepani\PanchangCore\Core\Enums\CalendarType|string $calendarType = JayeshMepani\PanchangCore\Core\Enums\CalendarType::Amanta): array
- getFestivalYearCalendar(int $year, float $lat, float $lon, string $tz, float $elevation = 0, Carbon\CarbonImmutable $calculationAt = null, JayeshMepani\PanchangCore\Core\Enums\CalendarType|string $calendarType = JayeshMepani\PanchangCore\Core\Enums\CalendarType::Amanta): array
- getMonthCalendar(int $year, int $month, float $lat, float $lon, string $tz, float $elevation = 0, array $options = [], Carbon\CarbonImmutable $calculationAt = null, JayeshMepani\PanchangCore\Core\Enums\CalendarType|string $calendarType = JayeshMepani\PanchangCore\Core\Enums\CalendarType::Amanta): array

## JayeshMepani\PanchangCore\Panchanga\PanchangaEngine
- calculateKundaLagna(float $ascLon): array
- calculatePanchakaRahita(int $tithiNum, int $varaNum, int $nakNum, int $lagnaNum): array
- calculateTithi(float $sunLon, float $moonLon): array
- calculateVara(array $birth, JayeshMepani\PanchangCore\Astronomy\SunService $sunService): array
- calculateYoga(float $sunLon, float $moonLon): array
- getAyana(float $sunLon): string
- getGujaratiSamvat(int $vikramSamvat, int $monthIndex): int
- getHinduMonth(float $sunLon, float $moonLon, string $paksha = "Shukla"): array
- getKaliSamvat(int $vikramSamvat): int
- getKarana(float $sunLon, float $moonLon): array
- getNakshatraInfo(float $longitude): array
- getPanchanga(float $sunLon, float $moonLon, array $birth, JayeshMepani\PanchangCore\Astronomy\SunService $sunService, JayeshMepani\PanchangCore\Astronomy\AstronomyService $astronomy): array
- getRitu(float $sunLon): string
- getSamvat(int $year, int $month): array
- getSamvatsara(int $vikramSamvat): string
- getSamvatsaraNorth(int $vikramSamvat): string
- isVishtiKarana(float $sunLon, float $moonLon): bool

## JayeshMepani\PanchangCore\Traits\CliBootstrap
- init(string $baseDir): void
- makeEclipseService(): JayeshMepani\PanchangCore\Astronomy\EclipseService
- makeOutputGenerator(JayeshMepani\PanchangCore\Panchanga\PanchangService $panchang): JayeshMepani\PanchangCore\Panchanga\OutputGeneratorService
- makePanchangService(): JayeshMepani\PanchangCore\Panchanga\PanchangService

Quick Reference