NAME

soartk - Soar system with Tk extension

SYNOPSIS

soartk [options]

DESCRIPTION

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:

-agent
Create agent interpreter(s). This includes Tcl + Tk + Soar if Tk is enabled, otherwise this includes Tcl + Soar.
-wish
Create wish interpreter(s). Wish includes Tcl + Tk. This is available only if Tk is enabled.
-tclsh
Create tclsh interpreter(s). Tclsh includes only Tcl.

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.

OPTIONS

Environment variables used below are assumed to be defined in the Unix shell used to start Soar.
-path
Use the given sequence of directories to scan for agent initialization files. The sequence is a colon (:) separated list of directories. The default value is ".:$HOME", where $HOME is the user's home directory. Agent initialization files are assumed to be named name.soar.
-display
Place the top-level window associated with the interpreter on the indicated display. The value of this option follows standard X conventions for specifying displays. The default is the value of $DISPLAY. This only applies to wish-based shells.
-file
Specifies a file to run immediately after defining the last interpreter. This only applies when invoking Soar.
-geometry
Specifies the geometry (width, height, and placement) of the top-level window associated with the interpreter. The value of this option follows standard X conventions for specifying geometries. This only applies to wish-based shells.
-help
Lists all available options for this command.
-noTk
Do not use Tk when creating any subsequent interpreters. This option applies to the rest of the command line.
-sync
Use synchronous X server updates with all subsequent wish-based interpreter windows. This applies only to wish-based shells.
-verbose
Print diagnostic information about options as each interpreter is defined.

EXAMPLES

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