The watch command controls run-time tracing of Soar. With no arguments, this command prints out the current watch status. The various options are used to modify the current watch settings. For example, watch -context on turns on the tracing of context slot decisions; watch -context off turns it off again. Individual watch parameters may be changed using this command as well as sets of parameters defined by watch levels. The learn command may also be used to alter certain watch settings.
The following options are allowed (status must be given as either on or off):
The options above allow complete control over individual watch settings. Some settings are often manipulated together and an aggregrate scheme has been generated to help make this process easier. Hence, a watch option can also be one of the following numeric arguments: -1, 0, 0.5, 1, 1.5, 2, 3. The table below gives the corresponding option parameter settings for each numeric argument:
Watch Level: -1 0 0.5 1 1.5 2 3 ---- ---- ---- ---- ---- ---- ---- -context off on on on on on on -phases off off on on on on on -firings nonchunk off off on on on on on -firings-wmes 0 0 0 1 2 2 2 -firings-preferences off off off off off off on -wmes off off off off off on on
watch task is also provided and is equivalent to watch -firings default off.
learn noprint/print/full-print and notrace/trace/full-trace also translate into keyword parameter settings, as shown in the tables below:
Learn: noprint print full-print ------- ----- ---------- -chunk-names off on on -chunks off off on Learn: notrace trace full-trace ------- ----- ---------- -firings chunk off on on -backtracing off off on
watch 0
or
watch 3
Of course, individual options can be changed as well:
watch 1 -justifications off -chunks on