Midas

The MultI-DomAin test Scenario (MIDAS) is a collection of mosaik simulators (https://gitlab.com/mosaik) for smart grid co-simulation and contains a semi-automatic scenario configuration tool. The latest documentation is always available at https://midas-mosaik.gitlab.io/midas.

Version: 2.1

Whats new in Version 2.0?

Midas is no longer a namespace package but still splitted into several individual packackes. There is a unified data simulator, which allows to integrate custom time series more easily. Furthermore, csv is now preferred over hdf5, since it is easier for humans to read with no special software. In this process, some of the lesser used packages are not (yet) updated, this includes

midas-goa
blackstart/mango
market_agents
qmarket

The midas-util package was fully integrated into the base package midas-mosaik. Default scenarios will now be copied over to your scenario directory, and can be restored with midasctl configure -u

Requirements

All required Python packages will be pulled during installation. However, there are some additional requirements which you have to setup up manually.

First of all, you need a working Python installation >= 3.10. Download it from (https://www.python.org/) or use your systems' package manager. Furthermore, you will need to have a working Git installation, which you can find on https://git-scm.com/downloads (or via your package manager).

Midas is able to create an analysis report of the simulation results. If you have a working pandoc (https://pandoc.org/) installation, this report will automatically be converted to an .odt file. This is purely optional.

Installation

Midas is available on https://pypi.org and can be installed, preferably into a virtualenv, with

pip install midas-mosaik

Alternatively, to install directly from the source, you can clone this repository with

git clone https://gitlab.com/midas-mosaik/midas.git

then switch to the midas folder and type

pip install .

for a normal install and

pip install -e .

for an editable install, i.e., changes you make in the source do not require a reinstall.

See the documation at https://midas-mosaik.gitlab.io/midas/installation.html for OS-specific installation instructions.

Usage

Midas comes with a command line tool called midasctl that let's you conveniently start your scenario and/or add minor modifications to it (e.g. change the number of simulations steps, write to a different database, etc.). midasctl also helps doing the initial setup of midas. Just type

midasctl configure

and you will be asked to specify where the runtime configuration of midas should be stored and where you want the datasets to be located. You can of course let midas decide this for you, just append -a to the command:

midasctl configure -a

Afterwards, you need to download the datasets that midas will use. Type

midasctl download

and wait a moment until midas is done. Finally, you can test your installation with

midasctl run demo

This will run a demonstration scenario and should not take very long.

Pro tip: If you just run the last command, configuration and download will be performed implicitly.

Data Sets and License

The datasets are pulled from different locations.

The default load profiles are publicly available at https://www.bdew.de/energie/standardlastprofile-strom/

The commercial data set is retrieved from https://data.openei.org/submissions/153 and is released under the Creative Commons License: https://creativecommons.org/licenses/by/4.0/ The energy values are converted from Kilowatt to Megawatt and are slightly rearranged to be usable with MIDAS.

The simbench datasets are directly extracted from the simbench pypi package.

The smart nord dataset comes from the research project Smart Nord (www.smartnord.de).

The Weather datasets are publicly available at https://opendata.dwd.de/ (see the Copyright information: https://www.dwd.de/EN/service/copyright/copyright_node.html) Since sometimes values are missing, those values are filled with previous orsimilar values.

Midas as Docker

There is a Docker file that can be used to run the midas command line tool. And there is an install script for those working on LINUX, simply run:

./build_docker.sh

Afterwards, execute

docker run \
    -v PATH_TO_MIDAS_DATA:/home/user/.config/midas/midas_data \
    -v PATH_TO_OUTPUT_DIR:/app/_outputs \
    midas run midasmv

to run the midasmv scenario in the docker. Replace PATH_TO_MIDAS_DATA with the absolute path to your midas data directory (usually located at ~/.config/midas/midas_data). Replace PATH_TO_OUTPUT_DIR with the location where the outputs should be stored.

If you create a runtime config in the same directory as the Dockerfile before run the build command, this file will be included. However, you should not change the output_path and the data_path, otherwise you will have to adapt the run command as well.

Citation

If you want to use midas in your research, you can cite this publication:

@InProceedings{10.1007/978-3-031-43824-0_10,
    author="Balduin, Stephan
    and Veith, Eric M. S. P.
    and Lehnhoff, Sebastian",
    editor="Wagner, Gerd
    and Werner, Frank
    and De Rango, Floriano",
    title="Midas: An Open-Source Framework for Simulation-Based Analysis of Energy Systems",
    booktitle="Simulation and Modeling Methodologies, Technologies and Applications",
    year="2023",
    publisher="Springer International Publishing",
    address="Cham",
    pages="177--194",
    isbn="978-3-031-43824-0"
}

Metadata

Release files for midas-mosaik 2.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for midas-mosaik 2.1.1
File	Size	Uploaded
midas_mosaik-2.1.1.tar.gz	7.3 MB	Sep 22, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for midas-mosaik 2.1.1
File	Interpreter	ABI	Platform	Reset
midas_mosaik-2.1.1-py3-none-any.whl 57.1 kB Sep 22, 2026	Python 3	none	any	Details

Total release size: 7.3 MB

Release files / midas_mosaik-2.1.1.tar.gz

Download URL	midas_mosaik-2.1.1.tar.gz
Size	7.3 MB
Tags	Source
SHA-256 checksum How to use checksums	`78f26b86906258423aa8f4aca7ba0a357cd9d3f8a05475d4679f122694c630cb`
BLAKE2b-256 checksum How to use checksums	`e43aab9e8055947de58718169a9fe325c69d5a9c6cb101f9cfb1c00bc5669bfb`
Upload date	Sep 22, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.12.8`

Release files / midas_mosaik-2.1.1-py3-none-any.whl

Download URL	midas_mosaik-2.1.1-py3-none-any.whl
Size	57.1 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`63f5c479b5693e5d602bd76624246f25ed5fc5baf5d4ae81de5236551906c588`
BLAKE2b-256 checksum How to use checksums	`a54ac7304f3aed2b2814ccda1ab72e4edad24812c10076514b7bba3f415478dd`
Upload date	Sep 22, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.12.8`