kosmorro/README.md

About the project

Kosmorro is a software that allows you to compute the ephemeris for a date, a month or a year.

Installation

Requirements

To use this software, you will need the following software:

• Python ≥ 3.7.0
• PIP
• Pipenv

Clone this repository and run pipenv sync to install all the dependencies.

Running Kosmorro

Because it’s still on an early-development stage, to run Kosmorro, you will need to prefix your commands pipenv run. A setup.py file will come later to manage installation in the real world.

Usage

kosmorro.py [-h] [--latitude LATITUDE] [--longitude LONGITUDE]
            [--altitude ALTITUDE] [--date DATE] [--month MONTH]
            year

Compute the ephemeris for a given day/month/year.

positional arguments:
  year                  The year you want to compute the ephemeris for

optional arguments:
  -h, --help            show this help message and exit
  --latitude LATITUDE, -lat LATITUDE
                        The observer's position on Earth (latitude)
  --longitude LONGITUDE, -lon LONGITUDE
                        The observer's position on Earth (longitude)
  --altitude ALTITUDE, -alt ALTITUDE
                        The observer's position on Earth (altitude)
  --date DATE, -d DATE  A number between 1 and 28, 29, 30 or 31 (depending on
                        the month). The date you want to compute the ephemeris
                        for
  --month MONTH, -m MONTH
                        A number between 1 and 12. The month you want to
                        compute the ephemeris for (defaults to the current
                        month if the day is defined)

By default, the observer will be set at position (0,0) with an altitude of 0.
You will more likely want to change that.

For instance, if you want the ephemeris of October 31th, 2019 in Paris, France:

$ python kosmorro.py --latitude 48.8032 --longitude 2.3511 -m 10 -d 31 2019
Planet     Rise time    Culmination time    Set time
--------  -----------  ------------------  ----------
Sun          06:35           11:33           16:32
Moon         10:21           14:41           19:01
Mercury      08:37           12:51           17:04
Venus        08:28           12:56           17:23
Mars         04:42           10:19           15:55
Jupiter      10:33           14:42           18:52
Saturn       12:05           16:18           20:31
Uranus       16:17             -             06:27
Neptune      14:47           20:21           02:00
Pluto        12:29           16:42           20:55

Moon phase: New Moon

Note: All the hours are given in UTC.