View source for Documentation/Command Line Interface

== What are CLI modules? ==

"CLI (commandline interface) modules" are standalone tools (for instance, a segmentation algorithm) that offer a commandline interface and a '''--xml''' switch that outputs a ''machine-readable kind of --help'' (XML description of their supported parameters, values, hints, etc.).  This makes it possible to use such CLIs as some kind of "plugins" for rich GUI applications that offer visualization and '''automatically generated GUI panels''' for parameter adjustment.  Also, the whole data handling is left to the host application (which may e.g. implement a batch processing pipeline, running the CLI systematically on all relevant data for a particular study), and it becomes possible to use the '''same algorithm in various different host applications and contexts''', by agreeing on a common standard for the --xml output.

== CTK Support for CLI Modules ==

CTK provides an API for interfacing with such self-describing command line modules, and the XML schema for the parameter description and most of the supported feature set for a module has been adopted from the Slicer Execution Model (the first host where this idea originated).

The API provided by CTK allows the management, GUI generation, and asynchronous execution of such modules in a toolkit-independent and interoperable way. Application writers can rely on the provided libraries and their API to quickly integrate command line modules into their applications.  CTK also comes with an example application, called ctkCommandLineModuleExplorer which can be used to load different kinds of modules, to verify their correctness, to run - and finally inspect their output.

;More information on CTK's support for CLI modules:
: There is [http://www.commontk.org/docs/html/CommandLineModules_Page.html a well-written page in the Doxygen docs] (and a [http://www.commontk.org/docs/html/group__CommandLineModules__Group.html group for the classes]), as well as [[Documentation/CLI Support in CTK|a separate wiki page]].

== Example Applications ==

CLI modules are already supported by a number of host applications, e.g. 3D Slicer, NiftyView / MITK Workbench, GIMIAS, MedInria, MeVisLab, nipype and more.  You can see some examples on the [[Documentation/CLI_In_Context|CLI In Context]] page.

== Background Information / Specs ==

Currently, the CLI module standard is documented as [http://www.slicer.org/slicerWiki/index.php/Slicer3:Execution_Model_Documentation Slicer's Execution Model].  There is an [https://github.com/commontk/CTK/blob/master/Libs/CommandLineModules/Core/Resources/ctkCmdLineModule.xsd XML schema definition] ([http://www.commontk.org/docs/html/ctkCmdLineModule.xsd auto-generated pretty-printed documentation]) that was created retroactively, and not all existing modules strictly follow the spec.  However, one problem is that XSL does not facilitate to specify that e.g. the order of author and description elements is irrelevant, so the schema is more strict than the actual implementation in some respects.

TODO: The standard (Slicer execution model description) should probably be moved to the CTK domain.

== Creating your own CLI modules ==

There is a [https://github.com/Slicer/SlicerExecutionModel "SlicerExecutionModel"] project at GitHub that shall help you with implementing new CLIs, e.g. by offering means to '''automatically parse commandline arguments''' based on the XML spec.

The Slicer documentation also contains instructions on [http://www.slicer.org/slicerWiki/index.php/Documentation/Nightly/Developers/Modules how to extend Slicer via CLI modules] or other means.