Quaternary Structure Modeling Through Chemical Cross-Linking Mass Spectrometry: Extending TX-MS Jupyter Reports
October 20th, 2021
Targeted cross-linking mass spectrometry creates quaternary protein structure models using mass spectrometry data acquired using up to three different acquisition protocols. When executed as a simplified workflow on the Cheetah-MS web server, the results are reported in a Jupyter Notebook. Here, we demonstrate the technical aspects of how the Jupyter Notebook can be extended for a more in-depth analysis.
This method use the power of Jupyter Notebook to deliver informative and visually appealing reports while allowing the users to extend and customize the report in a reproducible and traceable manner. This flexible technique allows all user modifications to be captured in a sufficient detail to be reproduced in a later timeframe or by different user. Although this method is generally applicable in any research field, it's primarily designed for Mucor life science, an area of research that can produce complex data.
Before beginning the analysis, open the targeted cross-linking mass spectrometry website. Upon navigation to the website, a welcome screen providing a high level description of the TX MS.web service will appear. Under the tutorial tab a detailed description of the services provided including information about how to use the service and how to analyze the results can be observed.
Under the download tab, software and resources can be downloaded. All of the software is available under an open source license. Under the License tab, the BSD 3-clause license explicitly makes the software as broadly usable as possible.
The Contact tab provides contact information for submitting questions or comments. To submit an email requesting user credentials, return to the Cheetah tab and click the email address hyperlink at the bottom of the page. Enter the relevant information into the subject line in the body of the email.
A reply will be sent as quickly as possible. After receiving a confirmation email with the user credentials, log in and upload the mass spectrometry data to the website. Click Submit workflow and enter a title and a description.
Then click view workflow and select the Cheetah workflow. After following the wizard, use the online viewer to inspect the Jupyter Notebook. To install the JupyterHub install the Docker as instructed and download the JupyterHub Docker container with the Jupyter openBIS extension.
After starting the Docker run P8171:8000 malmstroem/jove:latest container. Navigate to the indicated web address and log in with the username and password User. To download the report click new in Python 3 to open a new tab with an untitled notebook.
Click configure openBIS connections in the Jupyter tool menu and enter TX MS for the name, the TX MS web address for the URL, Guest for the user and G-U-E-S-T-P-A-S-S-W-D for the password. Select the new connection and click choose connection to search for the report. Then click, download in cell and run all to return the report.
To extend the report, click cell and insert below to add a new cell at the bottom. Then click code and press shift and enter to execute the cell. To upload the report, click the upload button to create a new data set.
A representative structure of M1 and albumin with top crosslinks mapped on the structure are shown here. All of the crosslinks were obtained by targeted crosslinking mass spectrometry after parsing high resolution MS1 data dependent and independent acquisition data and the computational models were provided by the RosettaDock protocol. It's important to remember that protein protein interactions are diverse in terms of their stability.
So therefore, your results may vary. The current methodology is limited to binary interactions and therefore cannot be applied to more complex protein quaternary structures. However, modeling individual pairs can provide a good base to build more complex structures.
Details about the binding interface can be useful in many ways, for example, to suggest mutations that can either stabilize or destabilize the protein interactions. So, this can be helpful to understand the role of protein-protein interactions better.
Overview
This article discusses a method for creating quaternary protein structure models using targeted cross-linking mass spectrometry. The workflow is executed on the Cheetah-MS web server, with results reported in a customizable Jupyter Notebook.
Key Study Components
Area of Science
- Mass Spectrometry
- Protein Structure Analysis
- Computational Biology
Background
- Targeted cross-linking mass spectrometry is a technique for studying protein interactions.
- The method is designed for complex data analysis in life sciences.
- Jupyter Notebooks provide a flexible platform for data reporting and analysis.
- Open-source software enhances accessibility for researchers.
Purpose of Study
- To demonstrate a simplified workflow for protein structure modeling.
- To showcase the capabilities of Jupyter Notebooks in scientific reporting.
- To provide a reproducible method for analyzing mass spectrometry data.
Methods Used
- Utilization of the Cheetah-MS web server for data submission.
- Integration of Jupyter Notebook for report generation.
- Application of the RosettaDock protocol for computational modeling.
- Detailed user instructions for software installation and data analysis.
Main Results
- Successful modeling of protein structures with mapped cross-links.
- Demonstration of the method's applicability to binary protein interactions.
- Insights into protein-protein interactions and their stability.
- Potential for suggesting mutations to influence protein interactions.
Conclusions
- The methodology is effective for analyzing binary protein interactions.
- Results can vary due to the diverse nature of protein interactions.
- Further development could enhance modeling of complex structures.
Frequently Asked Questions
Executive Industry Relevance
Quaternary structure modeling via targeted cross-linking mass spectrometry (TX-MS) enables high-confidence mapping of protein-protein interactions directly from complex biological samples, bypassing the need for large-scale purification. The integration of TX-MS with customizable Jupyter Notebook reports supports reproducible, traceable, and extensible analysis, enhancing predictive confidence in early discovery and structural biology pipelines. This capability is strategically relevant for biopharma R&D teams seeking to de-risk target validation and accelerate structure-guided drug discovery.
Strategic Applications in Biopharma R&D
Early Discovery & Target Validation
- Enables direct interrogation of protein-protein interfaces in native-like conditions.
- Supports functional target validation by mapping cross-links onto structural models.
- Facilitates mechanistic de-risking by clarifying interaction surfaces and stability.
- Improves predictive confidence for downstream structure-based design.
Screening & Assay Development
- Prepares validated structural models for use in screening and assay development workflows.
- Standardizes reporting and analysis through reproducible Jupyter Notebook outputs.
- Enables quantitative assessment of cross-linking data for assay optimization.
- Supports reliable evaluation of compound effects on protein interactions.
Translational & Preclinical Research
- Aligns structural insights with translational biomarker strategies when mapping disease-relevant complexes.
- Provides continuity from discovery-stage interaction mapping to preclinical model validation.
- De-risks advancement decisions by clarifying molecular mechanisms of action.
Pipeline & Workflow Integration
TX-MS with Jupyter-based reporting integrates into the discovery continuum from early target validation through lead identification and preclinical research, supporting iterative hypothesis testing and model refinement.
- Discovery Biology: Enables hypothesis-driven mapping of protein interfaces and interaction networks.
- Screening: Delivers standardized, quantitative cross-linking data for assay readiness.
- Analytics: Provides traceable, extensible reports for comparative analysis and decision support.
- Translational Research: Bridges structural findings to disease-relevant systems when supported by mapped complexes.
- Enterprise Reuse: Offers a reusable, open-source platform for ongoing structural and interaction studies.
Operational & Enterprise Impact
- Scientific Value: Increases predictive confidence and reduces ambiguity in target validation.
- Operational Value: Promotes reproducibility, traceability, and scalability through standardized digital workflows.
- Strategic Value: Enables informed go/no-go decisions and capital-efficient portfolio management.
- Portfolio Impact: Supports risk-adjusted prioritization and advancement of structurally validated targets.
Implementation Considerations
- Requires expertise in mass spectrometry, structural modeling, and computational analysis.
- Needs access to MS instrumentation and computational infrastructure for data processing and visualization.
- Demands cross-team standardization of data formats and reporting practices.
- Adaptation to more complex (non-binary) protein assemblies is currently limited.
- Practical limitations include variability in protein interaction stability and model generalizability.
Biopharma FAQs
Chapters in this video
0:04
Introduction
0:47
Targeted Cross-Linking Mass Spectrometry (TX-MS)
2:21
JupyterHub Installation
2:51
Report Download
3:30
Report Extension and Uploading
3:50
Results: Representative Structural Model of Streptococcus Pyogenes Protein M1 and Human Albumin with XLs Mapped on the Structure
4:18
Conclusion
