MSI Product Previous Next Contents Index Top
QSAR



14       Using the Equation Viewer

The Equation Viewer control panel provides detailed information about each QSAR equation that you generate. Regardless of the statistical method used to generate a QSAR equation, you can use the equation viewer to:

Additionally, if you used Simple (that is, simple linear regression) or Genetic (that is, genetic function approximation) as your statistical method, QSAR+ generates more than one QSAR equation and displays the entire group of equations in the equation viewer. So you can also use the equation viewer to sort the list of equations according to various statistical measures.

This chapter explains how to use the equation viewer:

Opening the equation viewer (next section)

Selecting equations on page 253

Deleting equations on page 254

Plotting equations on page 255

Renaming equation sets on page 256

Saving QSAR equations on page 257

Opening QSAR equations on page 257

Deleting a QSAR equation on page 258


Opening the equation viewer

You can open the Equation Viewer control panel by using the EQUATION VIEWER card or by selecting the Tools/Equation Viewer... menu item in the study table. QSAR+ also displays the equation viewer automatically after it generates a QSAR equation.

To open the equation viewer at any time

Go to the QSAR card deck, then choose View Equations from the EQUATION VIEWER card. The Equation Viewer control panel appears.

To control the default display

1.   Go to the QSAR Preferences control panel by selecting Preferences/General... on the study table menu bar or Preferences/ General on the QSAR card.

2.   To indicate whether you want QSAR+ to open the equation viewer automatically whenever you generate a QSAR equation, check or uncheck the Display QSAR Equations checkbox.

For more information about controlling the display of study table information, see the Equation viewer section on page 219.


Selecting equations

If your statistical method produces more than one equation (for example, Simple or GFA), you may need to select an equation from the group of equations displayed in the equation viewer. You need to select an individual equation when you want to:

To select a single equation from a set of equations.

To select an equation

1.   If necessary, use the QSAR Equation Set control to display the equation set that contains the equation you want to select.

When you open the equation viewer, it shows the current equation set. If you renamed generated equation sets (as described in Renaming equation sets on page 256), you can display each equation set by using the QSAR Equation Set control.

2.   You may want to sort the equation set by some term. To do this, click the upper More... button (above the equation browser) in the equation viewer. This opens the QSAR equations sets control panel.

3.   Use the scroll bars or the Number n of m control to scroll through the equation set in the equation viewer.

4.   Select an equation by:

Clicking the appropriate equation.

Using the up- and down-arrows associated with the Number n of m control to highlight the appropriate equation.

When you do so, QSAR+ will:

Highlight the selected equation.

Update the Number n of m control with the position of the selected equation within the equation set (for example, Number 5 of 100).

Display each term in the selected equation on a separate line in the Terms browser.

Display the statistics associated with the selected equation in the Statistics browser.

Plot the training data for the selected equation (if the Plot checkbox on the QSAR Preferences control panel is checked).

5.   Repeat Steps 2 through 4 to select other equations in the equation set and display information about them.


Deleting equations

You can use the equation viewer to delete both entire equation sets and individual equations within a set.

To delete an entire equation set

1.   If necessary, use the QSAR Equation Set control to display the equation set that you want to delete.

QSAR+ lists the equations in the selected equation set in the equation browser.

2.   Click Delete QSAR Equation Set in the QSAR Equation Sets control panel (opened by clicking the upper More... button in the equation viewer).

After prompting you to confirm your decision, QSAR+ deletes the entire equation set.

To delete an individual equation

1.   If necessary, use the QSAR Equation Set control to display the equation set containing the equation that you want to delete.

QSAR+ lists the equations in the selected equation set in the equation browser.

2.   Select the equation you want to delete (for example, by clicking the equation). For more about selecting an equation, see Selecting equations on page 253.

QSAR+ highlights the selected equation.

3.   Click Delete QSAR Equation Set in the QSAR Equation Sets control panel (opened by clicking the upper More... button in the equation viewer).

After prompting you to confirm your decision, QSAR+ deletes only the selected equation from the equation set.


Plotting equations

The equation viewer enables you to display a graph that illustrates each equation that you select. This graph plots predicted vs. observed activity for the selected equation.

To display a graph of an equation

1.   If necessary, use the QSAR Equation Set control to display the equation set containing the equation that you want to plot.

QSAR+ lists the equations in the selected equation set in the equation browser.

2.   Select the equation that you want to plot (for example, by clicking the equation).

3.   Click the Plot Equation button.

QSAR+ displays a graph showing predicted vs. observed activity for the selected equation. To view another equation, click it in the equation browser, then click the Plot Equation button. The graph window changes to show the new equation.

To enable automatic plotting of the currently selected equation, click the More... button to open the QSAR Equations control panel. If you check the Auto update 2D Plot checkbox, the currently selected equation is plotted in the Cerius2 Graphs window, and changing the currently selected equation in the equation browser automatically updates the 2D graph. Similarly, if you check the Auto update 3D-QSAR Labels checkbox, the currently selected equation is displayed in the Cerius2 main graphics window.

Identifying graph points from the study table

You can select a subset of points (that is, rows) in the study table and highlight them in the Cerius2 Graphs window in which the current equation is plotted. Select the rows in the study table that you want to highlight, then click the Equation button. This causes the selection made in the study table to be colored in the 2D Graph window.

Identifying study table observations from a graph

You can also select points in the 2D Graph window and identify them in the study table:

1.   Select a set of points in the 2D Graph window by dragging toout rectangle that encloses the points.

2.   Click Show Selected Points.

The rows of the study table corresponding to the graph points become highlighted. Information about those points is shown in the text window.

For more about working with graphs in Cerius2, see the Cerius2 Modeling Environment.


Renaming equation sets

Recall that QSAR+ enables you to save individual QSAR equations in the QSAR+ descriptor database. You can use these saved QSAR equations both to predict activity for new molecular structures and as descriptors in the generation of new QSAR equations. For detailed information about saving QSAR equations, see Saving QSAR equations on page 257.

QSAR+ also enables you to rename an entire equation set. Whenever you request generation of a QSAR equation, QSAR+ creates an equation set containing one or more QSAR equations and, based on the statistical method you select, automatically assigns a name to that equation set. For example, if you choose Linear as your statistical method, QSAR+ automatically names the resulting equation set QSAR Simple Linear Regression. If you again choose Linear as your statistical method, QSAR+ again automatically names the resulting equation set QSAR Simple Linear Regression, and overwrites the original equation set. Thus, to retain the original equation set, you must first rename it.

Note

To rename an equation set

1.   Click the top More... button in the equation viewer. This opens the QSAR Equations Sets control panel.

2.   Enter the equation set's new name in the New Name entry box.


Saving QSAR equations

To save a QSAR equation set, click on the Save Equations... button. The Save QSAR Equations control panel appears.

The Save QSAR Equations control panel contains a popup, Current Equation/Equations set, which lets you decide whether to save the entire set of equations or just the currently selected equation. The Name and Comments entry boxes allow you to give a name to and attach a comment to the saved item, and QSAR equations file allows you to name the file to which the data is saved. Browse... opens the Save QSAR Equation File control panel, which lets you select a name from a list of existing equation filenames. The extension .qsar is automatically appended to the name you supply.


Opening QSAR equations

Clicking the Open Equations... button opens the Open QSAR Equations control panel, which is used to load a previously saved set of QSAR equations or a single QSAR equation.

This control panel controls which equation file is read into QSAR+ and what is done with it. You may read in a single equation and create a new set with it or add it to an existing set. You may also read in a set of equations.

Adding an equation to an existing set

1.   Choose Equation from the popup.

2.   Select the file you want to read in from the file list. The File, Equation Name, and Description parameters are filled in.

3.   If necessary, set the Add to Set/Create new Set popup to Add to Set, then ensure that Equations Set specifies the equation set to which the equation will be added.

4.   Click Open.

The equation from the file is added to the specified equation set.

Adding an equation and creating a new set

1.   Change the popup to Equation.

2.   Select the file you want to read in from the file list.

3.   Enter the name of your new equation set in the New Equations Set entry box.

4.   Click Open.

A new equation set is created and appears in the equation browser.

Reading in a set of equations

1.   Change the popup to Equations Set.

2.   Select the file you want to read in from the file list.

3.   Enter the name of your new equation set in the New Equations Set entry box.

4.   Click Open.

A new equation set is created and appears in the equation browser.


Deleting a QSAR equation

1.   Select the equation that you want to delete from the equation browser then click the lower More... button in the Equation Viewer control panel. This opens the QSAR Equations control panel.

2.   Click the Delete Selected QSAR Equation button to delete the currently selected equation. A warning box asks you for confirmation.

3.   Click OK. The equation is deleted.


Labelling 3D QSAR equations

Two applications, MFA and Receptor, create columns in the study table that refer to a point in space near a molecular model or a (possibly aligned) group of models.

The controls to display these points are in the QSAR Equation control panel, which is accessed from the lower More... button in the Equation Viewer control panel.

The main control is the MFA/Receptor popup, which must be set to MFA if you want to label MFA 3D points and to Receptor if you want to label 3D points on a receptor surface model. The Label Current Equation pushbutton draws 3D points associated with terms in the current equation (highlighted in the equation viewer), and the Label Independent Variables pushbutton draws 3D points corresponding to columns in the study table marked Independent X. The Clear Labels pushbutton removes both kinds of labels from the Cerius2 Models window.

The bottom three checkboxes in the QSAR Equations control panel control how 3D points are displayed. If Show Column Name is checked, the 3D points are labelled with the column heading from the study table. If it is not checked, the 3D labels simply appear as crosses. If Show Loading Value is checked, the loading value is attached to the 3D label. The loading value is the coefficient of the term as it appears in the equation viewer multiplied by the standard deviation of the descriptor. Independent variables do not have a loading value, so this checkbox affects only the display of the current equation. The Scale Cross by Loading Value pushbutton applies only to labelling of the current equation and scales the size of the cross by the coefficient of the term that it represents.



MSI Product Previous Next Contents Index Top

Last updated May 18, 2000 at 05:51PM Pacific Daylight Time.
Copyright © 2000, Molecular Simulations Inc. All rights reserved.