annotate macros.xml @ 1:b8e9a7c7add2 draft

planemo upload for repository https://github.com/RECETOX/galaxytools/tree/master/tools/matchms commit ca44513d50b29a4706e2a2db96c23ef6688b7c2d

<macros>
    <token name="@TOOL_VERSION@">0.15.0</token>

    <xml name="creator">
        <creator>
            <person
                givenName="Helge"
                familyName="Hecht"
                url="https://github.com/hechth"
                identifier="0000-0001-6744-996X" />
            <person
                givenName="Zargham"
                familyName="Ahmad"
                url="https://github.com/zargham-ahmad"
                identifier="0000-0002-6096-224X" />
            <organization
                url="https://www.recetox.muni.cz/"
                email="[e-mail]"
                name="RECETOX MUNI" />
        </creator>
    </xml>

    <token name="@HELP_matchms@">
        <![CDATA[
            Documentation
                For documentation on the tool see https://github.com/matchms/matchms/blob/master/README.rst
                and https://matchms.readthedocs.io/en/latest/.

            Upstream Tools
                +-----------+---------------+--------+-----------+
                | Name      | Output File   | Format | Parameter |
                +===========+===============+========+===========+
                | RAMClustR | Mass spectra  | msp    | references|
                +-----------+---------------+--------+-----------+
                | RAMClustR | Mass spectra  | msp    | queries   |
                +-----------+---------------+--------+-----------+

            Downstream Tools
                The outputs are two tsv datasets. One containing the similarity scores and the other number of matched peaks.
        ]]>
    </token>

    <token name="@HELP_formatter@">
        <![CDATA[
            Usage
                This tool creates user friendly tables from the data matrices produces by matchms.
                The tool can be operated on two modes based on (i) thresholds or (ii) top k matches.

            Input Table Format
                The tool expects two data matrices with the format as depicted below.
                The tool assumes the reference compound labels as row labels and the query labels as column labels (as naturally outputted by matchms).

                +----------+------+------+-----+
                |          | C001 | C002 | ... |
                +==========+======+======+=====+
                | Perylene | 0.1  | 0.0  | ... |
                +----------+------+------+-----+
                | Glycine  | 0.5  | 0.34 | ... |
                +----------+------+------+-----+
                |   ...    | ...  | ...  | ... |
                +----------+------+------+-----+

            Output Table Format
                +----------+-----------+---------+--------+
                | query    | reference | matches | scores |
                +==========+===========+=========+========+
                | C001     | Glycine   |      6  | 0.5    |
                +----------+-----------+---------+--------+
                | C002     | Glycine   |     3   | 0.34   |
                +----------+-----------+---------+--------+
                |   ...    | ...       | ...     | ...    |
                +----------+-----------+---------+--------+
        ]]>
    </token>
</macros>