Usage

Video tutorial

See below for 5 min video for how to use either mzml2isa-qt, imzml2isa-qt or nmrml2isa-qt.

https://www.youtube.com/watch?v=xy3uusQRkbI

Folder structure

For mzML files, mzml2isa only requires that you put all you files in the same folder, and parsing should work fine. Note that reference to RAW files is extracted from the mzML files, so if you plan to create an ISA archive after mzml2isa creates ISA files, don’t forget to include those as well.

Example structure:

/
└ home/
  └ metabolomics/
    └ MZML study1/      # the name of the folder doesn't matter
      ├ Sample1.mzML   # the name of the file must correspond to the sample name
      ├ Sample2.mzML
      └ ...
    └ MZML study2/      # the name of the folder doesn't matter
      ├ Sample1.mzML   # the name of the file must correspond to the sample name
      ├ Sample2.mzML
      └ ...

See the mzml2isa documentation for more details.

Starting interface

../_images/mzml2isa_qt_1.png
  1. Directory containing the mzML files. e.g. ‘MZML study1’ in the above example
  2. Output folder (automatically the same as input)
  3. Study name (automatically the same as the input folder name, e.g. ‘MZML study1’ in the above example)
  4. If the ‘input folder’ contains multiple studies then mzML2ISA will be run each study, e.g. in the above example if ‘metabolomics’ folder was chosen as the ‘input folder’ then the parsing will be performed on both studies (‘MZML study 1’, ‘MZML study 2’)
  5. If selected, separate assay files will be created for positive and negative assays
  6. If selected, the output folder will be the same as the input folder and input folder name will be used as the study name
  7. The ‘Add Metadata’ button will open a new dialog box where users can add more metadata
  8. Start the conversion process!

Adding additional metadata

Users can add additional metadata manually through the dialog box below. However, all this information can be added at the final stage with ISAcreator tool.

../_images/mzml2isa_qt_2.png

Conversion

The following dialog boxes after the convert button is pressed. By default this is run in parallel (multiple cores). The following file types will be generated Investigation, Study and Assay

../_images/mzml2isa_qt_31.png

Editing with ISAcreator

The ISA-Tab structure can be further populated with the ISAcreator software.

See brief tutorial for more details.