jyotish-calc 1.1.1 → 1.3.0

package/README.md

@@ -5,7 +5,7 @@ A comprehensive JavaScript library for Vedic Astrology (Jyotish) calculations an
 
 ## Overview
 
-This package provides tools and utilities for performing various Vedic Astrology calculations, including planetary positions, nakshatras (lunar mansions), rashis (zodiac signs), bhavas (houses), planetary periods (dashas), divisional charts (vargas), and planetary strengths (shadbala). It leverages the Swiss Ephemeris for precise astronomical calculations.
+This package provides tools and utilities for performing various Vedic Astrology calculations, including planetary positions, nakshatras (lunar mansions), rashis (zodiac signs), special lagnas (Bhava, Hora, Ghati, etc.), upagrahas (Gulika, Mandi, Dhuma, etc.), Ashtakavarga (BAV & SAV), planetary periods (dashas), divisional charts (vargas), and planetary strengths (shadbala). It leverages the Swiss Ephemeris for precise astronomical calculations.
 
 ## Installation
 
@@ -16,11 +16,12 @@ npm install jyotish-calc
 ## Features
 
 - **Graha Calculations**: Calculate positions and aspects of the nine planets (grahas)
-- **Nakshatra Determinations**: Calculate and interpret the 27 lunar mansions
-- **Rashi Calculations**: Determine zodiac sign positions and interpretations
-- **Bhava Analysis**: House system calculations and interpretations
+- **Panchanga**: Complete Vedic calendar with tithi, nakshatra, yoga, karana, vaara, muhurtas
+- **Special Lagnas**: Calculate Bhava Lagna, Hora Lagna, Ghati Lagna, etc.
+- **Upagrahas**: Calculate shadow planets like Gulika, Mandi, Dhuma, etc.
+- **Ashtakavarga**: Complete BAV and SAV calculations with house strength analysis
 - **Dasha Systems**: Full support for 7 dasha systems (Vimshottari, Ashtottari, Yogini, etc.) with 5-level sub-periods
-- **Divisional Charts (Vargas)**: Precise calculations for all 21 divisional charts (D1-D60)
+- **Divisional Charts (Vargas)**: Precise calculations for all 21 divisional charts (D1-D60) with no redundant D1 data
 - **Shadbala & Bhavabala**: Comprehensive 6-fold planetary strength and house strength calculations
 
 ## Project Structure
@@ -30,6 +31,10 @@ jyotish
 ├── index.js            # Main entry point
 ├── package.json        # Package configuration
 └── src
+   ├── panchanga        # Panchanga (Vedic calendar/almanac)
+   ├── ashtakavarga     # Ashtakavarga (BAV & SAV) calculations
+   ├── lagnas           # Special Lagna calculations
+   ├── upagrahas        # Upagraha calculations
    ├── bhavas           # House calculations
    ├── dashas           # Dasha periods (Vimshottari, Jaimini, etc.)
    ├── grahas           # Planetary calculations
@@ -40,6 +45,7 @@ jyotish
    └── utils            # Helper utilities
 ```
 
+
 ## Usage
 
 ### Basic Planetary Positions
@@ -131,6 +137,86 @@ const bhavaStrength = strengths.calculateBhavaBala(positions, ascendant, jd, 28.
 console.log(bhavaStrength.total);
 ```
 
+### Special Lagnas & Upagrahas
+
+Calculate special rising signs and shadow planets for all divisional charts.
+
+```javascript
+const { lagnas, upagrahas, vargas, grahas } = require('jyotish-calc');
+
+const birthData = {
+    year: 1998, month: 9, date: 11,
+    hour: 4, min: 30, sec: 0,
+    lat: 13.0827, lng: 80.2707,
+    timezone: 5.5
+};
+
+// Calculate all special points
+const specialLagnas = lagnas.calculateAllSpecialLagnas(birthData);
+const positions = grahas.getGrahasPosition(birthData);
+const shadowPlanets = upagrahas.calculateAllUpagrahas(birthData, positions);
+
+// Integrate with divisional charts
+const allPoints = {
+    Sun: positions.Su.longitude,
+    Ascendant: positions.La.longitude,
+    ...specialLagnas,
+    ...shadowPlanets
+};
+const d9Chart = vargas.calculateVargaChart(allPoints, 'D9');
+```
+
+### Panchanga (Vedic Calendar)
+
+Complete Vedic almanac with all 5 elements, muhurtas, and calendar functions.
+
+```javascript
+const { panchanga } = require('jyotish-calc');
+
+const panchangaData = panchanga.calculatePanchanga({
+    year: 1998, month: 9, date: 11,
+    hour: 4, min: 30, sec: 0,
+    lat: 13.0827, lng: 80.2707, timezone: 5.5
+});
+
+console.log(panchangaData.sunrise);   // {time: 5.97, string: "05:57:55 AM"}
+console.log(panchangaData.tithi);     // {number: 21, name: "Shashthi", paksha: "Krishna"}
+console.log(panchangaData.nakshatra); // {number: 2, name: "Bharani", pada: 4}
+console.log(panchangaData.yoga);      // {number: 13, name: "Vyaghata"}
+console.log(panchangaData.vaara);     // {name: "Friday", nameSanskrit: "Shukravara"}
+console.log(panchangaData.muhurtas.raahuKaalam); // {start: "10:34 AM", end: "12:05 PM"}
+```
+
+### Ashtakavarga
+
+
+Complete strength assessment system.
+
+```javascript
+const { ashtakavarga } = require('jyotish-calc');
+
+const positions = {
+    Sun: 144.188,
+    Moon: 26.174,
+    Mars: 109.654,
+    Mercury: 131.142,
+    Jupiter: 329.905,
+    Venus: 131.297,
+    Saturn: 9.205,
+    Ascendant: 122.003
+};
+
+// Calculate BAV and SAV
+const results = ashtakavarga.calculateAshtakavarga(positions);
+
+console.log(results.sav); // [27, 33, 40, 23, 26, 25, 27, 26, 29, 34, 27, 20]
+console.log(results.interpretations.houses[2]); // "Exceptional" (40 bindus)
+
+// Kakshya Analysis
+const kakshya = ashtakavarga.getKakshya(145.5);
+console.log(kakshya.ruler); // "Mars"
+```
+
 ## Dependencies
 
 - [swisseph-v2](https://www.npmjs.com/package/swisseph-v2): v1.0.4 - Swiss Ephemeris library for astronomical calculations

package/index.js

@@ -5,6 +5,10 @@ const utils = require('./src/utils/index');
 const dashas = require('./src/dashas/index');
 const vargas = require('./src/vargas/index');
 const strengths = require('./src/strengths/index');
+const lagnas = require('./src/lagnas/index');
+const upagrahas = require('./src/upagrahas/index');
+const ashtakavarga = require('./src/ashtakavarga/index');
+const panchanga = require('./src/panchanga/index');
 
 module.exports = {
     grahas,
@@ -13,5 +17,10 @@ module.exports = {
     utils,
     dashas,
     vargas,
-    strengths
+    strengths,
+    lagnas,
+    upagrahas,
+    ashtakavarga,
+    panchanga
 }
+

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "jyotish-calc",
-  "version": "1.1.1",
-  "description": "Comprehensive Vedic Astrology library with Planet Positions, Dashas, Vargas (Divisional Charts), and Shadbala (Strengths)",
+  "version": "1.3.0",
+  "description": "Comprehensive Vedic Astrology library with Panchanga, Special Lagnas, Upagrahas, Ashtakavarga, Dashas, Vargas, and Shadbala",
   "main": "index.js",
   "scripts": {
     "test": "jest",

package/src/ashtakavarga/bav.js

@@ -0,0 +1,159 @@
+/**
+ * Bhinnashtakavarga (BAV) Calculator
+ * Individual planetary Ashtakavarga charts
+ */
+
+const { CONTRIBUTIONS, PLANET_TOTALS, PLANET_NAMES, REFERENCE_POINTS } = require('./constants');
+
+/**
+ * Get house number (1-12) from longitude
+ */
+function getHouseNumber(longitude) {
+    return Math.floor(longitude / 30) + 1;
+}
+
+/**
+ * Calculate house offset from reference to target
+ * Returns 1-12 (not 0-indexed)
+ */
+function calculateOffset(targetHouse, referenceHouse) {
+    let offset = targetHouse - referenceHouse + 1;
+    if (offset <= 0) offset += 12;
+    if (offset > 12) offset -= 12;
+    return offset;
+}
+
+/**
+ * Calculate BAV for a single planet
+ * @param {string} planet - Planet name (Sun, Moon, Mars, etc.)
+ * @param {Object} positions - Planetary positions {Sun: long, Moon: long, ...}
+ * @returns {Array} Array of 12 house bindus [house1, house2, ..., house12]
+ */
+function calculateBAV(planet, positions) {
+    const bindus = Array(12).fill(0);
+    const contributions = CONTRIBUTIONS[planet];
+
+    if (!contributions) {
+        throw new Error(`Unknown planet: ${planet}`);
+    }
+
+    const planetHouse = getHouseNumber(positions[planet]);
+
+    // For each reference point (Sun, Moon, ..., Saturn, Ascendant)
+    for (const refPoint of REFERENCE_POINTS) {
+        if (!positions[refPoint]) {
+            console.warn(`Missing position for ${refPoint}, skipping`);
+            continue;
+        }
+
+        const refHouse = getHouseNumber(positions[refPoint]);
+        const contributionList = contributions[refPoint];
+
+        if (!contributionList) {
+            continue; // No contributions from this reference point
+        }
+
+        // For each house this reference point contributes to
+        for (const offset of contributionList) {
+            // Calculate which house gets the bindu
+            // offset is counted FROM the reference point
+            let targetHouse = refHouse + offset - 1;
+            if (targetHouse > 12) targetHouse -= 12;
+            if (targetHouse < 1) targetHouse += 12;
+
+            // Add bindu to the target house (convert to 0-indexed array)
+            bindus[targetHouse - 1]++;
+        }
+    }
+
+    return bindus;
+}
+
+/**
+ * Calculate BAV for all planets
+ * @param {Object} positions - Planetary positions
+ * @returns {Object} BAV charts for all planets
+ */
+function calculateAllBAV(positions) {
+    const bavCharts = {};
+
+    for (const planet of PLANET_NAMES) {
+        if (!positions[planet]) {
+            throw new Error(`Missing position for planet: ${planet}`);
+        }
+        bavCharts[planet] = calculateBAV(planet, positions);
+    }
+
+    return bavCharts;
+}
+
+/**
+ * Validate BAV totals
+ * Each planet should contribute its expected total bindus
+ */
+function validateBAV(bavCharts) {
+    const errors = [];
+
+    for (const planet of PLANET_NAMES) {
+        const total = bavCharts[planet].reduce((a, b) => a + b, 0);
+        const expected = PLANET_TOTALS[planet];
+
+        if (total !== expected) {
+            errors.push(`${planet}: Expected ${expected} bindus, got ${total}`);
+        }
+    }
+
+    return {
+        valid: errors.length === 0,
+        errors: errors
+    };
+}
+
+/**
+ * Get house strength interpretation for a planet's BAV
+ */
+function interpretPlanetaryHouseStrength(bindus) {
+    if (bindus >= 5) return 'Very Strong';
+    if (bindus >= 4) return 'Strong';
+    if (bindus === 3) return 'Moderate';
+    if (bindus >= 1) return 'Weak';
+    return 'Very Weak';
+}
+
+/**
+ * Calculate detailed BAV with interpretations
+ */
+function calculateDetailedBAV(positions) {
+    const bavCharts = calculateAllBAV(positions);
+    const validation = validateBAV(bavCharts);
+
+    // Add interpretations
+    const detailed = {};
+    for (const planet of PLANET_NAMES) {
+        detailed[planet] = {
+            bindus: bavCharts[planet],
+            total: bavCharts[planet].reduce((a, b) => a + b, 0),
+            interpretations: bavCharts[planet].map(b => interpretPlanetaryHouseStrength(b)),
+            houses: bavCharts[planet].map((bindus, idx) => ({
+                house: idx + 1,
+                bindus: bindus,
+                strength: interpretPlanetaryHouseStrength(bindus)
+            }))
+        };
+    }
+
+    return {
+        bav: bavCharts,
+        detailed: detailed,
+        validation: validation
+    };
+}
+
+module.exports = {
+    calculateBAV,
+    calculateAllBAV,
+    validateBAV,
+    interpretPlanetaryHouseStrength,
+    calculateDetailedBAV,
+    getHouseNumber
+};

package/src/ashtakavarga/constants.js

@@ -0,0 +1,109 @@
+/**
+ * Ashtakavarga Constants
+ * Complete bindu contribution tables for all planets
+ */
+
+// Bindu contribution tables
+// Format: For each planet, specify which houses receive bindus when counted from each reference point
+// Houses are 1-12 (not 0-indexed in the tables for clarity)
+
+const CONTRIBUTIONS = {
+    Sun: {
+        Sun: [1, 2, 4, 7, 8, 9, 10, 11],
+        Moon: [3, 6, 10, 11],
+        Mars: [1, 2, 4, 7, 8, 9, 10, 11],
+        Mercury: [3, 5, 6, 9, 10, 11, 12],
+        Jupiter: [5, 6, 9, 11],
+        Venus: [6, 7, 12],
+        Saturn: [1, 2, 4, 7, 8, 9, 10, 11],
+        Ascendant: [3, 4, 6, 10, 11, 12]
+    },
+    Moon: {
+        Moon: [1, 3, 6, 7, 10, 11],
+        Sun: [3, 6, 7, 8, 10, 11],
+        Mars: [2, 3, 5, 6, 9, 10, 11],
+        Mercury: [1, 3, 4, 5, 7, 8, 10, 11],
+        Jupiter: [1, 4, 7, 8, 10, 11, 12],
+        Venus: [3, 4, 5, 7, 9, 10, 11],
+        Saturn: [3, 5, 6, 11],
+        Ascendant: [3, 6, 10, 11]
+    },
+    Mars: {
+        Mars: [1, 2, 4, 7, 8, 10, 11],
+        Sun: [3, 5, 6, 10, 11],
+        Moon: [3, 6, 11],
+        Mercury: [3, 5, 6, 11],
+        Jupiter: [6, 10, 11, 12],
+        Venus: [6, 8, 11, 12],
+        Saturn: [1, 4, 7, 8, 10, 11, 12], // Added 12th house (total 7)
+        Ascendant: [1, 3, 6, 10, 11]
+    },
+    Mercury: {
+        Mercury: [1, 3, 5, 6, 9, 10, 11, 12],
+        Sun: [5, 6, 9, 11, 12],
+        Moon: [2, 4, 6, 8, 10, 11],
+        Mars: [1, 2, 4, 7, 8, 9, 10, 11],
+        Jupiter: [6, 8, 11, 12],
+        Venus: [1, 2, 3, 4, 5, 8, 9, 11],
+        Saturn: [1, 2, 4, 7, 8, 9, 10, 11],
+        Ascendant: [1, 2, 4, 6, 8, 10, 11]
+    },
+    Jupiter: {
+        Jupiter: [1, 2, 3, 4, 7, 8, 10, 11],
+        Sun: [1, 2, 3, 4, 7, 8, 9, 10, 11],
+        Moon: [2, 5, 7, 9, 11],
+        Mars: [1, 2, 4, 7, 8, 10, 11],
+        Mercury: [1, 2, 4, 5, 6, 9, 10, 11],
+        Venus: [2, 5, 6, 9, 10, 11],
+        Saturn: [3, 5, 6, 12],
+        Ascendant: [1, 2, 4, 5, 6, 7, 9, 10, 11]
+    },
+    Venus: {
+        Venus: [1, 2, 3, 4, 5, 8, 9, 10, 11],
+        Sun: [8, 11, 12],
+        Moon: [1, 2, 3, 4, 5, 8, 9, 11, 12],
+        Mars: [3, 5, 6, 9, 11, 12],
+        Mercury: [3, 5, 6, 9, 11],
+        Jupiter: [5, 8, 9, 10, 11],
+        Saturn: [3, 4, 5, 8, 9, 10, 11],
+        Ascendant: [1, 2, 3, 4, 5, 8, 9, 11]
+    },
+    Saturn: {
+        Saturn: [3, 5, 6, 11],
+        Sun: [1, 2, 4, 7, 8, 10, 11],
+        Moon: [3, 6, 11],
+        Mars: [3, 5, 6, 10, 11], // Added 10th house (total 5)
+        Mercury: [6, 8, 9, 10, 11, 12],
+        Jupiter: [3, 5, 6, 11, 12], // Added 3rd house (total 5)
+        Venus: [6, 11, 12],
+        Ascendant: [1, 3, 4, 6, 10, 11]
+    }
+};
+
+// Expected total bindus per planet (for validation)
+const PLANET_TOTALS = {
+    Sun: 48,
+    Moon: 49,
+    Mars: 39,
+    Mercury: 54,
+    Jupiter: 56,
+    Venus: 52,
+    Saturn: 39
+};
+
+// Total bindus across all planets = 337
+const TOTAL_BINDUS = 337;
+
+// Planet names in standard order
+const PLANET_NAMES = ['Sun', 'Moon', 'Mars', 'Mercury', 'Jupiter', 'Venus', 'Saturn'];
+
+// All reference points including Ascendant
+const REFERENCE_POINTS = ['Sun', 'Moon', 'Mars', 'Mercury', 'Jupiter', 'Venus', 'Saturn', 'Ascendant'];
+
+module.exports = {
+    CONTRIBUTIONS,
+    PLANET_TOTALS,
+    TOTAL_BINDUS,
+    PLANET_NAMES,
+    REFERENCE_POINTS
+};

package/src/ashtakavarga/index.js

@@ -0,0 +1,158 @@
+/**
+ * Ashtakavarga Module
+ * Complete implementation of Bhinnashtakavarga (BAV) and Sarvashtakavarga (SAV)
+ */
+
+const {
+    calculateBAV,
+    calculateAllBAV,
+    validateBAV,
+    interpretPlanetaryHouseStrength,
+    calculateDetailedBAV,
+    getHouseNumber
+} = require('./bav');
+
+const {
+    calculateSAV,
+    validateSAV,
+    interpretHouseStrength,
+    getStrengthCategory,
+    calculateDetailedSAV,
+    getHousesByStrength,
+    analyzeTransitFavorability
+} = require('./sav');
+
+const {
+    getKakshya,
+    getAllKakshyasInSign,
+    analyzeKakshyaTransit,
+    getSignTransitKakshyas,
+    KAKSHYA_RULERS,
+    KAKSHYA_SIZE,
+    NUM_KAKSHYAS
+} = require('./kakshya');
+
+const {
+    CONTRIBUTIONS,
+    PLANET_TOTALS,
+    TOTAL_BINDUS,
+    PLANET_NAMES,
+    REFERENCE_POINTS
+} = require('./constants');
+
+/**
+ * Calculate complete Ashtakavarga (BAV + SAV)
+ * Main API function
+ * @param {Object} positions - Planetary positions {Sun, Moon, Mars, Mercury, Jupiter, Venus, Saturn, Ascendant}
+ * @returns {Object} Complete Ashtakavarga analysis
+ */
+function calculateAshtakavarga(positions) {
+    // Validate input
+    for (const planet of PLANET_NAMES) {
+        if (!positions[planet]) {
+            throw new Error(`Missing position for planet: ${planet}`);
+        }
+    }
+    if (!positions.Ascendant) {
+        throw new Error('Missing Ascendant position');
+    }
+
+    // Calculate BAV for all planets
+    const bavCharts = calculateAllBAV(positions);
+    const bavValidation = validateBAV(bavCharts);
+
+    // Calculate SAV
+    const sav = calculateSAV(bavCharts);
+    const savValidation = validateSAV(sav);
+
+    // Get interpretations
+    const savInterpretations = sav.map(b => interpretHouseStrength(b));
+    const housesByStrength = getHousesByStrength(sav);
+
+    // Calculate statistics
+    const total = sav.reduce((a, b) => a + b, 0);
+    const average = total / 12;
+
+    return {
+        bav: bavCharts,
+        sav: sav,
+        interpretations: {
+            houses: savInterpretations,
+            categories: housesByStrength
+        },
+        statistics: {
+            total: total,
+            average: average.toFixed(2),
+            max: Math.max(...sav),
+            min: Math.min(...sav)
+        },
+        validation: {
+            bav: bavValidation,
+            sav: savValidation,
+            allValid: bavValidation.valid && savValidation.valid
+        }
+    };
+}
+
+/**
+ * Calculate detailed Ashtakavarga with full analysis
+ * @param {Object} positions - Planetary positions
+ * @returns {Object} Detailed analysis including house-by-house breakdowns
+ */
+function calculateDetailedAshtakavarga(positions) {
+    const bavDetails = calculateDetailedBAV(positions);
+    const savDetails = calculateDetailedSAV(bavDetails.bav);
+
+    return {
+        bav: bavDetails,
+        sav: savDetails,
+        summary: {
+            totalBindus: savDetails.statistics.total,
+            averagePerHouse: savDetails.statistics.average,
+            strongestHouse: savDetails.statistics.strongestHouse,
+            weakestHouse: savDetails.statistics.weakestHouse,
+            allValid: bavDetails.validation.valid && savDetails.validation.valid
+        }
+    };
+}
+
+module.exports = {
+    // Main API
+    calculateAshtakavarga,
+    calculateDetailedAshtakavarga,
+
+    // BAV functions
+    calculateBAV,
+    calculateAllBAV,
+    validateBAV,
+    interpretPlanetaryHouseStrength,
+    calculateDetailedBAV,
+
+    // SAV functions
+    calculateSAV,
+    validateSAV,
+    interpretHouseStrength,
+    getStrengthCategory,
+    calculateDetailedSAV,
+    getHousesByStrength,
+    analyzeTransitFavorability,
+
+    // Kakshya functions
+    getKakshya,
+    getAllKakshyasInSign,
+    analyzeKakshyaTransit,
+    getSignTransitKakshyas,
+
+    // Utilities
+    getHouseNumber,
+
+    // Constants
+    CONTRIBUTIONS,
+    PLANET_TOTALS,
+    TOTAL_BINDUS,
+    PLANET_NAMES,
+    REFERENCE_POINTS,
+    KAKSHYA_RULERS,
+    KAKSHYA_SIZE,
+    NUM_KAKSHYAS
+};