- summary preferences command documentation
Examine details about the preferences that support the specified _identifier_ and _attribute_.
|| `pref` || `preferences` ||
|| `-0, -n, --none` || Print just the preferences themselves || || `-1, -N, --names` || Print the preferences and the names of the productions that generated them || || `-2, -t, --timetags` || Print the information for the `--names` option above plus the timetags of the wmes matched by the LHS of the indicated productions || || `-3, -w, --wmes` || Print the information for the `--timetags` option above plus the entire WME matched on the LHS. || || `-o, --object` || Print the support for all the WMEs that comprise the object (the specified _identifier_). || || `identifier` || Must be an existing Soar object _identifier_. || || `attribute` || Must be an existing _attribute_ of the specified _identifier_. ||
The preferences command prints all the preferences for the given object identifier and attribute. If identifier and attribute are not specified, they default to the current state and the current operator. The Soar syntax attribute carat (`^`) is optional when specifying the attribute. The optional arguments indicates the level of detail to print about each preference.
This command is useful for examining which candidate operators have been proposed and what relationships, if any, exist among them. If a preference has O-support, the string, `:O` will also be printed.
When only the identifier is specified on the commandline, if the identifier is a state, Soar uses the default attribute `^operator`. If the identifier is not a state, Soar prints the support information for all WMEs whose value is the identifier.
When an identifier and the `--object` flag are specified, Soar prints the preferences / WME support for all WMEs comprising the specified identifier.
For the time being, [cmd_numeric_indifferent_mode numeric-indifferent] preferences are listed under the heading `binary indifferents:`.
By default, using the `--wmes` option with a WME on the top state will only print the timetags. To change this, the kernel can be recompiled with `DO_TOP_LEVEL_REF_CTS`, but this has other consequences (see comments in `kernel.h`).
This example prints the preferences on `(S1 ^operator)` and the production names which created the preferences:
If the current state is `S1`, then the above syntax is equivalent to:
This example shows the support for the WMEs with the ^jug attribute:
This example shows the support for the WMEs with value `J1`, and the productions that generated them:
This example shows the support for all WMEs that make up the object `S1`: