Differences

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

--- user-guide:additional_interfaces:cli [2025/01/17 09:15] – [Installation & Execution] 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 18: / Line 34: @@
 ===== Structure =====
+==== Projects ====
 The CLI can be used to manage multiple workbenches. The currently used workbench is defined in the prefix of the command line:
@@ Line 24: / Line 42: @@
 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.
+==== Commands ====
+The commands to interact with GroIMP and the proejcts are sorted by level of usage. There is currently three levels:
+  * 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]]
-===== Tutorial =====
-You can have a look at [[:tutorials:Startup-CLI-model|this tutorial]] for more information.
+===== List of Commands =====
-===== 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.
-The commands are sorted by level of usage. There is currently three levels: at application, window, or workbench level.
+**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 ($)**                                                       |                                                  |