annotate isocor.xml @ 0:96f7617b4848 draft

planemo upload

<tool id="isocor" name="Isotope Correction for mass spectrometry labeling experiments" version="0.1.2">
    <requirements>
        <requirement type="package" version="2.1.3">isocor</requirement>
    </requirements>
    <command detect_errors="exit_code"><![CDATA[
        isocorcli -t "$tracer" -M "$input1" -D "$input2" -I "$input3"
#if $tracer_purity:
    -p $tracer_purity
#end if
#if $resolution:
    -r $resolution
#end if
#if $mz:
    -m $mz
#end if 
#if $resolution_formula_code:
    -f $resolution_formula_code
#end if
#if $correct_na_tracer:
    -n
#end if
#if $verbose_log:
    -v
#end if
 "$input4" > "$output1" 2> "$output2"
    ]]></command>
    <inputs>
        <param type="text" name="tracer" argument="-t" label="the isotopic tracer (e.g. '13C')" />
        <param type="data" name="input1" argument="-M" label="metabolites db" format="tabular" />
        <param type="data" name="input2" argument="-D" label="derivatives db" format="tabular" />
        <param type="data" name="input3" argument="-I" label="isotopes db" format="csv" />
        <param type="integer" optional="true" argument="-r" name="resolution" label="HR only: resolution of the mass spectrometer (e.g. 1e4)" />
        <param type="integer" optional="true" argument="-m" name="mz" label="HR only: mz at which resolution is given (e.g. '400')" />
        <param type="boolean" optional="true" argument="-n" name="correct_na_tracer" label="flag to correct tracer natural abundance" />
        <param type="boolean" optional="true" argument="-v" name="verbose_log" label="flag to enable verbose logs" />
        <param type="text" optional="true" argument="-p" name="tracer_purity" label="purity vector of the tracer" />

	<param name="resolution_formula_code" optional="true" argument="-f" type="select" label="HR only: spectrometer formula code">
		<option value="orbitrap">Orbitrap</option>
  		<option value="ft-icr">ft-icr</option>
  		<option value="constant">Constant</option>
  		<option value="datafile">Datafile</option>
	</param>

        <param type="data" name="input4" label="measurements Data file" format="tabular" />
    </inputs>
    <outputs>
        <data name="output1" label="corrected measurements data file" format="csv" />
        <data name="output2" label="processing log file" format="txt" />
    </outputs>
    <tests>
        <test>
            <param name="tracer" value="13C"/>
            <param name="input1" value="Metabolites.dat"/>
            <param name="input2" value="Derivatives.dat"/>
            <param name="input3" value="Isotopes.dat"/>
            <param name="input4" value="Data_example.tsv"/>
            <output name="output1">
		<assert_contents>
			<has_n_columns n="9" />
		</assert_contents>
	    </output>
            <output name="output2">
		<assert_contents>
			<has_text text="- root - INFO -    errors: 0" />
		</assert_contents>
	    </output>
        </test>
    </tests>
    <help><![CDATA[
.. class:: warningmark

 We strongly encourage you to read the `Tutorials <https://isocor.readthedocs.io/en/latest/tutorials.html#tutorials>`_ before using IsoCor.

----

usage:
    isocorcli [-h] [-M M] [-D D] [-I I] -t TRACER [-r RESOLUTION] [-m MZ_OF_RESOLUTION] [-f {orbitrap,ft-icr,constant,datafile}] [-p TRACER_PURITY] [-n] [-v] inputdata

    correction of MS data for naturally occurring isotopes

positional arguments:
  inputdata             measurements file to process

optional arguments:
  -h, --help                  show this help message and exit
  -M M                        path to metabolites database
  -D D                        path to derivatives database
  -I I                        path to isotopes database
  -t TRACER, --tracer TRACER  the isotopic tracer (e.g. "13C")

  -r RESOLUTION, --resolution RESOLUTION  HR only: resolution of the mass spectrometer (e.g. 1e4)

  -m MZ_OF_RESOLUTION, --mz_of_resolution MZ_OF_RESOLUTION   HR only: mz at which resolution is given (e.g. "400")

  -f FORMULA_ORIGIN, --resolution_formula_code FORMULA_ORIGIN
        HR only: spectrometer formula code

  -p TRACER_PURITY, --tracer_purity TRACER_PURITY   purity vector of the tracer
  -n, --correct_NA_tracer   flag to correct tracer natural abundance
  -v, --verbose             flag to enable verbose logs
    ]]></help>
    <citations>
        <citation type="bibtex">
@article{10.1093/bioinformatics/btz209,
    author = {Delépine, Baudoin and Létisse, Fabien and Millard, Pierre and Bellvert, Floriant and Guionnet, Matthieu and Heuillet, Maud},
    title = "{IsoCor: isotope correction for high-resolution MS labeling experiments}",
    year = {2019},
    month = {03},
    abstract = "{Mass spectrometry (MS) is widely used for isotopic studies of metabolism and other (bio)chemical processes. Quantitative applications in systems and synthetic biology require to correct the raw MS data for the contribution of naturally occurring isotopes. Several tools are available to correct low-resolution MS data, and recent developments made substantial improvements by introducing resolution-dependent correction methods, hence opening the way to the correction of high-resolution MS (HRMS) data. Nevertheless, current HRMS correction methods partly fail to determine which isotopic species are resolved from the tracer isotopologues and should thus be corrected. We present an updated version of our isotope correction software (IsoCor) with a novel correction algorithm which ensures to accurately exploit any chemical species with any isotopic tracer, at any MS resolution. IsoCor v2 also includes a novel graphical user interface for intuitive use by end-users and a command-line interface to streamline integration into existing pipelines.IsoCor v2 is implemented in Python 3 and was tested on Windows, Unix and MacOS platforms. The source code and the documentation are freely distributed under GPL3 license at https://github.com/MetaSys-LISBP/IsoCor/ and https://isocor.readthedocs.io/.Supplementary data are available at Bioinformatics online.}",
    doi = {10.1093/bioinformatics/btz209},
    url = {https://doi.org/10.1093/bioinformatics/btz209},
    eprint = {http://oup.prod.sis.lan/bioinformatics/advance-article-pdf/doi/10.1093/bioinformatics/btz209/28212636/btz209.pdf},
}</citation>
    </citations>
</tool>