every in the command, you can restrict the search to include only those items that meet certain criteria. This is a powerful way of identifying particular classes of items to inspect. This filter applies when you inspect classes of items by using the
every syntax with the `following Inspect commands:
show on a workspace
write to the file
display a table
replace
highlight
and and or, and optionally grouped in parentheses for clarity. For example, to see all the pipes that fall within an acceptable diameter range, enter the following:
show on a workspace every pipe where diameter >= 5 inches and
where diameter <= 18 inches
such that phrase as the filter. The syntax for the filter expression is:
such that truth-value-expression
show on a workspace every G2-variable
such that the G2-variable has a current value
Note: You cannot use such that to test the value of an attribute; use where instead (see Filtering Items Based on the Value of an Attribute).
Filtering Items that Contain Specific Text
You can filter items based on the existence of a particular piece of text by using containing the as the filter. The item can contain a word, a string, or a symbol.
containing [ the { word | symbol } ] text-expression
show on a workspace every statement containing "tank is overflowing"
the word or the symbol in the command, the command only finds text that exactly matches the specified word or symbol; it does not find partial strings. For example, the following command only finds statements containing the word inform; it would not find strings that contained the word information, for example.
show on a workspace every statement containing the word inform
OK in the Notes attribute. This command allows you to locate all items with unspecified information. For example:
show on a workspace every tank with notes
ok, bad, or incomplete indicates the value of the item's Notes attribute.
active and inactive indicates whether the workspace on which the item is located is active or inactive.
enabled and disabled indicates whether the item itself is enabled or disabled.
whose status is status
show on a workspace every class-definition whose status is incomplete
=, /=, >, <, >=, and <=.
is with a truth value (true or false) or any symbol to test the value.
where attribute-name relational-operator numeric-expression
where attribute-name is { truth-value-expression | symbolic-expression }
show on a workspace every tank where inflow >= 14
show on a workspace every bin where recently-emptied is true
Categories, Focal-classes, and Focal-objects. You can filter rules based on their category, focal class, or focal object by using the following filter expressions:
in the category symbolic-expression
which has the focal { class | object } symbolic-expression
show on a show on a workspace every rule in the category safety-rules
show on a workspace every rule which has the focal class automobile
found on the workspace in the command.
show on a workspace every rule found on the workspace
machine-schematic-rules
assigned to module in the filter expression.
assigned to the hierarchy of module in the filter expression.
show on a workspace every tracked-vehicle
assigned to module plant-floor-schematic
or, as follows:
show on a workspace every tracked-vehicle
assigned to module plant-floor-module or
assigned to module vehicle-status-module
or.This example shows how you filter items based on any module in a hierarchy, as follows:
show on a workspace every tracked-vehicle
assigned to the hierarchy of module plant-floor-module not in conjunction with any of the previously discussed filter expressions to restrict the search to those items that do not meet the criteria. The word
not precedes the filter expression.For example, the following command finds all class definitions whose status is not
OK:
show on a workspace every class-definition whose status is not ok
show on a workspace every G2-variable
not such that the G2-variable has a current value