Project

astro_chart

0.0
The project is in a healthy, maintained state
astro_chartmorriedig/astro_chartHomepageDocumentationSource CodeBug TrackerWiki
A Ruby gem for natal astrology chart calculation, powered by Swiss Ephemeris C library with Moshier ephemeris. No external data files needed.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
2026
 Popularity
Downloads
104
Stars
0
Forks
0
Watchers
0
 Releases
Current version
0.1.0
Total releases
1
First release
2026-02-01
Latest release
2026-02-01
 Development
Primary Language
C
Licenses
AGPL-3.0
Average date of last 50 commits
2026-02-01
Reverse Dependencies
0

 Dependencies

Development

rake
~> 13.0
rake-compiler
~> 1.2
rspec
~> 3.0

Runtime

tzinfo
~> 2.0
 Project Readme

AstroChart

Ruby gem for natal astrology chart calculation, powered by Swiss Ephemeris.

Uses the Moshier ephemeris mode — no external data files needed. Just compile and run.

Installation

gem "astro_chart", "~> 0.1.0"

Then bundle install. The C extension will compile automatically.

Usage

require "astro_chart"

chart = AstroChart::Chart.new(
  birth_date: "1990-01-01",
  birth_time: "12:00",
  latitude:   25.0330,
  longitude:  121.5654,
  timezone:   "Asia/Taipei"
)

result = chart.generate

Return Value

generate returns a Hash with string keys:

{
  "input" => {
    "birth_date"  => "1990-01-01",
    "birth_time"  => "12:00",
    "coordinates" => { "latitude" => 25.033, "longitude" => 121.5654 },
    "timezone"    => "Asia/Taipei"
  },
  "chart" => {
    "ascendant" => {
      "zodiac"       => "牡羊座",
      "degree"       => 16.4422,
      "total_degree" => 16.4422
    },
    "planets" => [
      {
        "planet"       => "太陽",
        "zodiac"       => "摩羯座",
        "house"        => 9,
        "degree"       => 10.4744,
        "total_degree" => 280.4744,
        "aspects"      => [
          { "planet" => "土星", "aspect_type" => "合相", "orb" => 5.14 }
        ]
      },
      # ... 月亮, 水星, 金星, 火星, 木星, 土星, 天王星, 海王星, 冥王星,
      #     北交點, 南交點, 北交點定位星, 南交點定位星, 上升星座定位星
    ],
    "houses" => [
      { "house_number" => 1, "degree" => 16.4422, "zodiac" => "牡羊座" },
      # ... 2-12
    ]
  }
}

Planets Included

太陽, 月亮, 水星, 金星, 火星, 木星, 土星, 天王星, 海王星, 冥王星, 北交點, 南交點

Plus three ruler points: 北交點定位星, 南交點定位星, 上升星座定位星

Aspects

合相 (0°, orb 15°), 六分相 (60°, orb 6°), 四分相 (90°, orb 8°), 三分相 (120°, orb 8°), 對分相 (180°, orb 10°)

Individual Modules

# Zodiac sign from ecliptic longitude
AstroChart::Zodiac.sign_name(280.5)  #=> "摩羯座"
AstroChart::Zodiac.ruler("摩羯座")    #=> "土星"

# Aspect between two positions
AstroChart::Aspects.calculate(0, 90)  #=> ["四分相", 0.0]

# Julian Day conversion
jd = AstroChart::TimeConversion.to_julian_day("1990-01-01", "12:00", "Asia/Taipei")

# Raw Swiss Ephemeris access
AstroChart::Ephemeris.julday(2000, 1, 1, 12.0)
AstroChart::Ephemeris.calc_ut(jd, AstroChart::Ext::SUN)
AstroChart::Ephemeris.houses(jd, 25.033, 121.565)

Geocoding

This gem does not handle geocoding. Pass latitude, longitude, and timezone directly. For city-to-coordinate conversion, use the geocoder gem or your own lookup table.

House System

Defaults to Placidus. Pass a different system code to Houses.calculate:

AstroChart::Houses.calculate(jd, lat, lon, "W")  # Whole sign
AstroChart::Houses.calculate(jd, lat, lon, "K")  # Koch

Development

bundle install
rake compile
rake spec

License

AGPL-3.0 (required by Swiss Ephemeris)