Package: jakopicevca2017
Program for Astro Pi 2017/18 - Mission Space Lab - Team JakopičevcaDescriptionWe would like to research how much of Slovenia (and other countries) is
covered with forests. We would compare the results with previous
pictures of forestation in order to determine possible deforestation or
even expansion of the forests. We would also like to research light
pollution with photographing at night. We would use NoIR camera in order
to determine different colorization in pictures. The photographs would
be analysed later.How It WorksThe program will use Python ephem module to determine location of ISS.
If ISS is flying over certain countries, the program will take pictures
for a certain number of seconds and save photos in a folder with a
location name. Name of the photo is time of the photo. It’s possible
that ISS doesn’t fly over certain countries, or if the location
calculations with ephem are wrong, program will in any case take photos
of Earth, but less often, and save the images indefaultfolder. We
will save direction of North from magnetometer due to a later analysis
of photographs. Location, sensor data, and time will be saved in the CSV
file.The locations of the photographing and other settings are stored in theconfig.jsonfile. This file also stores TLE data, so update them
before running the program. In thelocationssection, the
coordinates of countries for photographing are saved. The valuelatitude1is the latitude of the most north point of the country,
thelatitude2is the latitude of the most south point of the
country, thelongitude1is the longitude of most west point of the
country, and thelongitude2is the longitude of the most east point
of the country. The valuedelayis the number of seconds between
each photo of the country. In thedefaultsection, information about
photographing when the ISS is not above any country are stored. Thedelayvalue is the number of seconds between each photo, and thefallbackDelayis the number of seconds between each photo when there
is an error in obtaining an ISS location.UsageThe program must be used on Raspberry Pi. The program is intended for
use on ISS, but could be suitable for other environments with some
adjustments.RequirementsThe program uses Python 3 and has not been tested on Python 2. It uses
the following Python modules:sense-hatpicameraephemInstallationIt is recommended to install program in Python VENV. Python VENV must be
created with--system-site-packagesargument. However, here are
general installation instructions.Installation from PyPI:sudopip3installjakopicevca2017Installation from GitHub repository:gitclonehttps://github.com/filips123/jakopicevca/--branch2017--single-branchcdjakopicevcasudopython3setup.pyinstallRunningCreateconfig.jsonfile with the following content (fill the missing
informations):{"TLE":["ISS (ZARYA)","### Get the latest ISS TLE data ###","### http://www.celestrak.com/NORAD/elements/stations.txt ###"],"locations":{"### Location Name ###":{"latitude1":most-north-point,"latitude2":most-south-point,"longitude1":most-west-point,"longitude2":most-east-point,"delay":photographing-delay}},"default":{"delay":default-photographing-delay,"fallbackDelay":fallback-photographing-delay}}Save the file and start the program with:python3-mjakopicevca2017path/to/config.jsonpath/to/file.csvpath/to/image/folderpath/to/file.logCSV and log files, and image folder will be created automatically.LicenseThis project is licensed under the GNU GPL License. See the LICENSE file
for more details.