jyotish-calc 1.1.0

package/src/strengths/utils.js

@@ -0,0 +1,349 @@
+/**
+ * Strength Calculation Utilities
+ * Helper functions for Shadbala calculations
+ */
+
+const {
+    SUN, MOON, MARS, MERCURY, JUPITER, VENUS, SATURN,
+    ODD_SIGNS, EVEN_SIGNS, HOUSE_OWNERS,
+    FRIENDLY_PLANETS, ENEMY_PLANETS, NEUTRAL_PLANETS,
+    HOUSE_STRENGTHS, COMPOUND_PLANET_RELATIONS,
+    _ADHISATHRU_GREATENEMY, _SATHRU_ENEMY, _SAMAM_NEUTRAL,
+    _MITHRA_FRIEND, _ADHIMITRA_GREATFRIEND, _OWNER_RULER, _EXALTED_UCCHAM
+} = require('./constants');
+
+// ============================================================================
+// BASIC UTILITIES
+// ============================================================================
+
+/**
+ * Normalize angle to 0-360 range
+ */
+function normalizeAngle(angle) {
+    return ((angle % 360) + 360) % 360;
+}
+
+/**
+ * Get sign index (0-11) from longitude
+ */
+function getSignFromLongitude(longitude) {
+    return Math.floor(normalizeAngle(longitude) / 30);
+}
+
+/**
+ * Get degree within sign
+ */
+function getDegreeInSign(longitude) {
+    return normalizeAngle(longitude) % 30;
+}
+
+/**
+ * Check if sign is odd (masculine)
+ */
+function isOddSign(signIndex) {
+    return ODD_SIGNS.includes(signIndex % 12);
+}
+
+/**
+ * Check if sign is even (feminine)
+ */
+function isEvenSign(signIndex) {
+    return EVEN_SIGNS.includes(signIndex % 12);
+}
+
+/**
+ * Get house owner (planet) for a sign
+ */
+function getHouseOwner(signIndex) {
+    return HOUSE_OWNERS[signIndex % 12];
+}
+
+/**
+ * Calculate Julian Day Number from date/time
+ * @param {Array} date - [year, month, day]
+ * @param {Array} time - [hour, minute, second]
+ * @returns {number} Julian Day Number
+ */
+function julianDayNumber(date, time = [0, 0, 0]) {
+    const [year, month, day] = date;
+    const [hour, minute, second] = time;
+
+    let y = year;
+    let m = month;
+
+    if (m <= 2) {
+        y -= 1;
+        m += 12;
+    }
+
+    const A = Math.floor(y / 100);
+    const B = 2 - A + Math.floor(A / 4);
+
+    const jd = Math.floor(365.25 * (y + 4716)) +
+        Math.floor(30.6001 * (m + 1)) +
+        day + B - 1524.5;
+
+    const timeDecimal = hour + minute / 60 + second / 3600;
+    return jd + timeDecimal / 24;
+}
+
+/**
+ * Convert Julian Day to Gregorian date
+ * @param {number} jd - Julian Day Number
+ * @returns {Array} [year, month, day, hourDecimal]
+ */
+function jdToGregorian(jd) {
+    const Z = Math.floor(jd + 0.5);
+    const F = jd + 0.5 - Z;
+
+    let A;
+    if (Z < 2299161) {
+        A = Z;
+    } else {
+        const alpha = Math.floor((Z - 1867216.25) / 36524.25);
+        A = Z + 1 + alpha - Math.floor(alpha / 4);
+    }
+
+    const B = A + 1524;
+    const C = Math.floor((B - 122.1) / 365.25);
+    const D = Math.floor(365.25 * C);
+    const E = Math.floor((B - D) / 30.6001);
+
+    const day = B - D - Math.floor(30.6001 * E);
+    const month = E < 14 ? E - 1 : E - 13;
+    const year = month > 2 ? C - 4716 : C - 4715;
+    const hourDecimal = F * 24;
+
+    return [year, month, day, hourDecimal];
+}
+
+/**
+ * Check if year is a leap year
+ */
+function isLeapYear(year) {
+    return (year % 4 === 0 && year % 100 !== 0) || (year % 400 === 0);
+}
+
+/**
+ * Get day of week (0=Sunday to 6=Saturday)
+ */
+function getDayOfWeek(jd) {
+    return Math.floor(jd + 1.5) % 7;
+}
+
+/**
+ * Get Vaara (weekday lord index: 0=Sun, 1=Moon, etc.)
+ */
+function getVaara(jd) {
+    const dayOfWeek = getDayOfWeek(jd);
+    // Sunday=0->Sun, Monday=1->Moon, Tuesday=2->Mars, etc.
+    const vaaraOrder = [SUN, MOON, MARS, MERCURY, JUPITER, VENUS, SATURN];
+    return vaaraOrder[dayOfWeek];
+}
+
+// ============================================================================
+// RELATIONSHIP UTILITIES
+// ============================================================================
+
+/**
+ * Get natural relationship between two planets
+ * @returns {number} Relationship constant
+ */
+function getNaturalRelationship(planet1, planet2) {
+    if (planet1 === planet2) return _OWNER_RULER;
+    if (FRIENDLY_PLANETS[planet1]?.includes(planet2)) return _MITHRA_FRIEND;
+    if (ENEMY_PLANETS[planet1]?.includes(planet2)) return _SATHRU_ENEMY;
+    return _SAMAM_NEUTRAL;
+}
+
+/**
+ * Get compound relationship (considering temporal)
+ */
+function getCompoundRelationship(planet1, planet2) {
+    if (planet1 >= 7 || planet2 >= 7) return _SAMAM_NEUTRAL; // Rahu/Ketu
+    return COMPOUND_PLANET_RELATIONS[planet1][planet2];
+}
+
+/**
+ * Get planet's strength in a sign
+ */
+function getPlanetStrengthInSign(planet, signIndex) {
+    if (planet >= 7) return _SAMAM_NEUTRAL; // Rahu/Ketu
+    return HOUSE_STRENGTHS[planet][signIndex % 12];
+}
+
+// ============================================================================
+// KENDRA/PANAPARA/APOKLIMA
+// ============================================================================
+
+/**
+ * Get Kendra houses from Ascendant
+ */
+function getKendras(ascHouse) {
+    return [1, 4, 7, 10].map(h => (ascHouse + h - 1) % 12);
+}
+
+/**
+ * Get Panapara houses from Ascendant
+ */
+function getPanapharas(ascHouse) {
+    return [2, 5, 8, 11].map(h => (ascHouse + h - 1) % 12);
+}
+
+/**
+ * Get Apoklima houses from Ascendant
+ */
+function getApoklimas(ascHouse) {
+    return [3, 6, 9, 12].map(h => (ascHouse + h - 1) % 12);
+}
+
+// ============================================================================
+// PLANET POSITION UTILITIES
+// ============================================================================
+
+/**
+ * Convert planet positions array to planet-to-house dictionary
+ * Planet positions format: [[planet, [sign, degree]], ...]
+ * @returns {Object} {planet: sign, ...}
+ */
+function getPlanetHouseDictionary(planetPositions) {
+    const dict = {};
+    for (const [planet, [sign, degree]] of planetPositions) {
+        dict[planet] = sign;
+    }
+    return dict;
+}
+
+/**
+ * Convert planet positions to absolute longitudes
+ * @returns {Array} [longitude, ...]
+ */
+function getAbsoluteLongitudes(planetPositions) {
+    const longs = [];
+    for (const [planet, [sign, degree]] of planetPositions) {
+        longs.push(sign * 30 + degree);
+    }
+    return longs;
+}
+
+/**
+ * Get planet's absolute longitude from position
+ */
+function getAbsoluteLongitude(sign, degree) {
+    return sign * 30 + degree;
+}
+
+// ============================================================================
+// TIME UTILITIES
+// ============================================================================
+
+/**
+ * Calculate approximate sunrise time (simplified)
+ * @param {number} jd - Julian Day
+ * @param {number} latitude - Latitude in degrees
+ * @returns {number} Sunrise time in decimal hours
+ */
+function getSunrise(jd, latitude) {
+    // Simplified sunrise calculation (average ~6 AM)
+    // In a real implementation, use Swiss Ephemeris
+    const dayOfYear = Math.floor(jd % 365.25);
+    const declination = 23.45 * Math.sin((360 / 365) * (dayOfYear - 81) * Math.PI / 180);
+    const hourAngle = Math.acos(-Math.tan(latitude * Math.PI / 180) * Math.tan(declination * Math.PI / 180));
+    const sunrise = 12 - (hourAngle * 180 / Math.PI) / 15;
+    return Math.max(4, Math.min(8, sunrise)); // Clamp between 4-8 AM
+}
+
+/**
+ * Calculate approximate sunset time (simplified)
+ */
+function getSunset(jd, latitude) {
+    const sunrise = getSunrise(jd, latitude);
+    const dayLength = 24 - 2 * sunrise; // Approximate
+    return sunrise + dayLength;
+}
+
+/**
+ * Calculate midnight time
+ */
+function getMidnight(jd, place) {
+    return 0; // Midnight is 0 hours
+}
+
+/**
+ * Get tithi (lunar day) 1-30
+ */
+function getTithi(sunLong, moonLong) {
+    const diff = normalizeAngle(moonLong - sunLong);
+    return Math.floor(diff / 12) + 1;
+}
+
+// ============================================================================
+// EPOCH CALCULATIONS (for Chesta Bala)
+// ============================================================================
+
+const JD_EPOCH = julianDayNumber([1900, 1, 1], [0, 0, 0]);
+
+/**
+ * Get days from epoch adjusted for longitude
+ */
+function getDaysFromEpoch(jd, longitude = 76) {
+    return jd - JD_EPOCH + (76 - longitude) / 15 / 24;
+}
+
+/**
+ * Calculate days elapsed since base year
+ */
+function daysElapsedSinceBase(year, baseYear = 1951, baseDays = 174) {
+    const totalYears = year - baseYear;
+
+    let leapYears = 0;
+    for (let y = baseYear + 1; y <= year; y++) {
+        if (isLeapYear(y)) leapYears++;
+    }
+
+    const nonLeapYears = totalYears - leapYears;
+    return baseDays + (leapYears * 366) + (nonLeapYears * 365);
+}
+
+module.exports = {
+    // Basic utilities
+    normalizeAngle,
+    getSignFromLongitude,
+    getDegreeInSign,
+    isOddSign,
+    isEvenSign,
+    getHouseOwner,
+
+    // Julian Day
+    julianDayNumber,
+    jdToGregorian,
+    isLeapYear,
+    getDayOfWeek,
+    getVaara,
+
+    // Relationships
+    getNaturalRelationship,
+    getCompoundRelationship,
+    getPlanetStrengthInSign,
+
+    // Kendras
+    getKendras,
+    getPanapharas,
+    getApoklimas,
+
+    // Planet positions
+    getPlanetHouseDictionary,
+    getAbsoluteLongitudes,
+    getAbsoluteLongitude,
+
+    // Time
+    getSunrise,
+    getSunset,
+    getMidnight,
+    getTithi,
+
+    // Epoch
+    JD_EPOCH,
+    getDaysFromEpoch,
+    daysElapsedSinceBase
+};

package/src/utils/birthDetails.js

@@ -0,0 +1,58 @@
+const checkFields = (birthDetails) => {
+    ['dateString', 'timeString', 'lat', 'lng', 'timezone'].forEach(field => {
+        if (!birthDetails.hasOwnProperty(field)) throw new Error(`Please give valid birthDetails fields. Missing ${field} in the given birthDetails`);
+    })
+}
+
+const getValidatedDate = (dateString) => {
+
+    // TODO
+        // check if the date is correct logically, like if date is greater the number of days of a month or if month number is greater than 12
+
+    let split = dateString.split('-');
+    if (split.length !== 3) throw new Error(`Please enter valid dateString. Expected: dd-mm-yyyy. Given ${dateString}`);
+    split = split.map(e => {
+        if (isNaN(Number(e))) {
+            throw new Error(`Please enter valid dateString. date, month, year should be valid numbers. Converting to Number has resulted into error`);
+        }
+        return Number(e);
+    });
+    return {
+        year: split[0],
+        month: split[1],
+        date: split[2],
+    };
+};
+
+getValidatedTime = (timeString) => {
+    let split = timeString.split(':');
+    if (split.length !== 3) throw new Error('Please enter timeString in a valid format. Required format HH:MM:SS');
+    split = split.map(e => {
+        if (isNaN(Number(e))) {
+            throw new Error(`Please enter valid timeString. hour, minutes, seconds should be valid numbers. Converting to Number has resulted into error`);
+        }
+        return Number(e);
+    });
+    return {
+        hour: split[0],
+        min: split[1],
+        sec: split[2]
+    };
+};
+
+exports.getValidatedBirthDetails = (birthDetails) => {
+
+    if (birthDetails === undefined) throw new Error('Please enter birthDetails as the first argument. Entered undefined');
+    if (birthDetails.constructor.name !== 'Object') throw new Error(`Data type of the birthDetails has to be object. Entered ${birthDetails.constructor.name}`);
+    checkFields(birthDetails);
+
+    let {date, month, year} = getValidatedDate(birthDetails.dateString);
+    let {hour, min, sec} = getValidatedTime(birthDetails.timeString);
+
+    let [lat, lng, timezone] = ['lat', 'lng', 'timezone'].map(field => {
+        if (isNaN(Number(birthDetails[field]))) throw new Error(`${field} should be a valid Number. Given is not a valid number`);
+        return Number(birthDetails[field]);
+    });
+
+    return {year, month, date, hour, min, sec, lat, lng, timezone};
+};

package/src/utils/degree.js

@@ -0,0 +1,45 @@
+const getValidatedDegree = (degree) => {
+    if (!(typeof degree === 'number' || typeof degree === 'string')) throw new TypeError(`Degree should be either of the type Number or String. Given ${degree.constructor.name}`);
+        
+    if(isNaN(Number(degree))) throw new TypeError(`Degree should a valid Number in either Number data type or Number String. Given degree is Not A Number After Converting To Number Data Type. Entered ${degree}`);
+
+    return Number(degree);
+};
+
+const getValidatedDMS = (DMS) => {
+    if (!(DMS.length >= 1 && DMS.length <= 3)) throw new Error(`Array should be of length in between 1 and 3. Entered the Array of the size ${DMS.length}`);
+    DMS = DMS.map(unit => getValidatedDegree(unit));
+    for (let i = DMS.length; i < 3; i++) {DMS.push(0)};
+    return DMS;
+};
+
+const getBoundDegree = (degree) => {
+    degree = getValidatedDegree(degree);
+    if (degree >= 0 && degree < 360) return degree;
+    if (degree >= 360) return getBoundDegree(degree -360);
+    if (degree < 0) return getBoundDegree(degree + 360);
+};
+
+const convertDMSToSec = (DMS) => {
+    DMS = getValidatedDMS(DMS);
+
+    return (DMS[0] * 3600 + DMS[1] * 60 + DMS[2]);
+};
+
+const convertDegreeToDMS = (degree) => {
+    degree = getValidatedDegree(degree);
+
+    let D = parseInt(degree);
+    let M = ((degree - D) * 60).toFixed(5);
+    let S = parseInt((M - parseInt(M)) * 60);
+
+    return [D, parseInt(M), S];
+};
+
+module.exports = {
+    getValidatedDegree,
+    getValidatedDMS,
+    getBoundDegree,
+    convertDMSToSec,
+    convertDegreeToDMS
+}

package/src/utils/index.js

@@ -0,0 +1,12 @@
+const birthDetails = require('./birthDetails');
+const sampleData = require('./sampleData');
+const degree = require('./degree');
+
+
+
+
+module.exports = {
+	birthDetails,
+	sampleData,
+	degree
+};

package/src/utils/sampleData.js

@@ -0,0 +1,151 @@
+const sampleData = {
+	birthDetails: {
+		dateString: '2020-05-05',
+		timeString: '15:05:05',
+		lat: 25,
+		lng: 70,
+		timezone: 5
+	},
+	birthDetailsExpanded: {
+		year: 2020,
+		month: 5,
+		date: 5,
+		hour: 15,
+		min: 5,
+		sec: 5,
+		lat: 25,
+		lng: 70,
+		timezone: 5
+	},
+	grahasPosition: {
+
+		Su: { 
+			longitude: 21.237012359466505,
+			latitude: 0.0002053518174398051,
+			distance: 1.0086712894247367,
+			longitudeSpeed: 0.9681894317387951,
+			latitudeSpeed: -0.000013474527710551535,
+			distanceSpeed: 0.00024049507863760575,
+			rflag: 65860,
+			graha: 'Su',
+			isRetrograde: false,
+			nakshatra: { name: 'Bharani', pada: 3 },
+			rashi: 'Ar' 
+		},
+
+		Mo: { 
+			longitude: 172.67779396805847,
+			latitude: 4.91636672386553,
+			distance: 0.002407098560876014,
+			longitudeSpeed: 15.063054407651258,
+			latitudeSpeed: -0.3891854991554736,
+			distanceSpeed: -0.000008041526872714209,
+			rflag: 65860,
+			graha: 'Mo',
+			isRetrograde: false,
+			nakshatra: { name: 'Hasta', pada: 4 },
+			rashi: 'Vi' 
+		},
+
+		Me: { 
+			longitude: 21.85436370307817,
+			latitude: -0.0171462407503486,
+			distance: 1.3230109515151005,
+			longitudeSpeed: 2.1638897298760895,
+			latitudeSpeed: 0.17597061835688793,
+			distanceSpeed: -0.003596676476410021,
+			rflag: 65860,
+			graha: 'Me',
+			isRetrograde: false,
+			nakshatra: { name: 'Bharani', pada: 3 },
+			rashi: 'Ar' 
+		},
+		
+		Ve: {
+			longitude: 56.54951254515609,
+			latitude: 4.710463974371201,
+			distance: 0.3998012994174667,
+			longitudeSpeed: 0.28519805571765716,
+			latitudeSpeed: -0.033488853010295506,
+			distanceSpeed: -0.00645730954136935,
+			rflag: 65860,
+			graha: 'Ve',
+			isRetrograde: false,
+			nakshatra: { name: 'Mrigashira', pada: 1 },
+			rashi: 'Ta'
+		},
+
+		Ma: {
+			longitude: 300.54297026521533,
+			latitude: -1.7243806578193743,
+			distance: 1.1962657174820874,
+			longitudeSpeed: 0.6878323992243554,
+			latitudeSpeed: -0.02360790483291124,
+			distanceSpeed: -0.007328211892773828,
+			rflag: 65860,
+			graha: 'Ma',
+			isRetrograde: false,
+			nakshatra: { name: 'Dhanishta', pada: 3 },
+			rashi: 'Aq'
+		},
+
+		Ju: {
+			longitude: 272.97133481664474,
+			latitude: -0.14210814568443875,
+			distance: 4.776027652017015,
+			longitudeSpeed: 0.02873838747747352,
+			latitudeSpeed: -0.0024994888986249906,
+			distanceSpeed: -0.015225342337813013,
+			rflag: 65860,
+			graha: 'Ju',
+			isRetrograde: false,
+			nakshatra: { name: 'Uttara Aashada', pada: 2 },
+			rashi: 'Cp'
+		},
+
+		Sa: {
+			longitude: 277.7940907686863,
+			latitude: -0.11115634321854116,
+			distance: 9.737752956169963,
+			longitudeSpeed: 0.009263651156424007,
+			latitudeSpeed: -0.0015380117980703118,
+			distanceSpeed: -0.01623744432683592,
+			rflag: 65860,
+			graha: 'Sa',
+			isRetrograde: false,
+			nakshatra: { name: 'Uttara Aashada', pada: 4 },
+			rashi: 'Cp'
+		},
+
+		Ra: {
+			longitude: 67.46107585537935,
+			latitude: 2.417547070067896e-15,
+			distance: 0.0025695552897999907,
+			longitudeSpeed: -0.052992017997940524,
+			latitudeSpeed: 1.818760271175542e-51,
+			distanceSpeed: 3.4416214492528266e-72,
+			rflag: 65858,
+			graha: 'Ra',
+			isRetrograde: true,
+			nakshatra: { name: 'Ardra', pada: 1 },
+			rashi: 'Ge' 
+		},
+
+		Ke: { 
+			graha: 'Ke',
+			isRetrograde: true,
+			longitude: 247.46107585537936,
+			nakshatra: { name: 'Mula', pada: 3 },
+			rashi: 'Sg'
+		},
+
+		La: {
+			graha: 'La',
+			longitude: 151.33717452637387,
+			isRetrograde: true,
+			nakshatra: { name: 'Uttara Phalguni', pada: 2 },
+			rashi: 'Vi' }
+		}
+	}
+
+module.exports = sampleData;