This is an old revision of the document!
Table of Contents
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.