Skip to main content

Out Solar System. Planet's positions, Sun's and Moon' s position and rise/set

Project description


Our Solar System consist of:

  • our Star, the Sun
  • 8 Planets: Mercury, Venus, Earth, Mars, Jupiter, Saturn, Uranus and Neptune
  • Some dwarf Planets: Pluto, Ceres, Eris, (Haumea, Makemake, Quaoar, Sedna, Orcus, 2007 OR10, not yet included here)
  • Some Centaurs: Chiron (onlyone included here)
  • Many moons orbiting planets. Our Moon (Selene in Greek or Luna in Latin) is orbiting Earth

solarsystem is a library for finding position of planets around Sun or around Earth.

Also with solarsystem we can find positions around Sun/Earth of dwarf planets (only 3 planets so far) and Chiron Centaur and position of moon around Earth

Furthermore we compute sunrise/sunset, moonrise/moonset and moon phase for given place (geocoordinates).

Except all computation above with this library a set of usefull functions are included with which we can convert between coordinate systems:

  • Transform spherical to rectangular projection.
  • Transform rectangular to spherical projection.
  • Transform ecliptic to equatorial projection.
  • Transform equatorial to ecliptic projection.
  • Transform eclipitc to spherical projection.
  • Transform spherical to eclipitc projection.


Quick start

import solarsystem

Initialize class

H = solarsystem.Heliocentric(year=2020, month=1, day=1, hour=12, minute=0 )

Compute position of planets around sun

print('Planet','   \t','Longitude','   \t','Latitude','   \t','Distance in AU')
for planet in planets_dict:
    print(planet,'   \t',round(pos[0],2),'   \t',round(pos[1],2),'   \t',round(pos[2],2))
# Planet      Longitude    Latitude    Distance in AU
# Mercury     263.83       -4.06        0.47
# Venus       5.23         -3.22        0.73
# Earth       79.47         0.0         0.98
# Mars        214.38        0.49        1.59
# Jupyter     276.1         0.1         5.23
# Saturn      292.51        0.05        10.05
# Uranus      35.35         359.52      19.81
# Neptune     348.02       -1.04        29.91
# Pluto       292.75        359.33      33.88
# Ceres       290.87       -5.4         2.92
# Chiron      4.33          2.94        18.81
# Eris        23.55        -11.74       96.0


Examples - Use Cases






Latest version from source:

pip install git+



No requirements, no additional libraries needs to be installed.

Exception: example notebook Solar System Live, matplotlib is needed in order to view the plot



solarsystem is MIT-licensed. Read License

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for solarsystem, version 0.1.0
Filename, size File type Python version Upload date Hashes
Filename, size solarsystem-0.1.0.tar.gz (14.2 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page