NAME

schedule-interp - Setup a script to be run in the Soar scheduler

SYNOPSIS

schedule-interp -add | -remove -before | -after [name script]

DESCRIPTION

This command schedules a script to be run in a specified interpreter when the Soar scheduler runs. At most, two scripts may be posted: one to run before all the Soar agents in a schedule cycle and another to run after. Posted scripts may also be removed.

The first argument to this command is the option to add or remove a script from the Soar scheduler:

-add
Add a script to the scheduler cycle.
-remove
Remove a script from the scheduler cycle.

The second argument specifies which of the two Soar scheduler events applies:

-before
The script applies to the point in the Soar scheduler just before all the agents are run in a given cycle.
-after
The script applies to the point in the Soar scheduler just after all the agents have been run in a given cycle.

If the -add action has been given, then both a name and script must be given (nothing is given in the -remove case). The name must be the name of an existing interpreter. The script can be any Tcl script.

EXAMPLES

This command is primarily intended to make it easy to use a Tcl simulator in a non-agent interpreter with a set of Soar agents. Hence, if an interpreter named sim contains a simulator written in Tcl and the procedure TickSim updates the simulator, then the following command would schedule the simulator so that it would be ticked after agents are run in each schedule cycle.
schedule-interp -add -after sim TickSim

SEE ALSO

schedule