Version: 0.2.0
A Tool for automated Optimization of XCMS Parameters
Untargeted metabolomics generates a huge amount of data. Software packages for automated data processing are crucial to successfully process these data. A variety of such software packages exist, but the outcome of data processing strongly depends on algorithm parameter settings. If they are not carefully chosen, suboptimal parameter settings can easily lead to biased results. Therefore, parameter settings also require optimization. Several parameter optimization approaches have already been proposed, but a software package for parameter optimization which is free of intricate experimental labeling steps, fast and widely applicable is still missing.
The software package IPO (‘Isotopologue Parameter Optimization’) is fast and free of labeling steps, and applicable to data from different kinds of samples and data from different methods of liquid chromatography - high resolution mass spectrometry and data from different instruments.
IPO optimizes XCMS peak picking parameters by using natural, stable 13C isotopic peaks to calculate a peak picking score. Retention time correction is optimized by minimizing relative retention time differences within peak groups. Grouping parameters are optimized by maximizing the number of peak groups that show one peak from each injection of a pooled sample. The different parameter settings are achieved by design of experiments, and the resulting scores are evaluated using response surface models. IPO was tested on three different data sets, each consisting of a training set and test set. IPO resulted in an increase of reliable groups (146% - 361%), a decrease of non-reliable groups (3% - 8%) and a decrease of the retention time deviation to one third.
IPO was successfully applied to data derived from liquid chromatography coupled to high resolution mass spectrometry from three studies with different sample types and different chromatographic methods and devices. We were also able to show the potential of IPO to increase the reliability of metabolomics data.
- IPO optimizes XCMS peak picking parameters by using natural, stable 13C isotopic peaks to calculate a peak picking score
- Retention time correction is optimized by minimizing relative retention time differences within peak groups
- Optimization / Parameter Selection Optimization
- Metabolomics / Untargeted
- MS / LC-MS
- Gunnar Libiseller (Joanneum Research Forschungsgesellschaft m.b.H., HEALTH, Institute for Biomedicine and Health Sciences)
- Michaela Dvorzak (Joanneum Research Forschungsgesellschaft m.b.H., HEALTH, Institute for Biomedicine and Health Sciences)
- Ulrike Kleb (Joanneum Research Forschungsgesellschaft m.b.H., HEALTH, Institute for Biomedicine and Health Sciences)
- Venkata Chandrasekhar Nainala (EMBL-EBI)
- Pablo Moreno (EMBL-EBI)
- Philippe Rocca-Serra (University of Oxford)
- Gabriel Cretin (IPB Halle)
This container is integrated and available in the Galaxy interface of Phenomenal, but you can still use it locally for testing by simply overriding the entrypoint of the Dockerfile as described below:
You can clone this git repository with:
git clone https://github.com/phnmnl/container-ipo.git
Then on the main directory of your local git repo, build the image:
docker build -t ipo .
And then to run:
docker run --entrypoint "runIPO.R" ipo -i /complete/path/to/filesPaths -o /complete/path/to/out
On Mac OS X with docker-machine, because there is this intermediate VM, it is recommended to mount a high level directory on docker (as /Users), which will be already mounted on the docker-machine VM.
docker run --entrypoint "runIPO.R" -v /Users:/Users ipo -i /Users/yourUser/path/to/filesPaths -o /Users/yourUser/path/to/out
IPO has a number of options, which we have wrapped for you, to find them out please execute:
docker run --entrypoint "runIPO.R" ipo
You can pull the container from the Phenomenal official docker registry:
docker pull container-registry.phenomenal-h2020.eu/phnmnl/ipo
For convenience you can rename the repository with a shorter tag:
docker tag container-registry.phenomenal-h2020.eu/phnmnl/ipo:latest <short_fancy_name>:latest
Since the tool is now in a docker container we need to mount the folder containing the testing data so that the container has access to the "outside world":
docker run --entrypoint "runIPO.R" -v /complete/local/path/to/dir:/path/in/container <short_fancy_name> -i /path/in/container/to/filesPaths -o /path/in/container/to/out
To get all the options available give no arguments:
docker run --entrypoint "runIPO.R" <short_fancy_name>
- Libiseller, G., Dvorzak, M., Kleb, U., Gander, E., Eisenberg, T., Madeo, F., ... & Magnes, C. (2015). IPO: a tool for automated optimization of XCMS parameters. BMC bioinformatics, 16(1), 1.