Search
As mentioned in the section on the NG-CHM header area on the Interface Overview tab, the NG-CHM Viewer includes capabilities to search for data in the map.
Data can be searched for and selected among the row and column labels or among the values of covariates along either or both axes. When a search is done, the matching data replaces the currently selected data on the NG-CHM. ## Search Controls The search controls on the toolbar are displayed below.
The controls are described below.
| Search Control | Description |
|---|---|
| Search Target | Dropdown that allows you to select “Labels” or any of the Covariates on the NG-CHM. The default is to search the labels on the main matrix. |
| Search Text | Text field for manually entering text to search for or a dropdown of values to select from. See the section on “Search Text” below for additional information. |
| Axis Selector | Dropdown to tell whether you wish to search rows, columns, or both for the matches. If only one of rows or columns is selected then only the selected items along that axis will be replaced by the search results. If a covariate is selected in the Search Target dropdown, then this field will automatically be set to the axis associated with the selected covariate. |
| Go Button | Perform the search. This can also be done by hitting the Enter key in the Search Text control. |
| Red X | Clear search selections button. This will clear the search selections and deselect any items selected by the search function along the axis specified in the Axis Selector control. |
Search Text
The Search Text control works differently dependent on the selections made for Search Target control.
| Search Target Type | Search Text Behavior |
|---|---|
| Labels | The Search Text field will be a text box that uses a variety of regular expressions to search for matches among the rown and column labels of the main matrix of the NG-CHM. The search will find labels that partially match the search text. To find exact matches only, put double-quote characters around the search term. Multiple search terms can be separated by spaces.For example: Search: Gene_2 will find rows Gene_2, Gene_21, Gene_283, etc. Search: “Gene_2” will find only the row Gene_2 |
| Continuous Covariate | If the Search Target field is set to a Covariate with continuous values, then the Search Text will be a text box that will accept search expressions. Search expressions should be entered in the form of a comma-delimited string with each segment representing an expression. Valid expressions would include individual numeric values, values preceded by one of the following operators: >, >=< <, <= (e.g. >10), and/or range expressions with 2 operators creating a range of values (e.g.>10<=20). Expressions that do not match these patterns will be ignored. |
| Discrete Covaraite | If the Search Target field is set to a Covariate with discrete values, then the Search Text will be a multi-select list of the values that that covariate can have in the NG-CHM. Each item in the list will include a checkbox and all covariate rows or columns (dependent on location of covariate) that match the selected values will be selected on the NG-CHM. |
Search Results
If the search box turns red, none of the search terms were found. If it turns yellow, only some of the search terms were found.
All rows and/or columns, as specified by the Axis Selector will be selected in the NG-CHM. This will affect the selection of rows and/or columns on all panes of the NG-CHM.
The labels of rows and columns that match the search term will be selected (green background) and a green highlight will be displayed in the margin of Summary Panel at the position of matching rows/columns. See the selection color entry on Display Properties tab to change the selection color.