This command creates new Soar interpreters identified by given names. The various options specify any special initialization conditions, if any. The most important option is the type which indicates what type of interpreter is to be created and must be one of the following values:
One or more names may be given after the above types. If no type is given on the command line when Soar is invoked, a single -agent interpreter is created with the name soar. Within Soar, it is an error to call this command without specifying some interpreter name to create.
Tk is enabled if Soar has been compiled with the USE_TK option, the $DISPLAY environment variable is set, and the -noTk option has not been given on the command line (see below).
Once the Soar Tcl/Tk system has started, the command create-interp can be used to add additional interpreters.
The following example starts Soar with two agents named fred and wilma and a single wish interpreter named bedrock. This setup might be used to run a simulator in the wish interpreter bedrock that the agents fred and wilma can interact in.
soartk -agent fred wilma -wish bedrock
The next example is similar to the one above, except that the simulator display will be moved to the X display sgi1:0.0. Also, the switch -v has been added to indicate that we want detailed information about defined options as each interpreter is created. Note that all option names may be abbreviated to any prefix which uniquely distinguishes it from the other options.
soartk -v -agent fred wilma -display sgi1:0.0 -wish bedrock
This example has the extra option -foo bar. Since this is not recognized as a valid command line option, it is passed on to each interpreter defined on the command line. This information appears in the Tcl variable argv and can be used to pass startup information to user-defined Tcl procedures.
soartk -foo bar -agent fred wilma -wish bedrock