README
¶
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.
Compatibility
| Dependency | Version |
|---|---|
| Go | 1.26+ |
| PostgreSQL | >= 15 |
Quick start
cp .env.example .env # configure DB connection, ALLOWED_ORIGINS, APP_PORT
make build # compile all binaries into bin/
make create-db # create the PostgreSQL database named in .env
./bin/build_db # load TABULA workbook → PostgreSQL
make run # start API on APP_PORT (default 8080)
Full setup and API documentation: thd-spatial-ai.github.io/ignis
Testing
go test ./...
go test ./... -coverprofile=coverage.out -covermode=atomic
go tool cover -html=coverage.out
Local docs
python -m venv .venv
.venv/bin/pip install -r docs/requirements.txt
.venv/bin/mkdocs serve
License
MIT License — Copyright 2026 BigGeoData & Spatial AI, Technische Hochschule Deggendorf. See LICENSE for the full text.
Acknowledgements
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 13.11.2025)
Directories