README.md 3.2 KB
Newer Older
Bognár, Á.'s avatar
Bognár, Á. committed
1 2
# Pyrano

Bognár, Á.'s avatar
Bognár, Á. committed
3
![](https://gitlab.tue.nl/bp-tue/pyrano/-/raw/master/intro_slides/Pyrano_TUe_logo.png?inline=false "Pyrano-TU/e logo")
Bognár, Á.'s avatar
Bognár, Á. committed
4

Bognár, Á.'s avatar
Bognár, Á. committed
5
A Python project for matrix-based hourly annual solar irradiance simulations.
Bognár, Á.'s avatar
Bognár, Á. committed
6 7 8

# Features

Bognár, Á.'s avatar
Bognár, Á. committed
9
![](https://gitlab.tue.nl/bp-tue/pyrano/-/raw/master/intro_slides/Pyrano_GitLab_features_slide.png?inline=false "Example for a use case")
Bognár, Á.'s avatar
Bognár, Á. committed
10

Bognár, Á.'s avatar
Bognár, Á. committed
11 12 13 14
## Geometry preprocessing

* Translating [EnergyPlus](https://energyplus.net/) IDF geometry to .rad file for [Radiance](https://radiance-online.org/) simulation (utilizing [Eppy](https://github.com/santoshphilip/eppy) and [GeomEppy](https://github.com/jamiebull1/geomeppy))
* Generating sensor points over selected surfaces (utilizing GeomEppy)
15
* Processing LiDAR-based DSM point-clouds for shading geometry input
Bognár, Á.'s avatar
Bognár, Á. committed
16

Bognár, Á.'s avatar
Bognár, Á. committed
17
## Solar irradiance simulations
Bognár, Á.'s avatar
Bognár, Á. committed
18 19

* Running [Radiance](https://radiance-online.org/) sub-programs with Python
20
* Calculating irradiance with the 2 and PCB 2 phase method
Bognár, Á.'s avatar
Bognár, Á. committed
21 22 23 24 25 26 27 28 29 30 31 32
* (WIP) Providing an interface between irradiance and PV simulations (Radiance - [PVMismatch](https://github.com/SunPower/PVMismatch))

# Installation

Pyrano is on [PyPi](https://pypi.org/project/pyrano/). You can install it with pip:

`pip install pyrano`

*Note: On Windows, one of the dependencies (Rtree) might cause the pip installation to fail. In that case [download the whl of Rtree from Christoph Gohlke's collection of Windows binaries](http://www.lfd.uci.edu/~gohlke/pythonlibs/#rtree) and [install Rtree from the whl file](https://stackoverflow.com/questions/27885397/how-do-i-install-a-python-package-with-a-whl-file#:~:text=You%20can%20install%20the%20.,%3A%5CSome%5CPAth%5Cfilename%20.). Once Rtree is manually installed you can try again `pip install pyrano`.*

To utilize all features of Pyrano you also need to have [Radiance](https://www.radiance-online.org/download-install) and [EnergyPlus](https://energyplus.net/downloads) installed.

33
# Sources of freely available LiDAR-based DSM point clouds
Bognár, Á.'s avatar
Bognár, Á. committed
34
* The Netherlands: https://www.pdok.nl/introductie/-/article/actueel-hoogtebestand-nederland-ahn3-
Bognár, Á.'s avatar
Bognár, Á. committed
35
* United Kingdom: https://environment.data.gov.uk/DefraDataDownload/?Mode=survey
Bognár, Á.'s avatar
Bognár, Á. committed
36
* United States: https://viewer.nationalmap.gov/basic/
Bognár, Á.'s avatar
Bognár, Á. committed
37

38 39 40 41 42 43 44 45 46 47 48 49
# Short summary of the PCB 2 phase method: matrix-based solar irradiance simulations with LiDAR-based DSM point clouds as geometry input:

![](https://gitlab.tue.nl/bp-tue/pyrano/-/raw/master/intro_slides/Slide1.PNG?inline=false "")
![](https://gitlab.tue.nl/bp-tue/pyrano/-/raw/master/intro_slides/Slide2.PNG?inline=false "")
![](https://gitlab.tue.nl/bp-tue/pyrano/-/raw/master/intro_slides/Slide3.PNG?inline=false "")
![](https://gitlab.tue.nl/bp-tue/pyrano/-/raw/master/intro_slides/Slide4.PNG?inline=false "")
![](https://gitlab.tue.nl/bp-tue/pyrano/-/raw/master/intro_slides/Slide5.PNG?inline=false "")
![](https://gitlab.tue.nl/bp-tue/pyrano/-/raw/master/intro_slides/Slide6.PNG?inline=false "")
![](https://gitlab.tue.nl/bp-tue/pyrano/-/raw/master/intro_slides/Slide7.PNG?inline=false "")
![](https://gitlab.tue.nl/bp-tue/pyrano/-/raw/master/intro_slides/Slide8.PNG?inline=false "")
![](https://gitlab.tue.nl/bp-tue/pyrano/-/raw/master/intro_slides/Slide9.PNG?inline=false "")
![](https://gitlab.tue.nl/bp-tue/pyrano/-/raw/master/intro_slides/Slide10.PNG?inline=false "")