Go microservice implementing the EN ISO 13790 annual heating energy demand calculation pipeline derived from tabula-calculator.xlsx (Accessed on: 26.06.26). The calculation method has been documented in TABULA CommonCalculationMethod (Accessed on: 26.06.2026). The tool covers all European building typologies across 20 countries defined by TABULA & EPISCOPE (IEE Projects).
The results have been validated against the Excel Workbook output. So far 19/20 countries at 100% accuracy in total 2,091 / 2,147 buildings validated. See the validation report.
| Dependency | Version |
|---|---|
| Go | 1.26+ |
| PostgreSQL | >= 15 |
| Step | Command | Description |
|---|---|---|
| 1 | cp .env.example .env |
Configure DB connection, ALLOWED_ORIGINS, APP_PORT |
| 2 | make build |
Compile all binaries into bin/ |
| 3 | make create-db |
Create the PostgreSQL database named in .env |
| 4 | ./bin/build_db |
Load TABULA workbook inside PostgreSQL |
| 5 | make run |
Start API on APP_PORT (default 8080) |
Full setup and API documentation: thd-spatial-ai.github.io/ignis
Architecture documentation (arc42): under development, not yet published.
Note
AI usage disclaimer: Some tests in this repository were written with the assistance of AI coding tools, then reviewed and validated by a maintainer before merging.
go test ./...
go test ./... -coverprofile=coverage.out -covermode=atomic
go tool cover -html=coverage.outpython -m venv .venv
.venv/bin/pip install -r docs/requirements.txt
.venv/bin/mkdocs serveMIT License — Copyright 2026 BigGeoData & Spatial AI, Technische Hochschule Deggendorf. See LICENSE for the full text.
Found a security issue? See SECURITY.md for how to report it privately.
Developed in the context of the RENvolveIT research project (https://projekte.ffg.at/projekt/5127011), funded by CETPartnership under the 2023 joint call for research proposals, co-funded by the European Commission (GA N°101069750).
TABULA & EPISCOPE (IEE Projects): building-characteristic data (episcope.eu, accessed 08.07.2026)