herseyc / raspastroweb

Astronomy Web Application which predicts and displays interesting and useful information about the planets, stars, and other objects in the sky.

RaspAstro Web

RaspAstroWeb is an application which display interesting and useful Astronomy data. Information about the Sun, Moon, planets, and the ISS.

RaspAstro post at Suffolk Sky: http://www.suffolksky.com/tag/raspastro/

RaspAstro Web Demo running here: http://vhersey.hopto.org:5000/

Installation

Download RaspAstro Web

mkdir -p ~/Projects
cd ~/Projects
git clone https://github.com/herseyc/RaspAstroWeb.git
cd ~/Projects/RaspAstroWeb

Edit install_raspastro-web.sh and set INSTALL_DIR (default: /var/www/raspastro)

Update the PYTHON_BIN (default: /usr/bin/python3) if necessary.

Run

./install_raspastro-web.sh

Creates the configured install directory (INSTALL_DIR)

Sets up the python virtual environment with required python modules.

RaspAstroWeb files copied to the INSTALL_DIR

Generates Solar System map and places it at INSTALL_DIR/static/planets.png

raspastroweb.service is configured to start RaspAstroWeb at boot.

Starts RaspAstroWeb.

Update RaspAstroWeb

Updating RaspAstroWeb

cd ~/Projects/RaspAstroWeb
git pull origin master

Edit install_raspastroweb.sh and set the INSTALL_DIR

./install_raspastroweb.sh

INSTALL_DIR/config.py will be copied to INSTALL_DIR/config.old (I'll work on a better way to do this)

Update INSTALL_DIR/config.py as needed.

config.py

Config.py contains all the user-defined settings.

User-defined settings:

# Number of days to calculate ISS Passes
PASSDAYS = 5

#If USE_INDI is False then INDI Server info will not be queried
USE_INDI = True

# INDI Web Manager API Endpoint
INDIWEBMANAGER_API_ENDPOINT = "http://localhost:8624"

# Define Observer Horizon in DMS
MY_HORIZON = "0:34:0"

# Set to True to use GPS, False to use user configured lat/lon/elev
USE_GPS = True

# If USE_GPS is False use the following for observer location
# Latitude and Longitude DMS string
MY_LAT = "36:46:46.0"
MY_LON = "-76:32:8.1"

# Observer Elevation (float in meters)
MY_ELEVATION = 7.7

raspastro-web.py

Flash app to display data on webpage.

Edit config.py with your configuration settings and then use install_raspastro-web.sh to copy into INSTALL_DIR (/var/www/raspastro is the default). Then run raspastro-web.py

./install_raspastro-web.sh
cd /var/www/raspastro
/var/www/raspastro/virtualenv/raspastroweb/bin/python3 raspastro-web.py

Will listen on port 5000, so just access at http://ipofdevice:5000

If config.py exists in the INSTALL_DIR (default /var/www/raspastro) a copy of it, config.old, is created by install_raspastro-web.sh

raspastroweb.service

This can be used to set up systemd to start raspastro-web.py at boot. It is setup and installed by install_raspastro-web.sh

Edit the file and update the user and directory if required (default user is pi, replace INSTALLDIR with the installation directory - ie /var/www/raspastro)

cd /var/www/raspastro
sudo cp raspastroweb.service /etc/systemd/system
sudo chmod 644 /etc/systemd/system/raspastroweb.service
suod systemctl daemon-reload
sudo systemctl enable raspastroweb.service
sudo systemctl start raspastroweb.service

Example Observer Information

The Observer Page displays the Observer's location information. The location information is obtained from GPSD or from the manual configurations config.py. The INDI information is updated from the INDI Web Manager API. The Observer information is static and only updates if refreshed. The INDI Information updates every 30 seconds.

Example Solar System Information

Sun, Moon, and Planet Data. This information on this page is only updated when refreshed.

Example ISS Information

Example Polaris/Polar Alignment Information

planets.py

Generates a Solar System Map.

To update the Solar System map image manually run:

cd INSTALL_DIR
INSTALL_DIR/virtualenv/raspastroweb/bin/python3 ./planets.py

Replace INSTALL_DIR with the full path to the directory where RaspAstroWeb was installed.

raspissinfo.py

ISSData Class to get ISS current information and determine next passes for observer location.

raspastroinfo.py

AstroData Class to get information related to the Sun and Moon for an oberserver location

rasp_calc_func.py

Functions to convert UTC to local time (to_local(time)), convert meters to miles (meters_to_miles(meters)), and determine is a UTC datetime is at night in local time (is_at_night(checkdate, lat, lon) for a specific location.

examples.py

Examples for using the ISSData Class and AstroData Class as well as the rasp_calc_func.py