Running from the Command Line
Nameikaros - runs the Ikaros system
ikaros [options][attribute="value"] control_file
The ikaros command start the execution of Ikaros with the files specified. Typically, a single control file is used.
Ikaros catches CTRL-C and will attempt to terminate gracefully. A second CTRL-C will terminate Ikaros immediately.
|-a||List all; implies -m -l and -T (if -t is set).|
|-b#||Run batch #.|
|-B||Run in batch mode.|
|-c||List installed classes.|
|-i||list installed functionality: sockets, timer etc, type of target system.|
|-m||List modules and connections.|
|-n||Check that no outputs contains NANs. This option will slow down Ikaros somewhat but is useful for debugging to locate numerical problems such as division by zero etc.|
|-p||Print profiling data after execution. This option will list all modules and how much time they have used (in real time).|
|-r#||Run in real-time mode with time base # ms.|
|-s#||Stop after # ticks.|
|-t||Use threads. This option will create a separate thread for each set of modules with zero-delay connections between them.|
|-T||Use threads and list thread allocation.|
|-u#||Number of ticks to run for each step in the WebUI.|
|-w#||Start WebUI at port #. If -w is specified without a port number port 8000 will be used.|
|-W#||Start WebUI in debug mode at port #; lists all HTTP requests|
|-x||List xml after parsing. This option is useful for debugging and prints the internal XML-tree built from the supplied ikc-file.|
|-X||Debug xml parser; print tokenizer data.|
|-z#||Seed random number generator.|
These options are listed when Ikaros is started without any arguments. Each option must be a listed separately with its own - sign.
To run Ikaros, cd to the /Bin directory and write the following to start up ikaros with the WebUI.
./ikaros -w8000 ../Examples/WebUI-Demos/web_ui_objects.ikc
Start Chrome and use the URL 127.0.0.1:8000 to view some examples of output that Ikaros can produce.
In addition to setting different options, it is also possible to set paramaters directly at the command line using the following syntax:
ikaros test.ikc alpha="0.1"
This will set the parameter alpha to 0.1 for all modules that do not set this value in the ikc file. The citation characters can be omitted if there are not white space in the attribute value:
ikaros test.ikc alpha=0.1
This will start up Ikaros with the model described in the file test.ikc.
ikaros -w9000 test.ikc
This will start up Ikaros with the file test.ikc in paused mode where Ikaros will wait for commands on port 9000. This option are usually only used by the WebUI when it starts Ikaros.
ikaros -r100 test.ikc
This will start up Ikaros with the file test.ikc in real-time mode and execute ten ticks every second (i.e. 100ms per tick).
|1||Memory allocation error|
A separate '-' is required for each option.
Copyright © 2001-2011 Christian Balkenius