Skip to content

tum-ens/InfDB

Repository files navigation

Repo logo

InfDB - Infrastructure and Energy Database

InfDB - Infrastructure and Energy Database provides a modular and easy-to-configure open-source data and tool infrastructure. It is equipped with essential services, designed to minimize the effort required for data management. We follow a platform-independent containerized approach that streamlines collaboration in energy modeling and analysis, empowering the growth of an ecosystem by offering standardized interfaces and APIs, and by allowing users to dedicate their focus to generating insights rather than handling data logistics.

Category Badges
License License
Documentation Documentation
Community Contributing Contributors Repo Count

Table of Contents

Why use it?

InfDB addresses common challenges in energy system modeling and analysis, particularly those related to data management. By providing a standardized and modular infrastructure, InfDB reduces the time and effort required to set up and maintain data systems. This allows researchers, analysts, and planners to focus on their core tasks of modeling and analysis, rather than being bogged down by data logistics.

InfDB can be used effectively wherever geospatial and time series information is required. Possible applications include:

  • Energy System Modeling
  • Municipal Heat Planning and Infrastructure Planning
  • Scenario and Geospatial Analysis

How it works?

InfDB consists of the following layers:

  • Services – Dockerized open-source software providing base functionality.
  • Tools – Software interacting with InfDB.
  • Python API – Python package pyinfdb for interacting with InfDB.

InfDB overview

Services

The InfDB platform provides a suite of essential services designed to facilitate database operation and administration, data handling and visualization, and connectivity. Each preconfigured service can be activated individually to tailor the environment to your specific requirements.

More information, a list of available services see Services.

Tools

Tools are software that interact with InfDB and process data through standardized, open interfaces. This modular approach allows you to tackle problems of any complexity by combining different tools into custom toolchains.

More information, a list of integrated tools and additional information, see Tools.

Getting Started

If you want to use the InfDB with the default settings just use the Quick Start below. For more information in detail read the Usage Guide of the official documentation.

Prequisites

Local Folder Structure

The InfDB allows a modular folder structure to manage multiple database instances independently. Each instance represents a separate deployment with its own data, configuration, and services—ideal for handling different regions, projects, or environments.

infdb/
├── infdb-demo/
├── muenchen/
├── bavaria/
├── grid-planning/
└── ...

The recommended structure places all instance data in docker managed volumes while keeping each instance's configuration and tools in separate directories (e.g. by region muenchen/, bavaria/). This approach simplifies backups, migrations, and multi-instance management.

Quick Start

You can quickly start an InfDB with default configuration and credentials by following these steps:

First of all, create the main infdb directory and navigate into it:

mkdir infdb
cd infdb

Clone InfDB

# Replace "infdb-demo" by name of instance 
git clone --recurse-submodules git@github.com:tum-ens/InfDB.git infdb-demo
cd infdb-demo

Start InfDB

bash infdb.sh start

Import Opendata

bash infdb.sh import

Stop InfDB

bash infdb.sh stop

License and Citation

The code of this repository is licensed under the Apache 2.0 License.
See LICENSE for rights and obligations. See Citation for citation of this repository.
Copyright: TU Munich - ENS | Apache 2.0 License

Contact

Patrick Buchenberg

Chair of Renewable and Sustainable Energy System Technical University of Munich (TUM) Email: patrick.buchenberg@tum.de https://www.epe.ed.tum.de/ens/staff/ensteam/patrick-buchenberg/

About

InfDB (Infrastructure and Energy Database) provides a modular and easy-to-configure open-source data and tool infrastructure equipped with essential services, designed to minimize the effort required for data management.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors