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).
Results are validated against the workbook's own output: 19 of 20 countries at 100% accuracy, 2,124 of 2,147 buildings within ±2.5% (./bin/validate, 2026-10-02). See the validation report.
| Dependency | Version |
|---|---|
| Go | 1.26+ |
| PostgreSQL | 15 to 17 |
| 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.
In the graphic above, the top section is the whole project, the sections below it are folders, and the smallest are individual files. Slice size is the number of statements and slice colour is the coverage.
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. The licence covers the code. The TABULA workbooks in data/ are distributed under the TABULA usage rules; see ATTRIBUTIONS.md.
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).
Building-characteristic data source: IEE Projects TABULA + EPISCOPE (www.episcope.eu), used under the TABULA usage rules (accessed 08.07.2026).