The karpfen runtime is a server that runs karpfen models. A client uploads a metamodel, a model, event definitions and state machines over HTTP, runs them, sends events and watches the model change over a WebSocket.
| Section | Content |
|---|---|
| 3 Execution | What the runtime is and the life of an environment |
| 3.1 Execution semantics | Ticks, transitions, actions, events, splits and joins, histories, tick limits |
| 3.2 Runtime features | Histories, tick limits, stepping, breakpoints, recording and replaying events |
| 3.3 Running the runtime | Starting the runtime, application.conf and the trace log |
| 3.4 HTTP API | An overview of the HTTP API. Every route with its answers and errors is in docs/http-api.md |
| 3.5 WebSocket | An overview of the WebSocket. Connecting, sending events and every pushed message are in docs/websocket.md |
| 3.6 Examples | The example models in examples |
| Developing the runtime | Structure, main classes, building and testing |
The table of all chapters of the karpfen reference is in the karpfen-IDE repository.
The runtime reads KMeta, KModel and KStates with the library
karpfen-dsl-tools in version 2.0. The library is the git
submodule karpfen-dsl-tools, so clone with --recurse-submodules. The languages are described in the reference of
the library:
A simulation of a cyber-physical setting with several concurrent state machines and a world model is in the Turtle Robot Demo.
Licensed under the Apache License, Version 2.0. See LICENSE for details.
Parts of this project have been developed with the help of generative AI.