# Usage¶

## Video tutorial¶

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

## 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¶

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!