This repository was created to host the PySQM version deployed in the SQM LE (Unihedron) devices of the Photometre Network for the [Darkersky4CE](https://www.interreg-central.eu/projects/darkersky4ce/) Interreg Central Europe project.
PySQM is a multi-platform, open-source software designed to read and plot data from Unihedron SQM-LE and SQM-LU photometers, giving as an output files with the 'International Dark Sky Association (IDA) NSBM Community Standards for Reporting Skyglow Observations' format (http://www.darksky.org/night-sky-conservation/248).
PySQM is distributed under GNU GPL, either version 3 of the License, or (at your option) any later version. See the file LICENSE.txt for details.
...
...
@@ -13,11 +15,11 @@ This software has been developed by Mireia Nievas <mnievas@ucm.es> with the inva
The initial port to Python3 has been done by Anthony Tekatch (Unihedron).
This repository was created to host the PySQM version deployed in the SQM LE (Unihedron) devices of the Photometre Network for the Darkersky4CE Interreg Central Europe project (https://www.interreg-central.eu/projects/darkersky4ce/).
### Setup
After downloading the software, you need to modify the file config.py. In this file you will find several variables that need to be configured to match your hardware settings. For example:
After downloading the software, you need to modify the file `config.py`(config.py).
In this file you will find several variables that need to be configured to match your hardware settings.
For example:
- Location of the observatory (geographical coordinates)
- Device identifier
...
...
@@ -29,10 +31,10 @@ Remember that python (2.7) syntax is mandatory in this file
### How to use the software
After configuring the software, make sure you are in the parent directory were the README, LICENSE and MANIFEST files are located
After configuring the software, make sure you are in the parent directory were the `README.md`, `LICENSE.txt` and `MANIFEST.in` files are located
The program should find your SQM device and the data adquisition will start (if it's night-time).
Note: running the setup.py script is neither tested nor required. The program is currently being redesigned as a normal python package, but at present no setup is required.
Note: running the `setup.py` script is neither tested nor required. The program is currently being redesigned as a normal python package, but at present no setup is required.
### How it works
...
...
@@ -55,7 +57,7 @@ Each N measurements, the main program calls a plotting function to generate a gr
### PySQM known issues
Non-ASCII characters are not supported in the config.py file. Please, avoid using 'ñ', accented vowels, etc.
Non-ASCII characters are not supported in the `config.py` file. Please, avoid using 'ñ', accented vowels, etc.
In headless systems, such as the Raspberry PI, if you run the program without X, you may suffer from the following fatal error when the program tries to generate the plot:
