Jardeko-1127 / StrMNA

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

StrMNA

StrMNA User Manual

  • *1. Introduction and Installation

  • *2. Input files

    • *2.1 Background database

    • *2.2 Files for structure annotation

  • *3. Software running instructions

    • *3.1 Parameter settings for StrMN

    • *3.2 Metabolite annotation

      • *3.2.1 Using the default background database
      • *3.2.2 Building a new background network

1. Introduction and Installation

  • Structural Molecular Network-based Annotation (StrMNA) is a free network-based and spectral library-independent tool for deep annotation of untargeted ultra-performance liquid chromatography-high resolution mass spectrometry (UPLC-HRMS) metabolomics data. The source program is in the Python language, and the development environment is Spyder 3.7.

2. Input files

2.1 Background database

  • If you want to use the default background network, you can skip this step.
  • If you want to build a new background network instead of using the default one for the subsequent metabolite annotation, you need to provide a background database form. This form should be stored in csv format file and be named ‘Background database_POS.csv’ for positive ion mode and ‘Background database_NEG.csv’ for negative ion mode (Figure 1). The background database contains the ID, SMILES, exact mass, retention time (RT/min), formula, and Name.

image
Figure 1. Background database

2.2 Files for structure annotation

  • Peak table: The original data obtained from the biological sample after UPLC-HRMS analysis was processed by the peak picking software (such as Compound Discoverer, MS-DIAL, MZmine 2, XCMS, etc.) to obtain the peak table, including MS1, RT, exact mass, and calibration RT (Figure 2). The experimental RT should be corrected to the chromatographic condition used in the background database, which is called calibration RT. Then the ion fusion tools were used to remove the redundancy of metabolic features, such as CAMERA, mz.unity, and so on. The peak table should be named ‘Peak table_POS.csv’ for positive ion mode and ‘Peak table_NEG.csv’ for negative ion mode.

image
Figure 2. Peak table

  • MGF files: The raw data was translated to the MGF files with the open-source software MSConvert, which was known as MS/MS spectra data (Figure 3). The MGF files should be named ‘MSMS1.mgf’, ‘MSMS2.mgf’, …, ‘MSMSn.mgf’.

image
Figure 3. MGF files

  • Seed metabolites: A list of seed metabolites is needed, in which the seed metabolites were identified by searching the MS/MS spectral library (Figure 4). The list of seed metabolites should be named ‘Seed metabolites_POS.csv’ for positive ion mode and ‘Seed metabolites_NEG.csv’ for negative ion mode.

image
Figure 4. Seed metabolites

3. Software running instructions

  • The executable file is published in a folder, as shown in Figure 5. Double-click StrMNA.exe in the folder ‘StrMNA’ to run the executable file.

image
Figure 5. The folder where the software is published

3.1 Parameter settings for StrMNA

  • Enter parameters in turn according to the software prompts, and then press ‘Enter’ to continue. The default parameters are shown in Figure 6.

image
Figure 6. Software interface for parameter settings

3.2 Metabolite annotation

3.2.1 Using the default background database

  • When you decide to use the default background network for metabolite annotation, the software interface is shown in Figure 7.
  • If you use StrMNA for the first time, you should set parameters as shown in Figure 8.

image
Figure 7. Software interface for Metabolite annotation using the default background network

3.2.2 Building a new background network

  • When you decide to build a new background network for the subsequent metabolite annotation, the software interface is shown in Figure 8.

    image
    Figure 8. Software interface for Metabolite annotation using a new background network

About


Languages

Language:Python 93.9%Language:R 6.1%