create Natal Chart with ease
- SVG natal chart generation in pure python
- composite chart (transit/synastry/sun return ... etc) generation
- highly configurable
- all planets, asteroids, vertices can be enabled / disabled
- orbs for each aspect
- light, dark, or mono theme
- light / dark theme color definitions
- chart stroke, opacity, font, spacing between planets ...etc
- high precision astrological data with Swiss Ephemeris
- timezone, latitude and longitude database from GeoNames
- auto aware of daylight saving for a given time and location
- natal chart data statistics
- element, modality, and polarity counts
- planets in each houses
- quadrant and hemisphere distribution
- aspect pair counts
- composite chart aspects
- aspects cross reference table
- generate report in markdown or html
- thoroughly tested with
pytest
- default dark theme
- default light theme
- mono theme
- installation
pip install natal
- generate a chart
from natal import Data, Chart
# create chart data object
mimi = Data(
name = "MiMi",
city = "Taipei",
dt = "1980-04-20 14:30"
)
# return natal chart in SVG string
Chart(mimi, width=600).svg
# create transit data object
transit = Data(
name="Transit",
city="Taipei",
dt="2024-01-01 13:30",
)
# create a transit chart
transit_chart = Chart(
data1=mimi,
data2=transit,
width=600
)
# view the composite chart in jupyter notebook
from IPython.display import HTML
HTML(transit_chart.svg)following SVG chart will be produced:
## -- retrieve natal chart properties -- ##
mimi.planets # list[Planet]
mimi.houses # list[House]
mimi.extras # list[Extra]
mimi.vertices # list[Vertex]
mimi.signs # list[Sign]
mimi.aspects # list[Aspect]
mimi.quadrants # list[list[Aspectable]]
# Planet object
sun = mimi.planets[0]
sun.degree # 30.33039116987769
sun.normalized_degree # 230.62043431588035 # degree relative to Asc
sun.color # fire
sun.speed # 0.9761994105153413
sun.retro # False
sun.dms # 00°19'
sun.signed_dms # 00°♉19'
sun.signed_deg # 0
sun.sign.name # taurus
sun.sign.symbol # ♉
sun.sign.value # 2
sun.sign.color # earth
sun.sign.ruler # venus
sun.sign.classic_ruler # venus
sun.sign.element # earth
sun.sign.modality # fixed
sun.sign.polarity # negative
# Aspect object
aspect = mimi.aspects[0]
aspect.body1 # sun Planet obj
aspect.body2 # mars Planet obj
aspect.aspect_member # AspectMember(name='trine', symbol='△', value=120, color='air')
aspect.applying # False
aspect.orb # 3.3424- statistics of Data object in tabular form
from natal import Stats
stats = Stats(data1=mimi, data2=transit)
print(stats.full_report(kind="markdown"))- following markdown report will be produced:
# Element Distribution (MiMi)
| element | sum | bodies |
|-----------|-------|-------------------------------------------------|
| earth | 4 | sun ♉ , jupiter ♍ , saturn ♍ , asc ♍ |
| water | 2 | moon ♋ , uranus ♏ |
| fire | 4 | mercury ♈ , mars ♌ , neptune ♐ , asc_node ♌ |
| air | 3 | venus ♊ , pluto ♎ , mc ♊ |
# Modality Distribution (MiMi)
| modality | sum | bodies |
|------------|-------|-----------------------------------------------------------------|
| fixed | 4 | sun ♉ , mars ♌ , uranus ♏ , asc_node ♌ |
| cardinal | 3 | moon ♋ , mercury ♈ , pluto ♎ |
| mutable | 6 | venus ♊ , jupiter ♍ , saturn ♍ , neptune ♐ , asc ♍ , mc ♊ |
# Polarity Distribution (MiMi)
| polarity | sum | bodies |
|------------|-------|-------------------------------------------------------------------------------|
| negative | 6 | sun ♉ , moon ♋ , jupiter ♍ , saturn ♍ , uranus ♏ , asc ♍ |
| positive | 7 | mercury ♈ , venus ♊ , mars ♌ , neptune ♐ , pluto ♎ , asc_node ♌ , mc ♊ |
# Celestial Bodies (MiMi)
| body | sign | house | dignity |
|----------|--------------|---------|-----------|
| sun | 00° ♉ 19' | 8 | |
| moon | 08° ♋ 29' | 10 | domicile |
| mercury | 08° ♈ 28' | 8 | |
| venus | 15° ♊ 12' | 10 | |
| mars | 26° ♌ 59' | 12 | |
| jupiter | 00° ♍ 17' ℞ | 12 | detriment |
| saturn | 21° ♍ 03' ℞ | 1 | |
| uranus | 24° ♏ 31' ℞ | 3 | |
| neptune | 22° ♐ 29' ℞ | 4 | |
| pluto | 20° ♎ 06' ℞ | 2 | |
| asc_node | 26° ♌ 03' ℞ | 12 | |
| asc | 09° ♍ 42' | 1 | |
| mc | 09° ♊ 13' | 10 | |
# Houses (MiMi)
| house | cusp | ruler | ruler sign | ruler house |
|---------|------------|---------|--------------|---------------|
| 1 | 09° ♍ 41' | mercury | ♈ | 8 |
| 2 | 07° ♎ 13' | venus | ♊ | 10 |
| 3 | 07° ♏ 38' | pluto | ♎ | 2 |
| 4 | 09° ♐ 13' | jupiter | ♍ | 12 |
| 5 | 10° ♑ 25' | saturn | ♍ | 1 |
| 6 | 10° ♒ 44' | uranus | ♏ | 3 |
| 7 | 09° ♓ 41' | neptune | ♐ | 4 |
| 8 | 07° ♈ 13' | mars | ♌ | 12 |
| 9 | 07° ♉ 38' | venus | ♊ | 10 |
| 10 | 09° ♊ 13' | mercury | ♈ | 8 |
| 11 | 10° ♋ 25' | moon | ♋ | 10 |
| 12 | 10° ♌ 44' | sun | ♉ | 8 |
# Quadrants (MiMi)
| quadrant | sum | bodies |
|------------|-------|--------------------------------------|
| 1st ◵ | 3 | saturn, uranus, pluto |
| 2nd ◶ | 1 | neptune |
| 3rd ◷ | 2 | sun, mercury |
| 4th ◴ | 5 | moon, venus, mars, jupiter, asc_node |
# Hemispheres (MiMi)
| hemisphere | sum | bodies |
|--------------|-------|-------------------------------------------------------------|
| ← | 8 | saturn, uranus, pluto, moon, venus, mars, jupiter, asc_node |
| → | 3 | neptune, sun, mercury |
| ↑ | 7 | sun, mercury, moon, venus, mars, jupiter, asc_node |
| ↓ | 4 | saturn, uranus, pluto, neptune |
# Celestial Bodies of Transit in MiMi's chart
| Transit | sign | house | dignity |
|-----------|--------------|---------|-----------|
| sun | 10° ♑ 16' | 4 | |
| moon | 08° ♍ 42' | 12 | |
| mercury | 22° ♐ 14' ℞ | 4 | detriment |
| venus | 02° ♐ 53' | 3 | |
| mars | 27° ♐ 28' | 4 | |
| jupiter | 05° ♉ 34' | 8 | |
| saturn | 03° ♓ 15' | 6 | |
| uranus | 19° ♉ 22' ℞ | 9 | |
| neptune | 25° ♓ 04' | 7 | |
| pluto | 29° ♑ 21' | 5 | |
| asc_node | 20° ♈ 51' ℞ | 8 | |
| asc | 14° ♉ 41' | 9 | |
| mc | 02° ♒ 08' | 5 | |
# Aspects of Transit vs MiMi
| Transit | aspect | MiMi | phase | orb |
|-----------|----------|----------|---------|--------|
| sun | ☍ | moon | → ← | 1° 47' |
| sun | □ | mercury | → ← | 1° 48' |
| sun | △ | asc | ← → | 0° 34' |
| moon | ⚹ | moon | → ← | 0° 13' |
| moon | ☌ | asc | → ← | 1° 00' |
| moon | □ | mc | → ← | 0° 31' |
| mercury | □ | saturn | → ← | 1° 11' |
| mercury | ☌ | neptune | ← → | 0° 15' |
| mars | △ | mars | ← → | 0° 29' |
| mars | △ | asc_node | ← → | 1° 25' |
| uranus | △ | saturn | → ← | 1° 41' |
| neptune | △ | uranus | ← → | 0° 33' |
| pluto | □ | sun | ← → | 0° 58' |
| asc_node | △ | neptune | ← → | 1° 37' |
| asc_node | ☍ | pluto | → ← | 0° 45' |
| mc | □ | sun | → ← | 1° 49' |
# Aspect Cross Reference of Transit(cols) vs MiMi(rows)
| | ☉ | ☽ | ☿ | ♀ | ♂ | ♃ | ♄ | ♅ | ♆ | ♇ | ☊ | Asc | MC | sum |
|-----|-----|-----|-----|-----|-----|-----|-----|-----|-----|-----|-----|-------|------|-------|
| ☉ | | | | | | | | | | □ | | | □ | 2 |
| ☽ | ☍ | ⚹ | | | | | | | | | | | | 2 |
| ☿ | □ | | | | | | | | | | | | | 1 |
| ♀ | | | | | | | | | | | | | | 0 |
| ♂ | | | | | △ | | | | | | | | | 1 |
| ♃ | | | | | | | | | | | | | | 0 |
| ♄ | | | □ | | | | | △ | | | | | | 2 |
| ♅ | | | | | | | | | △ | | | | | 1 |
| ♆ | | | ☌ | | | | | | | | △ | | | 2 |
| ♇ | | | | | | | | | | | ☍ | | | 1 |
| ☊ | | | | | △ | | | | | | | | | 1 |
| Asc | △ | ☌ | | | | | | | | | | | | 2 |
| MC | | □ | | | | | | | | | | | | 1 |- see demo.ipynb for the HTML output
- generate PDF report as file-like object (BytesIO)
from natal import Report
report = Report(data1=mimi, data2=transit)
html = report.full_report
report.create_pdf(html) # returns BytesIO- see demo_report_light.pdf for light theme with Birth Chart
- see demo_report_mono.pdf for mono theme with Transit Chart
- create a
Configobject and assign it toDataobject - it will override the default settings in
config.py - a sample config as follow:
from natal.config import Display, Config, Orb
# adjust which celestial bodies to display
display = Display(
mc = False,
asc_node = False,
chiron = True
)
# adjust orbs for each aspect
orb = Orb(
conjunction = 8,
opposition = 8,
trine = 6,
square = 6,
sextile = 6
)
# the complete config object
config = Config(
theme_type = "light", # or "dark", "mono"
display = display,
orb = orb
)
# create data object with the config
data = Data(
name = "MiMi",
city = "Taipei",
dt = "1980-04-20 14:30",
config = config,
)read the docs for complete references
- tagit: SVG / HTML generation and manipulation
- pyswisseph: astrological data - Swiss Ephemeris
- mkdocs-material: docs site generation
- weasyprint: PDF generation (refer weasyprint docs for installing OS dependencies)
![@github-actions[bot]](https://avatars.githubusercontent.com/in/15368?s=64&v=4){kind=small}