HyperGraph

Plot Browser Filter

Plot Browser Filter

 Previous topic Next topic Expand/collapse all hidden text  

Plot Browser Filter

 Previous topic Next topic JavaScript is required for expanding text JavaScript is required for the print function  

The Plot Browser provides you with several ways to filter your plot data to display specific plot entities in the browser.

plot_browser_filter_area

Enter Search String Field

You can enter your search criteria in the Enter Search String... field.  The Plot Browser filter is always static.  After you enter your string in the search field, the Plot Browser will only be updated with your search results when you:

•Press the Enter key
•Click the magnifying glass, plot_browser_magnifying_glass.
•Use the Add as Filter option in the properties table.

If you enter an invalid search string, a red x is displayed in front of your entry:

plot_browser_incorrect_string_ex

Clear the Search String Field

The search string field can be cleared in the following ways:

•Clicking on the "x" on the right side of the search string field.
•If the magnifying class is displayed, click on it and it changes into the "x", then click on the "x" to clear the field.
•Highlighting the search string and press Delete or Backspace on your keyboard.

Clearing the search string field displays the full browser tree.

Filter Syntax

Note: All property keywords, like the ones used below, can be easily inserted into the search string field via the Add as Filter or Add as unevaluated Filter context menu in the Property Table.  Using this feature also allows for the correct usage of double quotes and the escape sequences in the filter syntax:

•Use the following syntax to filter for a property:
<keyword>:<value>
Example:
Filter for all curves with the color red:
linecolor:2
•Supported logical operators: AND, OR and NOT.
Note: These operators have to be upper case by default; AND will be inserted if multiple keywords are used for filtering.
Example:
Filter for all curves with the line color 4 (blue) and thickness 1:
linecolor:4 AND linethickness:1
•Parentheses can be used to build more complex filter strings.
Example:
Filter for all curves with the line color 4 (blue) and a thickness of either 1 or 3:
linecolor:4 AND (linethickness:1 OR linethickness:3)
•Filtering for labels with blanks requires double quotes.
Example:
Filter for all curves which have the complete label as shown below:
label:"LOWER TORSO - X-comp. acceleration"
•Filtering for labels that contain special characters, such as double quotes and parentheses, requires the escape sequence.
Example:
Filter for curve labels that contain Templex expressions using "Add as unevaluated Filter":
label:/"{y.HWRequest} - {y.HWComponent}/"
•The wildcard "*" for any number of characters and "?" for exactly one character are supported.
If no wildcard is added at the beginning or the end of the filter string, it will be used as if the wildcard "*" is added at both ends.  If at one end a wildcard is added, the other end is treated like it is the beginning or end of the filter string.
Examples:
Filter for all curves that contain the string TORSO in their label:
label:"*TORSO*"
Filter for all curves that begin with TORSO:
label:"TORSO*"

Using Add as Filter to Define Your Search Parameters

To apply a filter on a curve or on an x/y vector property, right-click on the curve or x/y vector’s property in the Properties Table and select Add as filter, as shown below.

plot_browser_add_as_filter_ex

The filter is added to the search field at the top of the browser.  If you add more than one filter type, it will be added to the search field, with the word AND, as shown below.  In this example, Line Thickness and Line Color were both added as filters.

plot_browser_search_ex2

If you want to change the line thickness or line color search criteria, you can backspace to remove the number from the search field and a context sensitive menu is displayed containing the line thickness types or color palette.  Selecting a new line thickness type or line color automatically adds the number equivalent to the search field.

plot_browser_line_thickness_support

All text fields which support Templex have an additional filter option, Add as unevaluated Filter.  This allows you to add the unevaluated Templex code as a filter.

plot_browser_filter_templex

NoteCurve labels are inserted without keywords.

Additional Permitted Search Criteria

Entity searches can be of the following combinations:

•Window and entity properties

plot_browser_window_entity_properties

•Page and entity properties:

plot_browser_page_entity_properties

Drag and Drop Support

On the Define Curves panel, you can use the Cut, Copy, and Paste buttons to add and remove curves to/from a window or remove them from the curve list.  Limitations  that are defined in the Define Curves panel apply to the cut and paste feature in the Plot Browser as well.

plot_browser_curve_list

Define Curves panel Cut, Copy, and Paste

You can define the position where you want to paste the curve. In the image below, you can cut the curve surrounded with the red border and add it to the window 2 on page 2.

plot_browser_cut_paste_ex_1 plot_browser_cut_paste_ex_2
 

Filter Example

The example below illustrates searching for all axes with Acceleration in the label on an xy plot.

plot_browser_final_search

hmtoggle_plus1greyDisplay Control Tools

The following buttons can be used to change the display state of various entities in the plot browser tree.

select_all_filter - Select All – Selects all entities shown in the tree.

select_none_filter - Select None – Clears all entity selections shown in the tree.

reverse_selection_filter - Reverse Selection - Reverses the state of the items in the tree (displays the hidden and hides the displayed).