Skip to content

Open-source research framework

Model how
systems behave.

A Python framework for learning, simulating, and evaluating models of cyber-physical systems.

Install from PyPI
pip install flowcean
Hybrid system example

Thermostat / simulation

System temperature
20.00°C
Heating / active mode
T ≥ 23°C T ≤ 21°C HEATING COOLING
Simulated temperature Target 22°C
Thermostat simulation trace Temperature begins at 20 degrees Celsius and cycles between heating at 21 and cooling at 23 around a 22-degree target. Five mode transitions occur over 12 model-time units. 23°22°21°20°036912
t = 0.00 / 12.00model time
Precomputed Flowcean simulationBenchmark gallery

Modeling approaches

Data-driven and
explicit models.

Data-driven learning

Train models from recorded datasets, incremental streams, or interactions with an active environment.

Learning strategies

Hybrid-system modeling

Specify continuous dynamics, event surfaces, and resets, then simulate the resulting hybrid system.

Hybrid systems guide

Python example

Simulate a built-in system.

thermostat() creates a benchmark system. simulate() runs it with an input signal and returns a Trace containing the state history, active modes, and transition events.

Simulation guide
thermostat.pyPython
import numpy as np
from flowcean.hybrid import simulate
from flowcean.hybrid.benchmarks import thermostat

trace = simulate(
    thermostat(),
    t_span=(0.0, 12.0),
    input_stream=lambda _t: np.array([22.0]),
    sample_dt=0.05,
)

Framework components

Modeling and evaluation.

Environments supply data, transforms prepare it, learning strategies train models, and metrics evaluate their behavior.

Learning components

Research

Project and publications.

Flowcean was developed as part of the AGenC research project on automatic model generation for cyber-physical systems.

AGenC research project
  1. ETFA / 2023

    Towards the Automatic Generation of Models for Prediction, Monitoring, and Testing of Cyber-Physical Systems

    IEEE International Conference on Emerging Technologies and Factory Automation
  2. AIABI at AIxIA / 2024

    Flowcean - Model Learning for Cyber-Physical Systems

    Italian Workshop on Artificial Intelligence and Applications for Business and Industries · ArXiv abs/2603.12015
BMBFBMBF

This work has been funded by
BMBF project AGenC no. 16IS22047A.

Impressum