IDSL.CSA

The Composite Spectra Analysis (IDSL.CSA) R package for the analysis of mass spectrometry data has been developed by the Integrated Data Science Laboratory for Metabolomics and Exposomics (IDSL.ME). This package can be used for the deconvolution of fragmentation spectra obtained through various analytical methods such as MS1-only Composite Spectra deconvolution Analysis (CSA), Data Dependent Acquisition (DDA), and a various Data-Independent Acquisition (DIA) methods including MS^E, All-Ion Fragmentation (AIF), and SWATH-MS analyses. The aim of the IDSL.CSA package is to assist in streamlining the data analysis process and improving the overall chemical structure annotation in the fields of metabolomics and exposomics.

Table of Contents

• Features of IDSL.CSA
• Installation
• Workflow
• Quick Batch Example
• Wiki
• Citation

Features of IDSL.CSA

1. Parameter selection through a user-friendly and well-described parameter spreadsheet
2. Peak detection and chromatogram deconvolution for various fragmentation data analyses including Composite Spectra Analysis (CSA), Data Dependent Acquisition (DDA), and Data-Independent Acquisition (DIA)
3. Analyzing population size untargeted studies (n > 500)
4. Aggregating annotated chemical structures on the aligned peak table using meta-variables such as InChIKey, SMILES, precursor type, molecular formula,... depending on the information in the reference library. This is a very unique feature that is only presented by IDSL.CSA. To familiarize with this statistical mass spectrometry feature, try PARAM0006 in the Start tab in the IDSL.CSA parameter spreadsheet.
5. Generating batch untargeted aligned extracted ion chromatograms (EIC) figures for the DIA and CSA analyses in addition to generating batch DDA spectra figures.
6. Parallel processing in Windows and Linux environments
7. Integration with IDSL.FSA workflow to annotate various types of MSP files and generating fragmentation libraries.

Installation

install.packages("IDSL.CSA")

Workflow

Prior to processing your mass spectrometry data (mzXML, mzML, netCDF) using the IDSL.CSA workflow, mass spectrometry data should be processed using the IDSL.IPA workflow to acquire chromatographic information of the peaks (m/z-RT). When the chromatographic information of individual and aggregated aligned peaklists were generated using the IDSL.IPA workflow, download the IDSL.CSA parameter spreadsheet and select the parameters accordingly and then use this spreadsheet as the input for the IDSL.CSA workflow:

library(IDSL.CSA)
IDSL.CSA_workflow("Address of the CSA parameter spreadsheet")

Quick Batch Example

Follow these steps for a quick case study (n = 33) ST002263 which has Thermo Q Exactive HF hybrid Orbitrap data collected in the HILIC-ESI-POS/NEG modes.

1. Process raw mass spectrometry data and chromatographic information using the method described for IDSL.IPA

2. The Composite Spectra Analysis requires 39 parameters distributed into 5 separate sections for a full scale analysis. For this study, use default parameter values presented in the IDSL.CSA parameter spreadsheet. Next, provide information for

   2.1. Select YES for PARAM0001 in the Start tab to only process CSA workflow.

   2.2. CSA0005 for HRMS data location address (MS1 level HRMS data)

   2.3. CSA0008 for Address of the peaklists directory generated by the IDSL.IPA workflow

   2.4. CSA0009 for Address of the peak_alignment directory generated by the IDSL.IPA workflow

   2.5. CSA0011 for Output location (.msp files and EICs)

   2.6. You may also increase the number of processing threads using CSA0004 according to your computational power

3. Run this command in R/Rstudio console or terminal:

library(IDSL.CSA)
IDSL.CSA_workflow("Address of the CSA parameter spreadsheet")

4. You may parse the results at the address you provided for CSA0011.

   4.1. CSA_MSP includes .msp file

   4.2. CSA_adduct_annotation includes peaklists with potential adduct information

   4.3. peak_alignment_subset includes subsets of aligned peak tables for the major ions in each CSA cluster

   4.4. aligned_spectra_table includes information for the CSA aggregation on the aligned table

Wiki

1. CSA analysis by IDSL.CSA
2. DDA analysis by IDSL.CSA
3. DIA analysis by IDSL.CSA
4. Unique spectra aggregation

Citation

[1] Fakouri Baygi, S., Kumar, Y. Barupal, D.K. IDSL.CSA: Composite Spectra Analysis for Chemical Annotation of Untargeted Metabolomics Datasets. Analytical Chemistry, 2023, 95(25), 9480–9487.

[2] Fakouri Baygi, S., Kumar, Y. Barupal, D.K. IDSL. IPA characterizes the organic chemical space in untargeted LC/HRMS datasets. Journal of proteome research, 2022, 21(6), 1485-1494.