SimpleSimulator

Mathematical Model Simulator — a JavaFX-based application to visualize, simulate, and analyze mathematical models interactively.

Project Description & Functionalities

This tool allows users to explore mathematical models, input parameters, and observe the resulting simulations in real time. Key features:

• Dynamic Elements: Stocks, Flows, Coefficients, Relations

• Custom Formulas: Define behavior using mathematical expressions

• Predefined Models: Includes sample models for quick start

• Real-time Simulation: Table & chart updates as simulation runs

• Export: Save diagrams as PNG for documentation or assignments

• Interactive GUI: Drag, rename, edit, and connect elements visually

Interface Overview

Quickstart Guide

1.Building from Source

Requirements

• Java 17 (JDK or JRE)

• Maven

Steps

1.Clone or download the project, then in the project root:

mvn clean install

2.Running the Application

After building, run the application from the IDE or via command line:

mvn javafx:run

or just execute the generated JAR in the target folder:

java -jar target/simplesimulator-1.0.jar

⚠️ Note on JavaFX Runtime

The current setup exports a fat/uber JAR that includes most dependencies. However, if you still see the error:

JavaFX runtime components are missing, and are required to run this application

this means your system’s Java does not have JavaFX available. In that case, follow these steps:

1. Download JavaFX SDK 17: From Gluon or your preferred source.

2. Unzip it to a folder (for example C:\javafx-sdk-17.0.17).

3. Run the application using the module path:

java --module-path "C:\javafx-sdk-17.0.17\lib" --add-modules javafx.controls,javafx.fxml,javafx.swing -jar target/simplesimulator-1.0.jar

This ensures the JavaFX runtime is available even if it wasn’t bundled in the JAR.

2.Running via Executable

For convenience, an executable version of the application is available, which includes a bundled JRE. This allows you to run the application out of the box without additional setup.

Download the executable here

To use the executable, simply rename the file extension from .zi_ to .zip and extract it.

Happy Modeling! :)