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)