Defining QM and MM regions in QSite
Tutorial Created with Software Release: 2023-3
Topics: Quantum Mechanics , Small Molecule Drug Discovery
Products Used: QSite
|
1.5 MB |
This tutorial is written for use with a 3-button mouse with a scroll wheel.
Words found in the Glossary of Terms are shown like this: Workspacethe 3D display area in the center of the main window, where molecular structures are displayedthe 3D display area in the center of the main window, where molecular structures are displayed
Abstract:
This tutorial demonstrates the common task of selecting QM (quantum mechanics) and MM (molecular mechanics) regions in the QM/MM program QSite. This task must be performed at the outset of each Qsite calculation.
Tutorial Content
1. Introduction
The QSite program performs QM/MM calculations, that is, calculations in which a region of the molecule is treated with QM (quantum mechanics) method and the rest of the molecule is treated with an MM (molecular mechanics) method. The regions interact via a QM/MM interface. Usually, the QM region is smaller than the MM region, and represents the most important part of the molecule (for example the active site of a protein). As MM methods are computationally significantly cheaper than the more accurate QM methods, treating the whole molecule at the QM/MM level has a benefit of working with a large, untruncated molecule, describing its most interesting region accurately and at the same time keeping computational costs low. QM/MM methods are normally used for modeling enzymatic reactions or non-covalent binding of small molecules to proteins. In order to start any calculation with QSite you must define the QM and MM regions of your molecule.
In this tutorial we will be using a small molecule/protein complex similar to that used in the research paper mentioned below:
R. Lonsdale and M. T. Reetz, “Reduction of α,β-Unsaturated Ketones by Old Yellow Enzymes: Mechanistic Insights from Quantum Mechanics/Molecular Mechanics Calculations”, J. Am. Chem. Soc., 2015, 137, 14733−14742.
In this paper the authors studied the oxidation of a 2-cyclohexen-1-one into cyclohexanone, catalyzed by the so-called old yellow enzyme YqjM from bacterium Bacillus subtilis. The complex details of preparing the small molecule/protein complex described by the authors are not important to follow for this tutorial, and instead, we will be working with a molecular system that has already been prepared for you for the task of selecting its QM and MM regions.
2. Creating Projects and Importing Structures
At the start of the session, change the file path to your chosen Working Directorythe location that files are saved in Maestro to make file navigation easier. Each session in Maestro begins with a default Scratch Projecta temporary project in which work is not saved, closing a scratch project removes all current work and begins a new scratch project, which is not saved. A Maestro project stores all your data and has a .prj extension. A project may contain numerous entries corresponding to imported structures, as well as the output of modeling-related tasks. Once a project is created, the project is automatically saved each time a change is made.
Structures can be imported from the PDB directly, or from your Working Directorythe location that files are saved using File > Import Structures, and are added to the Entry Lista simplified view of the Project Table that allows you to perform basic operations such as selection and inclusion and Project Tabledisplays the contents of a project and is also an interface for performing operations on selected entries, viewing properties, and organizing structures and data. The Entry Lista simplified view of the Project Table that allows you to perform basic operations such as selection and inclusion is located to the left of the Workspacethe 3D display area in the center of the main window, where molecular structures are displayed. The Project Tabledisplays the contents of a project and is also an interface for performing operations on selected entries, viewing properties, and organizing structures and data can be accessed by Ctrl+T (Cmd+T) or Window > Project Table if you would like to see an expanded view of your project data.
-
Double-click the Maestro icon
- (No icon? See Starting Maestro)
- Go to File > Change Working Directory
- Find your directory, and click Choose
- Pre-generated input and results files are included for running jobs or examining output. Download the zip file here: https://www.schrodinger.com/sites/default/files/s3/release/current/Tutorials/zip/qsite_define_regions.zip
- After downloading the zip file, unzip the contents in your Working Directorythe location that files are saved for ease of access throughout the tutorial
- Go to File > Save Project As
- Change the File name to Qsite-QM-MM-regions
-
Click Save
-
The project is now named
Qsite-QM-MM-regions.prj
-
The project is now named
3. Defining the QM-MM Regions
3.1 Import Structures
- Go to File > Import structures
-
Select
1Z44-prepared.mae -
Click Open
- The protein in complex with some small molecules is displayed in the Workspacethe 3D display area in the center of the main window, where molecular structures are displayed
- The protein is rendered in helices, beta-sheets, and loops, with the ligands shown in tube representation
This structure has been prepared using the Protein Preparation Workflow. The preparation procedure used in the paper was more complex, but ours is sufficient for this tutorial. Please see the Introduction to Structure Preparation and Visualization tutorial for more information about this process.
![]()
Figure 3-2. View of the protein sequences in the Multiple Sequence Viewer panel, showing that chains A and B have the same sequences.
- Click Tasks, and type multiple sequence viewer
-
Select Multiple Sequence Viewer
- The Multiple Sequence viewer panel opens
- Residues are colored by residue type to enable easier visual comparison
- Chains A and B are identical
Figure 3-3. View of the interaction between the ligand of one chain (gray) and an end of another chain (white).
Since both chains are the same, and the small molecules bound to these chains are also the same, it seems possible to simplify the QM/MM calculation by modeling one part of the system and deleting the other. However, this is not a good idea. By examining the boundaries between the two symmetrical parts of the system, we can see that Chain B of the protein lies close to and interacts with the ligand of Chain A. By removing one of the chains, we run the risk of disturbing the region around the ligand which is of greatest interest. It is therefore best to leave both chains intact when modeling this particular system with QSite.
Figure 3-4. View of the options in the Style palette to customize the representation of the complex, in the Workspace.
We will now render the complex using the Style palette, to give a clearer and more detailed view of the atoms and residues. This will help us while defining our QM and MM regions.
- Go to Style > Display atoms
-
In the Style palette, go to Color Atoms > Element + Custom Ligand
- This colors all the atoms in the protein according to the respective elements and the ligand is displayed in a different color, making it discernible from the remaining residues
- In the Style palette, click on Remove ribbons from selected residues
Figure 3-5. View of the Workspace centered on the 2-cyclohexen-1-one ligand. The coloring style followed is Element + Custom Ligand; atoms are colored as per the element and the ligand is shown with green carbons.
- Double click on the 2D representation of 2-cyclohexen-1-one for Chain A in the Workspacethe 3D display area in the center of the main window, where molecular structures are displayed
You can also press the L key on the keyboard
Note: If the 2D representation is not turned on by default, you can do so by choosing Window > 2D overlay
3.2 Select QM and MM regions
Once our structure has been imported and rendered, we are ready to select the QM and MM regions of our system.
- Go to Tasks > type QSite
-
Choose QSite
- The Qsite panel opens with the QM settings tab displayed
Note: You can also access the panel by navigating to Tasks > Browse > Other Applications > Qsite
The level of theory for our calculation is set at the top of the QSite panel. In our case the level of theory is DFT, and the density functional is B3LYP
Figure 3-8. Activate picking free ligand/ion in the QSite panel, for including small molecules bound to the protein in the QM region.
The first part of the system to include in the QM region is the ligand bound to the protein
-
Pick Free ligand/ion from the dropdown
- This option is used when including a small molecule or ion (not covalently attached to the protein) in the QM region
-
Click on any atom of 2- cyclohexen - 1- one in the Workspacethe 3D display area in the center of the main window, where molecular structures are displayed
- All the atoms in the molecule are highlighted, and an entry corresponding to this free ligand/ion appears in the QSite panel
You can use the Delete button to remove any entry, that has been included by mistake, from the table
Other parts of the system that we would include in the QM region are the residue TYR169 and the flavin cofactor. Both these parts are covalently attached to protein’s chain A.
- Pick Side Chain from the dropdown
Side chain cuts can be made in any peptide residue other than alanine, glycine, and proline
The flavin fragment attached to the protein is not a standard amino acid residue and must be selected using the hydrogen cap method.
-
Click on any atom of the residue, TYR 169 of chain A. (very close to 2 - cyclohexen - 1 - one.)
- The residue is highlighted in the Workspacethe 3D display area in the center of the main window, where molecular structures are displayed and added to the QM region table in the QSite panel
- Pick Hydrogen Cap from the dropdown
- In the Workspacethe 3D display area in the center of the main window, where molecular structures are displayed, click first on the carbon atom bonded to the CH2 group (atom number 5293) and then on the carbon atom of the OH group (atom number 5294)
- A 3D arrow appears in the Workspacethe 3D display area in the center of the main window, where molecular structures are displayed and the entry corresponding to the Hydrogen Cap is created in the QM panel, indicating the atoms that mark the QM and MM region respectively
- The origin of the arrow is at the latter carbon atom which is the beginning of the QM region and points to the former carbon atom which is in the MM region
- The rest of the flavin fragment now belongs to the QM region
To find a specific atom number in the Workspacethe 3D display area in the center of the main window, where molecular structures are displayed, it can be useful to use control-F and use the Find: Atom search bar that appears.
-
Click the Update QM Region at the bottom of the panel
- The QM atoms are now marked in red in the Workspacethe 3D display area in the center of the main window, where molecular structures are displayed
-
Click on the QM Basis tab
- The basis set function, lacvp* is assigned to the atoms in the QM region
Every atom that is not in the QM region will be treated at the MM level.
-
Click Run
- This job will take ~ 6-7 hours to run on a 2 CPUs
- To save time, we will look at pregenerated results
You can change the basis set for any atom by clicking on the corresponding row in the table and then selecting the appropriate basis set for that atom from the dropdown on the right.
-
Go to File > Import Structures and choose
qsite_1.01.mae -
Click Open
- The QSIte results are includedthe entry is represented in the Workspace, the circle in the In column is blue in the Workspacethe 3D display area in the center of the main window, where molecular structures are displayed
The qsite_1.out file contains information about various energetic contributions to the system, as well as the set-up of the QM and MM regions.
4. Conclusion and References
This tutorial explained the minimal necessary setup of the protein-ligand system required to start working with the QSite program. We introduced the QSite panel selected of the QM region using different QM selection methods: free ligand/ion, side chain, and hydrogen cap. Such operations have to be performed in every QM/MM calculation, and it is important to become familiar with them.
5. Glossary of Terms
Entry List - a simplified view of the Project Table that allows you to perform basic operations such as selection and inclusion
included - the entry is represented in the Workspace, the circle in the In column is blue
incorporated - once a job is finished, output files from the Working directory are added to the project and shown in the Entry List and Project Table
Project Table - displays the contents of a project and is also an interface for performing operations on selected entries, viewing properties, and organizing structures and data
Scratch Project - a temporary project in which work is not saved, closing a scratch project removes all current work and begins a new scratch project
selected - (1) the atoms are chosen in the Workspace. These atoms are referred to as "the selection" or "the atom selection". Workspace operations are performed on the selected atoms. (2) The entry is chosen in the Entry List (and Project Table) and the row for the entry is highlighted. Project operations are performed on all selected entries
Working Directory - the location that files are saved
Workspace - the 3D display area in the center of the main window, where molecular structures are displayed