UmbrielAstrology

⧉ Birth Chart Data Export: Plain Text, Markdown and JSON

Put in a birth date, and a time, UTC offset and place if you have them, and this free tool writes the chart's computed facts three ways side by side: plain text, Markdown and JSON. Each starts with where its numbers came from, and none says what anything means.

✦ Or see the whole birth chart, free

Runs in your browser.

COMPUTEDEvery number is the engine's own, to the arcminute, with where it came from printed first.

What the three formats look like

This is an invented chart (17 May 1990, 14:30, Sydney), cut short. The tool writes the whole thing, and this sample is produced by the same code.

Plain text
PROVENANCE
  Generator: Umbriel Astrology v980 · schema umbriel-chart-facts/1
  Born: 1990-05-17 14:30, UTC+10:00 (Australia/Sydney)
  UT instant used: 1990-05-17T04:30:00Z
  Place: Sydney, latitude -33.87, longitude 151.21 (north and east are plus)
  Zodiac: tropical
  House system: placidus
  North Node: true · Coordinates: geocentric, apparent, ecliptic of date
  Precision:
  ... (precision limits)

BODIES (longitude shown as degrees, arcminutes, sign; speed in degrees per day)
  Sun: 26°01' Taurus, house 8, +0.9636 deg/day
  Moon: 18°24' Aquarius, house 5, +12.8504 deg/day
  Mercury: 7°55' Taurus, house 7, stationary, +0.0077 deg/day
  Venus: 14°45' Aries, house 7, +1.1431 deg/day
  Mars: 19°35' Pisces, house 6, +0.7417 deg/day
  ...
Markdown
# Umbriel chart data

_Computed facts, no interpretation._

## Provenance
- ...

## Bodies

Position as degrees, arcminutes and sign. Speed in degrees per day.

| Body | Position | House | Motion | Speed (deg/day) |
| --- | --- | --- | --- | --- |
| Sun | 26°01' Taurus | 8 | direct | +0.9636 |
| Moon | 18°24' Aquarius | 5 | direct | +12.8504 |
| Mercury | 7°55' Taurus | 7 | stationary | +0.0077 |
| ... |
JSON
{
 "schema": "umbriel-chart-facts/1",
 "kind": "computed facts: no interpretation",
 "provenance": {
  "generator": "Umbriel Astrology",
  "engine": "v980",
  "instantUT": "1990-05-17T04:30:00Z",
  "zodiac": "tropical",
  "houseSystem": "placidus",
  "...": "..."
 },
 "bodies": [
  {
   "key": "sun",
   "label": "Sun",
   "kind": "planet",
   "longitude": 56.0227,
   "sign": "Taurus",
   "signIndex": 1,
   "deg": 26,
   "min": 1,
   "house": 8,
   "retrograde": false,
   "stationary": false,
   "speedDegPerDay": 0.9636
  },
  "..."
 ]
}

The units, named

The JSON carries a units block, and these are the same names. A key is never renamed inside version 1 of the schema.

Fields and their units
FieldUnit
longitudedegrees along the ecliptic, 0 to under 360, from 0 degrees Aries of the zodiac stated
sign, deg, minthe same position as a sign, whole degrees in the sign (0 to 29) and arcminutes (0 to 59)
speedDegPerDaydegrees per day; a negative number is retrograde motion
orbDegreesdegrees from exact
instantUTISO 8601, in UT
sameDayLongitudeRangelowest and highest longitude across the date, only when the birth time is not given

What this tool answers

The positions, houses, angles, aspects, traditional dignities and essential lots of a birth chart, written so another program or a note can use them, with the inputs and conventions stated at the top.

How it calculates

Umbriel casts the chart in your browser from published series and writes the engine's own numbers, to the arcminute. The UT instant, UTC offset, house system, zodiac and node mode are printed first, with the checked accuracy of each body.

When the result is uncertain

With no birth time, the Ascendant, houses and lots are listed as not given and the Moon may be shown as two signs. Nothing is guessed. Without a UTC offset the clock time is treated as UT, and the file says so.

Common questions

What is in the export?

The provenance (inputs, the UT instant used, UTC offset, house system, zodiac and ayanamsa, node mode, engine version and the checked accuracy), the positions of the Sun to Pluto, the nodes, Chiron and both Liliths to the arcminute with house, retrograde and speed, the Ascendant, Midheaven and twelve house cusps, every aspect with its orb and whether it is applying, the seven classical planets' essential dignities, and the seven essential Arabic lots. Asteroids, dominants and dated events are left out; the Full House file carries those.

Is anything interpreted?

No. Every line is a computed number or a table lookup. The export contains no sentence about what a placement means, and a test checks the whole output against a list of interpretive words. The traditional dignity points are a lookup in a table of conventions, and the export says so.

What does the short note on top do?

It is one optional paragraph that sits above any of the three formats. It says the facts were computed from the birth data listed, to treat them as computed, to use only the placements listed, and to say when something is not in the data. It is plain text you can delete.

What if I do not know the birth time?

Then the Ascendant, Midheaven, houses, Part of Fortune, Vertex, East Point and the lots are listed as not given, because they depend on the time. A planet that keeps one sign all day is given with its range of degrees across the date, and the Moon, or any planet that changes sign that day, is shown as the possible signs. Aspects to the Moon say how far their orb could be out.

How accurate are the numbers?

The provenance block states it. The Sun is checked against NASA/JPL Horizons to under 1 arcsecond from 1650 to 2050, the Moon to 0.27 arcminutes at worst over 312 dates from 1600 to 2050, and Jupiter to Neptune to 2.5 arcseconds over 120 moments from 1910 to 2044. Mercury, Venus and Mars are checked against published ingress dates only. The longitude field carries four decimals of a degree, which is not extra precision.

Which time zone and house system does it use?

The UTC offset you choose, applied to the clock time, and the house system you choose, Placidus by default. If a system cannot be drawn at your latitude, for example Placidus near the Arctic Circle, the export uses equal houses and names the reason. A sidereal zodiac uses the Lahiri ayanamsa and the export states its value.

Does it send my details anywhere?

No. The calculation runs in your browser, nothing you type is stored or sent, and the place is only a latitude and longitude that you type or pick from a short list.

Go deeper

Each of these is a page in its own right.

How accurate is this? · The aspects · Free birth chart

Related free tools

Prints in the head of this page, all public domain except where stated: Astrological chart (?). Woodcut (?)., Wellcome Collection; Two Astrologers and a Boy, from Scherzi, Giovanni Battista Tiepolo Italian, 1696–1770, 1735–40, Art Institute of Chicago; Johannes Hevelius, Machina coelestis, Danzig, 1673, Observatoire de Paris copy via Gallica (BnF). Ground: after Claudius Ptolemy, Ulm, 1482, Wikimedia Commons.

Umbriel offers every system here as a set of prompts to think with, never as a statement of fact about who you are. Take what's useful, leave the rest.

← All free calculators · Beginner guides · Free birth chart