annotate hicSumMatrices.xml @ 8:c109622e0cf5 draft

planemo upload for repository https://github.com/maxplanck-ie/HiCExplorer/tree/master/galaxy/wrapper/ commit 0456f085bac2c88b8cbddfcf12b02776d2a0d457

<tool id="hicexplorer_hicsummatrices" name="@BINARY@" version="@WRAPPER_VERSION@.0">
    <description>combines Hi-C matrices of the same size</description>
    <macros>
        <token name="@BINARY@">hicSumMatrices</token>
        <import>macros.xml</import>
    </macros>
    <expand macro="requirements" />
    <command detect_errors="exit_code"><![CDATA[

        #for $counter, $m in enumerate($matrix_h5_cooler_multiple):
            ln -s '$m' ${counter}_matrix &&
        #end for
        #set $m = '" "'.join([ '%s_matrix' % $counter for $counter, $matrix in enumerate($matrix_h5_cooler_multiple) ])

        hicSumMatrices
            --matrices "$m"
            --outFileName matrix.$outputFormat
        
        && mv matrix.$outputFormat matrix
]]>
    </command>
    <inputs>
        <expand macro='matrix_h5_cooler_multiple_macro'/>
        
        <param name='outputFormat' type='select' label="Output file format">
            <option value='h5'>HiCExplorer format</option>
            <option value="cool">cool</option>
        </param>
    </inputs>
    <outputs>
        <data name="outFileName" from_work_dir="matrix" format="h5">
             <change_format>
                <when input="outputFormat" value="cool" format="cool" />
            </change_format>
        </data>
    </outputs>
    <tests>
        <test>
            <param name="matrix_h5_cooler_multiple" value="hicCorrectMatrix_result1.npz.h5,hicCorrectMatrix_result1.npz.h5"/>
            <!-- <param name="matrices" value="hicCorrectMatrix_result1.npz.h5,hicCorrectMatrix_result1.npz.h5"/> -->
            <param name='outputFormat' value='h5'/>
            <output name="outFileName" file="hicSumMatrices_result1.npz.h5" ftype="h5" compare="sim_size" delta="70000"/>
        </test>
    </tests>
    <help><![CDATA[
Summation of matrices
=====================

``hicSumMatrix`` is combining two (or more) contact matrices of the same size to one. 
This is useful if replicates of an Hi-C experiment should be merged into one contact matrix to 
increase the power of the data. It is the nature of Hi-C that real contact cannot be distinguished 
from noise, especially with a low contact count. The more contacts are given, the more likely it is 
that a high number of contacts are real contact or contain at least a high amount. Therefore it is 
a common way to merge replicates of Hi-C experiments to increase the validity of the experiment.

Input
-----

Parameters
__________
- two or matrices of the same shape.

Output
------
The summed matrix.

| For more information about HiCExplorer please consider our documentation on readthedocs.io_

.. _readthedocs.io: http://hicexplorer.readthedocs.io/en/latest/index.html
]]></help>
    <expand macro="citations" />
</tool>