- Overview
- Background
- Before Starting
- Getting Started
- Software Requirements
- Architecture Design
- Data
- Funding
- License for Data
This cloud-based learning module teaches x-ray crystallography and molecular energy basics. The x-ray crystallography tutorial will be carried out threw the Phenix software. After going through this the user should be comfortable with the process of determining the protein structure. Additionally, the user should be comfortable with basic quantum chemistry concepts used to perform biochemistry modeling.
Click above image to watch overview video
The course is structured in four submodules, allowing us to:
- Gain a basic understanding of proteins and x-ray diffraction/crystallography
- Solve protein structure using SAD/MAD phasing in Phenix
- Solve protein structure using molecular replacement in Phenix
- Carry out protein modeling using COOT
The course content is organized in Jupyter Notebooks. The first three notebooks cover x-ray crystallography while the fourth discusses the quantum nature of molecular interactions.
The overall structure of the modules is explained below:
- Submodule 0: Used to launch the Phenix GUI
- Submodule 1: Provides fundamentals of protein structure and x-ray crystallography.
- Submodule 2: Solving protein structure using SAD/MAD phasing and Molecular replacement methods.
- Submodule 3: Perform protein modeling using coot.
- Submodule 4: Aims to introduce basics of molecular energies providing basics of schrodingers equation and quantum chemistry.
X-ray crystallography and molecular dynamics are two essential tools in the field of structural biology that provide valuable insights into the three-dimensional structure and dynamic behavior of proteins. X-ray crystallography is an experimental technique that involves growing protein crystals, exposing them to X-ray beams, and analyzing the resulting diffraction patterns to determine the precise atomic positions within the protein. This technique has been instrumental in elucidating the structures of countless proteins, including enzymes, receptors, and other drug targets. On the other hand, molecular dynamics is a computational method that simulates the motion and interactions of atoms within a protein over time, based on the principles of classical mechanics and empirical force fields. By capturing the dynamic nature of proteins, molecular dynamics simulations can reveal important information about protein flexibility, conformational changes, and ligand binding, which are crucial for understanding protein function and designing effective drugs.
These tutorials are designed to run on AWS with the notebooks running within SageMaker AI notebooks. Before starting please gain access to an AWS account which you will be able to run SageMaker.
Setting Up AWS Sagemaker AI
1. Setting Up an AWS SageMaker Notebook Instance
You can also reference this guide.
- Log in to AWS Management Console:
- Navigate to the AWS SageMaker Console (Find Amazon SageMaker AI in the Services, or search it in the search bar)
- Create a SageMaker Notebook Instance:
- Click Notebooks" in the left navigation pane (under Applications and IDEs, in Amazon SageMaker AI).
- Click "Create notebook instance" at the top of the Notebook instances.
- Fill out the following details:
- Notebook instance name: Provide a unique name (e.g., notebook-yourname-date).
- Instance type: Choose ml.t3.medium (or a larger instance type if your dataset is large, more examples.
- Click "Addtional configurations"
- Lifecycle Configuration (Optional): Add a script to install any additional dependencies automatically.
- Volumne size in GB: change it to 25
- IAM Role: If you don’t have an existing role, create a new one with S3 full access and AmazonSageMakerFullAccess permissions.
- Start the Notebook Instance:
- Click "Create notebook instance" and wait for the status to change to "InService".
2. Cloning the Tutorials Repository
- Open the Notebook Instance:
- Once the instance is active, click "Open JupyterLab" to access the notebook.
- Clone the Repository:
- Open a terminal from the Jupyter interface.
- Run the following command:
cd SageMakergit clone https://github.com/NIGMS/X-Ray-Crystallography-and-Molecular-Energies.git
- This will create a folder containing all tutorial files.
You can also watch the AWS notebook setup video below for step-by-step instructions:
Click above image to watch notebook setup video
Registering For Phenix Account
Submodule 2/3 uses Phenix and in order to access Phenix you must register for an account.For submodule 1, you can install all necessary requirements using the instructions in submodule 4, and the detailed software versions used in this tutorial are listed here:
python 3.10.16pandas 1.5.3IPython 8.34.0ipywidgets 8.1.5
For submodule 2/3 Phenix is used
Phenix version 1.1.4COOT 1.1.14
For submodule 4, you can install all necessary requirements using the instructions in submodule 4, and the detailed software versions used in this tutorial are listed here:
python 3.10.16pandas 1.5.3numpy 1.26.4matplotlib 3.10.1scipy 1.15.2IPython 8.34.0ipywidgets 8.1.5ase 3.24.0
Data for the crystallography exercises are from the following PDBIDs and their assocaited publications:
- 2A3N: Crystal structure of Putative glucosamine-fructose-6-phosphate aminotransferase (16423107) from SALMONELLA TYPHIMURIUM LT2 at 1.35 A resolution (To be published)
- 5TSO: Novel Enhancer Binding Site Found In Bacteria And Eukaryota But Not In Archea (To be published)
- 7DER: Acta Crystallogr D Struct Biol. 2021 Mar 1;77(Pt 3):288-292. Recent structural insights into the mechanism of lysozyme hydrolysis
- 8AB3: Mol Biol Evol 2023 40. Deciphering Evolutionary Trajectories of Lactate Dehydrogenases Provides New Insights into Allostery
- 3MJU: Crystal structure determination of pigeon (columba livia) haemoglobin at 3.5 angstrom resolution (To be published)
- 7EBC: J Struct Biol 213 2021: 107748-107748. Structural insights into the targeting specificity of ubiquitin ligase for S. cerevisiae isocitrate lyase but not C. albicans isocitrate lyase
- 7Q36: Commun Biol 5: 360-360 2022. High-pressure crystallography shows noble gas intervention into protein-lipid interaction and suggests a model for anaesthetic action.
- 7O83: J Med Chem 65: 6940-6952 2022. Discovery of AZD4625, a Covalent Allosteric Inhibitor of the Mutant GTPase KRAS G12C
We would like to acknowledge the sources of funding:
This work was supported by the Mississippi INBRE, funded by an Institutional Development Award (IDeA) from the National Institute of General Medical Sciences of the National Institutes of Health under grant number P20GM103476. Any opinions, findings, conclusions, or recommendations expressed in this material are those of the authors and do not necessarily reflect the views of the funding agencies.
Text and materials are licensed under a Creative Commons CC-BY-NC-SA license. The license allows you to copy, remix, and redistribute any of our publicly available materials, under the condition that you attribute the work (details in the license) and do not make profits from it.
This work is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License

