This command prints Soar internal statistics. The module indicates the component of interest. If specified, module must be one of -system, -memory, or -rete. If no specific statistic is given for the specified module, then all statistics are listed for that module. If no module is given, then the -system statistics are listed.
The -system module contains the following statistics:
-default-production-count -user-production-count -chunk-count -justification-count -all-productions-count -dc-count -ec-count -ecs/dc -firings-count -firings/ec -wme-change-count -wme-addition-count -wme-removal-count -wme-count -wme-avg-count -wme-max-count
If Soar has been compiled with the NO_TIMING_STUFF NOT set, then the following statistics are also available in the -system module:
-total-time -ms/dc -ms/ec -ms/firing -ms/wme-change
If Soar has been compiled with the DETAILED_TIMING_STATS SET, then the following statistics are also available in the -system module:
-match-time -ownership-time -chunking-time -o-support-time -instantiations-time -other-pref-phase-time
The -memory module contains the following statistics:
-total -overhead -strings -hash-table -pool pool-statistic -misc
The -pool statistic is additionally qualified by a pool-statistic option. If this option is not given, then all -memory pool statistics are printed. If given, pool-statistic must have one of the following forms:
chunk condition io wme output link preference wme slot instantiation ms change right mem negative token token node varnames rete node rete test alpha mem saved test not action production condition complex test float constant int constant sym constant identifier variable dl cons cons cell
If no aspect is given, then print all statistics about the given pool. If given, aspect must have one of the following forms:
-used -free -item-size -total-bytesThe first two aspects are available only if Soar has been compiled with MEMORY_POOL_STATS SET.
The -rete module contains statistics for the following node types:
unhashed memory memory unhashed mem-pos mem-pos unhashed negative negative unhashed positive positive dummy top dummy matches conj. neg. conj. neg. partner production totalThe total statistic gives a total count over all node types.
A -rete statistic is obtained by specifying one of the above nodes followed by a qualifier. The qualifier is one of -actual, -if-no-merging, and -if-no-sharing. The -if-no-sharing option is only available if Soar has been compiled with the SHARING_FACTORS option SET.
stats -system
This prints the number of io wme's:
stats -memory -pool {io wme} -usedNote that this particular pool name, "io wme", contains an embedded space character. Hence, the name must be surrounded by curly braces or double quotes to override the normal Tcl parsing of words separated by whitespace. This is not necessary for pool names that do not include spaces:
stats -memory -pool wme -used
This prints the actual number of unhashed negative nodes in the Rete memory:
stats -rete {unhashed negative} -actual