Skip to content

THD-Spatial-AI/ignis

Repository files navigation

Ignis logo Ignis logo

CI   MkDocs   GitHub release

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

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


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).

CETPartnership   EU

TABULA & EPISCOPE (IEE Projects): building-characteristic data (episcope.eu, accessed 08.07.2026)

About

Go microservice implementing the EN ISO 13790 annual heating energy demand calculation pipeline derived from IEE Project TABULA

Topics

Resources

License

Code of conduct

Contributing

Stars

1 star

Watchers

0 watching

Forks

Packages

 
 
 

Contributors

Languages