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 location
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 location 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 HybridTrajectory with continuous segments and transition events. Sample it explicitly for a trace frame of states, location IDs, and residence times.

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

trajectory = simulate(
    thermostat(),
    t_span=(0.0, 12.0),
    input_stream=lambda _t: np.array([22.0]),
)
frame = trajectory.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