Mercurial > repos > bgruening > bedtools_test_bag
changeset 5:b78d20957e7f draft
Uploaded
line wrap: on
line diff
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/BedToBam.xml Thu Jun 05 15:25:18 2014 -0400 @@ -0,0 +1,34 @@ +<tool id="bedtools_bedtobam" name="Convert from BED to BAM" version="0.1.0"> + <description></description> + <macros> + <import>macros.xml</import> + </macros> + <expand macro="requirements" /> + <expand macro="stdio" /> + <command> + bedToBam + $ubam + $bed12 + -mapq $mapq + -i '$input' + > '$output' + + </command> + <inputs> + <param format="bed" name="input" type="data" label="Convert the following BED file to BAM"/> + <param name="bed12" type="boolean" label="Indicate that the input BED file is in BED12 (a.k.a “blocked” BED) format" truevalue="-bed12" falsevalue="" checked="false" help="If Selected, bedToBam will convert blocked BED features (e.g., gene annotaions) into “spliced” BAM alignments by creating an appropriate CIGAR string.."/> + <param name="mapq" type="integer" label="Set a mapping quality (SAM MAPQ field) value for all BED entries" value="255" /> + <param name="ubam" type="boolean" label="Write uncompressed BAM output." truevalue="-ubam" falsevalue="" checked="false"/> + + </inputs> + <outputs> + <data format="bam" name="output" metadata_source="input" label="${input.name} (as BAM)"/> + </outputs> + <help> + +**What it does** + +bedToBam converts features in a feature file to BAM format. This is useful as an efficient means of storing large genome annotations in a compact, indexed format for visualization purposes. + + </help> +</tool>
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/bamToBed.xml Thu Jun 05 15:25:18 2014 -0400 @@ -0,0 +1,54 @@ +<tool id="bedtools_bamtobed" name="Convert from BAM to BED" version="0.2.0"> + <description></description> + <macros> + <import>macros.xml</import> + </macros> + <expand macro="requirements" /> + <expand macro="stdio" /> + <command> + bamToBed + $option + $ed_score + -i '$input' + > '$output' + #if str($tag): + -tag $tag + #end if + </command> + <inputs> + <param format="bam" name="input" type="data" label="Convert the following BAM file to BED"/> + <param name="option" type="select" label="What type of BED output would you like"> + <option value="">Create a 6-column BED file.</option> + <option value="-bed12">Create a full, 12-column "blocked" BED file.</option> + <option value="-bedpe">Create a paired-end, BEDPE format.</option> + </param> + <param name="split" type="boolean" label="Report each portion of a split BAM alignment" truevalue="-split" falsevalue="" checked="false" help="(i.e., having an 'N' CIGAR operation) as a distinct BED intervals."/> + <param name="ed_score" type="boolean" label="Use alignment's edit-distance for BED score" truevalue="-ed" falsevalue="" checked="false"/> + <param name="tag" type="text" optional="true" label="Use other NUMERIC BAM alignment tag as the BED score"/> + </inputs> + <outputs> + <data format="bed" name="output" metadata_source="input" label="${input.name} (as BED)"/> + </outputs> +<help> + +**What it does** + +bedtools bamtobed is a conversion utility that converts sequence alignments in BAM format into BED, BED12, and/or BEDPE records. + +.. class:: infomark + +The "Report spliced BAM alignment..." option breaks BAM alignments with the "N" (splice) operator into distinct BED entries. For example, using this option on a CIGAR such as 50M1000N50M would, by default, produce a single BED record that spans 1100bp. However, using this option, it would create two separate BED records that are each 50bp in size and are separated by 1000bp (the size of the N operation). This is important for RNA-seq and structural variation experiments. + + +.. class:: warningmark + +If using a custom BAM alignment TAG as the BED score, note that this must be a numeric tag (e.g., type "i" as in NM:i:0). + +.. class:: warningmark + +If creating a BEDPE output (see output formatting options), the BAM file should be sorted by query name. + +@REFERENCES@ + + </help> +</tool>
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/closestBed.xml Thu Jun 05 15:25:18 2014 -0400 @@ -0,0 +1,41 @@ +<tool id="bedtools_closestbed" name="ClosestBed" version="0.2.0"> + <description></description> + <macros> + <import>macros.xml</import> + </macros> + <expand macro="requirements" /> + <expand macro="stdio" /> + <command> + closestBed + $split + $strand + $addition + -t $ties + -a $inputA + -b $inputB + > $output + </command> + <inputs> + <param format="bed,vcf,gff,gff3" name="inputA" type="data" label="BED or BAM file"/> + <param format="bed,gff,vcf,gff3" name="inputB" type="data" label="overlap intervals in this BED file?"/> + + <param name="ties" type="select" label="How ties for closest feature should be handled" help="This occurs when two features in B have exactly the same overlap with a feature in A."> + <option value="all" selected="True">all- Report all ties (default)</option> + <option value="first">first- Report the first tie that occurred in the B file</option> + <option value="last">last- Report the last tie that occurred in the B file</option> + </param> + + <param name="strand" type="boolean" checked="false" truevalue="-s" falsevalue="" label="Force strandedness." help="That is, find the closest feature in B overlaps A on the same strand. By default, this is disabled." /> + <param name="addition" type="boolean" checked="false" truevalue="-d" falsevalue="" label="In addition to the closest feature in B, report its distance to A as an extra column. The reported distance for overlapping features will be 0." /> + </inputs> + <outputs> + <data format_source="inputA" name="output" metadata_source="inputA" label="Intersection of ${inputA.name} and ${inputB.name}"/> + </outputs> + <help> + +**What it does** + +Similar to intersectBed, closestBed searches for overlapping features in A and B. In the event that no feature in B overlaps the current feature in A, closestBed will report the closest (that is, least genomic distance from the start or end of A) feature in B. For example, one might want to find which is the closest gene to a significant GWAS polymorphism. Note that closestBed will report an overlapping feature as the closest—that is, it does not restrict to closest non-overlapping feature. + + </help> +</tool>
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/clusterBed.xml Thu Jun 05 15:25:18 2014 -0400 @@ -0,0 +1,37 @@ +<tool id="bedtools_clusterbed" name="ClusterBed" version="0.2.0"> + <description></description> + <macros> + <import>macros.xml</import> + </macros> + <expand macro="requirements" /> + <expand macro="stdio" /> + <command> + closestBed + $strand + -d $distance + -i $inputA + > $output + </command> + <inputs> + <param format="bed,vcf,gff,gff3" name="inputA" type="data" label="BED or BAM file"/> + + <param name="strand" type="boolean" checked="false" truevalue="-s" falsevalue="" label="Force strandedness." help="That is, only cluster features that are the same strand. By default, this is disabled." /> + <param name="distance" type="integer" value="0" label="Maximum distance between features allowed for features to be clustered" help="Default is 0. That is, overlapping and/or book-ended features are clustered." /> + </inputs> + <outputs> + <data format_source="inputA" name="output" metadata_source="inputA" label=""/> + </outputs> + <help> + +**What it does** + +Similar to merge, cluster report each set of overlapping or “book-ended” features in an interval file. In contrast to merge, cluster does not flatten the cluster of intervals into a new meta-interval; instead, it assigns an unique cluster ID to each record in each cluster. This is useful for having fine control over how sets of overlapping intervals in a single interval file are combined. + +.. image:: $PATH_TO_IMAGES/cluster-glyph.png + +.. class:: warningmark + +bedtools cluster requires that you presort your data by chromosome and then by start position (e.g., sort -k1,1 -k2,2n in.bed > in.sorted.bed for BED files). + + </help> +</tool>
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/complementBed.xml Thu Jun 05 15:25:18 2014 -0400 @@ -0,0 +1,30 @@ +<tool id="bedtools_complementbed" name="ComplementBed" version="0.2.0"> + <description></description> + <macros> + <import>macros.xml</import> + </macros> + <expand macro="requirements" /> + <expand macro="stdio" /> + <command> + complementBed + -d $distance + -g genome + > $output + </command> + <inputs> + <param format="bed,vcf,gff,gff3" name="inputA" type="data" label="BED or BAM file"/> + <expand macro="genome" /> + </inputs> + <outputs> + <data format_source="inputA" name="output" metadata_source="inputA" label="Complemen of ${inputA.name}"/> + </outputs> + <help> + +**What it does** + +bedtools complement returns all intervals in a genome that are not covered by at least one interval in the input BED/GFF/VCF file. + +.. image:: $PATH_TO_IMAGES/complement-glyph.png + + </help> +</tool>
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/coverageBed.xml Thu Jun 05 15:25:18 2014 -0400 @@ -0,0 +1,53 @@ +<tool id="bedtools_coveragebed" name="Compute both the depth and breadth of coverage" version="0.2.0"> + <description>of features in file A across the features in file B (coverageBed)</description> + <macros> + <import>macros.xml</import> + </macros> + <expand macro="requirements" /> + <expand macro="stdio" /> + <command> + coverageBed + #if $inputA.ext == "bam" + -abam '$inputA' + #else + -a '$inputA' + #end if + -b '$inputB' + $split + $strand + | sort -k1,1 -k2,2n + > '$output' + </command> + <inputs> + <param format="bed,bam,gff,gg3,vcf" name="inputA" type="data" label="Count how many intervals in this BED or BAM file (source)"> + <validator type="unspecified_build" /> + </param> + <param format="bed,gff,gff3,vcf" name="inputB" type="data" label="overlap the intervals in this BED file (target)"> + <validator type="unspecified_build" /> + </param> + <param name="split" type="boolean" checked="false" truevalue="-split" falsevalue="" label="Treat split/spliced BAM or BED12 entries as distinct BED intervals when computing coverage." + help="If set, the coverage will be calculated based the spliced intervals only. For BAM files, this inspects the CIGAR N operation to infer the blocks for computing coverage. For BED12 files, this inspects the BlockCount, BlockStarts, and BlockEnds fields (i.e., columns 10,11,12). If this option is not set, coverage will be calculated based on the interval's START/END coordinates, and would include introns in the case of RNAseq data." /> + <param name="strandedness" type="boolean" label="Force strandedness." truevalue="-s" falsevalue="" checked="false" + help="That is, only features in A are only counted towards coverage in B if they are the same strand."/> + </inputs> + + <outputs> + <data format="bed" name="output" metadata_source="inputB" label="count of overlaps in ${inputA.name} on ${inputB.name}"/> + </outputs> + <help> + +**What it does** + +coverageBed_ computes both the depth and breadth of coverage of features in file A across the features in file B. For example, coverageBed can compute the coverage of sequence alignments (file A) across 1 kilobase (arbitrary) windows (file B) tiling a genome of interest. One advantage that coverageBed offers is that it not only counts the number of features that overlap an interval in file B, it also computes the fraction of bases in B interval that were overlapped by one or more features. +Thus, coverageBed also computes the breadth of coverage for each interval in B. + +.. coverageBed: http://bedtools.readthedocs.org/en/latest/content/tools/coverage.html + +.. class:: infomark + +The output file will be comprised of each interval from your original target BED file, plus an additional column indicating the number of intervals in your source file that overlapped that target interval. + +@REFERENCES@ + + </help> +</tool>
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/flankbed.xml Thu Jun 05 15:25:18 2014 -0400 @@ -0,0 +1,59 @@ +<tool id="bedtools_flankbed" name="FlankBed" version="0.2.0"> + <description></description> + <macros> + <import>macros.xml</import> + </macros> + <expand macro="requirements" /> + <expand macro="stdio" /> + <command> + flankBed + $pct + $strand + -g $genome + -i $inputA + > $output + #if addition.addition_select = 'b': + -b $b + #else: + -l $l + -r $r + #end if + </command> + <inputs> + <param format="bed,vcf,gff,gff3" name="inputA" type="data" label="BED or BAM file"/> + <expand macro="genome" /> + <param name="pct" type="boolean" checked="false" truevalue="-pct" falsevalue="" label="Define -l and -r as a fraction of the feature’s length" help="E.g. if used on a 1000bp feature, -l 0.50, will add 500 bp “upstream”" /> + <param name="strand" type="boolean" checked="false" truevalue="-s" falsevalue="" label="Define -l and -r based on strand" help="For example. if used, -l 500 for a negative-stranded feature, it will add 500 bp to the end coordinate" /> + + + <conditional name="addition"> + <param name="addition_select" type="select" label="Choose what you want to do"> + <option value="b" selected="True">Increase the BED/GFF/VCF entry by the same number base pairs in each direction.</option> + <option value="lr">Increase by Start Coordinate and End Coordinate</option> + </param> + <when value="b"> + <param name="b" label="Give Value" type="integer" value="0" /> + </when> + <when value="lr"> + <param name="l" label="The number of base pairs to subtract from the start coordinate" type="integer" value="0" /> + <param name="r" label="The number of base pairs to add to the end coordinate" type="integer" value="0" /> + </when> + </conditional> + </inputs> + <outputs> + <data format_source="inputA" name="output" metadata_source="inputA" label=""/> + </outputs> + <help> + +**What it does** + +bedtools flank will optionally create flanking intervals whose size is user-specified fraction of the original interval. + +.. image:: $PATH_TO_IMAGES/flank-glyph.png + +.. class:: warningmark + +In order to prevent creating intervals that violate chromosome boundaries, bedtools flank requires a genome file defining the length of each chromosome or contig. + + </help> +</tool>
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/genomeCoverageBed_bedgraph.xml Thu Jun 05 15:25:18 2014 -0400 @@ -0,0 +1,122 @@ +<tool id="bedtools_genomecoveragebed_bedgraph" name="Create a BedGraph of genome coverage" version="0.2.0"> + <description> + </description> + <macros> + <import>macros.xml</import> + </macros> + <expand macro="requirements" /> + <expand macro="stdio" /> + <command> + genomeCoverageBed + #if $input.ext == "bam" + -ibam '$input' + #else + -i '$input' + -g ${chromInfo} + #end if + + #if str($scale): + -scale $scale + #end if + + -bg + $zero_regions + $split + $strand + > '$output' + </command> + <inputs> + <param format="bed,bam" name="input" type="data" label="The BAM or BED file from which coverage should be computed"> + <validator type="unspecified_build" /> + </param> + + <param name="zero_regions" type="boolean" checked="true" truevalue="-bga" falsevalue="" label="Report regions with zero coverage" help="If set, regions without any coverage will also be reported." /> + + <param name="split" type="boolean" checked="false" truevalue="-split" falsevalue="" label="Treat split/spliced BAM or BED12 entries as distinct BED intervals when computing coverage." help="If set, the coverage will be calculated based the spliced intervals only. For BAM files, this inspects the CIGAR N operation to infer the blocks for computing coverage. For BED12 files, this inspects the BlockCount, BlockStarts, and BlockEnds fields (i.e., columns 10,11,12). If this option is not set, coverage will be calculated based on the interval's START/END coordinates, and would include introns in the case of RNAseq data." /> + + <param name="strand" type="select" label="Calculate coverage based on"> + <option value="">both strands combined</option> + <option value="-strand +">positive strand only</option> + <option value="-strand -">negative strand only</option> + </param> + + <param name="scale" type="float" optional="true" label="Scale the coverage by a constant factor" help="Each BEDGRAPH coverage value is multiplied by this factor before being reported. Useful for normalizing coverage by, e.g., reads per million (RPM)"/> + </inputs> + <outputs> + <data format="bedgraph" name="output" metadata_source="input" label="${input.name} (Genome Coverage BedGraph)" /> + </outputs> + +$ cat A.bed +chr1 10 20 +chr1 20 30 +chr2 0 500 + +$ cat my.genome +chr1 1000 +chr2 500 + +$ bedtools genomecov -i A.bed -g my.genome +chr1 0 980 1000 0.98 +chr1 1 20 1000 0.02 +chr2 1 500 500 1 +genome 0 980 1500 0.653333 +genome 1 520 1500 0.346667 + + <help> + + +**What it does** + +This tool calculates the genome-wide coverage of intervals defined in a BAM or BED file and reports them in BedGraph format. + +.. class:: warningmark + +The input BED or BAM file must be sorted by chromosome name (but doesn't necessarily have to be sorted by start position). + +----- + +**Example 1** + +Input (BED format)- +Overlapping, un-sorted intervals:: + + chr1 140 176 + chr1 100 130 + chr1 120 147 + + +Output (BedGraph format)- +Sorted, non-overlapping intervals, with coverage value on the 4th column:: + + chr1 100 120 1 + chr1 120 130 2 + chr1 130 140 1 + chr1 140 147 2 + chr1 147 176 1 + +----- + +**Example 2 - with ZERO-Regions selected (assuming hg19)** + +Input (BED format)- +Overlapping, un-sorted intervals:: + + chr1 140 176 + chr1 100 130 + chr1 120 147 + + +Output (BedGraph format)- +Sorted, non-overlapping intervals, with coverage value on the 4th column:: + + chr1 0 100 0 + chr1 100 120 1 + chr1 120 130 2 + chr1 130 140 1 + chr1 140 147 2 + chr1 147 176 1 + chr1 176 249250621 0 + +@REFERENCES@ + </help> +</tool>
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/genomeCoverageBed_histogram.xml Thu Jun 05 15:25:18 2014 -0400 @@ -0,0 +1,67 @@ +<tool id="bedtools_genomecoveragebed_histogram" name="Create a histogram of genome coverage" version="0.2.0"> + <description> + </description> + <macros> + <import>macros.xml</import> + </macros> + <expand macro="requirements" /> + <expand macro="stdio" /> + <command> + genomeCoverageBed + #if $input.ext == "bam" + -ibam '$input' + #else + -i '$input' + -g ${chromInfo} + #end if + #if str($max): + -max $max + #end if + > '$output' + </command> + + <inputs> + <param format="bed,bam" name="input" type="data" label="The BAM or BED file from which coverage should be computed"></param> + <param name="max" type="text" optional="true" label="Max depth" help="Combine all positions with a depth >= max into a single bin in the histogram."/> + </inputs> + + <outputs> + <data format="tabular" name="output" metadata_source="input" label="${input.name} (Genome Coverage Histogram)" /> + </outputs> + +<help> +**What it does** + +This tool calculates a histogram of genome coverage depth based on mapped reads in BAM format or intervals in BED format. + + +------ + + +.. class:: infomark + +The output file will contain five columns: + + * 1. Chromosome name (or 'genome' for whole-genome coverage) + * 2. Coverage depth + * 3. The number of bases on chromosome (or genome) with depth equal to column 2. + * 4. The size of chromosome (or entire genome) in base pairs + * 5. The fraction of bases on chromosome (or entire genome) with depth equal to column 2. + +**Example Output**:: + + chr2L 0 1379895 23011544 0.0599653 + chr2L 1 837250 23011544 0.0363839 + chr2L 2 904442 23011544 0.0393038 + chr2L 3 913723 23011544 0.0397072 + chr2L 4 952166 23011544 0.0413778 + chr2L 5 967763 23011544 0.0420555 + chr2L 6 986331 23011544 0.0428624 + chr2L 7 998244 23011544 0.0433801 + chr2L 8 995791 23011544 0.0432735 + chr2L 9 996398 23011544 0.0432999 + + +@REFERENCES@ + </help> +</tool>
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/getfastaBed.xml Thu Jun 05 15:25:18 2014 -0400 @@ -0,0 +1,45 @@ +<tool id="bedtools_getfastabed" name="GetFastaBed" version="0.2.0"> + <description></description> + <macros> + <import>macros.xml</import> + </macros> + <expand macro="requirements" /> + <expand macro="stdio" /> + <command> + bedtools getfasta + + $name + $tab + $strand + $split + -fi $fasta + -bed $inputA + -fo $output + </command> + <inputs> + <param format="bed,vcf,gff,gff3" name="inputA" type="data" label="BED or BAM file"/> + <param format="fasta" name="fasta" type="data" label="Fasta file"/> + + <param name="name" type="boolean" checked="false" truevalue="-name" falsevalue="" label="Use the “name” column in the BED file for the FASTA headers in the output FASTA file" /> + <param name="tab" type="boolean" checked="false" truevalue="-tab" falsevalue="" label="Report extract sequences in a tab-delimited format instead of in FASTA format." /> +<param name="strand" type="boolean" checked="false" truevalue="-s" falsevalue="" label="Force strandedness." help="If the feature occupies the antisense strand, the sequence will be reverse complemented." /> +<param name="split" type="boolean" checked="false" truevalue="-split" falsevalue="" label="Given BED12 input, extract and concatenate the sequences from the BED “blocks” (e.g., exons)" /> + </inputs> + <outputs> + <data format="fasta" name="output" /> + </outputs> + <help> + +**What it does** + +bedtools getfasta will extract the sequence defined by the coordinates in a BED interval and create a new FASTA entry in the output file for each extracted sequence. By default, the FASTA header for each extracted sequence will be formatted as follows: “<chrom>:<start>-<end>”. + +.. image:: $PATH_TO_IMAGES/getfasta-glyph.png + +.. class:: warningmark + +1. The headers in the input FASTA file must exactly match the chromosome column in the BED file. + +2. You can use the UNIX fold command to set the line width of the FASTA output. For example, fold -w 60 will make each line of the FASTA file have at most 60 nucleotides for easy viewing. + </help> +</tool>
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/intersectBed.xml Thu Jun 05 15:25:18 2014 -0400 @@ -0,0 +1,85 @@ +<tool id="bedtools_intersectbed" name="Intersect interval files" version="0.2.0"> + <description></description> + <macros> + <import>macros.xml</import> + </macros> + <expand macro="requirements" /> + <expand macro="stdio" /> + <command> + intersectBed + #if $inputA.ext == "bam": + -abam $inputA + #else: + -a $inputA + #end if + + -b $inputB + $split + $strand + #if str($fraction): + -f $fraction + #end if + $reciprocal + $invert + $once + $header + $overlap_mode + > $output + </command> + <inputs> + <param format="bed,bam,vcf,gff,gff3" name="inputA" type="data" label="BED or BAM file"/> + <param format="bed,gff,vcf,gff3" name="inputB" type="data" label="overlap intervals in this BED file?"/> + + <param name="strand" type="select" label="Calculate the intersection based on strandedness?"> + <option value="" selected="True">Overlaps on either strand</option> + <option value="-s">Only overlaps occurring on the **same** strand.</option> + <option value="-S">Only overlaps occurring on the **opposite** strand.</option> + </param> + + <param name="overlap_mode" type="select" label="What should be written to the output file?"> + <option value="-wa" selected="True">Write the original entry in A for each overlap.</option> + <option value="-wb">Write the original entry in B for each overlap. Useful for knowing what A overlaps. Restricted by the fraction- and reciprocal option.</option> + <option value="-wo">Write the original A and B entries plus the number of base pairs of overlap between the two features. Only A features with overlap are reported. Restricted by the fraction- and reciprocal option.</option> + <option value="-wao">Write the original A and B entries plus the number of base pairs of overlap between the two features. However, A features w/o overlap are also reported with a NULL B feature and overlap = 0. Restricted by the fraction- and reciprocal option.</option> + <option value="-loj">Perform a "left outer join". That is, for each feature in A report each overlap with B. If no overlaps are found, report a NULL feature for B.</option> + </param> + + <param name="split" type="boolean" checked="true" truevalue="-split" falsevalue="" label="Treat split/spliced BAM or BED12 entries as distinct BED intervals when computing coverage." help="If set, the coverage will be calculated based the spliced intervals only. For BAM files, this inspects the CIGAR N operation to infer the blocks for computing coverage. For BED12 files, this inspects the BlockCount, BlockStarts, and BlockEnds fields (i.e., columns 10,11,12). If this option is not set, coverage will be calculated based on the interval's START/END coordinates, and would include introns in the case of RNAseq data." /> + <!-- -f --> + <param name="fraction" type="text" optional="true" label="Minimum overlap required as a fraction of the BAM alignment" help="Alignments are only retained if the overlap with the an interval in the BED file comprises at least this fraction of the BAM alignment's length. For example, to require that the overlap affects 50% of the BAM alignment, use 0.50. (-f)"/> + <!-- -r --> + <param name="reciprocal" type="boolean" checked="false" truevalue="-r" falsevalue="" label="Require reciprocal overlap." help="If set, the overlap between the BAM alignment and the BED interval must affect the above fraction of both the alignment and the BED interval. (-r)" /> + <!-- -v --> + <param name="invert" type="boolean" checked="false" truevalue="-v" falsevalue="" label="Report only those alignments that **do not** overlap the BED file. (-v)"/> + <!-- -u --> + <param name="once" type="boolean" checked="false" truevalue="-u" falsevalue="" label="Write the original A entry _once_ if _any_ overlaps found in B." help="Just report the fact >=1 hit was found. (-u)" /> + <!-- -c --> + <param name="count" type="boolean" checked="false" truevalue="-c" falsevalue="" label="For each entry in A, report the number of overlaps with B." help="Reports 0 for A entries that have no overlap with B. (-c)" /> + <!-- header --> + <param name="header" type="boolean" checked="false" truevalue="-header" falsevalue="" label="Print the header from the A file prior to results." /> + <!-- header --> + <param name="header" type="boolean" checked="false" truevalue="-header" falsevalue="" label="Print the header from the A file prior to results." /> + </inputs> + <outputs> + <data format_source="inputA" name="output" metadata_source="inputA" label="Intersection of ${inputA.name} and ${inputB.name}"/> + </outputs> + <help> + +**What it does** + +By far, the most common question asked of two sets of genomic features is whether or not any of the features in the two sets “overlap” with one another. This is known as feature intersection. bedtools intersect allows one to screen for overlaps between two sets of genomic features. Moreover, it allows one to have fine control as to how the intersections are reported. bedtools intersect works with both BED/GFF/VCF and BAM files as input. + +.. image:: $PATH_TO_IMAGES/intersect-glyph.png + +.. class:: infomark + +Note that each BAM alignment is treated individually. Therefore, if one end of a paired-end alignment overlaps an interval in the BED file, yet the other end does not, the output file will only include the overlapping end. + +.. class:: infomark + +Note that a BAM alignment will be sent to the output file **once** even if it overlaps more than one interval in the BED file. + +@REFERENCES@ + + </help> +</tool>
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/intersectBed_bam_obsolete.xml Thu Jun 05 15:25:18 2014 -0400 @@ -0,0 +1,135 @@ +<tool id="bedtools_intersectBed" name="intersectBed"> + <description>reports overlaps between two feature files.</description> + <requirements> + <requirement type="package">bedtools</requirement> + <requirement type="binary">intersectBed</requirement> + </requirements> + <command>intersectBed +#if $intype.inselect == "bam" +-abam $intype.inputBam -b $input $intype.bed +#else +-a $intype.inputBed -b $input +#end if +#if $outputopt.showoutputopt == "yes" +$outputopt.wa $outputopt.wb $outputopt.wo $outputopt.wao $outputopt.u $outputopt.c $outputopt.v +#end if +#if $overlapopt.showoverlapopt == "yes" + #if str($overlapopt.f.value) != "None" + -f $overlapopt.f + #end if +$overlapopt.r $overlapopt.s +#end if +$split +> $output + </command> + <inputs> + <conditional name="intype"> + <param name="inselect" type="select" label="Select input file type"> + <option value="bed" selected="true">BED, GFF</option> + <option value="bam">BAM</option> + </param> + <when value="bed"> + <param name="inputBed" type="data" format="bed,gff" label="Input A" help="Each feature in A is compared to B in search of overlaps."/> + </when> + <when value="bam"> + <param name="inputBam" type="data" format="bam" label="Input A" help="Each BAM alignment in A is compared to B in search of overlaps."/> + <param name="bed" type="boolean" truevalue="-bed" falsevalue="" checked="False" label="Write output as BED" help="The default is to write output in BAM when using BAM as input."/> + </when> + </conditional> + + <param name="input" type="data" format="bed" label="Input B"/> + + <conditional name="outputopt"> + <param name="showoutputopt" type="select" label="Show output options"> + <option value="no" selected="true">No</option> + <option value="yes">Yes</option> + </param> + <when value="yes">s + <param name="wa" type="boolean" truevalue="-wa" falsevalue="" checked="False" label="Write the original entry in A for each overlap"/> + <param name="wb" type="boolean" truevalue="-wb" falsevalue="" checked="False" label="Write the original entry in B for each overlap" help="Useful for knowing what A overlaps."/> + <param name="wo" type="boolean" truevalue="-wo" falsevalue="" checked="False" label="Write the original A and B entries plus the number of base pairs of overlap between the two features"/> + <param name="wao" type="boolean" truevalue="-wao" falsevalue="" checked="False" label="Write the original A and B entries plus the number of base pairs of overlap between the two features. However, A features without overlap are also reported with a NULL B feature and overlap = 0"/> + + <param name="u" type="boolean" truevalue="-u" falsevalue="" checked="False" label="Write original A entry once if any overlaps found in B" help="Frequently a feature in "A" will overlap with multiple features in "B". By default, intersectBed will report each overlap as a separate output line. However, one may want to simply know that there is at least one overlap (or none). When one uses this option, "A" features that overlap with one or more "B" features are reported once. Those that overlap with no "B" features are not reported at all."/> + + <param name="c" type="boolean" truevalue="-c" falsevalue="" checked="False" label="For each entry in A, report the number of hits in B while restricting to the minimum overlap fraction. Reports 0 for A entries that have no overlap with B" help="Reports a column after each "A" feature indicating the number (0 or more) of overlapping features found in "B"."/> + + <param name="v" type="boolean" truevalue="-v" falsevalue="" checked="False" label="Only report those entries in A that have no overlap in B"/> + </when> + <when value="no"/> + </conditional> + + <conditional name="overlapopt"> + <param name="showoverlapopt" type="select" label="Show options for overlap definition"> + <option value="no" selected="true">No</option> + <option value="yes">Yes</option> + </param> + <when value="yes"> + <param name="f" type="float" min="0" max="1" value="" optional="true" label="Minimum overlap required as a fraction of A" help="By default, intersectBed will report an overlap between A and B so long as there is at least one base pair is overlapping. Yet sometimes you may want to restrict reported overlaps between A and B to cases where the feature in B overlaps at least X% (e.g. 50%) of the A feature. This option does exactly this. Default is 1E-9 (i.e. 1bp)."/> + <param name="r" type="boolean" truevalue="-r" falsevalue="" checked="False" label="Require that the fraction of overlap be reciprocal for A and B" help="In other words, if the minimum overlap fraction is 0.90 and this option is used, it requires that B overlap at least 90% of A and that A also overlaps at least 90% of B."/> + <param name="s" type="boolean" truevalue="-s" falsevalue="" checked="False" label="Force "strandedness"" help="That is, only report hits in B that overlap A on the same strand. By default, overlaps are reported without respect to strand."/> + </when> + <when value="no"/> + </conditional> + <param name="split" type="boolean" truevalue="-split" falsevalue="" checked="false" label="Treat "split" BAM (i.e., having an "N" CIGAR operation) or BED12 entries as distinct BED intervals"/> + + + + + + + + + + + + + + </inputs> + <outputs> + <data name="output" format="bed"> + <change_format> + <when input="intype.bed" value="" format="bam"/> + </change_format> + </data> + </outputs> + + <help> + +**What it does** + +By far, the most common question asked of two sets of genomic features is whether or not any of the +features in the two sets "overlap" with one another. This is known as feature intersection. intersectBed +allows one to screen for overlaps between two sets of genomic features. Moreover, it allows one to have +fine control as to how the intersections are reported. intersectBed works with both BED/GFF +and BAM files as input. + +By default, if an overlap is found, intersectBed reports the shared interval between the two +overlapping features. + + +**Default behavior when using BAM input** + +When comparing alignments in BAM format to features in BED format, intersectBed +will, by default, write the output in BAM format. That is, each alignment in the BAM file that meets +the user's criteria will be written in BAM format. This serves as a mechanism to +create subsets of BAM alignments are of biological interest, etc. Note that only the mate in the BAM +alignment is compared to the BED file. Thus, if only one end of a paired-end sequence overlaps with a +feature in B, then that end will be written to the BAM output. By contrast, the other mate for the +pair will not be written. One should use pairToBed if one wants each BAM alignment +for a pair to be written to BAM output. + + +**Output BED format when using BAM input** + +When comparing alignments in BAM format to features in BED format, intersectBed +will optionally write the output in BED format. That is, each alignment in the BAM file is converted +to a 6 column BED feature and if overlaps are found (or not) based on the user's criteria, the BAM +alignment will be reported in BED format. The BED "name" field is comprised of the RNAME field in +the BAM alignment. If mate information is available, the mate (e.g., "/1" or "/2") field will be +appended to the name. The "score" field is the mapping quality score from the BAM alignment. + + + </help> + +</tool>
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/jaccardBed.xml Thu Jun 05 15:25:18 2014 -0400 @@ -0,0 +1,44 @@ +<tool id="bedtools_jaccard" name="JaccardBed" version="0.2.0"> + <description></description> + <macros> + <import>macros.xml</import> + </macros> + <expand macro="requirements" /> + <expand macro="stdio" /> + <command> + bedtools jaccard + + $reciprocal + $strand + $split + -f $overlap + -a $inputA + -b $inputB + > $output + </command> + <inputs> + <param format="bed,vcf,gff,gff3" name="inputA" type="data" label="BED or BAM file"/> + <param format="bed,vcf,gff,gff3" name="inputB" type="data" label="BED or BAM file"/> + <param name="overlap" type="float" value="0.000000001" label="Minimum overlap required as a fraction of A" /> + + <param name="reciprocal" type="boolean" checked="false" truevalue="-f" falsevalue="" label="Require that the fraction of overlap be reciprocal for A and B. In other words, if -f is 0.90 and -r is used, this requires that B overlap at least 90% of A and that A also overlaps at least 90% of B" /> + <param name="tab" type="boolean" checked="false" truevalue="-tab" falsevalue="" label="Report extract sequences in a tab-delimited format instead of in FASTA format." /> + <param name="strand" type="boolean" checked="false" truevalue="-s" falsevalue="" label="Force strandedness" help="That is, only report hits in B that overlap A on the same strand. By default, overlaps are reported without respect to strand" /> + <expand macro="strand2" /> + </inputs> + <outputs> + <data format_source="inputA" name="output" metadata_source="inputA" label="Intersection of ${inputA.name} and ${inputB.name}" /> + </outputs> + <help> + +**What it does** + +By default, bedtools jaccard reports the length of the intersection, the length of the union (minus the intersection), the final Jaccard statistic reflecting the similarity of the two sets, as well as the number of intersections. +Whereas the bedtools intersect tool enumerates each an every intersection between two sets of genomic intervals, one often needs a single statistic reflecting the similarity of the two sets based on the intersections between them. The Jaccard statistic is used in set theory to represent the ratio of the intersection of two sets to the union of the two sets. Similarly, Favorov et al [1] reported the use of the Jaccard statistic for genome intervals: specifically, it measures the ratio of the number of intersecting base pairs between two sets to the number of base pairs in the union of the two sets. The bedtools jaccard tool implements this statistic, yet modifies the statistic such that the length of the intersection is subtracted from the length of the union. As a result, the final statistic ranges from 0.0 to 1.0, where 0.0 represents no overlap and 1.0 represent complete overlap. +.. image:: $PATH_TO_IMAGES/jaccard-glyph.png + +.. class:: warningmark + +The jaccard tool requires that your data is pre-sorted by chromosome and then by start position (e.g., sort -k1,1 -k2,2n in.bed > in.sorted.bed for BED files). + </help> +</tool>
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/linksBed.xml Thu Jun 05 15:25:18 2014 -0400 @@ -0,0 +1,31 @@ +<tool id="bedtools_links" name="LinksBed" version="0.1.0"> + <description></description> + <macros> + <import>macros.xml</import> + </macros> + <expand macro="requirements" /> + <expand macro="stdio" /> + <command> + linksBed + -base $basename + -org $org + -db $db + -i $inputA + > $output + </command> + <inputs> + <param format="bed,vcf,gff,gff3" name="inputA" type="data" label="BED or BAM file"/> + <param name="basename" type="text" value="http://genome.ucsc.edu" label="The “basename” for the UCSC browser" /> + <param name="org" type="text" value="human" label="The organism (e.g. mouse, human)" /> + <param name="db" type="text" value="hg18" label="The genome build" /> + </inputs> + <outputs> + <data name="output" format="html" /> + </outputs> + <help> + +**What it does** + +Creates an HTML file with links to an instance of the UCSC Genome Browser for all features / intervals in a file. This is useful for cases when one wants to manually inspect through a large set of annotations or features. + </help> +</tool>
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/macros.xml Thu Jun 05 15:25:18 2014 -0400 @@ -0,0 +1,42 @@ +<macros> + <xml name="stdio"> + <stdio> + <!-- Anything other than zero is an error --> + <exit_code range="1:" /> + <exit_code range=":-1" /> + <!-- In case the return code has not been set propery check stderr too --> + <regex match="Error:" /> + <regex match="Exception:" /> + </stdio> + </xml> + + <xml name="overlap"> + <param name="overlap" type="float" value="0.000000001" label="Minimum overlap required as a fraction of A" /> + </xml> + <xml name="strand2"> + <param name="strand" type="select" label="Calculation based on strandedness?"> + <option value="" selected="True">Overlaps on either strand</option> + <option value="-s">Only overlaps occurring on the **same** strand.</option> + <option value="-S">Only overlaps occurring on the **opposite** strand.</option> + </param> + </xml> + <xml name="requirements"> + <requirements> + <requirement type="package" version="2.19.1">bedtools</requirement> + </requirements> + <version_command>bedtools --version</version_command> + </xml> + <xml name="genome"> + <param format="bed,vcf,gff,gff3" name="genome" type="data" label="Genome file" /> + </xml> + <token name="@REFERENCES@"> +------ + +This tool is part of the `bedtools package`__ from the `Quinlan laboratory`__. +If you use this tool, please cite `Quinlan AR, and Hall I.M. BEDTools: A flexible framework for comparing genomic features. Bioinformatics, 2010, 26, 6.`__ + +.. __: https://github.com/arq5x/bedtools2 +.. __: http://cphg.virginia.edu/quinlan/ +.. __: http://bioinformatics.oxfordjournals.org/content/26/6/841.short + </token> +</macros>
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/mapBed.xml Thu Jun 05 15:25:18 2014 -0400 @@ -0,0 +1,75 @@ +<tool id="bedtools_map" name="MapBed" version="0.2.0"> + <description></description> + <macros> + <import>macros.xml</import> + </macros> + <expand macro="requirements" /> + <expand macro="stdio" /> + <command> + bedtools map + -a $inputA + -b $inputB + $strand + -o $operation + -c $col + -f $overlap + $reciprocal + $split + $header + #if $genome.genome_choose == "-g" : + -g $genome.genome + #end if + > $output + </command> + <inputs> + <param format="bed,vcf,gff,gff3" name="inputA" type="data" label="BED File A"/> + <param format="bed,gff,vcf,gff3" name="inputB" type="data" label="BED File B"/> + <param name="col" type="integer" value="5" label="Specify the column from the B file to map onto intervals in A" /> + <expand macro="overlap" /> + <param name="reciprocal" type="boolean" checked="false" truevalue="-r" falsevalue="" label="Require reciprocal overlap." help="If set, the overlap between the BAM alignment and the BED interval must affect the above fraction of both the alignment and the BED interval." /> + <expand macro="strand2" /> + <param name="operation" type="select" label="Specify the operation"> + <option value="sum" selected="True">Sum - numeric only</option> + <option value="count">Count - numeric or text</option> + <option value="count_disctinct">Count Distinct - numeric or text</option> + <option value="min">Min - numeric only</option> + <option value="max">Max - numeric only</option> + <option value="mean">Mean - numeric only</option> + <option value="median">Median - numeric only</option> + <option value="mode">Mode - numeric only</option> + <option value="antimode">Antimode - numeric only</option> + <option value="collapse">collapse (i.e., print a comma separated list) - numeric or text</option> + <option value="distinct">distinct (i.e., print a comma separated list) - numeric or text</option> + <option value="concat">concat (i.e., print a comma separated list) - numeric or text</option> + </param> + <param name="split" type="boolean" checked="true" truevalue="-split" falsevalue="" label="Treat split/spliced BAM or BED12 entries as distinct BED intervals when computing coverage." help="If set, the coverage will be calculated based the spliced intervals only. For BAM files, this inspects the CIGAR N operation to infer the blocks for computing coverage. For BED12 files, this inspects the BlockCount, BlockStarts, and BlockEnds fields (i.e., columns 10,11,12). If this option is not set, coverage will be calculated based on the interval's START/END coordinates, and would include introns in the case of RNAseq data." /> + <param name="header" type="boolean" checked="false" truevalue="-header" falsevalue="" label="Print the header from the A file prior to results." /> + <conditional name="genome"> + <param name="genome_choose" type="boolean" checked="false" truevalue="-g" falsevalue="" label="Treat split/spliced BAM or BED12 entries as distinct BED intervals when computing coverage." help="" /> + <when value="-g"> + <expand macro="genome" /> + </when> + </conditional> + </inputs> + <outputs> + <data format_source="inputA" name="output" metadata_source="inputA" label="Mapping of ${inputB.name} into ${inputA.name}"/> + </outputs> + <help> + +**What it does** + +bedtools map allows one to map overlapping features in a B file onto features in an A file and apply statistics and/or summary operations on those features. + +.. image:: $PATH_TO_IMAGES/map-glyph.png + +.. class:: infomark + +bedtools map requires each input file to be sorted by genome coordinate. For BED files, this can be done with sort -k1,1 -k2,2n. Other sorting criteria are allowed if a genome file (-g) is provides that specifies the expected chromosome order. + +.. class:: infomark + +The map tool is substantially faster in versions 2.19.0 and later. The plot below demonstrates the increased speed when, for example, counting the number of exome alignments that align to each exon. The bedtools times are compared to the bedops bedmap utility as a point of reference. + + + </help> +</tool>
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/maskFastaBed.xml Thu Jun 05 15:25:18 2014 -0400 @@ -0,0 +1,35 @@ +<tool id="bedtools_maskfastabed" name="MaskFastaBed" version="0.2.0"> + <description></description> + <macros> + <import>macros.xml</import> + </macros> + <expand macro="requirements" /> + <expand macro="stdio" /> + <command> + bedtools maskfasta + $soft + -mc $mc + -fi $fasta + -bed $inputA + -fo $output + </command> + <inputs> + <param format="bed,vcf,gff,gff3" name="inputA" type="data" label="BED or BAM file"/> + <param format="fasta" name="fasta" type="data" label="Fasta file"/> + + <param name="soft" type="boolean" checked="false" truevalue="-name" falsevalue="" label="Soft-mask (that is, convert to lower-case bases) the FASTA sequence. By default, hard-masking (that is, conversion to Ns) is performed" /> + <param name="mc" type="text" value="N" length="1" falsevalue="" label="Replace masking character. That is, instead of masking with Ns, use another character." /> + </inputs> + <outputs> + <data format="fasta" name="output" /> + </outputs> + <help> + +**What it does** + +bedtools maskfasta masks sequences in a FASTA file based on intervals defined in a feature file. The headers in the input FASTA file must exactly match the chromosome column in the feature file. This may be useful fro creating your own masked genome file based on custom annotations or for masking all but your target regions when aligning sequence data from a targeted capture experiment. + +.. image:: $PATH_TO_IMAGES/maskfasta-glyph.png + + </help> +</tool>
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/mergeBed.xml Thu Jun 05 15:25:18 2014 -0400 @@ -0,0 +1,209 @@ +<tool id="bedtools_mergebed" name="Merge BED files" version="0.1.0"> + <description>(mergeBed)</description> + <macros> + <import>macros.xml</import> + </macros> + <expand macro="requirements" /> + <expand macro="stdio" /> + <command> + mergeBed + -i $input + $strandedness + $report_number + -d $distance + $nms + #if str($scores) != 'none' + -scores $scores + #end if + > $output + </command> + <inputs> + <param name="input" format="bed,gff,vcf" type="data" label="Sort the following BED file"/> + <param name="strandedness" type="boolean" label="Force strandedness." truevalue="-s" falsevalue="" checked="false" + help="That is, only merge features that are the same strand."/> + <param name="report_number" type="boolean" label="Report the number of BED entries that were merged." truevalue="-n" falsevalue="" checked="false" + help="1 is reported if no merging occurred."/> + <param name="nms" type="boolean" label="Report the names of the merged features separated by commas." truevalue="-nms" falsevalue="" checked="false" + help="1 is reported if no merging occurred."/> + + <param name="distance" type="integer" value="0" label="Maximum distance between features allowed for features to be merged." + help="That is, overlapping and/or book-ended features are merged."/> + <param name="scores" type="select" label="Report the scores of the merged features as"> + <option value="none">Do not report at all</option> + <option value="sum">Sum</option> + <option value="min">Min</option> + <option value="max">Max</option> + <option value="mean">Mean</option> + <option value="median">Median</option> + <option value="mode">Mode</option> + <option value="antimode">Antimode</option> + <option value="collapse">Semicolon separated list</option> + </param> + </inputs> + <outputs> + <data format="bed" name="output" metadata_source="input" label="Merged ${input.name}"/> + </outputs> + <tests> + <test> + <param name="input" value="0.bed" ftype="bed" /> + <output name="output" file="0_result.bed" ftype="bed" /> + </test> + <test> + <param name="input" value="1.bed" ftype="bed" /> + <param name="strandedness" value="-s" /> + <output name="output" file="1_result.bed" ftype="bed" /> + </test> + <test> + <param name="input" value="2.bed" ftype="bed" /> + <param name="report_number" value="-n" /> + <output name="output" file="2_result.bed" ftype="bed" /> + </test> + <test> + <param name="input" value="3.bed" ftype="bed" /> + <param name="distance" value="1000" /> + <output name="output" file="3_result.bed" ftype="bed" /> + </test> + </tests> + <help> + +**What it does** + +bedtools merge combines overlapping or "book-ended" features in an interval file into a single feature which spans all of the combined features. + + +.. image:: $PATH_TO_IMAGES/merge-glyph.png + + +.. class:: warningmark + +bedtools merge requires that you presort your data by chromosome and then by start position. + + +========================================================================== +Default behavior +========================================================================== +By default, ``bedtools merge`` combines overlapping (by at least 1 bp) and/or +bookended intervals into a single, "flattened" or "merged" interval. + +:: + + $ cat A.bed + chr1 100 200 + chr1 180 250 + chr1 250 500 + chr1 501 1000 + + $ bedtools merge -i A.bed + chr1 100 500 + chr1 501 1000 + + +========================================================================== +*-s* Enforcing "strandedness" +========================================================================== +The ``-s`` option will only merge intervals that are overlapping/bookended +*and* are on the same strand. + +:: + + $ cat A.bed + chr1 100 200 a1 1 + + chr1 180 250 a2 2 + + chr1 250 500 a3 3 - + chr1 501 1000 a4 4 + + + $ bedtools merge -i A.bed -s + chr1 100 250 + + chr1 501 1000 + + chr1 250 500 - + + +========================================================================== +*-n* Reporting the number of features that were merged +========================================================================== +The -n option will report the number of features that were combined from the +original file in order to make the newly merged feature. If a feature in the +original file was not merged with any other features, a "1" is reported. + +:: + + $ cat A.bed + chr1 100 200 + chr1 180 250 + chr1 250 500 + chr1 501 1000 + + $ bedtools merge -i A.bed -n + chr1 100 500 3 + chr1 501 1000 1 + + +========================================================================== +*-d* Controlling how close two features must be in order to merge +========================================================================== +By default, only overlapping or book-ended features are combined into a new +feature. However, one can force ``merge`` to combine more distant features +with the ``-d`` option. For example, were one to set ``-d`` to 1000, any +features that overlap or are within 1000 base pairs of one another will be +combined. + +:: + + $ cat A.bed + chr1 100 200 + chr1 501 1000 + + $ bedtools merge -i A.bed + chr1 100 200 + chr1 501 1000 + + $ bedtools merge -i A.bed -d 1000 + chr1 100 200 1000 + + +============================================================= +*-nms* Reporting the names of the features that were merged +============================================================= +Occasionally, one might like to know that names of the features that were +merged into a new feature. The ``-nms`` option will add an extra column to the +``merge`` output which lists (separated by semicolons) the names of the +merged features. + +:: + + $ cat A.bed + chr1 100 200 A1 + chr1 150 300 A2 + chr1 250 500 A3 + + $ bedtools merge -i A.bed -nms + chr1 100 500 A1,A2,A3 + + +=============================================================== +*-scores* Reporting the scores of the features that were merged +=============================================================== +Similarly, we might like to know that scores of the features that were +merged into a new feature. Enter the ``-scores`` option. One can specify +how the scores from each overlapping interval should be reported. + +:: + + $ cat A.bed + chr1 100 200 A1 1 + chr1 150 300 A2 2 + chr1 250 500 A3 3 + + $ bedtools merge -i A.bed -scores mean + chr1 100 500 2 + + $ bedtools merge -i A.bed -scores max + chr1 100 500 3 + + $ bedtools merge -i A.bed -scores collapse + chr1 100 500 1,2,3 + + +@REFERENCES@ + </help> +</tool>
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/multiIntersectBed.xml Thu Jun 05 15:25:18 2014 -0400 @@ -0,0 +1,195 @@ +<tool id="bedtools_multiintersectbed" name="Intersect multiple sorted BED files" version="0.2.0"> + <description></description> + <macros> + <import>macros.xml</import> + </macros> + <expand macro="requirements" /> + <expand macro="stdio" /> + <command> + multiIntersectBed + $header + #if $zero.value == True: + -empty + -g ${chromInfo} + #end if + + -i '$input1' + '$input2' + #for $q in $beds + '${q.input}' + #end for + + -names + #if $name1.choice == "tag": + '${input1.name}' + #else + '${name1.custom_name}' + #end if + + #if $name2.choice == "tag": + '${input2.name}' + #else + '${name2.custom_name}' + #end if + + #for $q in $beds + #if $q.name.choice == "tag": + '${q.input.name}' + #else + '${q.input.custom_name}' + #end if + #end for + > '$output' + </command> + + <inputs> + <!-- Make it easy for the user, first two input files are always shown --> + <!-- INPUT 1 --> + <param name="input1" format="bed" type="data" label="First sorted BED file" /> + + <conditional name="name1"> + <param name="choice" type="select" label="Sample name"> + <option value="tag" selected="true">Use input's tag</option> + <option value="custom">Enter custom table name</option> + </param> + <when value="tag"> + </when> + <when value="custom"> + <param name="custom_name" type="text" area="false" label="Custom sample name"/> + </when> + </conditional> + + <!-- INPUT 2 --> + <param name="input2" format="bed" type="data" label="Second sorted BED file" /> + + <conditional name="name2"> + <param name="choice" type="select" label="Sample name"> + <option value="tag" selected="true">Use input's tag</option> + <option value="custom">Enter custom table name</option> + </param> + <when value="tag"> + </when> + <when value="custom"> + <param name="custom_name" type="text" area="false" label="Custom sample name"/> + </when> + </conditional> + + <!-- Additional files, if the user needs more --> + <repeat name="beds" title="Add'l sorted BED files" > + <param name="input" format="bed" type="data" label="BED file" /> + + <conditional name="name"> + <param name="choice" type="select" label="Sample name"> + <option value="tag" selected="true">Use input's tag</option> + <option value="custom">Enter custom table name</option> + </param> + <when value="tag"> + </when> + <when value="custom"> + <param name="custom_name" type="text" area="false" label="Custom sample name"/> + </when> + </conditional> + </repeat> + + <param name="header" type="boolean" checked="true" truevalue="-header" falsevalue="" label="Print header line" help="The first line will include the name of each sample." /> + + <param name="zero" type="boolean" checked="true" label="Report regions that are not covered by any of the files" help="If set, regions that are not overlapped by any file will also be reported. Requires a valid organism key for all input datasets" /> + + </inputs> + + <outputs> + <data format="tabular" name="output" metadata_source="input1" label="Common intervals identified from among ${input1.name}, ${input2.name} and so on." /> + </outputs> + <help> + +**What it does** + +This tool identifies common intervals among multiple, sorted BED files. Intervals can be common among 0 to N of the N input BED files. The pictorial and raw data examples below illustrate the behavior of this tool more clearly. + + +.. image:: http://people.virginia.edu/~arq5x/files/bedtools-galaxy/mbi.png + + +.. class:: warningmark + +This tool requires that each BED file is reference-sorted (chrom, then start). + + +.. class:: infomark + +The output file will contain five fixed columns, plus additional columns for each BED file: + + * 1. Chromosome name (or 'genome' for whole-genome coverage). + * 2. The zero-based start position of the interval. + * 3. The one-based end position of the interval. + * 4. The number of input files that had at least one feature overlapping this interval. + * 5. A list of input files or labels that had at least one feature overlapping this interval. + * 6. For each input file, an indication (1 = Yes, 0 = No) of whether or not the file had at least one feature overlapping this interval. + +------ + +**Example input**:: + + # a.bed + chr1 6 12 + chr1 10 20 + chr1 22 27 + chr1 24 30 + + # b.bed + chr1 12 32 + chr1 14 30 + + # c.bed + chr1 8 15 + chr1 10 14 + chr1 32 34 + + +------ + +**Example without a header and without reporting intervals with zero coverage**:: + + + chr1 6 8 1 1 1 0 0 + chr1 8 12 2 1,3 1 0 1 + chr1 12 15 3 1,2,3 1 1 1 + chr1 15 20 2 1,2 1 1 0 + chr1 20 22 1 2 0 1 0 + chr1 22 30 2 1,2 1 1 0 + chr1 30 32 1 2 0 1 0 + chr1 32 34 1 3 0 0 1 + + +**Example adding a header line**:: + + + chrom start end num list a.bed b.bed c.bed + chr1 6 8 1 1 1 0 0 + chr1 8 12 2 1,3 1 0 1 + chr1 12 15 3 1,2,3 1 1 1 + chr1 15 20 2 1,2 1 1 0 + chr1 20 22 1 2 0 1 0 + chr1 22 30 2 1,2 1 1 0 + chr1 30 32 1 2 0 1 0 + chr1 32 34 1 3 0 0 1 + + +**Example adding a header line and custom file labels**:: + + + chrom start end num list joe bob sue + chr1 6 8 1 joe 1 0 0 + chr1 8 12 2 joe,sue 1 0 1 + chr1 12 15 3 joe,bob,sue 1 1 1 + chr1 15 20 2 joe,bob 1 1 0 + chr1 20 22 1 bob 0 1 0 + chr1 22 30 2 joe,bob 1 1 0 + chr1 30 32 1 bob 0 1 0 + chr1 32 34 1 sue 0 0 1 + + +@REFERENCES@ + + </help> +</tool>
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/overlapBed.xml Thu Jun 05 15:25:18 2014 -0400 @@ -0,0 +1,28 @@ +<tool id="bedtools_overlapbed" name="OverlapBed" version="0.2.0"> + <description></description> + <macros> + <import>macros.xml</import> + </macros> + <expand macro="requirements" /> + <expand macro="stdio" /> + <command> + overlap + -i $inputA + -cols $cols + > $output + </command> + <inputs> + <param format="bed,vcf,gff,gff3" name="inputA" type="data" label="BED or BAM file"/> + <param name="cols" type="text" value="" area="True" size="40x10" label="Specify the columns (1-based) for the starts and ends of the features for which you’d like to compute the overlap/distance. The columns must be listed in the following order: start1,end1,start2,end2" /> + </inputs> + <outputs> + <data format_source="inputA" name="output" metadata_source="inputA" label="Overlap of ${inputA.name}"/> + </outputs> + <help> + +**What it does** + +overlap computes the amount of overlap (in the case of positive values) or distance (in the case of negative values) between feature coordinates occurring on the same input line and reports the result at the end of the same line. In this way, it is a useful method for computing custom overlap scores from the output of other BEDTools. + + </help> +</tool>
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/sortBed.xml Thu Jun 05 15:25:18 2014 -0400 @@ -0,0 +1,45 @@ +<tool id="bedtools_sortbed" name="Sort BED files" version="0.2.0"> + <description></description> + <macros> + <import>macros.xml</import> + </macros> + <expand macro="requirements" /> + <expand macro="stdio" /> + <command> + sortBed -i $input $option > $output + </command> + <inputs> + <param format="bed" name="input" type="data" label="Sort the following BED file"/> + <param name="option" type="select" label="Sort by"> + <!-- sort -k 1,1 -k2,2 -n a.bed --> + <option value="">chromosome, then by start position (asc)</option> + <option value="-sizeA">feature size in ascending order.</option> + <option value="-sizeD">feature size in descending order.</option> + <option value="-chrThenSizeA">chromosome, then by feature size (asc).</option> + <option value="-chrThenSizeD">chromosome, then by feature size (desc).</option> + <option value="-chrThenScoreA">chromosome, then by score (asc).</option> + <option value="-chrThenScoreD">chromosome, then by score (desc).</option> + </param> + </inputs> + + <outputs> + <data format="bed" name="output" metadata_source="input" label="${input.name} (as BED)"/> + </outputs> + + <help> + +**What it does** + +Sorts a feature file by chromosome and other criteria. + + +.. class:: warningmark + +It should be noted that sortBed is merely a convenience utility, as the UNIX sort utility +will sort BED files more quickly while using less memory. For example, UNIX sort will sort a BED file +by chromosome then by start position in the following manner: sort -k 1,1 -k2,2 -n a.bed + +@REFERENCES@ + + </help> +</tool>
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/test-data/0.bed Thu Jun 05 15:25:18 2014 -0400 @@ -0,0 +1,4 @@ +chr1 100 200 +chr1 180 250 +chr1 250 500 +chr1 501 1000
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/test-data/0_result.bed Thu Jun 05 15:25:18 2014 -0400 @@ -0,0 +1,2 @@ +chr1 100 500 +chr1 501 1000
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/test-data/1.bed Thu Jun 05 15:25:18 2014 -0400 @@ -0,0 +1,4 @@ +chr1 100 200 a1 1 + +chr1 180 250 a2 2 + +chr1 250 500 a3 3 - +chr1 501 1000 a4 4 +
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/test-data/1_result.bed Thu Jun 05 15:25:18 2014 -0400 @@ -0,0 +1,3 @@ +chr1 100 250 + +chr1 501 1000 + +chr1 250 500 -
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/test-data/2.bed Thu Jun 05 15:25:18 2014 -0400 @@ -0,0 +1,4 @@ +chr1 100 200 +chr1 180 250 +chr1 250 500 +chr1 501 1000
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/test-data/2_result.bed Thu Jun 05 15:25:18 2014 -0400 @@ -0,0 +1,2 @@ +chr1 100 500 3 +chr1 501 1000 1
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/test-data/3.bed Thu Jun 05 15:25:18 2014 -0400 @@ -0,0 +1,2 @@ +chr1 100 200 +chr1 501 1000
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/test-data/3_result_1000.bed Thu Jun 05 15:25:18 2014 -0400 @@ -0,0 +1,1 @@ +chr1 100 200 1000
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/tool_dependencies.xml Thu Jun 05 15:25:18 2014 -0400 @@ -0,0 +1,6 @@ +<?xml version="1.0"?> +<tool_dependency> + <package name="bedtools" version="2.19.1"> + <repository changeset_revision="3ad963111153" name="package_bedtools_2_19" owner="iuc" toolshed="https://testtoolshed.g2.bx.psu.edu" /> + </package> +</tool_dependency>
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/unionBedGraphs.xml Thu Jun 05 15:25:18 2014 -0400 @@ -0,0 +1,231 @@ +<tool id="bedtools_mergebedgraph" name="Merge BedGraph files" version="0.2.0"> + <description></description> + <macros> + <import>macros.xml</import> + </macros> + <expand macro="requirements" /> + <expand macro="stdio" /> + <command>unionBedGraphs + $header + -filler '$filler' + #if $zero.value == True: + -empty + -g ${chromInfo} + #end if + + -i '$input1' + '$input2' + #for $q in $bedgraphs + '${q.input}' + #end for + + -names + #if $name1.choice == "tag": + '${input1.name}' + #else + '${name1.custom_name}' + #end if + + #if $name2.choice == "tag": + '${input2.name}' + #else + '${name2.custom_name}' + #end if + + #for $q in $bedgraphs + #if $q.name.choice == "tag": + '${q.input.name}' + #else + '${q.input.custom_name}' + #end if + #end for + > '$output' + </command> + <inputs> + <!-- Make it easy for the user, first two input files are always shown --> + <!-- INPUT 1 --> + <param name="input1" format="bedgraph" type="data" label="First BedGraph file" /> + + <conditional name="name1"> + <param name="choice" type="select" label="Sample name"> + <option value="tag" selected="true">Use input's tag</option> + <option value="custom">Enter custom table name</option> + </param> + <when value="tag"> + </when> + <when value="custom"> + <param name="custom_name" type="text" area="false" label="Custom sample name"/> + </when> + </conditional> + + <!-- INPUT 2 --> + <param name="input2" format="bedgraph" type="data" label="Second BedGraph file" /> + + <conditional name="name2"> + <param name="choice" type="select" label="Sample name"> + <option value="tag" selected="true">Use input's tag</option> + <option value="custom">Enter custom table name</option> + </param> + <when value="tag"> + </when> + <when value="custom"> + <param name="custom_name" type="text" area="false" label="Custom sample name"/> + </when> + </conditional> + + <!-- Additional files, if the user needs more --> + <repeat name="bedgraphs" title="Add'l BedGraph files" > + <param name="input" format="bedgraph" type="data" label="BedGraph file" /> + <conditional name="name"> + <param name="choice" type="select" label="Sample name"> + <option value="tag" selected="true">Use input's tag</option> + <option value="custom">Enter custom table name</option> + </param> + <when value="tag"> + </when> + <when value="custom"> + <param name="custom_name" type="text" area="false" label="Custom sample name"/> + </when> + </conditional> + </repeat> + + <param name="header" type="boolean" checked="true" truevalue="-header" falsevalue="" label="Print header line" help="The first line will include the name of each sample." /> + + <param name="zero" type="boolean" checked="true" label="Report regions with zero coverage" help="If set, regions without any coverage will also be reported. Requires a valid organism key for all input datasets" /> + + <param name="filler" type="text" value="0" label="Text to use for no-coverage value" help="Can be 0.0, N/A, - or any other value." /> + </inputs> + + <outputs> + <data format="tabular" name="output" metadata_source="input1" label="Merged BedGraphs of ${input1.name}, ${input2.name} and so on." /> + </outputs> + <help> + +**What it does** + +This tool merges multiple BedGraph files, allowing direct and fine-scale coverage comparisons among many samples/files. The BedGraph files need not represent the same intervals; the tool will identify both common and file-specific intervals. In addition, the BedGraph values need not be numeric: one can use any text as the BedGraph value and the tool will compare the values from multiple files. + +.. image:: http://people.virginia.edu/~arq5x/files/bedtools-galaxy/ubg.png + + +.. class:: warningmark + +This tool requires that each BedGraph file is reference-sorted (chrom, then start) and contains non-overlapping intervals (within a given file). + + +------ + +**Example input**:: + + # 1.bedgraph + chr1 1000 1500 10 + chr1 2000 2100 20 + + # 2.bedgraph + chr1 900 1600 60 + chr1 1700 2050 50 + + # 3.bedgraph + chr1 1980 2070 80 + chr1 2090 2100 20 + + +------ + +**Examples using the Zero Coverage checkbox** + +Output example (*without* checking "Report regions with zero coverage"):: + + chr1 900 1000 0 60 0 + chr1 1000 1500 10 60 0 + chr1 1500 1600 0 60 0 + chr1 1700 1980 0 50 0 + chr1 1980 2000 0 50 80 + chr1 2000 2050 20 50 80 + chr1 2050 2070 20 0 80 + chr1 2070 2090 20 0 0 + chr1 2090 2100 20 0 20 + + +Output example (*with* checking "Report regions with zero coverage"). The lines marked with (*) are not covered in any input file, but are still reported (The asterisk marking does not appear in the file).:: + + chr1 0 900 0 0 0 (*) + chr1 900 1000 0 60 0 + chr1 1000 1500 10 60 0 + chr1 1500 1600 0 60 0 + chr1 1600 1700 0 0 0 (*) + chr1 1700 1980 0 50 0 + chr1 1980 2000 0 50 80 + chr1 2000 2050 20 50 80 + chr1 2050 2070 20 0 80 + chr1 2070 2090 20 0 0 + chr1 2090 2100 20 0 20 + chr1 2100 247249719 0 0 0 (*) + + +------ + +**Examples adjusting the "Filler value" for no-covered intervals** + +The default value is '0', but you can use any other value. + +Output example with **filler = N/A**:: + + chr1 900 1000 N/A 60 N/A + chr1 1000 1500 10 60 N/A + chr1 1500 1600 N/A 60 N/A + chr1 1600 1700 N/A N/A N/A + chr1 1700 1980 N/A 50 N/A + chr1 1980 2000 N/A 50 80 + chr1 2000 2050 20 50 80 + chr1 2050 2070 20 N/A 80 + chr1 2070 2090 20 N/A N/A + chr1 2090 2100 20 N/A 20 + + +------ + +**Examples using the "sample name" labels**:: + + chrom start end WT-1 WT-2 KO-1 + chr1 900 1000 N/A 60 N/A + chr1 1000 1500 10 60 N/A + chr1 1500 1600 N/A 60 N/A + chr1 1600 1700 N/A N/A N/A + chr1 1700 1980 N/A 50 N/A + chr1 1980 2000 N/A 50 80 + chr1 2000 2050 20 50 80 + chr1 2050 2070 20 N/A 80 + chr1 2070 2090 20 N/A N/A + chr1 2090 2100 20 N/A 20 + + +------ + +**Non-numeric values** + +The input BedGraph files can contain any kind of value in the fourth column, not necessarily a numeric value. + +Input Example:: + + File-1 File-2 + chr1 200 300 Sample1 chr1 100 240 0.75 + chr1 400 450 Sample1 chr1 250 700 0.43 + chr1 530 600 Sample2 + +Output Example:: + + chr1 100 200 0 0.75 + chr1 200 240 Sample1 0.75 + chr1 240 250 Sample1 0 + chr1 250 300 Sample1 0.43 + chr1 300 400 0 0.43 + chr1 400 450 Sample1 0.43 + chr1 450 530 0 0.43 + chr1 530 600 Sample2 0.43 + chr1 600 700 0 0.43 + +@REFERENCES@ + + </help> +</tool>