@nrweb/astro-calc

v1.0.0

Published

5 months ago

Comprehensive astrological calculations using Swiss Ephemeris and astronomy-engine for positions, aspects, houses, lots, and scoring metrics

Downloads

101

0High
0Medium
0Low

nrweb

astrology ephemeris planetary-positions swiss-ephemeris aspects houses zodiac calculator astronomy celestial

Astro Calculator

A comprehensive TypeScript library for astrological calculations using Swiss Ephemeris and astronomy-engine. Calculate planetary positions, aspects, houses, lots, and scoring metrics for celestial bodies with high precision.

Features

Planetary Positions: Calculate precise positions for all planets, Moon, and lunar nodes
Zodiac Signs & Dignities: Determine zodiac signs, dignities, decans, and bounds
Houses: Generate house systems with planet placements
Aspects: Calculate major aspects between planets with orbs and grades
Lots: Compute various Arabic parts and lots
Retrograde Tracking: Track retrograde periods and planetary motion
Scoring Systems: Romance, career, wealth, magic, friendship, and health scores
Planetary Hours: Calculate planetary hour rulers
Moon Phases: Determine lunar phases and illumination

Installation

npm install astro-calculator

Quick Start

import { getAstrologicalPositions } from "astro-calculator";

// Get astrological data for current time and default location
const chart = getAstrologicalPositions();

// Get data for specific date and location
const specificChart = getAstrologicalPositions(
  new Date("2024-03-15"),
  40.7128, // latitude
  -74.006 // longitude
);

console.log(chart.positions); // Planetary positions
console.log(chart.houses); // House system
console.log(chart.romanceScore); // Romance compatibility score

API Reference

Main Functions

`getAstrologicalPositions(date?, latitude?, longitude?)`

Returns a complete astrological chart with positions, houses, aspects, and scores.

Parameters:

date (Date, optional): Target date (defaults to current date)
latitude (number, optional): Latitude in degrees (defaults to Belfast)
longitude (number, optional): Longitude in degrees (defaults to Belfast)

Returns: Chart object containing:

positions: Array of planetary positions
houses: Array of house data
lots: Array of calculated lots
aspects: Array of planetary aspects
romanceScore, careerScore, wealthScore, etc.: Scoring metrics
planetaryHours: Planetary hour rulers
moonPhase: Current lunar phase information

Scoring Functions

import {
  calculateRomanceScore,
  calculateCareerScore,
  calculateWealthScore,
  calculateMagicScore,
  calculateFriendshipScore,
  calculateHealthScore,
} from "astro-calculator";

const chart = getAstrologicalPositions();
const romanceScore = calculateRomanceScore(
  chart.positions,
  chart.houses,
  chart.isDayChart
);

Usage Examples

Basic Chart Calculation

import { getAstrologicalPositions } from "astro-calculator";

const chart = getAstrologicalPositions();

// Access planetary positions
chart.positions.forEach((planet) => {
  console.log(`${planet.name}: ${planet.degrees}° ${planet.sign}`);
  console.log(`Dignity: ${planet.dignity}`);
  console.log(`Motion: ${planet.planetaryMotion}`);
});

// Access houses
chart.houses.forEach((house) => {
  console.log(
    `House ${house.number}: ${house.startDegrees}° ${house.startSign}`
  );
});

Aspect Analysis

const chart = getAstrologicalPositions();

// Find all aspects involving the Sun
const sunAspects = chart.positions.find((p) => p.name === "Sun")?.aspects || [];

sunAspects.forEach((aspect) => {
  console.log(`Sun ${aspect.type} ${aspect.planets.right}`);
  console.log(`Deviation: ${aspect.deviation}°`);
});

Historical Chart

// Calculate chart for a historical date
const historicalChart = getAstrologicalPositions(
  new Date("1969-07-20T20:17:00Z"), // Moon landing
  28.5383, // Kennedy Space Center latitude
  -80.6511 // Kennedy Space Center longitude
);

console.log("Moon landing chart:", historicalChart);

This will run the TypeScript code directly without building.

Output

The script outputs a comprehensive JSON object containing:

Date and Location: The date/time and coordinates used for calculations
Planets: Positions, motion states, dignities, and aspects for all traditional planets
Houses: 12 houses with planetary placements and aspects
Lots: Traditional lots (Fortune, Spirit, Marriage, Children, Career, Health, Wealth, Love) with positions and aspects
Challenges: Astrological challenges (Algol transit, aneretic degrees, Via Combusta, Void Course)
Moon Phase: Current lunar phase and illumination
Scoring Metrics: Five normalized scores (0-1) for different life areas

Scoring Metrics

The application calculates five normalized scores (0-1) for different life areas. Each score starts at 0.5 and is adjusted based on positive and negative astrological factors.