User Tools

Site Tools


user-guide:additional_interfaces:headless

This is an old revision of the document!


GroIMP headless user guide

GroIMP can be started without its graphical interface, in a non interactive headless mode. This mode can either execute a specified model and or a specified GroIMP command and can therefore be used for simple automation or as a base for e.g. the HTTP server.

Running a model headless

To execute a given model in headless the additional parameter –headless is used:

java -Xverify:none -jar core.jar --headless /path/to/your/model.gsz

This will return a list of all installed plugins including versions and then start the model. Any further actions must be defined in the code of the Model, including the steps of the simulation, the way data is printed/exported and the closing of the workbench at the end.

For the automated starting of the simulation overwriting the startup function of the simulation is recommended.

Executing a command headless

Tutorial

You can have a look at this tutorial for more information. Further a tutorial for using command line parameters in the model can be found here

You can find an example here.

user-guide/additional_interfaces/headless.1737123676.txt.gz · Last modified: 2025/01/17 15:21 by Tim