pith. sign in

arxiv: 2604.13690 · v1 · submitted 2026-04-15 · 💻 cs.CE

mosaiks are made of tesserae: GUI design for a co-simulation framework

Eike Schulte , Jan S\"oren Schwarz , Malte Stomberg , Sharaf Alsharif , Danila Valko , Jirapa Kamsamsong This is my paper

Pith reviewed 2026-05-10 12:42 UTC · model grok-4.3

classification 💻 cs.CE
keywords mosaiktesseraeco-simulationgraphical user interfacesimulation scenariosdrag and dropdata flow
0
0 comments X

The pith

Tesserae enable visual creation of co-simulation scenarios in mosaik with automatic data-flow consistency.

A machine-rendered reading of the paper's core claim, the machinery that carries it, and where it could break.

The paper introduces tesserae as sets of entities within the mosaik co-simulation framework. These sets allow entities to be created together and connected between different sets at once. This setup keeps multidirectional data flows consistent automatically. The authors use this to build a graphical user interface for drag-and-drop scenario building and execution. This approach aims to open mosaik to users who avoid scripting while keeping the system's flexibility intact.

Core claim

Tesserae are sets of entities that support collective creation and simultaneous connection between pairs of tesserae. They ensure that multidirectional data-flow between them remains consistent without additional manual synchronization. Based on this concept, the paper presents a GUI extension to mosaik that supports drag-and-drop creation of co-simulation setups and their execution, making the framework accessible to non-scripting users without compromising its flexibility, extensibility, and modular architecture.

What carries the argument

Tesserae, defined as sets of entities in mosaik that allow joint creation and inter-tessera connections with built-in data-flow consistency maintenance.

Load-bearing premise

The addition of the GUI based on tesserae maintains mosaik's flexibility, extensibility, and modular architecture while making it usable by people who do not write scripts.

What would settle it

A demonstration where a user builds a multi-component simulation using the GUI, connects tesserae with bidirectional data flows, and verifies that the simulation runs correctly without any manual data synchronization code would support the claim; failure to maintain consistency would disprove it.

Figures

Figures reproduced from arXiv: 2604.13690 by Danila Valko, Eike Schulte, Jan S\"oren Schwarz, Jirapa Kamsamsong, Malte Stomberg, Sharaf Alsharif.

Figure 1
Figure 1. Figure 1: An example scenario represented using tesserae and connections [PITH_FULL_IMAGE:figures/full_fig_p001_1.png] view at source ↗
Figure 2
Figure 2. Figure 2: Triangle of tesserae consisting of PV systems, controllers for those [PITH_FULL_IMAGE:figures/full_fig_p003_2.png] view at source ↗
Figure 3
Figure 3. Figure 3: The example scenario being edited in the mosaik GUI. The wind plants tessera is selected and its settings are visible in the right sidebar. [PITH_FULL_IMAGE:figures/full_fig_p004_3.png] view at source ↗
Figure 4
Figure 4. Figure 4: Architecture of the mosaik GUI. are written by us, keeping the core Python-based and not forc￾ing any changes to the simulators were also strict requirements. Therefore, the mosaik-orbit package is implemented in Python. It provides access to the mosaik orbit and the mosaik world contained within, as well as to the result of the baking via websockets. This architecture is visualized in [PITH_FULL_IMAGE:fi… view at source ↗
Figure 3
Figure 3. Figure 3: Sidebar The sidebar on the left side lists available simulators and allows to add simulators to the scenario. Also, the current state of the connection to the mosaik orbit and the state of the scenario baking process is displayed. Scenario view In the center, the scenario view contains the tesserae and the connections. Each tessera is represented by a hexagonal element. Tesserae can be moved and connection… view at source ↗
read the original abstract

In a mosaic, a tessera is a single stone. We introduce tesserae for the co-simulation framework mosaik, where they are sets of entities. They allow for a visual, intuitive, and yet systematic description of simulation scenarios by allowing their entities to be created together and the entities of two tesserae to be connected simultaneously, while ensuring that multidirectional data-flow between tesserae remains consistent without further manual synchronization. We further present an extension of mosaik by a graphical user interface (GUI) based on these tesserae, enabling the drag-and-drop creation of co-simulation setups and their execution. The GUI aims to make mosaik more accessible to users previously excluded by its script-based nature. At the same time, it preserves mosaik's flexibility, extensibility, and modular architecture.

Editorial analysis

A structured set of objections, weighed in public.

Desk editor's note, referee report, simulated authors' rebuttal, and a circularity audit. Tearing a paper down is the easy half of reading it; the pith above is the substance, this is the friction.

Referee Report

1 major / 2 minor

Summary. The paper claims that tesserae, defined as sets of entities in the mosaik co-simulation framework, enable a visual, intuitive, and systematic description of simulation scenarios by supporting batch creation of entities within a tessera, simultaneous connections between entities from two tesserae, and automatic maintenance of consistent multidirectional data-flow between tesserae without manual synchronization. It further presents a GUI extension based on tesserae that supports drag-and-drop creation and execution of co-simulation setups, with the aim of improving accessibility for non-scripting users while preserving mosaik's flexibility, extensibility, and modular architecture.

Significance. If implemented and validated as described, the tesserae abstraction and associated GUI could moderately advance the usability of co-simulation frameworks like mosaik by reducing the scripting barrier for domain experts in areas such as energy systems modeling. This might expand the tool's adoption without altering its core scheduler or modularity. However, the absence of any implementation specifics, examples, or validation in the manuscript makes the practical significance difficult to assess at present.

major comments (1)
  1. [Abstract] Abstract: The central claim that tesserae ensure 'multidirectional data-flow between tesserae remains consistent without further manual synchronization' is load-bearing for the proposed benefits, yet the manuscript provides no description of the underlying mechanism, data structures, or verification approach that would enforce or demonstrate this consistency property.
minor comments (2)
  1. The manuscript would benefit from at least one concrete usage example or diagram illustrating a tessera-based scenario and the drag-and-drop GUI workflow to make the design claims tangible.
  2. No discussion of related GUI tools for co-simulation or similar entity-grouping abstractions in other frameworks is included, which would help situate the novelty of the tesserae approach.

Simulated Author's Rebuttal

1 responses · 0 unresolved

We thank the referee for their thoughtful review and constructive feedback on our manuscript. We address the major comment below and outline the revisions we will make to strengthen the presentation of the tesserae consistency mechanism.

read point-by-point responses

  1. Referee: The central claim that tesserae ensure 'multidirectional data-flow between tesserae remains consistent without further manual synchronization' is load-bearing for the proposed benefits, yet the manuscript provides no description of the underlying mechanism, data structures, or verification approach that would enforce or demonstrate this consistency property.

    Authors: We agree that the manuscript would benefit from an explicit description of the mechanism supporting this property. The consistency arises because tesserae define connections at the group level: when two tesserae are linked via drag-and-drop in the GUI, the system instantiates a complete bipartite set of entity-to-entity connections while automatically propagating attribute mappings in both directions. This is implemented through a TesseraConnection object that stores source and target tessera references, a connection template (specifying which attributes flow in which direction), and a flag for automatic synchronization. Upon execution, the mosaik scheduler uses these templates to route data without requiring per-entity manual setup. In the revised manuscript we will add a dedicated subsection (new Section 3.2) containing: (i) the data-structure definitions, (ii) pseudocode for the connection instantiation and synchronization logic, and (iii) a small worked example with a diagram showing how multidirectional flow is preserved. We will also include a brief verification note based on the existing mosaik test suite that checks for attribute consistency after tessera-level connections. revision: yes

Circularity Check

0 steps flagged

No significant circularity

full rationale

The paper is a software design description introducing tesserae as sets of entities in mosaik and a GUI for drag-and-drop scenario creation. It contains no equations, fitted parameters, derivations, or predictions. The central claims (batch entity creation within tesserae, simultaneous inter-tessera connections, and automatic multidirectional data-flow consistency) are definitional properties of the proposed abstraction, not results derived from prior steps that could reduce to inputs by construction. No self-citations are load-bearing for any mathematical or predictive claim, and the work is self-contained as an architectural proposal without opportunity for circular reasoning.

Axiom & Free-Parameter Ledger

0 free parameters · 0 axioms · 1 invented entities

The contribution rests on the newly introduced tesserae abstraction and the assumption that a GUI can be added without compromising the framework's core properties; no formal axioms or external benchmarks are invoked.

invented entities (1)
  • tesserae no independent evidence
    purpose: Sets of entities that can be created and connected together while maintaining consistent multidirectional data flow
    Newly defined abstraction introduced to support visual scenario description in mosaik.

pith-pipeline@v0.9.0 · 5464 in / 1157 out tokens · 46209 ms · 2026-05-10T12:42:42.090685+00:00 · methodology

discussion (0)

Sign in with ORCID, Apple, or X to comment. Anyone can read and Pith papers without signing in.

Reference graph

Works this paper leans on

11 extracted references · 11 canonical work pages

  1. [1]

    CPES testing with mosaik: Co-simulation planning, execution and analysis,

    C. Steinbrink, M. Blank-Babazadeh, A. El-Ama, S. Holly, B. L ¨uers, M. Nebel-Wenner, R. Ram´ırez Acosta, T. Raub, J. S. Schwarz, S. Stark, A. Nieße, and S. Lehnhoff, “CPES testing with mosaik: Co-simulation planning, execution and analysis,”Applied Sciences, vol. 9, no. 5, p. 923, 2019. [Online]. Available: https://doi.org/10.3390/app9050923

    work page doi:10.3390/app9050923 2019

  2. [2]

    MOSAIK 3.0 : Combining time stepped and discrete event simulation,

    A. Ofenloch, J. S. Schwarz, D. Tolk, T. Brandt, R. Eilers, R. Ramirez, T. Raub, and S. Lehnhoff, “MOSAIK 3.0 : Combining time stepped and discrete event simulation,” in1st International Workshop on ”Open Source Modelling and Simulation of Energy Systems”, Aachen,

    work page

  3. [3]

    Available: https://doi.org/10.1109/OSMSES54027.2022

    [Online]. Available: https://doi.org/10.1109/OSMSES54027.2022. 9769116

    work page doi:10.1109/osmses54027.2022 2022

  4. [4]

    A comparison study of co-simulation frameworks for multi-energy systems: the scalability problem,

    L. Barbierato, P. Rando Mazzarino, M. Montarolo, A. Macii, E. Patti, and L. Bottaccioli, “A comparison study of co-simulation frameworks for multi-energy systems: the scalability problem,” Energy Informatics, vol. 5, p. 53, 12 2022. [Online]. Available: https://doi.org/10.1186/s42162-022-00231-6

    work page doi:10.1186/s42162-022-00231-6 2022

  5. [5]

    On conceptual structuration and coupling methods of co-simulation frameworks in cyber-physical energy system validation,

    V . H. Nguyen, Y . Besanger, Q. T. Tran, and T. L. Nguyen, “On conceptual structuration and coupling methods of co-simulation frameworks in cyber-physical energy system validation,”Energies, vol. 10, no. 12, 2017. [Online]. Available: https://doi.org/10.3390/ en10121977

    work page 2017

  6. [6]

    HELICS: A co-simulation framework for scalable multi-domain modeling and analysis,

    T. D. Hardy, B. Palmintier, P. L. Top, D. Krishnamurthy, and J. C. Fuller, “HELICS: A co-simulation framework for scalable multi-domain modeling and analysis,”IEEE Access, vol. 12, pp. 24 325–24 347, 2024. [Online]. Available: https://doi.org/10.1109/ACCESS.2024.3363615

    work page doi:10.1109/access.2024.3363615 2024

  7. [7]

    aiomas documentation,

    S. Scherfke, “aiomas documentation,” https://aiomas.readthedocs.io, 2014, accessed: 2025-12-05

    work page 2014

  8. [8]

    Test- und simulationsumgebung f¨ur betriebsf ¨uhrungen und aggregatoren im smart-grid (opsim),

    C. T ¨obermann, M. Braun, N. Asanalieva, K. Brauns, K. Diwold, D. Fetzer, and F. A. Florez Alzate, “Test- und simulationsumgebung f¨ur betriebsf ¨uhrungen und aggregatoren im smart-grid (opsim),” 2018. [Online]. Available: https://doi.org/10.2314/GBV:1029773750

    work page doi:10.2314/gbv:1029773750 2018

  9. [9]

    An efficient co-simulation and control approach to tackle complex multi-domain energetic systems: concepts and applications of the PEGASE platform,

    M. Vallee, R. Baviere, V . Seguin, V . Vuillerme, N. Lamaison, M. N. Descamps, and A. Aurousseau, “An efficient co-simulation and control approach to tackle complex multi-domain energetic systems: concepts and applications of the PEGASE platform,” 2025. [Online]. Available: https://arxiv.org/abs/2506.15195

    work page arXiv 2025

  10. [10]

    Daccosim NG: co-simulation made simpler and faster,

    J. Evora-Gomez, J. J. Hernandez Cabrera, j.-p. Tavella, S. Vialle, E. Kremers, and L. Frayssinet, “Daccosim NG: co-simulation made simpler and faster,” inProceedings of the 13th International Modelica Conference, 02 2019, pp. 785–794. [Online]. Available: https://doi.org/10.3384/ecp19157785

    work page doi:10.3384/ecp19157785 2019

  11. [11]

    librosa/librosa: 0.6.3,

    C. Seiwerth, J. S. Schwarz, L. Fuentes Grau, R. German, S. Lehnhoff, A. Monti, and A. Nieße, “Towards a simulation-as-a-service hub for the energy domain,” in2. NFDI4Energy Conference, Karlsruhe. Zenodo, Mar. 2025. [Online]. Available: https://doi.org/10.5281/zenodo. 15065996

    work page doi:10.5281/zenodo 2025