Calculate Menu: Difference between revisions

From ACD Percepta
Jump to navigation Jump to search
(Created page with "<!-- ==Calculate Menu== --> Image:Spreadsheet calculate menu.png <br> <br> # '''Properties''' - Calculate any from the variety of available PhysChem, ADME and Toxicity rel...")
 
No edit summary
Line 91: Line 91:
<br>
<br>
The '''Expression Editor''' only accepts the listed functions.  
The '''Expression Editor''' only accepts the listed functions.  
<br>
<br>
<br>
Variables designate columns in a database spreadsheet.  
Variables designate columns in a database spreadsheet.  
*Variables are designated with brackets in the following manner - [variable] - and appear in a teal (greenish-blue) color. Example: <span style="color:teal">[ID]</span>.
:*Variables are designated with brackets in the following manner - [variable] - and appear in a teal (greenish-blue) color. Example: <span style="color:teal">[ID]</span>.
:*Brackets are not allowed as part of a variable name but are meant to separate the variable from the other parts of a filter expression.
:*Brackets are not allowed as part of a variable name but are meant to separate the variable from the other parts of a filter expression.
:*Spaces following an open bracket "[" and before a close bracket "]" are allowed. Example: <span style="color:teal">[ ID ]</span>
:*Spaces following an open bracket "[" and before a close bracket "]" are allowed. Example: <span style="color:teal">[ ID ]</span>
:*Spaces within a variable name are not allowed; the Expression Editor will automatically display these as syntax errors in a burgundy (purplish-red) color. Example: <span style="color:maroon">[I D]</span>
:*Spaces within a variable name are not allowed; the Expression Editor will automatically display these as syntax errors in a burgundy (purplish-red) color. Example: <span style="color:maroon">[I D]</span>
:*Text within a variable is not case sensitive. The following variable names are all identical: <span style="color:teal">[ID] [Id] [iD] [id]</span>
:*Text within a variable is not case sensitive. The following variable names are all identical: <span style="color:teal">[ID] [Id] [iD] [id]</span>
<br>
 
General operators appear in navy blue: <span style="color:navy">+, -, /, *, <, >, <=, >=, <>, =</span>.
General operators appear in navy blue: <span style="color:navy">+, -, /, *, <, >, <=, >=, <>, =</span>.
<br>
<br>
Line 106: Line 107:
<br>
<br>
Arguments following functions must always be enclosed by parentheses that appear in navy blue. Example: Function<span style="color:navy">(</span><span style="color:green">Argument</span><span style="color:navy">)</span>
Arguments following functions must always be enclosed by parentheses that appear in navy blue. Example: Function<span style="color:navy">(</span><span style="color:green">Argument</span><span style="color:navy">)</span>
<br><br>  
<br>  
Static constants can be used.  
Static constants can be used.  
:*Real number constants are designated in green. Decimal points designate fractions and minus signs designate negative numbers. Examples: <span style="color:green">6</span>, <span style="color:green">-7.45767</span>.
:*Real number constants are designated in green. Decimal points designate fractions and minus signs designate negative numbers. Examples: <span style="color:green">6</span>, <span style="color:green">-7.45767</span>.
:*Scientific numbers are also recognized. Exponents can be designated using an upper or lower case “e”. Examples: <span style="color:green">-1.658476e-5</span>, <span style="color:green">-1.62E2</span> = <span style="color:green">-162</span>.
:*Scientific numbers are also recognized. Exponents can be designated using an upper or lower case “e”. Examples: <span style="color:green">-1.658476e-5</span>, <span style="color:green">-1.62E2</span> = <span style="color:green">-162</span>.
:*String static constants are designated using single quotation marks in the following manner - <span style="color:purple">‘molecule’</span> - and appear in purple.
:*String static constants are designated using single quotation marks in the following manner - <span style="color:purple">‘molecule’</span> - and appear in purple.

Revision as of 14:00, 4 July 2012

File:Spreadsheet calculate menu.png

  1. Properties - Calculate any from the variety of available PhysChem, ADME and Toxicity related properties. Opens the Properties Calculation List window.

  2. Categories - Differentiate compounds into several qualitative classes (Good, Average, Bad and Unknown) according to the most relevant PhysChem, ADME and Tox properties using the built-in profiling functions. Opens the Categories Calculation List window.

  3. Rank - Perform compound ranking, i.e., the prioritization with respect to the favorable/unfavorable profile of the selected PhysChem, ADME or Tox properties. Opens the Rank window.

  4. Expression - Opens the Expression Editor window. The Expression editor is used for calculating new columns using logical, mathematical, or text operations on the already existing columns.


NOTE: ACD/Percepta takes advantage of multiple computing threads, as a result, some of its basic functionality (e.g. the ability to browse the spreadsheet, or perform detailed single structure analysis in the Module View) is retained even at the time when any spreadsheet calculations are in progress. 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.

Properties Calculation


Calculate any from the variety of available PhysChem, ADME and Drug Safety related properties.


  1. Type the text in the text field to perform quick search.
  2. The list of properties available for calculation.
    NOTE: The actual list depends on the particular license, i.e. the combination of single-structure calculation modules present under the Module View.
  3. Click an individual algorithm to select it. Press Ctrl while clicking to select multiple fields.
  4. Use the arrow buttons to move selected fields between panes: Arrow Buttons move one or more selected fields and Arrows Buttons move all fields between panes.
  5. The list of properties selected for calculation.
  6. Click “+” and “-” pictograms to expand/collapse the list of parameters required for calculation.
  7. Click the add ph value.png pictogram to add required parameters.
    NOTE: You can add up to 5 specified parameters.
  8. Enter the required value.
  9. Click OK to proceed with the calculations. For each algorithm selected, a new column will be created, to which the calculated values will be written.


Categorization

Differentiate compounds into several qualitative classes (Good, Average, Bad and Unknown) according to the most relevant PhysChem, ADME and Drug Safety-related properties using the built-in profiling functions.

Spreadsheet Profile calculator.png


  1. Type the text in the text field to perform quick search.
  2. The list of the profiling functions.
  3. Click an individual profiling function to select it. Press Ctrl while clicking to select multiple fields.
  4. Use the arrow buttons to move selected fields between panes: Arrow Buttons move one or more selected fields and Arrows Buttons move all fields between panes.
  5. The list of profiling functions selected for calculation.
  6. Click OK to proceed with the calculations. Each qualitative compound profile (Good, Average, Bad, Unknown) according to the corresponding property will be written to a separate new column of the spreadsheet.

Ranking

Perform compound ranking, i.e., the prioritization with respect to the favorable/unfavorable profile of the selected PhysChem, ADME or Tox properties.

Spreadsheet Rank Calculator.png


  1. Type the text in the text field to perform quick search.
  2. A list of all the columns available for use in compound ranking. Only fields containing qualitative category data (Good, Average, Bad, Undefined) can be used in rank calculation, therefore the list contains only the columns calculated using built-in categorization algorithms as well as columns containing any numerical (calculated within ACD/Percepta or imported) data that can be differentiated into aforementioned categories manually by the user. Red exclamation marks note the columns that have to be preprocessed prior to using them in ranking, i.e. the continuous data in them has to be split into intervals and each of those has to be assigned one of four available categories.
  3. Click an individual column to select it. Press Ctrl while clicking to select multiple fields.
  4. Use the arrow buttons to move selected fields between panes: Arrow Buttons move one or more selected fields and Arrows Buttons move all fields between panes.
  5. The list of selected columns to be used in compound rank calculation.
  6. Press OK to proceed with the compound ranking that outputs the calculation results into a new spreadsheet column (please see below). In case any of the fields indicated with red exclamation marks have been selected, the wizard will appear guiding the user through the Interval Manager window for each of those, allowing the assignment of the qualitative categories necessary for rank calculation.

The newly calculated Rank column contains compound positions in the ranking list, i.e. the smaller this number is, the better is the analyzed profile for a particular molecule. Sort this column ascending to get your best compounds floating on top of the spreadsheet. Identical result in the Rank column indicates that a series of compounds received exactly the same score and consequently share the same position in the ranking. E.g. there are 20 compounds ranked as number “1”. This means that they all share the positions from the 1-st to the 20-th – the positions for subsequent compound(s) ranked lower will start from “21”. Therefore one should not expect that in a database of N compounds the Rank column will provide all the numbers from 1 to N. The higher the number of components (data columns) is used in the ranking the greater is the variability of the obtained ranking score and consequently the better is the separation between compounds and vice versa. Additionally it is possible to assign different importance factors to multiple ranking score elements.

Spreadsheet Calculated Rank.png


  1. Click to enable/disable the variable ranking score component weighting setup controls. These are automatically displayed on all the columns used in the corresponding rank calculation. If the spreadsheet contains more than one rank column , the variable ranking score component weighting setup controls can be activated for only one of them at a time, clicking “enable” on one of them will automatically disable the same controls of any other rank column active at the time.
  2. When active the column star ratings can be set up to differentiate between importance of various ranking score components. I.e. the fact that the property is within favorable or unfavorable range can have a non-uniform impact on the ranking score, depending on the star rating assigned to the column containing the categorized data for a particular property. Initially all the components are automatically assigned an equal weight.


NOTE 1: Throughout this document, the categories are referred by generic names "Good" (green), "Average" (yellow), "Bad" (red), and "Undefined" (gray). However, as shown in the screenshots above, the predefined profiling functions have distinct category descriptions that reflect the classification of the underlying properties, e.g. for Ames test: "Mutagenic" = "Bad", "Non-mutagenic" = "Good"; for HIA: "Highly absorbed" = "Good", "Moderately absorbed" = "Average", "Poorly absorbed" = "Bad", etc.
NOTE 2: In the ranking score calculation “Undefined” category is treated as a most favorable following “Good”. This is because of the fact that both “Average” and “Bad” are obviously not “Good” while “Undefined” still retains a positive shade in the perspective, because “Undefined” can be as well found out to be “Good”. This means that the compounds with “Undefined” categories still carry substantial potential and are more interesting than their counterparts classified as “Average” in terms of the same properties even despite the fact that they require some further investigation.

Expression Editor

The Expression Editor functions as a parser, allowing the user to create complex expressions using an easy-to-learn set of syntax rules. Expressions can be constructed using a set of mathematical and string functions, as well as logical and arithmetic operators.

Spreadsheet Expression Editor.png


  1. The Edit window allows you to type constructs directly or insert functions and operators from the roll-down menus by double-clicking them.
  2. Functions/operators and fields appear in the roll-down menus. Click any function sub-menu to expand/collapse it.
  3. Roll-down menus can be viewed simultaneously by dragging them halfway up or down the pane.


The Expression Editor only accepts the listed functions.

Variables designate columns in a database spreadsheet.

  • Variables are designated with brackets in the following manner - [variable] - and appear in a teal (greenish-blue) color. Example: [ID].
  • Brackets are not allowed as part of a variable name but are meant to separate the variable from the other parts of a filter expression.
  • Spaces following an open bracket "[" and before a close bracket "]" are allowed. Example: [ ID ]
  • Spaces within a variable name are not allowed; the Expression Editor will automatically display these as syntax errors in a burgundy (purplish-red) color. Example: [I D]
  • Text within a variable is not case sensitive. The following variable names are all identical: [ID] [Id] [iD] [id]

General operators appear in navy blue: +, -, /, *, <, >, <=, >=, <>, =.
Functions always appear in black.
Logical operators appear in black: And, Or, Not.
Arguments following functions must always be enclosed by parentheses that appear in navy blue. Example: Function(Argument)
Static constants can be used.

  • Real number constants are designated in green. Decimal points designate fractions and minus signs designate negative numbers. Examples: 6, -7.45767.
  • Scientific numbers are also recognized. Exponents can be designated using an upper or lower case “e”. Examples: -1.658476e-5, -1.62E2 = -162.
  • String static constants are designated using single quotation marks in the following manner - ‘molecule’ - and appear in purple.