Labeling, Searching and Filtering

From ACD Percepta
Jump to navigation Jump to search

How to:


How to apply a label?

Click the label circle which is in the upper-right corner of the Structure pane in the Prediction Module, PhysChem Profiler and Drug Profiler workspaces or the Structure field in the Spreadsheet workspace. The color of the label depends on which color setting option is selected.

Note: You can add only one label to a compound. In most circumstances you can label only one compound at a time, however labeling multiple compounds in one operation is supported in the Scatter plots that can be displayed in the Spreadsheet workspace.

How to set a label color?

Click the arrow button near the label in the upper-right corner of the Structure pane or the Structure field to expand the color settings list:

  • The first option "Toggle between: white and green.png" is useful for quick marking of compounds with favorable profiles: the label color will alternate between green or none.
  • The second option "Toggle between: white and red.png" is useful for quick marking of compounds with unfavorable profiles: the label color will alternate between red or none.
  • To set an arbitrary label color, select the "Color selector" option and click the label circle. The color palette will appear. Choose one color of your preference from a predefined set of colors.
    label color setting.png


How to edit or delete a label?

In order to edit or delete the label, perform the same steps as in the case of applying a new label:

  • If one of the "Toggle between" options is enabled, just press on the label circle until it becomes clear to delete the label.
  • If "Color selector" option is enabled, choose the crossed circle in the color palette to delete the label.

label color pallete.png

How to perform substructure search?

  1. In the Spreadsheet workspace, place the cursor on the field with structures.
  2. Click the Add New Filter Icon icon in the Column menu – a few filter setup options will appear. Analogously, this filter can be found in the Single Record View workspace, or by right-clicking on the spreadsheet field containing a structure.
  3. Choose a logical operator if you wish to apply more than one filter condition. You can combine multiple filter conditions in two ways: either all conditions must be met (AND check box) or any conditions may be met in order to make a record visible (OR check box).
    NOTE: max 3 filter conditions can be applied.
  4. To select a substructure, click Edit Structure Icon or anywhere in the empty structure field. This will open an empty window where you can paste a 2-D structure to the Structure pane by clicking the Paste Structure Button button, or find and select a structure from the Dictionary by clicking the Open Dictionary Button button.
  5. To select a substructure, lasso any part of a structure using the cross shaped mouse cursor. The selection will be highlighted in orange.
  6. Check the 'Substructure', 'Superstructure' or 'Exact match' option button to begin searching for the selected substructure.
  7. Also you can search for similar structures and adjust the similarity threshold, which is set as 0.75 by default.
  8. The list of matching entries is displayed on the bottom status bar, and the column to which the filtering conditions have been applied is indicated with a filter pictogram in the header.
  9. To remove any structure filter rule, click the trash bin icon next to the filter conditions.


How to filter labeled records?

  1. While in the Spreadsheet view, place the cursor on any record in the Structure field. The indicators of all labels applied to the current data set will appear in the Column menu.
  2. Check/uncheck the label indicators boxes to perform a quick search of the labeled compounds.
  3. The list of matching entries is displayed on the bottom status line. Save it for further use if needed (see How to create and save a list?)


How to look for the record containing specific text?

  1. Place cursor in the textual field, e.g. 'Name' or 'References'.
  2. Type any text string in the text field to perform a quick search.
  3. The list of matching entries is displayed on the bottom status line, and the column to which the filtering conditions have been applied is indicated with a filter pictogram in the header.


How to filter the numeric field?

  1. Place cursor in the numeric field.
  2. Drag both ends of the Filters slider to filter out the values below and/or above the desired threshold in the currently selected column.
    Numberfilter.png
  3. The list of matching entries is displayed on the bottom status line, and the column to which the filtering conditions have been applied is indicated with a filter pictogram in the header.


How to create and save a list?

  1. After searching, filtering, categorizing, etc. is performed in the dataset, select Save list as in the spreadsheet Lists menu.
  2. Type in a name for the current subset in the List name text box.
  3. Click OK. The list (but not its filter conditions) is saved within the current project for further use.


How to load a list?

  1. In the spreadsheet Lists menu, select Load list.
  2. Select the desirable list from the previously saved ones.
  3. The list is loaded and the records in the list that fulfill currently set filter conditions are displayed.


How to retrieve all records in the list?

  • When the spreadsheet is being affected by any filters, columns to which the filtering conditions have been applied are indicated with a filter pictogram in the header. Click this pictogram to remove the respective filter.
  • When the previously saved list is loaded, the filter pictogram is displayed in the upper-left corner of the spreadsheet. Click it or anywhere in the empty space outside the spreadsheet to retrieve all dataset records.


How to intersect, merge or subtract previously saved lists?

  1. Select Lists > List operations. The Manage Lists window with two panes displaying all saved lists will be opened.
  2. Click a list to select it in the left pane.
  3. Choose one of three desirable actions to be performed with the lists.
  4. Then click another list to select it in the right pane.
  5. If you wish to save the resulting list for future use, check the Save resulting list as: box and type a name for it in the text field.
  6. Click OK.




FAQ:


Why is my previously saved list empty when I load it?

When you apply any filters and save a resulting subset as a list, the filter conditions are not saved along with it. If you apply new filter rules or perform searching in the dataset and afterwards load previously saved list, it may contain fewer or even no records according to currently designated filters. Remove them to view the full saved list.


Is it right that calculations are performed for the whole data set regardless of the filters applied?

Regardless of the filters applied to the spreadsheet, commencing calculation procedure retrieves all compounds and predicts the corresponding values for all of them (so than no additional recalculation procedures would be necessary if filtering conditions are changed at a later time). The filter is re-applied again when the program completes all the calculations.