Skip to main content

A package providing a GUI for the skylight_gui package.

Project description

Graphical User Interface (GUI) for models of skylight GitHub top language GitHub license GitHub last-commit Build Status

Rendered GUI

This (Python-based) GUI allows for interactive exploration of the skylight information provided by the different models. The GUI is based on the one implemented by Vévoda et al. (2022) for their Prague Sky Model (original C++ code here). There are three available datasets that work with this model, which can be downloaded form here:

Installation

You can easily install the package by using pip as:

pip install git+https://github.com/evgkanias/sky-gui.git

Alternatively you need to clone the GitHub repository, navigate to the main directory of the project, install the dependencies and finally the package itself. Here is an example code that installs the package:

  1. Install the skylight package by using the instructions from here, or run:
pip install skylight
  1. Clone this repo.
mkdir ~/src
cd ~/src
git clone https://github.com/evgkanias/sky-gui.git
cd sky-gui
  1. Install the required libraries.
    1. using pip :

      pip install -r requirements.txt
      
    2. using conda :

      conda env create -f environment.yml
      
  2. Install the package.
    1. using pip :
      pip install .
      
    2. using conda :
      conda install .
      

Note that the pip project might be needed for the above installation.

Run the graphical user interface (GUI)

To run the GUI, open a Python terminal and run the below.

from skylight_gui import SkyModelGUI

gui = SkyModelGUI()
gui()

Alternatively, go to the examples directory and run the script that opens the graphical environment.

cd examples
python run_gui.pyw

This will open the GUI which should look like this:

Initial GUI

By clicking the file-name filed, you can choose the dataset file, which will load automatically. Once loaded, you can click "Render" (or choose the auto-update option) and this will print an image of the sky radiance, sun radiance, degree of polarisation, transmittance, or angle of polarisation (depending on the rendering mode), as shown below:

Rendered GUI

By clicking the saving file-name, you can define the file-name and type of data you want to save. Theses are:

  • Image file (PNG or JPEG)
  • Raw data (CSV or EXCEL)

The raw data option will save the data of the chosen mode but for all the available wavelengths and the extracted visible light (RGB).

Report an issue

If you have any issues installing or using the package, you can report it here.

Author

The code is written by Evripidis Gkanias.

Credits

The original (C++) code for this model was written by Petr Vévoda et al. from Alexander Wilkie's group in Charles University, which was part of their wide spectral range sky radiance model.

Copyright

Copyright © 2022, Evripidis Gkanias; Institute of Perception, Action and Behaviour; School of Informatics; the University of Edinburgh.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

skylight-gui-1.0b4.tar.gz (121.7 kB view hashes)

Uploaded Source

Built Distribution

skylight_gui-1.0b4-py3-none-any.whl (117.4 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page