# HelioBench: third-party data and software

## Data

**ČÚZK** (Czech Office for Surveying, Mapping and Cadastre), open data under
[CC BY 4.0](https://creativecommons.org/licenses/by/4.0/), terms:
https://www.cuzk.gov.cz/Predpisy/Podminky-poskytovani-prostor-dat-a-sitovych-sluzeb/Podminky-poskytovani-prostorovych-dat-CUZK.aspx

Source: ČÚZK, 2026. Used: Ortofoto ČR, DMP OK (digital surface model from
image correlation), DMP 1G, DMR 5G (digital terrain model), RÚIAN (building
outlines, addresses).
Modifications: building footprints, wings, roof types, pitches and heights
and tree positions are reconstructed automatically from the surface and
terrain models, the orthophoto and the RÚIAN outlines; the orthophoto is
resampled and draped over the 3D model. The reconstruction is an estimate.

**PVGIS** (Photovoltaic Geographical Information System), © European Union,
2001-2026, reused under the Commission's reuse policy
([CC BY 4.0](https://creativecommons.org/licenses/by/4.0/),
https://commission.europa.eu/legal-notice_en). Used: PVcalc long-term
monthly yield and hourly series (seriescalc) with irradiance components.
Modifications: the hourly series is corrected for inter-row and 3D shading
and combined with the long-term monthly yield.

**OpenStreetMap**: map tiles and place search (Nominatim), © OpenStreetMap
contributors, data under [ODbL](https://www.openstreetmap.org/copyright),
used under the OSMF tile and Nominatim usage policies.

## Usage statistics

The service keeps anonymous usage statistics (web/server/stats.py): per
action the hour, the kind of action, its duration and result, a location
rounded to 0.1 degree (about 10 km), the size of the design and the
language. No IP addresses, cookies, user agents or exact coordinates are
stored, and nothing links two actions to the same visitor.

## Software in the web app

| Component | Licence | Where |
|---|---|---|
| [three.js](https://threejs.org/) | MIT | 3D view (`web/static/vendor/LICENSE.three`) |
| [Leaflet](https://leafletjs.com/) | BSD-2-Clause | map (`web/static/vendor/LICENSE.leaflet`) |
| [Chart.js](https://www.chartjs.org/) | MIT | charts (`web/static/vendor/LICENSE.chartjs`) |
| [FastAPI](https://fastapi.tiangolo.com/) | MIT | server |
| [Starlette](https://www.starlette.io/), [Uvicorn](https://www.uvicorn.org/) | BSD-3-Clause | server |
| [Pydantic](https://docs.pydantic.dev/) | MIT | server |
| [NumPy](https://numpy.org/) | BSD-3-Clause (with 0BSD, MIT, Zlib parts) | server |
| [SciPy](https://scipy.org/) | BSD-3-Clause | server |
| [Matplotlib](https://matplotlib.org/) | Matplotlib licence (PSF based) | server |
| [Pillow](https://python-pillow.org/) | MIT-CMU | server |
| [MobileSAM](https://github.com/ChaoningZhang/MobileSAM) model | Apache-2.0 | optional "from orthophoto" tools |

The licence texts of the Python packages ship with the packages in the
server image; the JavaScript licences are next to the files in
`web/static/vendor/`. Development and test tools (pytest, httpx,
Playwright) are not part of the running service.