view bigwigCompare.xml @ 47:56b3f9d4fafe

Uploaded

<tool id="bigwigCompare" name="bigwigCompare" version="1.0">
  <description>compares two bigwig files based on the number of mapped reads</description>

  <command>
  bigwigCompare
  --bigwig1 '$bigwigFile1'
  --bigwig2 '$bigwigFile2'

  --outFileName '$outFileName'
  --outFileFormat '$outFileFormat'

  --ratio $comparison_type
  
  #if $advancedOpt.showAdvancedOpt == "yes":
    #if str($advancedOpt.region.value) != '':
      --region '$advancedOpt.region'
    #end if
  
    --missingDataAsZero $advancedOpt.missingDataAsZero
    --scaleFactors '$advancedOpt.scaleFactor1:$advancedOpt.scaleFactor2'
    --pseudocount '$advancedOpt.pseudocount'
    --binSize $advancedOpt.binSize
    
  #end if
  --numberOfProcessors 4
  

  </command>

  <inputs>
    <param name="bigwigFile1" format="bigwig" type="data" label="Treatment bigwig file" />

    <param name="bigwigFile2" format="bigwig" type="data" label="Input bigwig file" />

      <param name="comparison_type" type="select" 
	     label="How to compare the two files"
	     help="The reciprocal ratio returns the negative of the inverse of the ratio if the ratio is less than 0. The resulting values are interpreted as negative fold changes." >
	    <option value="log2" selected="true">log2 ratio</option>
	    <option value="ratio">simple ratio</option>
	    <option value="subtract">difference (subtract input from treatment)</option>
	    <option value="add">sum</option>
	    <option value="reciprocal_ratio">reciprocal ratio</option>
      </param>

    

    <param name="outFileFormat" type="select" label="Coverage file format">
        <option value="bigwig" selected="true">bigwig</option>
	<option value="bedgraph">bedgraph</option>
    </param>
    
        <conditional name="advancedOpt">
    <param name="showAdvancedOpt" type="select" label="Show advanced options" >
        <option value="no" selected="true">no</option>
        <option value="yes">yes</option>
      </param>
      <when value="no" />
      <when value="yes">
      
          <param name="binSize" type="integer" value="50" min="1" 
	   label="Bin size in bp"
	   help="Size of the bins in bp for the ouput of the bigwig/bedgraph file "/>
    
    <param name="region" type="text" value=""
	   label="Region of the genome to limit the operation to"
	   help="This is useful when testing parameters to reduce the computing time. The format is chr:start:end, for example &quot;chr10&quot; or &quot;chr10:456700:891000&quot;" />
	   
	<param name="missingDataAsZero" type="boolean" truevalue="yes" falsevalue="no" checked="True"
	   label ="Treat missing data as zero"
	   help  ="This parameter determines if missing data should be replaced with a zero. If set to &quot;no&quot;, missing data will be ignored and will not be included in the output file at all. Missing data is defined as those regions for which no value exists in *any* of the bigwig files. The decision to include or exclude missing data depends on the interpretation of the data. Missing data in a bigwig file may mean that there is no information available for certain regions, for example a repetitive region that is not being considered. In the same file regions with low coverage may get zero read counts. If missing data is replaced by zero, this would convert the excluded repetitive regions into regions of low coverage." />
	
	<param name="scaleFactor1" type="float" value="1" label="Scale factor for treatment"/>
	<param name="scaleFactor2" type="float" value="1" label="Scale factor for input"/>
	<param name="pseudocount" type="float" value="1" label="Pseudocount" help="Small number to avoid dividing by zero."/>

	</when>
 </conditional>

  </inputs>
  <outputs>
    <data format="bigwig" name="outFileName">
	<change_format>
		<when input="outFileFormat" value="bigwig" format="bigwig" />
		<when input="outFileFormat" value="bedgraph" format="bedgraph" />
	</change_format>
    </data>
  </outputs>

  <requirements>
    <requirement type="python-module">argsparse</requirement>
    <requirement type="python-module">pysam</requirement>
    <requirement type="python-module">numpy</requirement>
  </requirements>

  <help>

**What it does**

This tool compares two bigwig files based on the number of mapped reads. To
compare the bigwig files the genome is partitioned into bins of equal size,
then the number of reads found in each BAM file are counted for such bins and
finally a summarizing value is reported. This vaule can be the ratio of the
number of readsper bin, the log2 of the ratio, the sum or the difference.

-----

.. class:: infomark

Please acknowledge that this tool **is still in development** and we will be very happy to receive feedback from the users. If you run into any trouble please sent an email to `Fidel Ramirez`_.

This tool is developed by the `Bioinformatics and Deep-Sequencing Unit`_ at the `Max Planck Institute for Immunobiology and Epigenetics`_.


.. _Bioinformatics and Deep-Sequencing Unit: http://www3.ie-freiburg.mpg.de/facilities/research-facilities/bioinformatics-and-deep-sequencing-unit/
.. _Max Planck Institute for Immunobiology and Epigenetics: http://www3.ie-freiburg.mpg.de
.. _Fidel Ramirez: [e-mail]

  </help>
  
</tool>