allenerocha / pysky

Python application to retrieve the information of celestial objects in a given date-time range

Pysky

Download & Installation

Initial setup

Download and install latest version of Python here.

Follow these instructions to get the latest version of pip.

~$ git clone https://github.com/allenerocha/pysky.git && cd pysky/

pysky/$ pip install .

Uninstalling

~$ pip uninstall pysky -y

Usage

~$ pysky -sd [start date] -st [start time] -ed [end date] -et [end time] -t [thread count] -v [verbosity level]

Command line options

Options (Dates and times are in ISO 8601 format)

-sd/--startdate	Starting date. [1]
-st/--starttime	Starting time. [1]
-ed/--enddate	Ending date. [2]
-et/--endtime	Ending time. [2]
-t/--threads	Number of threads to use. [2]
-v/--verbosity	Verbosity level. [2]
-h/--help	Display help for the CL options.

[1]	(1, 2) Required.

[2]	(1, 2, 3, 4) Optional.

Date format (YEAR-MONTH-DAY)

YEAR	4 digit format
MONTH	2 digit format
DAY	2 digit format

Time format (HOUR:MINUTE)

HOUR	24 hour format (0-23)
MINUTE	Minute in regular format (0-59)

Specifying no end date and time defaults the search to only go for one hour long.

Help

~$ pysky -h

~$ pysky --help

---

Images

Default

By default images of valid objects will be saved in the filename format:

$HOME/PySkySlideshow/object-width-height-resolution-scaling.png

User Defined

To change the location of the saved images, you can add the following line to the user_prefs.cfg file:

slideshow_dir=

Followed by the directory to save in. The folder PySkySlideshow will be created in the specified directory.

Examples

slideshow_dir=/home/allen

This will set the directory to save the images as:

slideshow_dir=/home/allen/PySkySlideshow/

Usage

Start July 10th, 2012 17:00 End July 10th, 2012 23:00

$ pysky -sd 2012-07-10 -st 17:00 -ed 2012-07-10 -et 23:00

Start December 31st, 2015 08:00 End January 1st, 2016 02:00 with high verbosity

$ pysky -sd 2015-12-31 -st 08:00 -ed 2016-01-01 -et 02:00 -v 5

Start September 1st, 2019 19:00 for one hour with 2 threads and medium verbosity

$ pysky -sd 2019-09-01 -st 17:00 -t 2 -v 3

Supported Python Versions

Python 3.6+

pysky's Issues

Identify error produced by test case in revision ee93f030:

2020-11-30 20:36:22,113 [INFO] Retrieving data for tonight's moon...
Traceback (most recent call last):
File "C:\Users\William\PycharmProjects\pysky\venv\Scripts\pysky-script.py", line 33, in
sys.exit(load_entry_point('pysky==0.9.9', 'console_scripts', 'pysky')())
File "c:\users\william\pycharmprojects\pysky\venv\lib\site-packages\pysky_main_.py", line 13, in main
invoke()
File "c:\users\william\pycharmprojects\pysky\venv\lib\site-packages\pysky\core.py", line 47, in invoke
gen_moon_data()
File "c:\users\william\pycharmprojects\pysky\venv\lib\site-packages\pysky\core.py", line 477, in gen_moon_data
illumination, phase = query()
File "c:\users\william\pycharmprojects\pysky\venv\lib\site-packages\pysky\moonquery.py", line 28, in query
for item in data["2"]:
TypeError: list indices must be integers or slices, not str

Lunar Horizontal Coordinates Incorrect

Describe the bug
Lunar horizontal coordinates (alt., az.) are incorrect in the output table

To Reproduce
user_prefs.cfg
latitude=-87.8791
longitude= 42.6499
elevation=0.204

pysky -sd 2020-12-21 -st 22:00 -ed 2020-12-21 -et 23:00
open ~/PySkySlideshow/pysky-report-2020-12-21.html

Expected behavior
Moon altitude is 35° - 40° and azimuth 144 - 160° during this time from this location

Screenshots

Desktop (please complete the following information):
macOS 10.13.6

Windows OS file paths raise OSError

Describe the bug
The file paths in the application must be updated to use Python 3’s pathlib module to support Linux, MacOS, and Windows

To Reproduce
Steps to reproduce the behavior:

1. pysky -sd 2020-01-01 -st 21:00 -t 4 -v 5
2. log.txt

Expected behavior
Should read any project files without raising an OSError

Screenshots
If applicable, add screenshots to help explain your problem.

Desktop (please complete the following information):

• OS: Windows 10
• Version 0.9.9

TypeError in image_manipulation for Moon

Describe the bug
Code exits with the following traceback:
File "C:\Users\William\PycharmProjects\pysky\venv\Scripts\pysky-script.py", line 11, in
load_entry_point('pysky==0.9.9', 'console_scripts', 'pysky')()
File "c:\users\william\pycharmprojects\pysky\venv\lib\site-packages\pysky_main_.py", line 14, in main
invoke()
File "c:\users\william\pycharmprojects\pysky\venv\lib\site-packages\pysky\core.py", line 422, in invoke
overlay_text("Moon", v_obj)
File "c:\users\william\pycharmprojects\pysky\venv\lib\site-packages\pysky\image_manipulation.py", line 120, in overlay_text
img = add_text(img, overlay_txt)
File "c:\users\william\pycharmprojects\pysky\venv\lib\site-packages\pysky\image_manipulation.py", line 225, in add_text
text="\n".join(overlay_text), # concats all strings in the list
TypeError: can only join an iterable

To Reproduce
Steps to reproduce the behavior:
pysky -sd 2020-12-21 -st 22:00 -ed 2020-12-22 -et 00:00 -t 1

Expected behavior
Code completes without error. Moon image overlaid produced.

Screenshots
N/A

Desktop (please complete the following information):

• OS: Windows 10 Pro
• Version 19041.804
• Python 3.8.5

Additional context
N/A

When parsing webpages for celestial objects, it returns 'NoneType'

Errors:

Object: capella

2020-04-19 15:40:59,433 [CRITICAL] Error trying to parse the web page of capella!

'NoneType' object has no attribute 'find'

2020-04-19 15:40:59,433 [CRITICAL] Error trying to parse the web page of capella! Removing from queue...

Object: sirius

2020-04-19 15:40:58,113 [CRITICAL] Error trying to parse the web page of sirius!

'NoneType' object has no attribute 'find'

2020-04-19 15:40:58,114 [CRITICAL] Error trying to parse the web page of sirius! Removing from queue...

Multiple stars can create issues with brightness

When entering a celestial object that is comprised of two stars, like mizar, it will not output correctly.
http://simbad.u-strasbg.fr/simbad/sim-basic?Ident=mizar&submit=SIMBAD+search
When searching Mizar with simbad, it does not give a brightness.

Example of user_prefs.cfg format?

Hi,
I'd like to run this for a specific lat/lon combination. Could you provide an example of a user_prefs.cfg file that shows how different fields could be provided? I have tried to do this with lat= , lon= and ele= but it seems that's the wrong format.
Thank you!
mconsidine

Negative values of sec(z) are accepted

is_object_visible definition in pysky/check_sky.py does not check to ensure that sec(z) > 0 (zenith angle < 90°)

Change Cadwell catalog to Caldwell catalogue

Spelling mistake.
Cadwell catalog is misspelled and should be spelled Caldwell catalogue.