NAME

go - Run Soar

SYNOPSIS

go [n] [unit]

DESCRIPTION

This command runs Soar. n is a single integer which specifies the number of times to run Soar. If n is the single keyword forever, then Soar is run until halted by problem-solving completion or an external interrupt. The unit argument indicates the unit of measure to be used in counting Soar run cycles. unit must be one of the following keywords:

p
run Soar for n phases. A phase is either an input phase, preference phase, working memory phase, output phase, or decision phase.
e
run Soar for n elaboration cycles. (For purposes of this command, decision phase is counted as an elaboration cycle.)
d
run Soar for n decision cycles
s
run Soar until the nth time a state is selected
o
run Soar until the nth time an operator is selected
context-variable
run Soar until the nth time a selection is made for that particular context slot, or until the context stack pops to above that context. Permissable context-variables include <s> and <o>, which represent the current state and operator, respectively. The parent context can be accessed by prefixing s to each of the above variables: <ss> and <so>. <ss> refers to the superstate. Finally, the grandparent context can be accessed by prefixing another s to each of the parent context variables: <sss> and <sso>. So <sss> refers to the super-superstate which is the state in the parent's parent context.

The go command remembers each argument you give it each time. If you don't give arguments next time, it uses the ones from the previous time.

EXAMPLES

Here are several examples in sequence:
go 5 d
run for 5 decision cycles
go e
run for another 5 elaboration cycles
go 1 s
run until the next state is selected (i.e., until the next time an impasse arises)
go <so>
run until the next superoperator is selected (or until the supergoal goes away)
go 3 <o>
run for 3 operator selections at this level (continuing through any subgoals that arise)