# HG changeset patch # User devteam # Date 1444768708 14400 # Node ID 08256557922fd657046761552d5a09a4a019f204 planemo upload commit 4720b3dfa114d790b597fef6ccf3c17e8c11e111 diff -r 000000000000 -r 08256557922f macros.xml --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/macros.xml Tue Oct 13 16:38:28 2015 -0400 @@ -0,0 +1,27 @@ + + + + + velvet + + + 1.2.10 + + + + + + + + + + + + + + 10.1101/gr.074492.107 + + + + + diff -r 000000000000 -r 08256557922f tool_dependencies.xml --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/tool_dependencies.xml Tue Oct 13 16:38:28 2015 -0400 @@ -0,0 +1,6 @@ + + + + + + diff -r 000000000000 -r 08256557922f velvetg.xml --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/velvetg.xml Tue Oct 13 16:38:28 2015 -0400 @@ -0,0 +1,307 @@ + + Velvet sequence assembler for very short reads + velvetg 2>&1 | grep "Version" | sed -e 's/Version //' + + macros.xml + + + + + velvetg_wrapper.py + '$input.extra_files_path' + #if $generate_amos.afg == "yes": + -amos_file $generate_amos.afg + #end if + #if $unused_reads.generate_unused == "yes": + -unused_reads $unused_reads.generate_unused + #end if + $read_trkg + #if $coverage.cutoff == "auto": + -cov_cutoff auto + #elif $coverage.cutoff == "value": + -cov_cutoff $coverage.cov_cutoff + #end if + #if $expected.coverage == "auto": + -exp_cov auto + #elif $expected.coverage == "value": + -exp_cov $expected.exp_cov + #end if + #if $contig_lgth.use_contig_lgth == "yes": + -min_contig_lgth $contig_lgth.min_contig_lgth + #end if + #if $reads.paired == "yes": + #if int($reads.ins_length) > 0: + -ins_length $reads.ins_length + #end if + #if $reads.options.advanced == "yes": + #if int($reads.options.ins_length_sd) > 0: + -ins_length_sd $reads.options.ins_length_sd + #end if + #if int($reads.options.ins_length2) > 0: + -ins_length2 $reads.options.ins_length2 + #end if + #if int($reads.options.ins_length2_sd) > 0: + -ins_length2_sd $reads.options.ins_length2_sd + #end if + #if int($reads.options.ins_length_long) > 0: + -ins_length_long $reads.options.ins_length_long + #end if + #if int($reads.options.ins_length_long_sd) > 0: + -ins_length_long_sd $reads.options.ins_length_long_sd + #end if + #if int($reads.options.max_branch_length) > 0: + -max_branch_length $reads.options.max_branch_length + #end if + #if int($reads.options.max_divergence) > 0: + -max_divergence $reads.options.max_divergence + #end if + #if int($reads.options.max_gap_count) > 0: + -max_gap_count $reads.options.max_gap_count + #end if + #if int($reads.options.min_pair_count) > 0: + -min_pair_count $reads.options.min_pair_count + #end if + #if int($reads.options.max_coverage) > 0: + -max_coverage $reads.options.max_coverage + #end if + #if int($reads.options.long_mult_cutoff) > 0: + -long_mult_cutoff $reads.options.long_mult_cutoff + #end if + $reads.options.scaffolding + #end if + #end if + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + read_trkg is True + + + last_graph['generate_graph'] == "yes" + + + generate_amos['afg'] == "yes" + + + unused_reads['generate_unused'] == "yes" + + + + + + velvet + + + + + + + + + + + + + + + + + + + + + + + + +**What it does** + +Velvet_ is a de novo genomic assembler specially designed for short read sequencing technologies, such as Solexa or 454, developed by Daniel Zerbino and Ewan Birney at the European Bioinformatics Institute (EMBL-EBI), near Cambridge, in the United Kingdom. + +Velvet currently takes in short read sequences, removes errors then produces high quality unique contigs. It then uses paired-end read and long read information, when available, to retrieve the repeated areas between contigs. + +Read the Velvet `documentation`__ for details on using the Velvet Assembler. + +.. _Velvet: http://www.ebi.ac.uk/~zerbino/velvet/ + +.. __: http://www.ebi.ac.uk/~zerbino/velvet/Manual.pdf + +------ + +**Input formats** + +Velvet can input sequence files in the following formats: fasta fastq fasta.gz fastq.gz eland gerald + +The input files are prepared for the velvet assembler using **velveth**. + +------ + +**Outputs** + +**Contigs** + +The *contigs.fa* file. +This fasta file contains the sequences of the contigs longer than 2k, where k is the word-length used in velveth. If you have specified a min contig length threshold, then the contigs shorter than that value are omitted. +Note that the length and coverage information provided in the header of each contig should therefore be understood in k-mers and in k-mer coverage (cf. 5.1) respectively. +The N's in the sequence correspond to gaps between scaffolded contigs. The number of N's corresponds to the estimated length of the gap. For reasons of compatibility with the archives, any gap shorter than 10bp is represented by a sequence of 10 N's. + +**Stats** + +The *stats.txt* file. +This file is a simple tabbed-delimited description of the nodes. The column names are pretty much self-explanatory. Note however that node lengths are given in k-mers. To obtain the length in nucleotides of each node you simply need to add k - 1, where k is the word-length used in velveth. +The in and out columns correspond to the number of arcs on the 5' and 3' ends of the contig respectively. +The coverages in columns short1 cov, short1 Ocov, short2 cov, and short2 Ocov are provided in k-mer coverage (5.1). +Also, the difference between # cov and # Ocov is the way these values are computed. In the first count, slightly divergent sequences are added to the coverage tally. However, in the second, stricter count, only the sequences which map perfectly onto the consensus sequence are taken into account. + +**LastGraph** + +The *LastGraph* file. +This file describes in its entirety the graph produced by Velvet. + +**AMOS.afg** + +The *velvet_asm.afg* file. +This file is mainly designed to be read by the open-source AMOS genome assembly package. Nonetheless, a number of programs are available to transform this kind of file into other assembly file formats (namely ACE, TIGR, Arachne and Celera). See http://amos.sourceforge.net/ for more information. +The file describes all the contigs contained in the contigs.fa file (cf 4.2.1). + +------ + +**Velvet parameter list** + +This is a list of implemented Velvetg options:: + + Standard options: + -cov_cutoff floating-point|auto : removal of low coverage nodes AFTER tour bus or allow the system to infer it + (default: no removal) + -ins_length integer : expected distance between two paired end reads (default: no read pairing) + -read_trkg yes|no : tracking of short read positions in assembly (default: no tracking) + -min_contig_lgth integer : minimum contig length exported to contigs.fa file (default: hash length * 2) + -amos_file yes|no : export assembly to AMOS file (default: no export) + -exp_cov floating point|auto : expected coverage of unique regions or allow the system to infer it + (default: no long or paired-end read resolution) + + Advanced options: + -ins_length2 integer : expected distance between two paired-end reads in the second short-read dataset (default: no read pairing) + -ins_length_long integer : expected distance between two long paired-end reads (default: no read pairing) + -ins_length*_sd integer : est. standard deviation of respective dataset (default: 10% of corresponding length) + [replace '*' by nothing, '2' or '_long' as necessary] + -scaffolding yes|no : scaffolding of contigs used paired end information (default: on) + -max_branch_length integer : maximum length in base pair of bubble (default: 100) + -max_divergence floating-point : maximum divergence rate between two branches in a bubble (default: 0.2) + -max_gap_count integer : maximum number of gaps allowed in the alignment of the two branches of a bubble (default: 3) + -min_pair_count integer : minimum number of paired end connections to justify the scaffolding of two long contigs (default: 10) + -max_coverage floating point : removal of high coverage nodes AFTER tour bus (default: no removal) + -long_mult_cutoff int : minimum number of long reads required to merge contigs (default: 2) + -unused_reads yes|no : export unused reads in UnusedReads.fa file (default: no) + + Output: + directory/contigs.fa : fasta file of contigs longer than twice hash length + directory/stats.txt : stats file (tab-spaced) useful for determining appropriate coverage cutoff + directory/LastGraph : special formatted file with all the information on the final graph + directory/velvet_asm.afg : (if requested) AMOS compatible assembly file + + + + diff -r 000000000000 -r 08256557922f velvetg_wrapper.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/velvetg_wrapper.py Tue Oct 13 16:38:28 2015 -0400 @@ -0,0 +1,46 @@ +#!/usr/bin/env python + +""" +Classes encapsulating decypher tool. +James E Johnson - University of Minnesota +""" +import os +import sys +import subprocess + +assert sys.version_info[:2] >= ( 2, 4 ) + +def stop_err( msg ): + sys.stderr.write( "%s\n" % msg ) + sys.exit() + + +def __main__(): + #Parse Command Line + working_dir = sys.argv[1] + inputs = ' '.join(sys.argv[2:]) + for _ in ('Roadmaps', 'Sequences'): + os.symlink(os.path.join(working_dir, _), _) + cmdline = 'velvetg . %s' % (inputs) + print "Command to be executed: %s" % cmdline + try: + proc = subprocess.Popen( args=cmdline, shell=True, stderr=subprocess.PIPE ) + returncode = proc.wait() + # get stderr, allowing for case where it's very large + stderr = '' + buffsize = 1048576 + try: + while True: + stderr += proc.stderr.read( buffsize ) + if not stderr or len( stderr ) % buffsize != 0: + break + except OverflowError: + pass + if returncode != 0: + raise Exception, stderr + except Exception, e: + stop_err( 'Error running velvetg ' + str( e ) ) + + +if __name__ == "__main__": + __main__() diff -r 000000000000 -r 08256557922f velveth.xml --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/velveth.xml Tue Oct 13 16:38:28 2015 -0400 @@ -0,0 +1,136 @@ + + Prepare a dataset for the Velvet velvetg Assembler + velveth 2>&1 | grep "Version" | sed -e 's/Version //' + + macros.xml + + + + + velveth_wrapper.py + '$out_file1' '$out_file1.extra_files_path' + $hash_length + $strand_specific + #for $i in $inputs + ${i.file_format} + ${i.read_type} + ${i.input} + #end for + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + velvet + + + + + + + + + + + + + + + + + + + +**What it does** + +Velvet_ is a de novo genomic assembler specially designed for short read sequencing technologies, such as Solexa or 454, developed by Daniel Zerbino and Ewan Birney at the European Bioinformatics Institute (EMBL-EBI), near Cambridge, in the United Kingdom. + +Velvet currently takes in short read sequences, removes errors then produces high quality unique contigs. It then uses paired-end read and long read information, when available, to retrieve the repeated areas between contigs. + +Read the Velvet `documentation`__ for details on using the Velvet Assembler. + +.. _Velvet: http://www.ebi.ac.uk/~zerbino/velvet/ + +.. __: http://www.ebi.ac.uk/~zerbino/velvet/Manual.pdf + +------ + +**Velveth** + +Velveth takes in a number of sequence files, produces a hashtable, then outputs two files in an output directory (creating it if necessary), Sequences and Roadmaps, which are necessary to velvetg. + +------ + +**Hash Length** + +The hash length, also known as k-mer length, corresponds to the length, in base pairs, of the words being hashed. + +The hash length is the length of the k-mers being entered in the hash table. Firstly, you must observe three technical constraints:: + +# it must be an odd number, to avoid palindromes. If you put in an even number, Velvet will just decrement it and proceed. +# it must be below or equal to MAXKMERHASH length (cf. 2.3.3, by default 31bp), because it is stored on 64 bits +# it must be strictly inferior to read length, otherwise you simply will not observe any overlaps between reads, for obvious reasons. + +Now you still have quite a lot of possibilities. As is often the case, it's a trade- off between specificity and sensitivity. Longer kmers bring you more specificity (i.e. less spurious overlaps) but lowers coverage (cf. below). . . so there's a sweet spot to be found with time and experience. +We like to think in terms of "k-mer coverage", i.e. how many times has a k-mer been seen among the reads. The relation between k-mer coverage Ck and standard (nucleotide-wise) coverage C is Ck = C # (L - k + 1)/L where k is your hash length, and L you read length. +Experience shows that this kmer coverage should be above 10 to start getting decent results. If Ck is above 20, you might be "wasting" coverage. Experience also shows that empirical tests with different values for k are not that costly to run! + +**Input Files** + +Velvet works mainly with fasta and fastq formats. For paired-end reads, the assumption is that each read is next to its mate +read. In other words, if the reads are indexed from 0, then reads 0 and 1 are paired, 2 and 3, 4 and 5, etc. + +Supported file formats are:: + + fasta + fastq + fasta.gz + fastq.gz + eland + gerald + +Read categories are:: + + short (default) + shortPaired + short2 (same as short, but for a separate insert-size library) + shortPaired2 (see above) + long (for Sanger, 454 or even reference sequences) + longPaired + + + + diff -r 000000000000 -r 08256557922f velveth_wrapper.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/velveth_wrapper.py Tue Oct 13 16:38:28 2015 -0400 @@ -0,0 +1,65 @@ +#!/usr/bin/env python + +""" +Classes encapsulating decypher tool. +James E Johnson - University of Minnesota +""" +import pkg_resources +import logging, os, string, sys, tempfile, glob, shutil, types, urllib +import shlex, subprocess +from optparse import OptionParser, OptionGroup +from stat import * + + +log = logging.getLogger( __name__ ) + +assert sys.version_info[:2] >= ( 2, 4 ) + +def stop_err( msg ): + sys.stderr.write( "%s\n" % msg ) + sys.exit() + +def __main__(): + #Parse Command Line + s = 'velveth_wrapper.py: argv = %s\n' % (sys.argv) + argcnt = len(sys.argv) + html_file = sys.argv[1] + working_dir = sys.argv[2] + try: # for test - needs this done + os.makedirs(working_dir) + except Exception, e: + stop_err( 'Error running velveth ' + str( e ) ) + hash_length = sys.argv[3] + inputs = string.join(sys.argv[4:],' ') + cmdline = 'velveth %s %s %s > /dev/null' % (working_dir, hash_length, inputs) + try: + proc = subprocess.Popen( args=cmdline, shell=True, stderr=subprocess.PIPE ) + returncode = proc.wait() + # get stderr, allowing for case where it's very large + stderr = '' + buffsize = 1048576 + try: + while True: + stderr += proc.stderr.read( buffsize ) + if not stderr or len( stderr ) % buffsize != 0: + break + except OverflowError: + pass + if returncode != 0: + raise Exception, stderr + except Exception, e: + stop_err( 'Error running velveth ' + str( e ) ) + sequences_path = os.path.join(working_dir,'Sequences') + roadmaps_path = os.path.join(working_dir,'Roadmaps') + rval = ['Velvet Galaxy Composite Dataset

'] + rval.append('

%s

' % (cmdline) ) + rval.append('
This composite dataset is composed of the following files:

' ) + f = file(html_file,'w') + f.write("\n".join( rval )) + f.write('\n') + f.close() + +if __name__ == "__main__": __main__()