PetriObjModelPaint

A graphical editor and simulator for Petri nets and Petri-object models.

Draw a net, or frame parts of it as linked Petri-objects to compose a larger model, then run it with live animation, watch the statistics, and exchange it as PNML.

---

Tip

Just want to use the app? Grab the ready-made editor, no source build required: Windows · Linux · macOS (or browse the latest release page for other versions). Unzip it and run the launcher inside (.bat / .sh / .command): it checks for Java 23+ and points you to the official download if it's missing.

Note

Want to contribute? Open an issue to discuss the change first, then create a branch, open a pull request against master, and follow the steps in CONTRIBUTING.md.

This is a multi-module Maven project:

Module	Purpose
petri-math	Core simulation engine
petri-api	Interfaces and DTOs (shared contract)
petri-model	Graph model, PNML parser
petri-swing-ui	Desktop editor (Swing, fat JAR)
petri-server	Spring Boot REST + WebSocket server

---

Two ways to run it

Desktop UI (Swing)	Self-contained visual editor and simulator, no server required
Server (Spring Boot)	REST + SSE + WebSocket API for running simulations from external systems

Both run the same model underneath, whether it's a single net or several composed into a Petri-object model.

Desktop UI.

mvn package -DskipTests

java -jar petri-swing-ui/target/petri-swing-ui.jar

Draw a net, run it with live animation, watch statistics charts, save nets to the net library and import/export PNML. Frame parts of a drawing as Petri-objects, link them across frame borders, and animate the whole composition on one canvas.

Server.

mvn package -DskipTests

java -jar petri-server/target/petri-server.jar
# or: mvn spring-boot:run -pl petri-server

Starts at http://localhost:8080, interactive docs at http://localhost:8080/docs. /api/v1 runs a single net; /api/v2 runs a Petri-object model and reports statistics per object.

---

Petri-object simulation technique

PetriObjModelPaint is the project of Petri-object simulation technique implementation. Petri-object simulation technique, the main concept of which is to compose the code of model of complicated discrete event system in a fast and flexible way, simultaneously providing fast running the simulation, is requisite. The behaviour description of the model is based on stochastic multichannel Petri net while the model composition is grounded on object-oriented technology. The Petri-object simulation software provides a scalable simulation algorithm, graphical editor, correct transformation of graphical images into a model, and correct simulation results.

In code terms, this technique lives in the petri-math module (PetriObjModel, PetriSim, PetriP, PetriT, NetLibrary): a Petri-object is built with class PetriSim from a Petri net, and one net drawn in the graphical editor and saved to the net library is reused to create a whole group of Petri-objects, either with the same parameters or with different ones passed through the Petri-object's constructor. Several Petri-objects are then composed into a model by declaring links between them: a place shared by two objects, or a transition of one object feeding a place of another. Once the list of Petri-objects is prepared and the links are set, the model is assembled with PetriObjModel, whose go(double time) method runs the simulation. petri-model carries the same model at graph level, so a composition is drawn in the editor, stored as a single PNML document and replayed by the server.

---

Requirements

• Java 23+
• Maven 3.9+

---

Build

mvn package -DskipTests

Output:

• petri-swing-ui/target/petri-swing-ui.jar
• petri-server/target/petri-server.jar

---

Documentation

Guide	What it covers
Desktop UI	Editor, animation controls, statistics module, Petri-objects on the canvas, net library, PNML import/export
Petri-object models	Objects and links, composing a model in the editor, the PNML form, running one from code or over HTTP
Server integration	REST API reference, SSE streaming, WebSocket/STOMP, session control, PNML requirements, the Petri-object model API

---

Project Structure

PetriObjModelPaint/
├── petri-math/        # Simulation engine (PetriObj, LibNet, utils)
├── petri-api/         # Interfaces and DTOs
├── petri-model/       # Graph model, PNML, config
├── petri-swing-ui/    # Swing desktop editor
├── petri-server/      # Spring Boot server
└── pom.xml            # Parent POM

---

Web app

petri-net-sim web app: an agent-powered super-app for building, generating and simulating Petri nets in the browser, with AI features at its core. Describe a production or queueing system in plain language and an AI agent composes it into a net from a catalog of reusable patterns; then edit it in the live graph editor, run stochastic simulations and exchange models with this project over PNML.

---

License

This project is licensed per module (see the LICENSE file in each module directory):

Modules	License
petri-math, petri-api, petri-model	MIT
petri-swing-ui, petri-server	PolyForm Noncommercial 1.0.0

The simulation engine and model libraries stay free for any use, including commercial. The desktop editor and the simulation server may be used for noncommercial purposes only: personal use, research, education, and use by noncommercial organizations are all permitted. For commercial licensing of these modules, contact inna.stetsenko-fiot@edu.kpi.ua or sergey24rybak@gmail.com.