Differences

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

--- user-guide:additional_interfaces:cli [2025/01/17 09:08] – Tim
+++ user-guide:additional_interfaces:cli [2025/01/22 15:48] (current) – [More documentation] Tim
@@ Line 1: / Line 1: @@
-===== CLI User guid=====
+===== CLI =====
-The CLI (command line interface) of GroIMP, can be used to interact with multiple projects without the need of a graphical user interface. This makes it a valuable feature especially on remote server or for small changes. It syntax of the commands is oriented on basic linux command.
+GroIMP can be started without its graphical interface, with a CLI. Unlike the Headless mode, the CLI enables interaction with multiple the models during run time including opening and closing models, running simulations, editing RGG files etc. Its a valuable feature especially on remote server or for small changes. It syntax of the commands is oriented on basic linux command.
+<uml>@startuml
+!pragma teoz true
+hide footbox
+title CLI
+participant User
+participant "Interactive command line" as cli
+participant GroIMP
+User -> GroIMP: Start GroIMP
+cli<-> GroIMP
+& User <-> cli
+@enduml</uml>
 ===== Installation & Execution =====
@@ Line 16: / Line 32: @@
-Then, to create the default new rgg template project, type ''$createWB''.
-You can now run the model with `run`, reset with ''compile'', or export the 3d view with ''export3d /path/to/file.x3d''.
+===== Structure =====
-You can also open your own project with ''$open /path/to/model.gsz''.
+==== Projects ====
-**Note: the command ''$help'' lists most of the available commands with a description**
+The CLI can be used to manage multiple workbenches. The currently used workbench is defined in the prefix of the command line:
+ [**myProject**]%%>>%%
-===== Tutorial =====
+After starting the CLI the first workbench is always "base", which is similar to the empty window when starting the GUI. This workbench cant do much more then creating or opening other projects.
-You can have a look at [[:tutorials:Startup-CLI-model|this tutorial]] for more information.
+==== Commands ====
-===== Commands =====
+The commands to interact with GroIMP and the proejcts are sorted by level of usage. There is currently three levels:
-The commands are sorted by level of usage. There is currently three levels: at application, window, or workbench level.
+  * application for managing the different projects and for basic interaction with the operation system
+  * window for managing the panels(the cli version) of the current workbench
+  * workbench for editing and execution the current project as well general project management
+The list can be found below.
+===== More documentation =====
+  * [[:user-guide:additional_interfaces:cli | CLI user guid]]
+    * [[:user-guide:additional_interfaces:cli#list_of_commands|List of CLI commands]]
+  * [[:groimp-platform:interfaces:cli|CLI implementation]]
+  * [[https://wkurth.grogra.de/oberlaender_msc.pdf| GroLink: implementing and testing a general application programming interface for the plant-modelling platform GroIMP]]
+===== Tutorials =====
+  * [[:tutorials:startup-cli-model|Getting started with CLI]]
+===== List of Commands =====
+The commands are sorted by level of usage. There is currently three levels: at application, window, or workbench level. The first character of a command indicates at which level it should be executed.
+**Note: the command ''$help'' lists most of the available commands with a description**
-The first character of a command indicates at which level it should be executed.
 | **App commands ($)**                                                       |                                                  |