annotate reldist.xml @ 19:a8eabd2838f6 draft

planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/bedtools commit 542ddc9e98cee5cc2a9e4caae945dee4b2c747b8

<tool id="bedtools_reldistbed" name="ReldistBed" version="@WRAPPER_VERSION@.0">
    <description>calculate the distribution of relative distances</description>
    <macros>
        <import>macros.xml</import>
    </macros>
    <expand macro="requirements" />
    <expand macro="stdio" />
    <command>
<![CDATA[
        bedtools reldist
        -a '$inputA'
        -b '$inputB'
        $detail
        > '$output'
]]>
    </command>
    <inputs>
        <param format="bed,bam,vcf,gff,gff3" name="inputA" type="data" label="BED/VCF/GFF/BAM file"/>
        <param format="bed,gff,vcf,gff3" name="inputB" type="data" label="BED/VCF/GFF file"/>
        <param name="detail" type="boolean" checked="false" truevalue="-detail" falsevalue=""
            label="Instead of a summary, report the relative distance for each interval in A" help="(-detail)" />
    </inputs>
    <outputs>
        <data format_source="inputA" name="output" metadata_source="inputA" label="Relalative distance of ${inputA.name} and ${inputB.name}"/>
    </outputs>
    <tests>
        <test>
            <param name="inputA" value="a.bed" ftype="bed" />
            <param name="inputB" value="a.bed" ftype="bed" />
            <output name="output" file="reldistBed_result1.bed" ftype="bed" />
        </test>
    </tests>
    <help>
<![CDATA[
**What it does**

Traditional approaches to summarizing the similarity between two sets of genomic intervals are based upon the number or proportion of intersecting intervals. However, such measures are largely blind to spatial correlations between the two sets where, dpesite consistent spacing or proximity, intersections are rare (for example, enhancers and transcription start sites rarely overlap, yet they are much closer to one another than two sets of random intervals). Favorov et al proposed a relative distance metric that describes distribution of relative distances between each interval in one set nd the two closest intervals in another set (see figure above). If there is no spatial correlation between the two sets, one would expect the relative distances to be uniformaly distributed among the relative distances ranging from 0 to 0.5. If, however, the intervals tend to be much closer than expected by chance, the distribution of observed relative distances would be shifted towards low relative distance values (e.g., the figure below).

.. image:: $PATH_TO_IMAGES/reldist-glyph.png

.. class:: infomark

@REFERENCES@
]]>
    </help>
    <expand macro="citations">
        <citation type="doi">10.1371/journal.pcbi.1002529</citation>
    </expand>
</tool>