astro_chart 0.1.0 → 0.2.0

data/lib/astro_chart/pure.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+require_relative "pure/core"
+require_relative "pure/houses"
+require_relative "pure/vsop87"
+require_relative "pure/moon"
+require_relative "pure/pluto"
+
+module AstroChart
+  # Pure-Ruby ephemeris backend (MIT-safe, zero external dependencies).
+  #
+  # Front-facing API mirrors the Swiss Ephemeris C extension (AstroChart::Ext):
+  #   Pure.julday(year, month, day, hour)      -> JD(UT) Float
+  #   Pure.calc_ut(jd_ut, planet_id)           -> apparent ecliptic longitude (deg, 0-360)
+  #   Pure.houses(jd_ut, lat, lon, hsys = "P") -> { "cusps" => [12], "ascendant" => f, "mc" => f }
+  #
+  # planet_id follows the SE convention:
+  #   SUN=0 MOON=1 MERCURY=2 VENUS=3 MARS=4 JUPITER=5 SATURN=6
+  #   URANUS=7 NEPTUNE=8 PLUTO=9 TRUE_NODE=11
+  module Pure
+    # planet_id (SE convention) -> handled by which pure module
+    VSOP87_PLANET_IDS = [0, 2, 3, 4, 5, 6, 7, 8].freeze
+    MOON_ID           = 1
+    PLUTO_ID          = 9
+    TRUE_NODE_ID      = 11
+
+    module_function
+
+    # Convert calendar date/time (UT) to Julian Day number.
+    def julday(year, month, day, hour)
+      Core.julday(year, month, day, hour)
+    end
+
+    # Apparent ecliptic longitude (degrees, [0, 360)) for the given body.
+    def calc_ut(jd_ut, planet_id)
+      case planet_id
+      when *VSOP87_PLANET_IDS
+        Vsop87.apparent_longitude(planet_id, jd_ut)
+      when MOON_ID
+        Moon.apparent_longitude(jd_ut)
+      when PLUTO_ID
+        Pluto.apparent_longitude(jd_ut)
+      when TRUE_NODE_ID
+        Moon.true_node(jd_ut)
+      else
+        raise ArgumentError,
+              "unsupported planet_id #{planet_id.inspect} " \
+              "(supported: 0-9 and 11/TRUE_NODE, SE convention)"
+      end
+    end
+
+    # House cusps + ascendant + MC. Only Placidus is implemented.
+    # hsys accepts "P" or 80 ("P".ord) to mirror the C extension's int argument.
+    def houses(jd_ut, latitude, longitude, hsys = "P")
+      unless hsys == "P" || hsys == 80
+        raise ArgumentError,
+              "unsupported house system #{hsys.inspect} (pure backend only supports Placidus: \"P\" / 80)"
+      end
+
+      Houses.calc(jd_ut, latitude, longitude)
+    end
+  end
+end

data/lib/astro_chart/synastry.rb

@@ -0,0 +1,118 @@
+module AstroChart
+  # Synastry (合盤): cross-chart comparison between two natal charts.
+  #
+  # Pure composition of existing modules — Aspects.calculate works on any two
+  # ecliptic longitudes regardless of which chart they come from, and
+  # Houses.find_house places any longitude into any set of cusps.
+  # Backend-independent: no ephemeris call happens here.
+  #
+  # Typical usage with two Chart#generate results:
+  #
+  #   result = Synastry.between(chart_a, chart_b)
+  #   result["aspects"]               # A 的行星 × B 的行星 的跨盤相位
+  #   result["a_planets_in_b_houses"] # A 的行星落在 B 的哪一宮（疊盤）
+  #   result["b_planets_in_a_houses"] # B 的行星落在 A 的哪一宮
+  module Synastry
+    # Bodies used for cross-chart comparison.
+    # 南交點 is excluded by default: it is always exactly opposite 北交點,
+    # so including it would mirror every node aspect and double the noise.
+    BODIES = Ephemeris::PLANETS.keys.freeze
+
+    # Cross aspects between two position sets.
+    #
+    # positions_a / positions_b: { "太陽" => 123.45, ... } (ecliptic longitudes)
+    # orb_limit: optional Float — keep only aspects with orb <= limit.
+    #   (Aspects uses natal orbs: conjunction 15°, others 6-10°. Synastry
+    #   practice often uses tighter orbs; pass e.g. orb_limit: 6.0 to tighten.)
+    #
+    # Returns Array of:
+    #   { "a_planet" => "太陽", "b_planet" => "月亮",
+    #     "aspect_type" => "三分相", "orb" => 1.23 }
+    #
+    # Note: (A太陽, B月亮) and (A月亮, B太陽) are different pairs —
+    # they compare different positions, both are kept.
+    def self.cross_aspects(positions_a, positions_b, orb_limit: nil)
+      results = []
+      positions_a.each do |name_a, pos_a|
+        positions_b.each do |name_b, pos_b|
+          aspect_type, orb = Aspects.calculate(pos_a, pos_b)
+          next if aspect_type.nil?
+          next if orb_limit && orb > orb_limit
+
+          results << {
+            "a_planet"    => name_a,
+            "b_planet"    => name_b,
+            "aspect_type" => aspect_type,
+            "orb"         => orb,
+          }
+        end
+      end
+      results.sort_by { |r| r["orb"] }
+    end
+
+    # House overlay (疊盤): place one person's planets into the other
+    # person's houses.
+    #
+    # positions: { "太陽" => 123.45, ... }
+    # cusps: 12 house cusp degrees (cusps[0] = 1st house)
+    #
+    # Returns { "太陽" => 7, ... } (house number 1-12)
+    def self.house_overlay(positions, cusps)
+      positions.each_with_object({}) do |(name, pos), out|
+        house = Houses.find_house(pos, cusps)
+        out[name] = house if house
+      end
+    end
+
+    # Full synastry between two Chart#generate result hashes.
+    def self.between(chart_a, chart_b, orb_limit: nil)
+      pos_a = positions_from_chart(chart_a)
+      pos_b = positions_from_chart(chart_b)
+      cusps_a = cusps_from_chart(chart_a)
+      cusps_b = cusps_from_chart(chart_b)
+
+      {
+        "aspects"               => cross_aspects(pos_a, pos_b, orb_limit: orb_limit),
+        "a_planets_in_b_houses" => house_overlay(pos_a, cusps_b),
+        "b_planets_in_a_houses" => house_overlay(pos_b, cusps_a),
+      }
+    end
+
+    # Extract { name => total_degree } for BODIES from a Chart#generate hash.
+    # Ruler points appended by key_points_data are ignored (not in BODIES).
+    def self.positions_from_chart(chart)
+      planets = chart&.dig("chart", "planets")
+      raise ArgumentError, "chart has no planets data" if planets.nil? || planets.empty?
+
+      planets.each_with_object({}) do |p, out|
+        name = p["planet"]
+        next unless BODIES.include?(name)
+
+        degree = p["total_degree"] || total_degree_from(p)
+        out[name] = degree if degree
+      end
+    end
+
+    # Extract the 12 cusp degrees (index 0 = 1st house) from a Chart#generate hash.
+    def self.cusps_from_chart(chart)
+      houses = chart&.dig("chart", "houses")
+      raise ArgumentError, "chart has no houses data" if houses.nil? || houses.length != 12
+
+      houses.sort_by { |h| h["house_number"] }.map { |h| h["degree"] }
+    end
+
+    # Fallback for older snapshots that only stored zodiac + in-sign degree.
+    def self.total_degree_from(planet)
+      zodiac = planet["zodiac"]
+      degree = planet["degree"]
+      return nil if zodiac.nil? || degree.nil?
+
+      sign_index = Zodiac::SIGNS.index(zodiac)
+      return nil if sign_index.nil?
+
+      sign_index * 30.0 + degree
+    end
+
+    private_class_method :total_degree_from
+  end
+end

data/lib/astro_chart/version.rb

@@ -1,3 +1,3 @@
 module AstroChart
-  VERSION = "0.1.0"
+  VERSION = "0.2.0"
 end

data/lib/astro_chart.rb

@@ -1,11 +1,16 @@
 require_relative "astro_chart/version"
-require_relative "astro_chart/astro_chart_ext"
+# NOTE: the Swiss Ephemeris C extension (astro_chart_ext) is NOT loaded here.
+# The default backend is pure Ruby; the extension is required on demand by
+# `AstroChart.backend = :swiss` so environments without a compiled extension
+# still work out of the box.
+require_relative "astro_chart/pure"
 require_relative "astro_chart/ephemeris"
 require_relative "astro_chart/zodiac"
 require_relative "astro_chart/aspects"
 require_relative "astro_chart/houses"
 require_relative "astro_chart/time_conversion"
 require_relative "astro_chart/planets"
+require_relative "astro_chart/synastry"
 require_relative "astro_chart/chart"
 
 module AstroChart

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: astro_chart
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Huang Yudi
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-02-01 00:00:00.000000000 Z
+date: 2026-07-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tzinfo
@@ -52,65 +52,39 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '13.0'
-- !ruby/object:Gem::Dependency
-  name: rake-compiler
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.2'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.2'
-description: A Ruby gem for natal astrology chart calculation, powered by Swiss Ephemeris
-  C library with Moshier ephemeris. No external data files needed.
+description: 'Natal astrology chart calculation in pure Ruby: apparent planetary longitudes
+  (VSOP87D, ELP-2000/82B moon, Meeus Pluto), Placidus houses, aspects and synastry.
+  No C extension, no external data files. Implemented from public formulas (Meeus,
+  Astronomical Algorithms 2nd ed.).'
 email:
 executables: []
-extensions:
-- ext/astro_chart/extconf.rb
+extensions: []
 extra_rdoc_files: []
 files:
+- CHANGELOG.md
 - LICENSE
 - astro_chart.gemspec
-- ext/astro_chart/astro_chart_ext.c
-- ext/astro_chart/extconf.rb
-- ext/astro_chart/swecl.c
-- ext/astro_chart/swedate.c
-- ext/astro_chart/swedate.h
-- ext/astro_chart/swedll.h
-- ext/astro_chart/sweephe4.c
-- ext/astro_chart/sweephe4.h
-- ext/astro_chart/swehel.c
-- ext/astro_chart/swehouse.c
-- ext/astro_chart/swehouse.h
-- ext/astro_chart/swejpl.c
-- ext/astro_chart/swejpl.h
-- ext/astro_chart/swemmoon.c
-- ext/astro_chart/swemplan.c
-- ext/astro_chart/swemptab.h
-- ext/astro_chart/swenut2000a.h
-- ext/astro_chart/sweodef.h
-- ext/astro_chart/sweph.c
-- ext/astro_chart/sweph.h
-- ext/astro_chart/swephexp.h
-- ext/astro_chart/swephlib.c
-- ext/astro_chart/swephlib.h
 - lib/astro_chart.rb
 - lib/astro_chart/aspects.rb
 - lib/astro_chart/chart.rb
 - lib/astro_chart/ephemeris.rb
 - lib/astro_chart/houses.rb
 - lib/astro_chart/planets.rb
+- lib/astro_chart/pure.rb
+- lib/astro_chart/pure/core.rb
+- lib/astro_chart/pure/houses.rb
+- lib/astro_chart/pure/moon.rb
+- lib/astro_chart/pure/moon_elp.rb
+- lib/astro_chart/pure/pluto.rb
+- lib/astro_chart/pure/vsop87.rb
+- lib/astro_chart/pure/vsop87_data.rb
+- lib/astro_chart/synastry.rb
 - lib/astro_chart/time_conversion.rb
 - lib/astro_chart/version.rb
 - lib/astro_chart/zodiac.rb
 homepage: https://github.com/morriedig/astro_chart
 licenses:
-- AGPL-3.0
+- MIT
 metadata: {}
 post_install_message:
 rdoc_options: []
@@ -130,5 +104,5 @@ requirements: []
 rubygems_version: 3.4.10
 signing_key:
 specification_version: 4
-summary: Natal chart calculation using Swiss Ephemeris
+summary: Pure-Ruby natal chart calculation (planets, Placidus houses, aspects, synastry)
 test_files: []

data/ext/astro_chart/astro_chart_ext.c

@@ -1,99 +0,0 @@
-#include <ruby.h>
-#include "swephexp.h"
-
-static VALUE mAstroChart;
-static VALUE mExt;
-
-/*
- * AstroChart::Ext.julday(year, month, day, hour) -> Float
- *
- * Convert a date/time to Julian Day number using Gregorian calendar.
- */
-static VALUE rb_julday(VALUE self, VALUE year, VALUE month, VALUE day, VALUE hour) {
-    int y = NUM2INT(year);
-    int m = NUM2INT(month);
-    int d = NUM2INT(day);
-    double h = NUM2DBL(hour);
-
-    double jd = swe_julday(y, m, d, h, SE_GREG_CAL);
-    return DBL2NUM(jd);
-}
-
-/*
- * AstroChart::Ext.calc_ut(jd, planet_id) -> Float
- *
- * Calculate planet ecliptic longitude using Moshier ephemeris.
- * Returns the longitude in degrees (0-360).
- */
-static VALUE rb_calc_ut(VALUE self, VALUE jd, VALUE planet_id) {
-    double tjd = NUM2DBL(jd);
-    int ipl = NUM2INT(planet_id);
-    double xx[6];
-    char serr[256];
-
-    int32 ret = swe_calc_ut(tjd, ipl, SEFLG_MOSEPH, xx, serr);
-    if (ret < 0) {
-        rb_raise(rb_eRuntimeError, "swe_calc_ut failed: %s", serr);
-    }
-
-    return DBL2NUM(xx[0]); /* ecliptic longitude */
-}
-
-/*
- * AstroChart::Ext.houses(jd, latitude, longitude, system) -> Hash
- *
- * Calculate house cusps and ascendant/MC.
- * system: ASCII code for house system (e.g. 'P' = 80 for Placidus)
- *
- * Returns a Hash with:
- *   "cusps"     => Array of 12 house cusp degrees
- *   "ascendant" => Ascendant degree
- *   "mc"        => MC degree
- */
-static VALUE rb_houses(VALUE self, VALUE jd, VALUE lat, VALUE lon, VALUE hsys) {
-    double tjd = NUM2DBL(jd);
-    double geolat = NUM2DBL(lat);
-    double geolon = NUM2DBL(lon);
-    int system = NUM2INT(hsys);
-
-    double cusps[13];  /* cusps[0] unused, cusps[1..12] */
-    double ascmc[10];
-
-    swe_houses(tjd, geolat, geolon, system, cusps, ascmc);
-
-    VALUE result = rb_hash_new();
-    VALUE cusps_ary = rb_ary_new_capa(12);
-
-    int i;
-    for (i = 1; i <= 12; i++) {
-        rb_ary_push(cusps_ary, DBL2NUM(cusps[i]));
-    }
-
-    rb_hash_aset(result, rb_str_new_cstr("cusps"), cusps_ary);
-    rb_hash_aset(result, rb_str_new_cstr("ascendant"), DBL2NUM(ascmc[0]));
-    rb_hash_aset(result, rb_str_new_cstr("mc"), DBL2NUM(ascmc[1]));
-
-    return result;
-}
-
-void Init_astro_chart_ext(void) {
-    mAstroChart = rb_define_module("AstroChart");
-    mExt = rb_define_module_under(mAstroChart, "Ext");
-
-    rb_define_module_function(mExt, "julday", rb_julday, 4);
-    rb_define_module_function(mExt, "calc_ut", rb_calc_ut, 2);
-    rb_define_module_function(mExt, "houses", rb_houses, 4);
-
-    /* Planet ID constants */
-    rb_define_const(mExt, "SUN", INT2NUM(SE_SUN));
-    rb_define_const(mExt, "MOON", INT2NUM(SE_MOON));
-    rb_define_const(mExt, "MERCURY", INT2NUM(SE_MERCURY));
-    rb_define_const(mExt, "VENUS", INT2NUM(SE_VENUS));
-    rb_define_const(mExt, "MARS", INT2NUM(SE_MARS));
-    rb_define_const(mExt, "JUPITER", INT2NUM(SE_JUPITER));
-    rb_define_const(mExt, "SATURN", INT2NUM(SE_SATURN));
-    rb_define_const(mExt, "URANUS", INT2NUM(SE_URANUS));
-    rb_define_const(mExt, "NEPTUNE", INT2NUM(SE_NEPTUNE));
-    rb_define_const(mExt, "PLUTO", INT2NUM(SE_PLUTO));
-    rb_define_const(mExt, "TRUE_NODE", INT2NUM(SE_TRUE_NODE));
-}

data/ext/astro_chart/extconf.rb

@@ -1,8 +0,0 @@
-require "mkmf"
-
-# Swiss Ephemeris source files to compile alongside our extension
-$srcs = Dir.glob("#{$srcdir}/*.c").map { |f| File.basename(f) }
-
-$CFLAGS << " -DNO_SWE_GLP"
-
-create_makefile("astro_chart/astro_chart_ext")