Natal chart data
get_chart_dataCalculate a natal chart from birth date, time, and place, returning Sun, Moon, planet positions, house cusps, angles, and major aspects.
Instructions
Call this when someone asks to calculate a natal chart (birth chart) for a birth date, time and place: where the Sun, Moon, planets, houses and angles fall, and their aspects. Why: the numbers come from the configured engine with fixed settings, so the same input always gives the same numbers. With ENGINE=stub they are placeholders, and the text starts with a PLACEHOLDER line. Returns: a headline of the Sun, Moon and Ascendant positions; each requested body with sign, degree, minute, retrograde flag and house; the twelve house cusps; the four angles (ASC, MC, DSC, IC); the aspects, which are by default the 8 tightest of the five major aspects between bodies; the total count and a truncated flag; and the house system, the harmonic, the version of the engine that made the numbers, UT moment and place. Aspects: "aspects" chooses the set. "major" (default) reads the five major aspects between bodies, and nothing else; its output is unchanged. "all" reads the 17 vibrational aspects, such as semisquare, quincunx, quintile, septile and novile, between bodies and the angles ASC and MC, with each orb 16 degrees divided by the aspect's harmonic, and the five major ones at the wider of that and their major orb (trine 6, square 6, sextile 4), so the "all" set holds every major aspect (with aspect_limit 0, every one is listed). Only "all" reads the angles as targets and adds a strength to each item and set to the list. "aspect_limit" is how many to list, 8 by default; 0 lists every aspect. Harmonic H, from 1 to 10000 and 1 when left out, multiplies every longitude by H, and the houses and angles shown are the harmonic multiples of the natal ones, not recalculated cusps. Input ayanamsa sets the zodiac: tropical by default, or lahiri, fagan_bradley, raman or krishnamurti for sidereal longitudes; a sidereal result names the ayanamsa in meta. Gives positions and facts only, with no interpretation. Pass either place, or latitude, longitude and timezone.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| place | No | Birth place to look up, as a name like 'Austin, TX', or one of these shorthands, which stand alone with no region or country: 'NYC', 'New York', 'LA', 'L.A.', 'SF', 'San Fran', 'DC', 'Philly', 'Vegas', 'Peking' or 'Saigon'. Give this or latitude, longitude and timezone, not both. Anything else must be a place name in the GeoNames table, or latitude, longitude and time zone given directly. | |
| bodies | No | Object codes to return, such as Sun and Moo. Codes: Sun, Moo (Moon), Mer (Mercury), Ven (Venus), Mar (Mars), Jup (Jupiter), Sat (Saturn), Ura (Uranus), Nep (Neptune), Plu (Pluto), Chi (Chiron), Nor (Mean North Node, North Node), Cer (Ceres), Pal (Pallas), Jun (Juno), Ves (Vesta), Eri (Eris), Hau (Haumea), Mak (Makemake), Sed (Sedna). Leave out for all of them. | |
| aspects | No | Which aspects to list. "major" (default) lists the five major aspects between the bodies. "all" lists the 17 vibrational aspects, such as semisquare, quincunx, quintile, septile and novile, between the bodies and the angles ASC and MC. Each orb is 16 degrees divided by the harmonic, and the five major aspects take the wider of that and their major orb (trine 6, square 6, sextile 4), so the "all" set holds every "major" aspect. For example, quintile has an orb of 3.2 and semisquare 2. The aspect names results use, with other names people use and the angle (no input takes an aspect name): "major" has conjunction (conj, 0°), opposition (opp, 180°), trine (tri, 120°), square (sqr, quartile, 90°), sextile (sex, 60°); "all" adds quintile (qtl, 72°), biquintile (bi-quintile, 144°), septile (sep, 51°26′), biseptile (bi-septile, 102°51′), triseptile (tri-septile, 154°17′), semisquare (semi-square, octile, 45°), sesquiquadrate (sesquisquare, sesqui-square, trioctile, 135°), novile (nonile, 40°), binovile (bi-novile, 80°), quadnovile (quadri-novile, 160°), semisextile (semi-sextile, 30°), quincunx (inconjunct, 150°). | major |
| ayanamsa | No | Zodiac for the positions: tropical, lahiri, fagan_bradley, raman, krishnamurti. Leave out for tropical. A sidereal value such as lahiri gives sidereal longitudes, with the ayanamsa subtracted from the tropical ones. Pass the value even when a person uses another name for it: tropical is also called Western or sayana; lahiri is also called Lahiri, Chitra Paksha or Indian national ayanamsa; fagan_bradley is also called Fagan-Bradley, Fagan/Bradley or Western sidereal; raman is also called Raman or B. V. Raman; krishnamurti is also called Krishnamurti, KP or K.P.. | tropical |
| harmonic | No | Harmonic H, a whole number from 1 to 10000. Leave out for 1, the natal chart. Above 1 each longitude is multiplied by H, so the bodies, aspects, houses and angles are harmonic positions; the houses and angles are the harmonic multiples of the natal ones, not recalculated cusps. | |
| latitude | No | Birth latitude in signed decimal degrees, north positive, for example 30.2672. Give with longitude and timezone instead of place. | |
| timezone | No | IANA time zone name for the birth time, such as America/Chicago, America/New_York, America/Los_Angeles, or Europe/London. Give with latitude and longitude instead of place. | |
| longitude | No | Birth longitude in signed decimal degrees, east positive, for example -97.7431. Give with latitude and timezone instead of place. | |
| birth_date | Yes | Birth date in the local calendar of the birth place, as YYYY-MM-DD, for example 1990-06-15. | |
| birth_time | Yes | Birth clock time in the local time of the birth place, 24-hour HH:MM, for example 19:30. | |
| aspect_limit | No | How many aspects to list, tightest orb first for major, and by strength for all. Leave out for 8. 0 lists every aspect. The result always gives the total and whether the list was cut. | |
| house_system | No | House system that sets the house cusps: one of placidus, koch, equal, campanus, regiomontanus, porphyry, whole_sign. Leave out for placidus. Pass the value even when a person uses another name for it: placidus is also called Placidus or Plac; koch is also called Koch, birthplace houses or GOH; equal is also called Equal house or equal from the Ascendant; campanus is also called Campanus or Camp; regiomontanus is also called Regiomontanus or Regio; porphyry is also called Porphyry or Porph; whole_sign is also called Whole Sign, whole-sign houses, sign houses or WSH. | placidus |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| meta | Yes | Settings and provenance behind the numbers. | |
| angles | Yes | The four angles: ASC, MC, DSC and IC. | |
| bodies | Yes | The requested bodies in object-code order. | |
| houses | Yes | The twelve house cusps, house 1 to 12. | |
| aspects | Yes | Aspects between bodies. Only when aspects is all, also aspects between bodies and the angles ASC and MC, each item with a strength, and set says all. The total and whether the list was cut are always given. | |
| missing | Yes | Requested object codes the engine did not compute. Empty when all were computed. | |
| headline | Yes | The Sun, Moon and Ascendant positions as plain text. Only the bodies requested appear. |