Differences

This shows you the differences between two versions of the page.

--- user-guide:additional_interfaces:headless [2025/01/17 15:21] – Tim
+++ user-guide:additional_interfaces:headless [2025/01/22 15:48] (current) – [Further Info] Tim
@@ Line 1: / Line 1: @@
-====== GroIMP headless user guide ======
+====== Headless mode ======
 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 [[user-guide:additional_interfaces:http|HTTP server]].
+<uml>
+@startuml
+hide footbox
+title Headless
+User -> GroIMP: Start GroIMP with model
+GroIMP -> User: Print log & close GroIMP
+@enduml
+</uml>
+If a model is started in headless, GroIMP executes it,logs the console output and afterwards shut down. Capturing any feedback from the simulation must be included in the model.
 ==== Running a model headless ====
@@ Line 20: / Line 32: @@
 ==== Executing a command headless ====
+GroIMP is capable of executing any registry command on startup, if this command is provided as full path using the additional command line argument: %%'-- -cmd "/path/to/command" '%%.
+This is mostly used to start the [[user-guide:additional_interfaces:http|HTTP server]] but also combining this with a provided model is possible as shown [[https://wwwuser.gwdguser.de/~groimp/grogra.de/gallery/Technics/renderHeadlessDemo2.html | here]].
+====  More documentation ====
+  * [[:groimp-platform:interfaces:headless|Headless implementation]]
+  * [[:user-guide:advanced-groimp-arguments|Common command line arguments]]
+==== Tutorials ====
-==== Tutorial ====
+  * [[:tutorials:startup-headless-model|Getting started with headless]]
+  * [[:Tutorials:xparametric-model|Forwarding command line arguments to simulations]]
-You can have a look at [[:Tutorials:Startup-headless-model|this tutorial]] for more information.
+  * [[https://wwwuser.gwdg.de/~groimp/grogra.de/gallery/Technics/renderHeadlessDemo.html|renderHeadlessDemo]].
-Further a tutorial for using command line parameters in the model can be found [[:Tutorials:xparametric-model|here]]
-You can find an example
-[[https://wwwuser.gwdg.de/~groimp/grogra.de/gallery/Technics/renderHeadlessDemo.html|here]].