GeMoMa-Docs: Difference between revisions
m (github link) |
(1.8) |
||
Line 2: | Line 2: | ||
If you have any questions, comments or bugs, please check the [[GeMoMa#Frequently asked questions|FAQs]], [https://github.com/Jstacs/Jstacs/issues?q=label%3AGeMoMa our github page] or contact [mailto:jens.keilwagen@julius-kuehn.de Jens Keilwagen]. | If you have any questions, comments or bugs, please check the [[GeMoMa#Frequently asked questions|FAQs]], [https://github.com/Jstacs/Jstacs/issues?q=label%3AGeMoMa our github page] or contact [mailto:jens.keilwagen@julius-kuehn.de Jens Keilwagen]. | ||
= GeMoMa pipeline = | === GeMoMa pipeline === | ||
This tool can be used to run the complete GeMoMa pipeline. The tool is multi-threaded and can utilize all compute cores on one machine, but not distributed as for instance in a compute cluster. It basically runs: '''Extract RNA-seq evidence (ERE)''', '''DenoiseIntrons''', '''Extractor''', external search (tblastn or mmseqs), '''Gene Model Mapper (GeMoMa)''', '''GeMoMa Annotation Filter (GAF)''', and '''AnnnotationFinalizer'''. | This tool can be used to run the complete GeMoMa pipeline. The tool is multi-threaded and can utilize all compute cores on one machine, but not distributed as for instance in a compute cluster. It basically runs: '''Extract RNA-seq evidence (ERE)''', '''DenoiseIntrons''', '''Extractor''', external search (tblastn or mmseqs), '''Gene Model Mapper (GeMoMa)''', '''GeMoMa Annotation Filter (GAF)''', and '''AnnnotationFinalizer'''. | ||
Line 8: | Line 8: | ||
''GeMoMa pipeline'' may be called with | ''GeMoMa pipeline'' may be called with | ||
java -jar GeMoMa-1. | java -jar GeMoMa-1.8.jar CLI GeMoMaPipeline | ||
and has the following parameters | and has the following parameters | ||
Line 21: | Line 21: | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green">t</font></td> | <td><font color="green">t</font></td> | ||
<td>target genome (Target genome file (FASTA), | <td>target genome (Target genome file (FASTA), type = fasta,fa,fas,fna,fasta.gz,fa.gz,fas.gz,fna.gz)</td> | ||
<td style="width:100px;">FILE</td> | <td style="width:100px;">FILE</td> | ||
</tr> | </tr> | ||
Line 34: | Line 34: | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green">i</font></td> | <td><font color="green">i</font></td> | ||
<td>ID (ID to distinguish the different reference species | <td>ID (ID to distinguish the different reference species, OPTIONAL)</td> | ||
<td style="width:100px;">STRING</td> | <td style="width:100px;">STRING</td> | ||
</tr> | </tr> | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green">a</font></td> | <td><font color="green">a</font></td> | ||
<td>annotation (Reference annotation file (GFF or GTF), which contains gene models annotated in the reference genome, | <td>annotation (Reference annotation file (GFF or GTF), which contains gene models annotated in the reference genome, type = gff,gff3,gtf,gff.gz,gff3.gz,gtf.gz)</td> | ||
<td style="width:100px;">FILE</td> | <td style="width:100px;">FILE</td> | ||
</tr> | </tr> | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green">g</font></td> | <td><font color="green">g</font></td> | ||
<td>genome (Reference genome file (FASTA), | <td>genome (Reference genome file (FASTA), type = fasta,fa,fas,fna,fasta.gz,fa.gz,fas.gz,fna.gz)</td> | ||
<td style="width:100px;">FILE</td> | <td style="width:100px;">FILE</td> | ||
</tr> | </tr> | ||
Line 54: | Line 54: | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green">ai</font></td> | <td><font color="green">ai</font></td> | ||
<td>annotation info (annotation information of the reference, tab-delimted file containing at least the columns transcriptName, GO and .*defline, | <td>annotation info (annotation information of the reference, tab-delimted file containing at least the columns transcriptName, GO and .*defline, type = tabular, OPTIONAL)</td> | ||
<td style="width:100px;">FILE</td> | <td style="width:100px;">FILE</td> | ||
</tr> | </tr> | ||
Line 60: | Line 60: | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green">i</font></td> | <td><font color="green">i</font></td> | ||
<td>ID (ID to distinguish the different reference species | <td>ID (ID to distinguish the different reference species, OPTIONAL)</td> | ||
<td style="width:100px;">STRING</td> | <td style="width:100px;">STRING</td> | ||
</tr> | </tr> | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green">c</font></td> | <td><font color="green">c</font></td> | ||
<td>cds parts (The query | <td>cds parts (The query CDS parts file (protein FASTA), i.e., the CDS parts that have been searched in the target genome using for instance BLAST or mmseqs, type = fasta,fa,fas,fna)</td> | ||
<td style="width:100px;">FILE</td> | <td style="width:100px;">FILE</td> | ||
</tr> | </tr> | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green">a</font></td> | <td><font color="green">a</font></td> | ||
<td>assignment (The assignment file, which combines parts | <td>assignment (The assignment file, which combines CDS parts to proteins, type = tabular, OPTIONAL)</td> | ||
<td style="width:100px;">FILE</td> | <td style="width:100px;">FILE</td> | ||
</tr> | </tr> | ||
Line 80: | Line 80: | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green">ai</font></td> | <td><font color="green">ai</font></td> | ||
<td>annotation info (annotation information of the reference, tab-delimted file containing at least the columns transcriptName, GO and .*defline, | <td>annotation info (annotation information of the reference, tab-delimted file containing at least the columns transcriptName, GO and .*defline, type = tabular, OPTIONAL)</td> | ||
<td style="width:100px;">FILE</td> | <td style="width:100px;">FILE</td> | ||
</tr> | </tr> | ||
Line 90: | Line 90: | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green">ID</font></td> | <td><font color="green">ID</font></td> | ||
<td>ID (ID to distinguish the different external annotations of the target organism | <td>ID (ID to distinguish the different external annotations of the target organism, OPTIONAL)</td> | ||
<td style="width:100px;">STRING</td> | <td style="width:100px;">STRING</td> | ||
</tr> | </tr> | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green">e</font></td> | <td><font color="green">e</font></td> | ||
<td>external annotation (External annotation file (GFF,GTF) of the target organism, which contains gene models from an external source (e.g., ab initio gene prediction) and will be integrated in the module GAF, | <td>external annotation (External annotation file (GFF,GTF) of the target organism, which contains gene models from an external source (e.g., ab initio gene prediction) and will be integrated in the module GAF, type = gff,gff3,gtf)</td> | ||
<td style="width:100px;">FILE</td> | <td style="width:100px;">FILE</td> | ||
</tr> | </tr> | ||
Line 112: | Line 112: | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green">selected</font></td> | <td><font color="green">selected</font></td> | ||
<td>selected (The path to list file, which allows to make only a predictions for the contained transcript ids. The first column should contain transcript IDs as given in the annotation. Remaining columns can be used to determine a target region that should be overlapped by the prediction, if columns 2 to 5 contain chromosome, strand, start and end of region, | <td>selected (The path to list file, which allows to make only a predictions for the contained transcript ids. The first column should contain transcript IDs as given in the annotation. Remaining columns can be used to determine a target region that should be overlapped by the prediction, if columns 2 to 5 contain chromosome, strand, start and end of region, type = tabular,txt, OPTIONAL)</td> | ||
<td style="width:100px;">FILE</td> | <td style="width:100px;">FILE</td> | ||
</tr> | </tr> | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green">gc</font></td> | <td><font color="green">gc</font></td> | ||
<td>genetic code (optional user-specified genetic code, | <td>genetic code (optional user-specified genetic code, type = tabular, OPTIONAL)</td> | ||
<td style="width:100px;">FILE</td> | <td style="width:100px;">FILE</td> | ||
</tr> | </tr> | ||
Line 146: | Line 146: | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green">ERE.m</font></td> | <td><font color="green">ERE.m</font></td> | ||
<td>mapped reads file (BAM/SAM files containing the mapped reads, | <td>mapped reads file (BAM/SAM files containing the mapped reads, type = bam,sam)</td> | ||
<td style="width:100px;">FILE</td> | <td style="width:100px;">FILE</td> | ||
</tr> | </tr> | ||
Line 175: | Line 175: | ||
<td>minimum context (only introns that have evidence of at least one split read with a minimal M (=(mis)match) stretch in the cigar string larger than or equal to this value will be used, valid range = [1, 1000000], default = 1)</td> | <td>minimum context (only introns that have evidence of at least one split read with a minimal M (=(mis)match) stretch in the cigar string larger than or equal to this value will be used, valid range = [1, 1000000], default = 1)</td> | ||
<td style="width:100px;">INT</td> | <td style="width:100px;">INT</td> | ||
</tr> | |||
<tr style="vertical-align:top"> | |||
<td><font color="green">ERE.maximumcoverage</font></td> | |||
<td>maximum coverage (optional parameter to reduce the size of coverage output files, coverage higher than this value will be reported as this value, valid range = [1, 10000], OPTIONAL)</td> | |||
<td style="width:100px;">INT</td> | |||
</tr> | |||
<tr style="vertical-align:top"> | |||
<td><font color="green">ERE.f</font></td> | |||
<td>filter by intron mismatches (filter reads by the number of mismatches around splits, range={NO, YES}, default = NO)</td> | |||
<td style="width:100px;">STRING</td></tr> | |||
<tr><td></td><td colspan=2><table border=0 cellpadding=0 align="center" width="100%"> | |||
<tr><td colspan=3><b>No parameters for selection "NO"</b></td></tr> | |||
<tr><td colspan=3><b>Parameters for selection "YES":</b></td></tr> | |||
<tr style="vertical-align:top"> | |||
<td><font color="green">ERE.r</font></td> | |||
<td>region around introns (test region of this size around introns/splits for mismatches to the genome, valid range = [0, 100], default = 10)</td> | |||
<td style="width:100px;">INT</td> | |||
</tr> | |||
<tr style="vertical-align:top"> | |||
<td><font color="green">ERE.n</font></td> | |||
<td>number of mismatches (number of mismatches allowed in regions around introns/splits, valid range = [0, 100], default = 3)</td> | |||
<td style="width:100px;">INT</td> | |||
</tr> | |||
</table></td></tr> | |||
<tr style="vertical-align:top"> | |||
<td><font color="green">ERE.e</font></td> | |||
<td>evidence long splits (require introns to have at least this number of times the supporting reads as their length deviates from the mean split length, valid range = [0.0, 100.0], default = 0.0)</td> | |||
<td style="width:100px;">DOUBLE</td> | |||
</tr> | |||
<tr style="vertical-align:top"> | |||
<td><font color="green">ERE.mil</font></td> | |||
<td>minimum intron length (introns shorter than the minimum length are discarded and considered as contiguous, valid range = [0, 1000], default = 0)</td> | |||
<td style="width:100px;">INT</td> | |||
</tr> | |||
<tr style="vertical-align:top"> | |||
<td><font color="green">ERE.repositioning</font></td> | |||
<td>repositioning (due to limitations in BAM/SAM format huge chromosomes need to be split before mapping. This parameter allows to undo the split mapping to real chromosomes and coordinates. The repositioning file has 3 columns: split_chr_name, original_chr_name, offset_in_original_chr, type = tabular, OPTIONAL)</td> | |||
<td style="width:100px;">FILE</td> | |||
</tr> | </tr> | ||
<tr><td colspan=3><b>Parameters for selection "EXTRACTED":</b></td></tr> | <tr><td colspan=3><b>Parameters for selection "EXTRACTED":</b></td></tr> | ||
Line 181: | Line 219: | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green">introns</font></td> | <td><font color="green">introns</font></td> | ||
<td>introns (Introns (GFF), which might be obtained from RNA-seq, | <td>introns (Introns (GFF), which might be obtained from RNA-seq, type = gff,gff3)</td> | ||
<td style="width:100px;">FILE</td> | <td style="width:100px;">FILE</td> | ||
</tr> | </tr> | ||
Line 196: | Line 234: | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green">coverage_unstranded</font></td> | <td><font color="green">coverage_unstranded</font></td> | ||
<td>coverage_unstranded (The coverage file contains the unstranded coverage of the genome per interval. Intervals with coverage 0 (zero) can be left out., | <td>coverage_unstranded (The coverage file contains the unstranded coverage of the genome per interval. Intervals with coverage 0 (zero) can be left out., type = bedgraph)</td> | ||
<td style="width:100px;">FILE</td> | <td style="width:100px;">FILE</td> | ||
</tr> | </tr> | ||
Line 202: | Line 240: | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green">coverage_forward</font></td> | <td><font color="green">coverage_forward</font></td> | ||
<td>coverage_forward (The coverage file contains the forward coverage of the genome per interval. Intervals with coverage 0 (zero) can be left out., | <td>coverage_forward (The coverage file contains the forward coverage of the genome per interval. Intervals with coverage 0 (zero) can be left out., type = bedgraph)</td> | ||
<td style="width:100px;">FILE</td> | <td style="width:100px;">FILE</td> | ||
</tr> | </tr> | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green">coverage_reverse</font></td> | <td><font color="green">coverage_reverse</font></td> | ||
<td>coverage_reverse (The coverage file contains the reverse coverage of the genome per interval. Intervals with coverage 0 (zero) can be left out., | <td>coverage_reverse (The coverage file contains the reverse coverage of the genome per interval. Intervals with coverage 0 (zero) can be left out., type = bedgraph)</td> | ||
<td style="width:100px;">FILE</td> | <td style="width:100px;">FILE</td> | ||
</tr> | </tr> | ||
Line 265: | Line 303: | ||
<td><font color="green">Extractor.f</font></td> | <td><font color="green">Extractor.f</font></td> | ||
<td>full-length (A flag which allows for choosing between only full-length and all (i.e., full-length and partial) transcripts, default = true)</td> | <td>full-length (A flag which allows for choosing between only full-length and all (i.e., full-length and partial) transcripts, default = true)</td> | ||
<td style="width:100px;">BOOLEAN</td> | |||
</tr> | |||
<tr style="vertical-align:top"> | |||
<td><font color="green">Extractor.l</font></td> | |||
<td>long fasta comment (whether a short (transcript ID) or a long (transcript ID, gene ID, chromosome, strand, interval) fasta comment should be written for proteins, CDSs, and genomic regions, default = false)</td> | |||
<td style="width:100px;">BOOLEAN</td> | <td style="width:100px;">BOOLEAN</td> | ||
</tr> | </tr> | ||
Line 279: | Line 322: | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green">GeMoMa.sm</font></td> | <td><font color="green">GeMoMa.sm</font></td> | ||
<td>substitution matrix (optional user-specified substitution matrix, | <td>substitution matrix (optional user-specified substitution matrix, type = tabular, OPTIONAL)</td> | ||
<td style="width:100px;">FILE</td> | <td style="width:100px;">FILE</td> | ||
</tr> | </tr> | ||
Line 351: | Line 394: | ||
<td>prefix (A prefix to be used for naming the predictions, default = )</td> | <td>prefix (A prefix to be used for naming the predictions, default = )</td> | ||
<td style="width:100px;">STRING</td> | <td style="width:100px;">STRING</td> | ||
</tr> | |||
<tr style="vertical-align:top"> | |||
<td><font color="green">GeMoMa.v</font></td> | |||
<td>verbose (A flag which allows to output a wealth of additional information per transcript, default = false)</td> | |||
<td style="width:100px;">BOOLEAN</td> | |||
</tr> | </tr> | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
Line 356: | Line 404: | ||
<td>timeout (The (maximal) number of seconds to be used for the predictions of one transcript, if exceeded GeMoMa does not output a prediction for this transcript., valid range = [0, 604800], default = 3600)</td> | <td>timeout (The (maximal) number of seconds to be used for the predictions of one transcript, if exceeded GeMoMa does not output a prediction for this transcript., valid range = [0, 604800], default = 3600)</td> | ||
<td style="width:100px;">LONG</td> | <td style="width:100px;">LONG</td> | ||
</tr> | |||
<tr style="vertical-align:top"> | |||
<td><font color="green">GeMoMa.ru</font></td> | |||
<td>replace unknown (Replace unknown amino acid symbols by X, default = false)</td> | |||
<td style="width:100px;">BOOLEAN</td> | |||
</tr> | </tr> | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
Line 361: | Line 414: | ||
<td>Score (A flag which allows to do nothing, re-score or re-align the search results, range={Trust, ReScore, ReAlign}, default = ReAlign)</td> | <td>Score (A flag which allows to do nothing, re-score or re-align the search results, range={Trust, ReScore, ReAlign}, default = ReAlign)</td> | ||
<td style="width:100px;">STRING</td> | <td style="width:100px;">STRING</td> | ||
</tr> | </tr> | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green">GAF.d</font></td> | <td><font color="green">GAF.d</font></td> | ||
<td>default attributes (Comma-separated list of attributes that is set to NaN if they are not given in the annotation file. This allows to use these attributes for sorting or filter criteria. It is especially meaningful if the gene annotation files were received fom different software packages (e.g., GeMoMa, Braker, ...) having different attributes., default = tie,tde,tae,iAA,pAA,score)</td> | <td>default attributes (Comma-separated list of attributes that is set to NaN if they are not given in the annotation file. This allows to use these attributes for sorting or filter criteria. It is especially meaningful if the gene annotation files were received fom different software packages (e.g., GeMoMa, Braker, ...) having different attributes., default = tie,tde,tae,iAA,pAA,score,lpm,maxGap,bestScore,maxScore,raa,rce)</td> | ||
<td style="width:100px;">STRING</td> | <td style="width:100px;">STRING</td> | ||
</tr> | </tr> | ||
Line 384: | Line 427: | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green">GAF.s</font></td> | <td><font color="green">GAF.s</font></td> | ||
<td>sorting (comma-separated list that defines the way predictions are sorted within a cluster, default = | <td>sorting (comma-separated list that defines the way predictions are sorted within a cluster, default = sumWeight,score)</td> | ||
<td style="width:100px;">STRING</td> | <td style="width:100px;">STRING</td> | ||
</tr> | </tr> | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green">GAF.a</font></td> | <td><font color="green">GAF.a</font></td> | ||
<td>alternative transcript filter (If a prediction is suggested as an alternative transcript, this additional filter will be applied. The filter works syntactically like the 'filter' parameter and allows you to keep the number of alternative transcripts small based on meaningful criteria. Reasonable filter could be based on RNA-seq data (tie==1) or on | <td>alternative transcript filter (If a prediction is suggested as an alternative transcript, this additional filter will be applied. The filter works syntactically like the 'filter' parameter and allows you to keep the number of alternative transcripts small based on meaningful criteria. Reasonable filter could be based on RNA-seq data (tie==1) or on sumWeight (sumWeight>1). A more sophisticated filter could be applied combining several criteria: tie==1 or sumWeight>1, default = tie==1 or sumWeight>1, OPTIONAL)</td> | ||
<td style="width:100px;">STRING</td> | <td style="width:100px;">STRING</td> | ||
</tr> | </tr> | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green">AnnotationFinalizer.u</font></td> | <td><font color="green">GAF.c</font></td> | ||
<td>UTR (allows to predict UTRs using RNA-seq data, range={NO, YES}, default = NO)</td> | <td>common border filter (the filter on the common borders of transcripts, the lower the more transcripts will be checked as alternative splice isoforms, valid range = [0.0, 1.0], default = 0.75)</td> | ||
<td style="width:100px;">STRING</td></tr> | <td style="width:100px;">DOUBLE</td> | ||
<tr><td></td><td colspan=2><table border=0 cellpadding=0 align="center" width="100%"> | </tr> | ||
<tr><td colspan=3><b> | <tr style="vertical-align:top"> | ||
<td><font color="green">GAF.m</font></td> | |||
<td>maximal number of transcripts per gene (the maximal number of allowed transcript predictions per gene, valid range = [1, 2147483647], default = 2147483647)</td> | |||
<td style="width:100px;">INT</td> | |||
</tr> | |||
<tr style="vertical-align:top"> | |||
<td><font color="green">GAF.aat</font></td> | |||
<td>add alternative transcripts (a switch to decide whether the IDs of alternative transcripts that have the same CDS should be listed for each prediction, default = false)</td> | |||
<td style="width:100px;">BOOLEAN</td> | |||
</tr> | |||
<tr style="vertical-align:top"> | |||
<td><font color="green">GAF.t</font></td> | |||
<td>transfer features (if true, additional features like UTRs will be transfered from the input to the output. Only features of the representatives will be transfered. The UTRs of identical CDS predictions listed in "alternative" will not be transfered or combined, default = false)</td> | |||
<td style="width:100px;">BOOLEAN</td> | |||
</tr> | |||
<tr style="vertical-align:top"> | |||
<td><font color="green">AnnotationFinalizer.u</font></td> | |||
<td>UTR (allows to predict UTRs using RNA-seq data, range={NO, YES}, default = NO)</td> | |||
<td style="width:100px;">STRING</td></tr> | |||
<tr><td></td><td colspan=2><table border=0 cellpadding=0 align="center" width="100%"> | |||
<tr><td colspan=3><b>Parameters for selection "NO":</b></td></tr> | |||
<tr style="vertical-align:top"> | |||
<td><font color="green">AnnotationFinalizer.t</font></td> | |||
<td>transfer features (if true other features than gene, <tag> (default: mRNA), and CDS of the input will be written in the output, default = false)</td> | |||
<td style="width:100px;">BOOLEAN</td> | |||
</tr> | |||
<tr><td colspan=3><b>No parameters for selection "YES"</b></td></tr> | <tr><td colspan=3><b>No parameters for selection "YES"</b></td></tr> | ||
</table></td></tr> | </table></td></tr> | ||
Line 447: | Line 515: | ||
<td><font color="green">AnnotationFinalizer.n</font></td> | <td><font color="green">AnnotationFinalizer.n</font></td> | ||
<td>name attribute (if true the new name is added as new attribute "Name", otherwise "Parent" and "ID" values are modified accordingly, default = true)</td> | <td>name attribute (if true the new name is added as new attribute "Name", otherwise "Parent" and "ID" values are modified accordingly, default = true)</td> | ||
<td style="width:100px;">BOOLEAN</td> | |||
</tr> | |||
<tr style="vertical-align:top"> | |||
<td><font color="green">sc</font></td> | |||
<td>synteny check (run SyntenyChecker if possible, default = true)</td> | |||
<td style="width:100px;">BOOLEAN</td> | <td style="width:100px;">BOOLEAN</td> | ||
</tr> | </tr> | ||
Line 503: | Line 576: | ||
'''Example:''' | '''Example:''' | ||
java -jar GeMoMa-1. | java -jar GeMoMa-1.8.jar CLI GeMoMaPipeline t=<target_genome> AnnotationFinalizer.p=<prefix> | ||
= Extract RNA-seq Evidence = | === Extract RNA-seq Evidence === | ||
This tools extracts introns and coverage from mapped RNA-seq reads. Introns might be denoised by the tool '''DenoiseIntrons'''. Introns and coverage results can be used in '''GeMoMa''' to improve the predictions and might help to select better gene models in '''GAF'''. In addition, introns and coverage can be used to predict UTRs by '''AnnotationFinalizer'''. | This tools extracts introns and coverage from mapped RNA-seq reads. Introns might be denoised by the tool '''DenoiseIntrons'''. Introns and coverage results can be used in '''GeMoMa''' to improve the predictions and might help to select better gene models in '''GAF'''. In addition, introns and coverage can be used to predict UTRs by '''AnnotationFinalizer'''. | ||
Line 512: | Line 585: | ||
''Extract RNA-seq Evidence'' may be called with | ''Extract RNA-seq Evidence'' may be called with | ||
java -jar GeMoMa-1. | java -jar GeMoMa-1.8.jar CLI ERE | ||
and has the following parameters | and has the following parameters | ||
Line 532: | Line 605: | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green">m</font></td> | <td><font color="green">m</font></td> | ||
<td>mapped reads file (BAM/SAM files containing the mapped reads, | <td>mapped reads file (BAM/SAM files containing the mapped reads, type = bam,sam)</td> | ||
<td style="width:100px;">FILE</td> | <td style="width:100px;">FILE</td> | ||
</tr> | </tr> | ||
Line 563: | Line 636: | ||
</tr> | </tr> | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green"> | <td><font color="green">maximumcoverage</font></td> | ||
<td> | <td>maximum coverage (optional parameter to reduce the size of coverage output files, coverage higher than this value will be reported as this value, valid range = [1, 10000], OPTIONAL)</td> | ||
<td> | <td style="width:100px;">INT</td> | ||
</tr> | </tr> | ||
</ | <tr style="vertical-align:top"> | ||
<td><font color="green">f</font></td> | |||
<td>filter by intron mismatches (filter reads by the number of mismatches around splits, range={NO, YES}, default = NO)</td> | |||
<td style="width:100px;">STRING</td></tr> | |||
<tr><td></td><td colspan=2><table border=0 cellpadding=0 align="center" width="100%"> | |||
<tr><td colspan=3><b>No parameters for selection "NO"</b></td></tr> | |||
<tr><td colspan=3><b>Parameters for selection "YES":</b></td></tr> | |||
= | <tr style="vertical-align:top"> | ||
<td><font color="green">r</font></td> | |||
<td>region around introns (test region of this size around introns/splits for mismatches to the genome, valid range = [0, 100], default = 10)</td> | |||
<td style="width:100px;">INT</td> | |||
</tr> | |||
<tr style="vertical-align:top"> | |||
<td><font color="green">n</font></td> | |||
<td>number of mismatches (number of mismatches allowed in regions around introns/splits, valid range = [0, 100], default = 3)</td> | |||
<td style="width:100px;">INT</td> | |||
<tr> | |||
<td> | |||
<td> | |||
<td> | |||
</tr> | </tr> | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green">t</font></td> | <td><font color="green">t</font></td> | ||
<td>target genome (The target genome file (FASTA) | <td>target genome (The target genome file (FASTA). Should be in IUPAC code, type = fasta,fas,fa,fna,fasta.gz,fas.gz,fa.gz,fna.gz)</td> | ||
<td style="width:100px;">FILE</td> | <td style="width:100px;">FILE</td> | ||
</tr> | </tr> | ||
< | </table></td></tr> | ||
<tr><td></td><td | <tr style="vertical-align:top"> | ||
<td><font color="green">e</font></td> | |||
<td>evidence long splits (require introns to have at least this number of times the supporting reads as their length deviates from the mean split length, valid range = [0.0, 100.0], default = 0.0)</td> | |||
<td style="width:100px;">DOUBLE</td> | |||
</tr> | |||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green"> | <td><font color="green">mil</font></td> | ||
<td>introns | <td>minimum intron length (introns shorter than the minimum length are discarded and considered as contiguous, valid range = [0, 1000], default = 0)</td> | ||
<td style="width:100px;"> | <td style="width:100px;">INT</td> | ||
</tr> | </tr> | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green"> | <td><font color="green">repositioning</font></td> | ||
<td> | <td>repositioning (due to limitations in BAM/SAM format huge chromosomes need to be split before mapping. This parameter allows to undo the split mapping to real chromosomes and coordinates. The repositioning file has 3 columns: split_chr_name, original_chr_name, offset_in_original_chr, type = tabular, OPTIONAL)</td> | ||
<td style="width:100px;"> | <td style="width:100px;">FILE</td> | ||
</tr> | </tr> | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
Line 619: | Line 687: | ||
'''Example:''' | '''Example:''' | ||
java -jar GeMoMa-1. | java -jar GeMoMa-1.8.jar CLI ERE m=<mapped_reads_file> | ||
= | === CheckIntrons === | ||
The tool checks the distribution of introns on the strands and the dinucleotide distribution at splice sites. | |||
'' | ''CheckIntrons'' may be called with | ||
java -jar GeMoMa-1. | java -jar GeMoMa-1.8.jar CLI CheckIntrons | ||
and has the following parameters | and has the following parameters | ||
Line 639: | Line 707: | ||
</tr> | </tr> | ||
<tr><td colspan=3><hr></td></tr> | <tr><td colspan=3><hr></td></tr> | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green"> | <td><font color="green">t</font></td> | ||
<td> | <td>target genome (The target genome file (FASTA), i.e., the target sequences in the blast run. Should be in IUPAC code, type = fasta)</td> | ||
<td style="width:100px;">FILE</td> | <td style="width:100px;">FILE</td> | ||
</tr> | </tr> | ||
<tr><td colspan=3>The following parameter(s) can be used multiple times:</td></tr> | <tr><td colspan=3>The following parameter(s) can be used multiple times:</td></tr> | ||
<tr><td></td><td colspan=2><table border=0 cellpadding=0 align="center" width="100%"> | <tr><td></td><td colspan=2><table border=0 cellpadding=0 align="center" width="100%"> | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green"> | <td><font color="green">i</font></td> | ||
<td> | <td>introns (Introns (GFF), which might be obtained from RNA-seq, type = gff)</td> | ||
<td style="width:100px;">FILE</td> | <td style="width:100px;">FILE</td> | ||
</tr> | </tr> | ||
</table> | |||
</td></tr> | |||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green"> | <td><font color="green">v</font></td> | ||
<td> | <td>verbose (A flag which allows to output a wealth of additional information per transcript, default = false)</td> | ||
<td style="width:100px;"> | <td style="width:100px;">BOOLEAN</td> | ||
</tr> | </tr> | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green"> | <td><font color="green">outdir</font></td> | ||
<td> | <td>The output directory, defaults to the current working directory (.)</td> | ||
<td | <td>STRING</td> | ||
</tr> | </tr> | ||
</table> | </table> | ||
'''Example:''' | '''Example:''' | ||
java -jar GeMoMa-1. | java -jar GeMoMa-1.8.jar CLI CheckIntrons t=<target_genome> i=<introns> | ||
= | === DenoiseIntrons === | ||
This | This module allows to analyze introns extracted by '''ERE'''. Introns with a large intron size or a low relative expression are possibly artefacts and will be removed. The result of this module can be used in the module '''GeMoMa''', '''AnnotationEvidence''', and '''AnnotationFinalizer'''. | ||
'' | ''DenoiseIntrons'' may be called with | ||
java -jar GeMoMa-1. | java -jar GeMoMa-1.8.jar CLI DenoiseIntrons | ||
and has the following parameters | and has the following parameters | ||
Line 719: | Line 755: | ||
</tr> | </tr> | ||
<tr><td colspan=3><hr></td></tr> | <tr><td colspan=3><hr></td></tr> | ||
<tr><td colspan=3>The following parameter(s) can be used multiple times:</td></tr> | |||
<tr><td></td><td colspan=2><table border=0 cellpadding=0 align="center" width="100%"> | |||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green"> | <td><font color="green">i</font></td> | ||
<td> | <td>introns (Introns (GFF), which might be obtained from RNA-seq, type = gff,gff3)</td> | ||
<td style="width:100px;"> | <td style="width:100px;">FILE</td> | ||
</tr> | </tr> | ||
</table> | |||
</td></tr> | |||
<tr><td colspan=3>The following parameter(s) can be used multiple times:</td></tr> | |||
<tr><td></td><td colspan=2><table border=0 cellpadding=0 align="center" width="100%"> | |||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green"> | <td><font color="green">c</font></td> | ||
<td> | <td>coverage (experimental coverage (RNA-seq), range={UNSTRANDED, STRANDED}, default = UNSTRANDED)</td> | ||
<td style="width:100px;"> | <td style="width:100px;">STRING</td></tr> | ||
<tr><td></td><td colspan=2><table border=0 cellpadding=0 align="center" width="100%"> | |||
<tr><td colspan=3><b>Parameters for selection "UNSTRANDED":</b></td></tr> | |||
<tr style="vertical-align:top"> | |||
<td><font color="green">coverage_unstranded</font></td> | |||
<td>coverage_unstranded (The coverage file contains the unstranded coverage of the genome per interval. Intervals with coverage 0 (zero) can be left out., type = bedgraph)</td> | |||
<td style="width:100px;">FILE</td> | |||
</tr> | </tr> | ||
<tr><td colspan=3><b>Parameters for selection "STRANDED":</b></td></tr> | |||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green"> | <td><font color="green">coverage_forward</font></td> | ||
<td> | <td>coverage_forward (The coverage file contains the forward coverage of the genome per interval. Intervals with coverage 0 (zero) can be left out., type = bedgraph)</td> | ||
<td style="width:100px;">FILE</td> | <td style="width:100px;">FILE</td> | ||
</tr> | </tr> | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green">outdir</font></td> | <td><font color="green">coverage_reverse</font></td> | ||
<td>The output directory, defaults to the current working directory (.)</td> | <td>coverage_reverse (The coverage file contains the reverse coverage of the genome per interval. Intervals with coverage 0 (zero) can be left out., type = bedgraph)</td> | ||
<td style="width:100px;">FILE</td> | |||
</tr> | |||
</table></td></tr> | |||
</table> | |||
</td></tr> | |||
<tr style="vertical-align:top"> | |||
<td><font color="green">m</font></td> | |||
<td>maximum intron length (The maximum length of an intron, default = 15000)</td> | |||
<td style="width:100px;">INT</td> | |||
</tr> | |||
<tr style="vertical-align:top"> | |||
<td><font color="green">me</font></td> | |||
<td>minimum expression (The threshold for removing introns, valid range = [0.0, 1.0], default = 0.01)</td> | |||
<td style="width:100px;">DOUBLE</td> | |||
</tr> | |||
<tr style="vertical-align:top"> | |||
<td><font color="green">context</font></td> | |||
<td>context (The context upstream a donor and donwstream an acceptor site that is used to determine the expression of the region, valid range = [0, 100], default = 10)</td> | |||
<td style="width:100px;">INT</td> | |||
</tr> | |||
<tr style="vertical-align:top"> | |||
<td><font color="green">outdir</font></td> | |||
<td>The output directory, defaults to the current working directory (.)</td> | |||
<td>STRING</td> | <td>STRING</td> | ||
</tr> | </tr> | ||
Line 743: | Line 815: | ||
'''Example:''' | '''Example:''' | ||
java -jar GeMoMa-1. | java -jar GeMoMa-1.8.jar CLI DenoiseIntrons i=<introns> coverage_unstranded=<coverage_unstranded> | ||
= | === NCBI Reference Retriever === | ||
This tool can be used to | This tool can be used to download or update assembly and annotation files of reference organsims from NCBI. This way it allows to easily collect all data necessary to start '''GeMoMaPipeline''' or '''Extractor'''. | ||
'' | ''NCBI Reference Retriever'' may be called with | ||
java -jar GeMoMa-1. | java -jar GeMoMa-1.8.jar CLI NRR | ||
and has the following parameters | and has the following parameters | ||
Line 764: | Line 836: | ||
<tr><td colspan=3><hr></td></tr> | <tr><td colspan=3><hr></td></tr> | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green"> | <td><font color="green">r</font></td> | ||
<td> | <td>reference directory (the directory where the genome and annotation files of the reference organisms should be stored, default = references/)</td> | ||
<td style="width:100px;"> | <td style="width:100px;">STRING</td> | ||
</tr> | </tr> | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green"> | <td><font color="green">n</font></td> | ||
<td> | <td>number of tries (the number of tries for downloading a reference file, valid range = [1, 100], default = 10)</td> | ||
<td style="width:100px;"> | <td style="width:100px;">INT</td> | ||
</tr> | </tr> | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green"> | <td><font color="green">rl</font></td> | ||
<td> | <td>reference list (a list of reference organisms, type = txt)</td> | ||
<td style="width:100px;">FILE</td> | <td style="width:100px;">FILE</td> | ||
</tr> | </tr> | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green"> | <td><font color="green">outdir</font></td> | ||
<td> | <td>The output directory, defaults to the current working directory (.)</td> | ||
<td | <td>STRING</td> | ||
</tr> | </tr> | ||
< | </table> | ||
< | |||
<td> | '''Example:''' | ||
<td | |||
java -jar GeMoMa-1.8.jar CLI NRR rl=<reference_list> | |||
=== Extractor === | |||
This tool can be used to create input files for '''GeMoMa''', i.e., it creates at least a fasta file containing the translated parts of the CDS and a tabular file containing the assignment of transcripts to genes and parts of CDS to transcripts. In addition, '''Extractor''' can be used to create several additional files from the final prediction, e.g. proteins, CDSs, ... . Two inputs are mandatory: The genome as fasta or fasta.gz and the corresponding annotation as gff or gff.gz. The gff file should be sorted. If you like to set a user-specific genetic code, please use a tab-delimited file with two columns. The first column contains the amino acid in one letter code, the second a list of tripletts. | |||
''Extractor'' may be called with | |||
java -jar GeMoMa-1.8.jar CLI Extractor | |||
and has the following parameters | |||
<table border=0 cellpadding=10 align="center" width="100%"> | |||
<tr> | |||
<td>name</td> | |||
<td>comment</td> | |||
<td>type</td> | |||
</tr> | </tr> | ||
<tr><td colspan=3><hr></td></tr> | |||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green"> | <td><font color="green">a</font></td> | ||
<td> | <td>annotation (Reference annotation file (GFF or GTF), which contains gene models annotated in the reference genome, type = gff,gff3,gtf,gff.gz,gff3.gz,gtf.gz)</td> | ||
<td style="width:100px;"> | <td style="width:100px;">FILE</td> | ||
</tr> | </tr> | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green"> | <td><font color="green">g</font></td> | ||
<td> | <td>genome (Reference genome file (FASTA), type = fasta,fa,fas,fna,fasta.gz,fa.gz,fas.gz,fna.gz)</td> | ||
<td style="width:100px;"> | <td style="width:100px;">FILE</td> | ||
</tr> | </tr> | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green">u</font></td> | <td><font color="green">gc</font></td> | ||
<td>genetic code (optional user-specified genetic code, type = tabular, OPTIONAL)</td> | |||
<td style="width:100px;">FILE</td> | |||
</tr> | |||
<tr style="vertical-align:top"> | |||
<td><font color="green">p</font></td> | |||
<td>proteins (whether the complete proteins sequences should returned as output, default = false)</td> | |||
<td style="width:100px;">BOOLEAN</td> | |||
</tr> | |||
<tr style="vertical-align:top"> | |||
<td><font color="green">c</font></td> | |||
<td>cds (whether the complete CDSs should returned as output, default = false)</td> | |||
<td style="width:100px;">BOOLEAN</td> | |||
</tr> | |||
<tr style="vertical-align:top"> | |||
<td><font color="green">genomic</font></td> | |||
<td>genomic (whether the genomic regions should be returned (upper case = coding, lower case = non coding), default = false)</td> | |||
<td style="width:100px;">BOOLEAN</td> | |||
</tr> | |||
<tr style="vertical-align:top"> | |||
<td><font color="green">i</font></td> | |||
<td>introns (whether introns should be extracted from annotation, that might be used for test cases, default = false)</td> | |||
<td style="width:100px;">BOOLEAN</td> | |||
</tr> | |||
<tr style="vertical-align:top"> | |||
<td><font color="green">identical</font></td> | |||
<td>identical (if CDS is identical Extractor only used one transcript. This parameter allows to return a table that lists in the first column the used transcript and in the second column the discarded transcript. If no transcript is discarded, the list is empty., default = false)</td> | |||
<td style="width:100px;">BOOLEAN</td> | |||
</tr> | |||
<tr style="vertical-align:top"> | |||
<td><font color="green">u</font></td> | |||
<td>upcase IDs (whether the IDs in the GFF should be upcased, default = false)</td> | <td>upcase IDs (whether the IDs in the GFF should be upcased, default = false)</td> | ||
<td style="width:100px;">BOOLEAN</td> | <td style="width:100px;">BOOLEAN</td> | ||
Line 810: | Line 931: | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green">s</font></td> | <td><font color="green">s</font></td> | ||
<td>selected (The path to list file, which allows to make only a predictions for the contained transcript ids. The first column should contain transcript IDs as given in the annotation. Remaining columns will be ignored., | <td>selected (The path to list file, which allows to make only a predictions for the contained transcript ids. The first column should contain transcript IDs as given in the annotation. Remaining columns will be ignored., type = tabular,txt, OPTIONAL)</td> | ||
<td style="width:100px;">FILE</td> | <td style="width:100px;">FILE</td> | ||
</tr> | </tr> | ||
Line 831: | Line 952: | ||
<td><font color="green">f</font></td> | <td><font color="green">f</font></td> | ||
<td>full-length (A flag which allows for choosing between only full-length and all (i.e., full-length and partial) transcripts, default = true)</td> | <td>full-length (A flag which allows for choosing between only full-length and all (i.e., full-length and partial) transcripts, default = true)</td> | ||
<td style="width:100px;">BOOLEAN</td> | |||
</tr> | |||
<tr style="vertical-align:top"> | |||
<td><font color="green">l</font></td> | |||
<td>long fasta comment (whether a short (transcript ID) or a long (transcript ID, gene ID, chromosome, strand, interval) fasta comment should be written for proteins, CDSs, and genomic regions, default = false)</td> | |||
<td style="width:100px;">BOOLEAN</td> | <td style="width:100px;">BOOLEAN</td> | ||
</tr> | </tr> | ||
Line 847: | Line 973: | ||
'''Example:''' | '''Example:''' | ||
java -jar GeMoMa-1. | java -jar GeMoMa-1.8.jar CLI Extractor a=<annotation> g=<genome> | ||
= GeneModelMapper = | === GeneModelMapper === | ||
This tool is the main part of, a homology-based gene prediction tool. GeMoMa builds gene models from search results (e.g. tblastn or mmseqs). | This tool is the main part of, a homology-based gene prediction tool. GeMoMa builds gene models from search results (e.g. tblastn or mmseqs). | ||
Line 871: | Line 997: | ||
''GeneModelMapper'' may be called with | ''GeneModelMapper'' may be called with | ||
java -jar GeMoMa-1. | java -jar GeMoMa-1.8.jar CLI GeMoMa | ||
and has the following parameters | and has the following parameters | ||
Line 884: | Line 1,010: | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green">s</font></td> | <td><font color="green">s</font></td> | ||
<td>search results (The search results, e.g., from tblastn or mmseqs, | <td>search results (The search results, e.g., from tblastn or mmseqs, type = tabular)</td> | ||
<td style="width:100px;">FILE</td> | <td style="width:100px;">FILE</td> | ||
</tr> | </tr> | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green">t</font></td> | <td><font color="green">t</font></td> | ||
<td>target genome (The target genome file (FASTA), i.e., the target sequences in the blast run. Should be in IUPAC code, | <td>target genome (The target genome file (FASTA), i.e., the target sequences in the blast run. Should be in IUPAC code, type = fasta,fas,fa,fna,fasta.gz,fas.gz,fa.gz,fna.gz)</td> | ||
<td style="width:100px;">FILE</td> | <td style="width:100px;">FILE</td> | ||
</tr> | </tr> | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green">c</font></td> | <td><font color="green">c</font></td> | ||
<td>cds parts (The query | <td>cds parts (The query CDS parts file (protein FASTA), i.e., the CDS parts that have been searched in the target genome using for instance BLAST or mmseqs, type = fasta,fa,fas,fna)</td> | ||
<td style="width:100px;">FILE</td> | <td style="width:100px;">FILE</td> | ||
</tr> | </tr> | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green">a</font></td> | <td><font color="green">a</font></td> | ||
<td>assignment (The assignment file, which combines parts | <td>assignment (The assignment file, which combines CDS parts to proteins, type = tabular, OPTIONAL)</td> | ||
<td style="width:100px;">FILE</td> | <td style="width:100px;">FILE</td> | ||
</tr> | </tr> | ||
Line 906: | Line 1,032: | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green">i</font></td> | <td><font color="green">i</font></td> | ||
<td>introns (Introns (GFF), which might be obtained from RNA-seq, | <td>introns (Introns (GFF), which might be obtained from RNA-seq, type = gff,gff3)</td> | ||
<td style="width:100px;">FILE</td> | <td style="width:100px;">FILE</td> | ||
</tr> | </tr> | ||
Line 931: | Line 1,057: | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green">coverage_unstranded</font></td> | <td><font color="green">coverage_unstranded</font></td> | ||
<td>coverage_unstranded (The coverage file contains the unstranded coverage of the genome per interval. Intervals with coverage 0 (zero) can be left out., | <td>coverage_unstranded (The coverage file contains the unstranded coverage of the genome per interval. Intervals with coverage 0 (zero) can be left out., type = bedgraph)</td> | ||
<td style="width:100px;">FILE</td> | <td style="width:100px;">FILE</td> | ||
</tr> | </tr> | ||
Line 937: | Line 1,063: | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green">coverage_forward</font></td> | <td><font color="green">coverage_forward</font></td> | ||
<td>coverage_forward (The coverage file contains the forward coverage of the genome per interval. Intervals with coverage 0 (zero) can be left out., | <td>coverage_forward (The coverage file contains the forward coverage of the genome per interval. Intervals with coverage 0 (zero) can be left out., type = bedgraph)</td> | ||
<td style="width:100px;">FILE</td> | <td style="width:100px;">FILE</td> | ||
</tr> | </tr> | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green">coverage_reverse</font></td> | <td><font color="green">coverage_reverse</font></td> | ||
<td>coverage_reverse (The coverage file contains the reverse coverage of the genome per interval. Intervals with coverage 0 (zero) can be left out., | <td>coverage_reverse (The coverage file contains the reverse coverage of the genome per interval. Intervals with coverage 0 (zero) can be left out., type = bedgraph)</td> | ||
<td style="width:100px;">FILE</td> | <td style="width:100px;">FILE</td> | ||
</tr> | </tr> | ||
Line 950: | Line 1,076: | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green">g</font></td> | <td><font color="green">g</font></td> | ||
<td>genetic code (optional user-specified genetic code, | <td>genetic code (optional user-specified genetic code, type = tabular, OPTIONAL)</td> | ||
<td style="width:100px;">FILE</td> | <td style="width:100px;">FILE</td> | ||
</tr> | </tr> | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green">sm</font></td> | <td><font color="green">sm</font></td> | ||
<td>substitution matrix (optional user-specified substitution matrix, | <td>substitution matrix (optional user-specified substitution matrix, type = tabular, OPTIONAL)</td> | ||
<td style="width:100px;">FILE</td> | <td style="width:100px;">FILE</td> | ||
</tr> | </tr> | ||
Line 1,010: | Line 1,136: | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green">selected</font></td> | <td><font color="green">selected</font></td> | ||
<td>selected (The path to list file, which allows to make only a predictions for the contained transcript ids. The first column should contain transcript IDs as given in the annotation. Remaining columns can be used to determine a target region that should be overlapped by the prediction, if columns 2 to 5 contain chromosome, strand, start and end of region, | <td>selected (The path to list file, which allows to make only a predictions for the contained transcript ids. The first column should contain transcript IDs as given in the annotation. Remaining columns can be used to determine a target region that should be overlapped by the prediction, if columns 2 to 5 contain chromosome, strand, start and end of region, type = tabular,txt, OPTIONAL)</td> | ||
<td style="width:100px;">FILE</td> | <td style="width:100px;">FILE</td> | ||
</tr> | </tr> | ||
Line 1,051: | Line 1,177: | ||
<td><font color="green">sort</font></td> | <td><font color="green">sort</font></td> | ||
<td>sort (A flag which allows to sort the search results, default = false)</td> | <td>sort (A flag which allows to sort the search results, default = false)</td> | ||
<td style="width:100px;">BOOLEAN</td> | |||
</tr> | |||
<tr style="vertical-align:top"> | |||
<td><font color="green">ru</font></td> | |||
<td>replace unknown (Replace unknown amino acid symbols by X, default = false)</td> | |||
<td style="width:100px;">BOOLEAN</td> | <td style="width:100px;">BOOLEAN</td> | ||
</tr> | </tr> | ||
Line 1,067: | Line 1,198: | ||
'''Example:''' | '''Example:''' | ||
java -jar GeMoMa-1. | java -jar GeMoMa-1.8.jar CLI GeMoMa s=<search_results> t=<target_genome> c=<cds_parts> | ||
= GeMoMa Annotation Filter = | === GeMoMa Annotation Filter === | ||
This tool combines and filters gene predictions from different sources yielding a common gene prediction. The tool does not modify the predictions, but filters redundant and low-quality predictions and selects relevant predictions. In addition, it adds attributes to the annotation of transcript predictions. | This tool combines and filters gene predictions from different sources yielding a common gene prediction. The tool does not modify the predictions, but filters redundant and low-quality predictions and selects relevant predictions. In addition, it adds attributes to the annotation of transcript predictions. | ||
Line 1,086: | Line 1,217: | ||
''GeMoMa Annotation Filter'' may be called with | ''GeMoMa Annotation Filter'' may be called with | ||
java -jar GeMoMa-1. | java -jar GeMoMa-1.8.jar CLI GAF | ||
and has the following parameters | and has the following parameters | ||
Line 1,101: | Line 1,232: | ||
<td>tag (the tag used to read the GeMoMa annotations, default = mRNA)</td> | <td>tag (the tag used to read the GeMoMa annotations, default = mRNA)</td> | ||
<td style="width:100px;">STRING</td> | <td style="width:100px;">STRING</td> | ||
</tr> | </tr> | ||
<tr><td colspan=3>The following parameter(s) can be used multiple times:</td></tr> | <tr><td colspan=3>The following parameter(s) can be used multiple times:</td></tr> | ||
Line 1,126: | Line 1,247: | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green">g</font></td> | <td><font color="green">g</font></td> | ||
<td>gene annotation file (GFF file containing the gene annotations (predicted by GeMoMa), | <td>gene annotation file (GFF file containing the gene annotations (predicted by GeMoMa), type = gff,gff3)</td> | ||
<td style="width:100px;">FILE</td> | <td style="width:100px;">FILE</td> | ||
</tr> | </tr> | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green">a</font></td> | <td><font color="green">a</font></td> | ||
<td>annotation info (annotation information of the reference, tab-delimted file containing at least the columns transcriptName, GO and .*defline, | <td>annotation info (annotation information of the reference, tab-delimted file containing at least the columns transcriptName, GO and .*defline, type = tabular, OPTIONAL)</td> | ||
<td style="width:100px;">FILE</td> | <td style="width:100px;">FILE</td> | ||
</tr> | </tr> | ||
Line 1,138: | Line 1,259: | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green">d</font></td> | <td><font color="green">d</font></td> | ||
<td>default attributes (Comma-separated list of attributes that is set to NaN if they are not given in the annotation file. This allows to use these attributes for sorting or filter criteria. It is especially meaningful if the gene annotation files were received fom different software packages (e.g., GeMoMa, Braker, ...) having different attributes., default = tie,tde,tae,iAA,pAA,score)</td> | <td>default attributes (Comma-separated list of attributes that is set to NaN if they are not given in the annotation file. This allows to use these attributes for sorting or filter criteria. It is especially meaningful if the gene annotation files were received fom different software packages (e.g., GeMoMa, Braker, ...) having different attributes., default = tie,tde,tae,iAA,pAA,score,lpm,maxGap,bestScore,maxScore,raa,rce)</td> | ||
<td style="width:100px;">STRING</td> | <td style="width:100px;">STRING</td> | ||
</tr> | </tr> | ||
Line 1,148: | Line 1,269: | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green">s</font></td> | <td><font color="green">s</font></td> | ||
<td>sorting (comma-separated list that defines the way predictions are sorted within a cluster, default = | <td>sorting (comma-separated list that defines the way predictions are sorted within a cluster, default = sumWeight,score)</td> | ||
<td style="width:100px;">STRING</td> | <td style="width:100px;">STRING</td> | ||
</tr> | </tr> | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green">atf</font></td> | <td><font color="green">atf</font></td> | ||
<td>alternative transcript filter (If a prediction is suggested as an alternative transcript, this additional filter will be applied. The filter works syntactically like the 'filter' parameter and allows you to keep the number of alternative transcripts small based on meaningful criteria. Reasonable filter could be based on RNA-seq data (tie==1) or on | <td>alternative transcript filter (If a prediction is suggested as an alternative transcript, this additional filter will be applied. The filter works syntactically like the 'filter' parameter and allows you to keep the number of alternative transcripts small based on meaningful criteria. Reasonable filter could be based on RNA-seq data (tie==1) or on sumWeight (sumWeight>1). A more sophisticated filter could be applied combining several criteria: tie==1 or sumWeight>1, default = tie==1 or sumWeight>1, OPTIONAL)</td> | ||
<td style="width:100px;">STRING</td> | <td style="width:100px;">STRING</td> | ||
</tr> | </tr> | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green"> | <td><font color="green">c</font></td> | ||
<td> | <td>common border filter (the filter on the common borders of transcripts, the lower the more transcripts will be checked as alternative splice isoforms, valid range = [0.0, 1.0], default = 0.75)</td> | ||
<td> | <td style="width:100px;">DOUBLE</td> | ||
</tr> | </tr> | ||
</table> | <tr style="vertical-align:top"> | ||
<td><font color="green">m</font></td> | |||
<td>maximal number of transcripts per gene (the maximal number of allowed transcript predictions per gene, valid range = [1, 2147483647], default = 2147483647)</td> | |||
<td style="width:100px;">INT</td> | |||
</tr> | |||
<tr style="vertical-align:top"> | |||
<td><font color="green">aat</font></td> | |||
<td>add alternative transcripts (a switch to decide whether the IDs of alternative transcripts that have the same CDS should be listed for each prediction, default = false)</td> | |||
<td style="width:100px;">BOOLEAN</td> | |||
</tr> | |||
<tr style="vertical-align:top"> | |||
<td><font color="green">tf</font></td> | |||
<td>transfer features (if true, additional features like UTRs will be transfered from the input to the output. Only features of the representatives will be transfered. The UTRs of identical CDS predictions listed in "alternative" will not be transfered or combined, default = false)</td> | |||
<td style="width:100px;">BOOLEAN</td> | |||
</tr> | |||
<tr style="vertical-align:top"> | |||
<td><font color="green">outdir</font></td> | |||
<td>The output directory, defaults to the current working directory (.)</td> | |||
<td>STRING</td> | |||
</tr> | |||
</table> | |||
'''Example:''' | '''Example:''' | ||
java -jar GeMoMa-1. | java -jar GeMoMa-1.8.jar CLI GAF g=<gene_annotation_file> | ||
= AnnotationFinalizer = | === AnnotationFinalizer === | ||
This tool finalizes an annotation. It allows to predict for UTRs for annotated coding sequences and to generate generic gene and transcript names. UTR prediction might be negatively influenced (i.e. too long predictions) by genomic contamination of RNA-seq libraries, overlapping genes or genes in close proximity as well as unstranded RNA-seq libraries. Please use '''ERE''' to preprocess the mapped reads. | This tool finalizes an annotation. It allows to predict for UTRs for annotated coding sequences and to generate generic gene and transcript names. UTR prediction might be negatively influenced (i.e. too long predictions) by genomic contamination of RNA-seq libraries, overlapping genes or genes in close proximity as well as unstranded RNA-seq libraries. Please use '''ERE''' to preprocess the mapped reads. | ||
Line 1,174: | Line 1,315: | ||
''AnnotationFinalizer'' may be called with | ''AnnotationFinalizer'' may be called with | ||
java -jar GeMoMa-1. | java -jar GeMoMa-1.8.jar CLI AnnotationFinalizer | ||
and has the following parameters | and has the following parameters | ||
Line 1,187: | Line 1,328: | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green">g</font></td> | <td><font color="green">g</font></td> | ||
<td>genome (The genome file (FASTA), i.e., the target sequences in the blast run. Should be in IUPAC code, | <td>genome (The genome file (FASTA), i.e., the target sequences in the blast run. Should be in IUPAC code, type = fasta,fa,fas,fna,fasta.gz,fa.gz,fas.gz,fna.gz)</td> | ||
<td style="width:100px;">FILE</td> | <td style="width:100px;">FILE</td> | ||
</tr> | </tr> | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green">a</font></td> | <td><font color="green">a</font></td> | ||
<td>annotation (The predicted genome annotation file (GFF), | <td>annotation (The predicted genome annotation file (GFF), type = gff,gff3)</td> | ||
<td style="width:100px;">FILE</td> | <td style="width:100px;">FILE</td> | ||
</tr> | </tr> | ||
Line 1,205: | Line 1,346: | ||
<td style="width:100px;">STRING</td></tr> | <td style="width:100px;">STRING</td></tr> | ||
<tr><td></td><td colspan=2><table border=0 cellpadding=0 align="center" width="100%"> | <tr><td></td><td colspan=2><table border=0 cellpadding=0 align="center" width="100%"> | ||
<tr><td colspan=3><b> | <tr><td colspan=3><b>Parameters for selection "NO":</b></td></tr> | ||
<tr style="vertical-align:top"> | |||
<td><font color="green">tf</font></td> | |||
<td>transfer features (if true other features than gene, <tag> (default: mRNA), and CDS of the input will be written in the output, default = false)</td> | |||
<td style="width:100px;">BOOLEAN</td> | |||
</tr> | |||
<tr><td colspan=3><b>Parameters for selection "YES":</b></td></tr> | <tr><td colspan=3><b>Parameters for selection "YES":</b></td></tr> | ||
<tr><td colspan=3>The following parameter(s) can be used multiple times:</td></tr> | <tr><td colspan=3>The following parameter(s) can be used multiple times:</td></tr> | ||
Line 1,211: | Line 1,357: | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green">i</font></td> | <td><font color="green">i</font></td> | ||
<td>introns file (Introns (GFF), which might be obtained from RNA-seq, | <td>introns file (Introns (GFF), which might be obtained from RNA-seq, type = gff,gff3)</td> | ||
<td style="width:100px;">FILE</td> | <td style="width:100px;">FILE</td> | ||
</tr> | </tr> | ||
Line 1,232: | Line 1,378: | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green">coverage_unstranded</font></td> | <td><font color="green">coverage_unstranded</font></td> | ||
<td>coverage_unstranded (The coverage file contains the unstranded coverage of the genome per interval. Intervals with coverage 0 (zero) can be left out., | <td>coverage_unstranded (The coverage file contains the unstranded coverage of the genome per interval. Intervals with coverage 0 (zero) can be left out., type = bedgraph)</td> | ||
<td style="width:100px;">FILE</td> | <td style="width:100px;">FILE</td> | ||
</tr> | </tr> | ||
Line 1,238: | Line 1,384: | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green">coverage_forward</font></td> | <td><font color="green">coverage_forward</font></td> | ||
<td>coverage_forward (The coverage file contains the forward coverage of the genome per interval. Intervals with coverage 0 (zero) can be left out., | <td>coverage_forward (The coverage file contains the forward coverage of the genome per interval. Intervals with coverage 0 (zero) can be left out., type = bedgraph)</td> | ||
<td style="width:100px;">FILE</td> | <td style="width:100px;">FILE</td> | ||
</tr> | </tr> | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green">coverage_reverse</font></td> | <td><font color="green">coverage_reverse</font></td> | ||
<td>coverage_reverse (The coverage file contains the reverse coverage of the genome per interval. Intervals with coverage 0 (zero) can be left out., | <td>coverage_reverse (The coverage file contains the reverse coverage of the genome per interval. Intervals with coverage 0 (zero) can be left out., type = bedgraph)</td> | ||
<td style="width:100px;">FILE</td> | <td style="width:100px;">FILE</td> | ||
</tr> | </tr> | ||
Line 1,308: | Line 1,454: | ||
'''Example:''' | '''Example:''' | ||
java -jar GeMoMa-1. | java -jar GeMoMa-1.8.jar CLI AnnotationFinalizer g=<genome> a=<annotation> p=<prefix> | ||
= Annotation evidence = | === Annotation evidence === | ||
This tool adds attributes to the annotation, e.g., tie, tpc, aa, start, stop. These attributes can be used, for instance, if the annotation is used in '''GAF'''. All predictions of the annotation are used. The predictions are not filtered for internal stop codons, missing start or stop codons, frame-shifts, ... . Please use '''ERE''' to preprocess the mapped reads. | This tool adds attributes to the annotation, e.g., tie, tpc, aa, start, stop. These attributes can be used, for instance, if the annotation is used in '''GAF'''. All predictions of the annotation are used. The predictions are not filtered for internal stop codons, missing start or stop codons, frame-shifts, ... . Please use '''ERE''' to preprocess the mapped reads. | ||
Line 1,317: | Line 1,463: | ||
''Annotation evidence'' may be called with | ''Annotation evidence'' may be called with | ||
java -jar GeMoMa-1. | java -jar GeMoMa-1.8.jar CLI AnnotationEvidence | ||
and has the following parameters | and has the following parameters | ||
Line 1,330: | Line 1,476: | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green">a</font></td> | <td><font color="green">a</font></td> | ||
<td>annotation (The genome annotation file (GFF,GTF), | <td>annotation (The genome annotation file (GFF,GTF), type = gff,gff3,gtf,gff.gz,gff3.gz,gtf.gz)</td> | ||
<td style="width:100px;">FILE</td> | <td style="width:100px;">FILE</td> | ||
</tr> | </tr> | ||
Line 1,340: | Line 1,486: | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green">g</font></td> | <td><font color="green">g</font></td> | ||
<td>genome (The genome file (FASTA), i.e., the target sequences in the blast run. Should be in IUPAC code, | <td>genome (The genome file (FASTA), i.e., the target sequences in the blast run. Should be in IUPAC code, type = fasta,fas,fa,fna,fasta.gz,fas.gz,fa.gz,fna.gz)</td> | ||
<td style="width:100px;">FILE</td> | <td style="width:100px;">FILE</td> | ||
</tr> | </tr> | ||
Line 1,347: | Line 1,493: | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green">i</font></td> | <td><font color="green">i</font></td> | ||
<td>introns file (Introns (GFF), which might be obtained from RNA-seq, | <td>introns file (Introns (GFF), which might be obtained from RNA-seq, type = gff,gff3, OPTIONAL)</td> | ||
<td style="width:100px;">FILE</td> | <td style="width:100px;">FILE</td> | ||
</tr> | </tr> | ||
Line 1,368: | Line 1,514: | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green">coverage_unstranded</font></td> | <td><font color="green">coverage_unstranded</font></td> | ||
<td>coverage_unstranded (The coverage file contains the unstranded coverage of the genome per interval. Intervals with coverage 0 (zero) can be left out., | <td>coverage_unstranded (The coverage file contains the unstranded coverage of the genome per interval. Intervals with coverage 0 (zero) can be left out., type = bedgraph)</td> | ||
<td style="width:100px;">FILE</td> | <td style="width:100px;">FILE</td> | ||
</tr> | </tr> | ||
Line 1,374: | Line 1,520: | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green">coverage_forward</font></td> | <td><font color="green">coverage_forward</font></td> | ||
<td>coverage_forward (The coverage file contains the forward coverage of the genome per interval. Intervals with coverage 0 (zero) can be left out., | <td>coverage_forward (The coverage file contains the forward coverage of the genome per interval. Intervals with coverage 0 (zero) can be left out., type = bedgraph)</td> | ||
<td style="width:100px;">FILE</td> | <td style="width:100px;">FILE</td> | ||
</tr> | </tr> | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green">coverage_reverse</font></td> | <td><font color="green">coverage_reverse</font></td> | ||
<td>coverage_reverse (The coverage file contains the reverse coverage of the genome per interval. Intervals with coverage 0 (zero) can be left out., | <td>coverage_reverse (The coverage file contains the reverse coverage of the genome per interval. Intervals with coverage 0 (zero) can be left out., type = bedgraph)</td> | ||
<td style="width:100px;">FILE</td> | <td style="width:100px;">FILE</td> | ||
</tr> | </tr> | ||
Line 1,392: | Line 1,538: | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green">gc</font></td> | <td><font color="green">gc</font></td> | ||
<td>genetic code (optional user-specified genetic code, | <td>genetic code (optional user-specified genetic code, type = tabular, OPTIONAL)</td> | ||
<td style="width:100px;">FILE</td> | <td style="width:100px;">FILE</td> | ||
</tr> | </tr> | ||
Line 1,404: | Line 1,550: | ||
'''Example:''' | '''Example:''' | ||
java -jar GeMoMa-1. | java -jar GeMoMa-1.8.jar CLI AnnotationEvidence a=<annotation> g=<genome> | ||
= | === Synteny checker === | ||
This tool | This tool can be used to determine syntenic regions between target organism and reference organism based on similiarity of genes. The tool returns a table of reference genes per predicted gene. This table can be easily visualized with an R script that is included in the GeMoMa package. | ||
'' | ''Synteny checker'' may be called with | ||
java -jar GeMoMa-1. | java -jar GeMoMa-1.8.jar CLI SyntenyChecker | ||
and has the following parameters | and has the following parameters | ||
Line 1,425: | Line 1,571: | ||
<tr><td colspan=3><hr></td></tr> | <tr><td colspan=3><hr></td></tr> | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green"> | <td><font color="green">t</font></td> | ||
<td> | <td>tag (the tag used to read the GeMoMa annotations, default = mRNA)</td> | ||
<td style="width:100px;"> | <td style="width:100px;">STRING</td> | ||
</tr> | </tr> | ||
<tr><td colspan=3>The following parameter(s) can be used multiple times:</td></tr> | |||
<tr><td></td><td colspan=2><table border=0 cellpadding=0 align="center" width="100%"> | |||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green"> | <td><font color="green">p</font></td> | ||
<td>prefix (the prefix can be used to distinguish predictions from different input files (=reference organisms), OPTIONAL)</td> | |||
<td>prefix (the prefix can be used to distinguish predictions from different input files | |||
<td style="width:100px;">STRING</td> | <td style="width:100px;">STRING</td> | ||
</tr> | </tr> | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green"> | <td><font color="green">a</font></td> | ||
<td>assignment (the | <td>assignment (the assignment file of this reference organism, which combines parts of the CDS to transcripts, type = tabular)</td> | ||
<td style="width:100px;">FILE</td> | <td style="width:100px;">FILE</td> | ||
</tr> | </tr> | ||
</table> | </table> | ||
</td></tr> | </td></tr> | ||
<tr style="vertical-align:top"> | |||
<td><font color="green">g</font></td> | |||
<td>gene annotation file (GFF file containing the gene annotations predicted by GAF, type = gff,gff3)</td> | |||
<td style="width:100px;">FILE</td> | |||
</tr> | |||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green">outdir</font></td> | <td><font color="green">outdir</font></td> | ||
Line 1,457: | Line 1,603: | ||
'''Example:''' | '''Example:''' | ||
java -jar GeMoMa-1. | java -jar GeMoMa-1.8.jar CLI SyntenyChecker a=<assignment> g=<gene_annotation_file> | ||
= | === AddAttribute === | ||
This tool | This tool allows to add an additional attribute to specific features of an annotation. | ||
'' | Those additional attributes might be used in '''GAF''' for filtering or sorting or might be displayed in genome browsers like IGV or WebApollo. The user can choose binary attributes (true or false) or attributes with values according to given tab-delimited table. | ||
''AddAttribute'' may be called with | |||
java -jar GeMoMa-1. | java -jar GeMoMa-1.8.jar CLI AddAttribute | ||
and has the following parameters | and has the following parameters | ||
Line 1,478: | Line 1,626: | ||
<tr><td colspan=3><hr></td></tr> | <tr><td colspan=3><hr></td></tr> | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green"> | <td><font color="green">a</font></td> | ||
<td> | <td>annotation (annotation file, type = gff,gff3)</td> | ||
<td style="width:100px;"> | <td style="width:100px;">FILE</td> | ||
</tr> | </tr> | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green"> | <td><font color="green">f</font></td> | ||
<td> | <td>feature (a feature of the annotation, e.g., gene, transcript or mRNA, default = mRNA)</td> | ||
<td style="width:100px;">STRING</td> | <td style="width:100px;">STRING</td> | ||
</tr> | </tr> | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green"> | <td><font color="green">attribute</font></td> | ||
<td> | <td>attribute (the name of the attribute that is added to the annotation)</td> | ||
<td style="width:100px;"> | <td style="width:100px;">STRING</td> | ||
</tr> | </tr> | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green"> | <td><font color="green">t</font></td> | ||
<td> | <td>table (a tab-delimited file containing IDs and additional attribute, type = tabular)</td> | ||
<td style="width:100px;">FILE</td> | <td style="width:100px;">FILE</td> | ||
</tr> | </tr> | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green"> | <td><font color="green">i</font></td> | ||
<td> | <td>ID column (the ID column in the tab-delimited file, valid range = [0, 2147483647])</td> | ||
<td> | <td style="width:100px;">INT</td> | ||
</tr> | </tr> | ||
</table> | <tr style="vertical-align:top"> | ||
<td><font color="green">type</font></td> | |||
'''Example:''' | <td>type (type of addition attribute, range={VALUES, BINARY}, default = VALUES)</td> | ||
<td style="width:100px;">STRING</td></tr> | |||
java -jar GeMoMa-1. | <tr><td></td><td colspan=2><table border=0 cellpadding=0 align="center" width="100%"> | ||
<tr><td colspan=3><b>Parameters for selection "VALUES":</b></td></tr> | |||
<tr style="vertical-align:top"> | |||
<td><font color="green">ac</font></td> | |||
<td>attribute column (the attribute column in the tab-delimited file, valid range = [0, 2147483647])</td> | |||
<td style="width:100px;">INT</td> | |||
</tr> | |||
<tr><td colspan=3><b>No parameters for selection "BINARY"</b></td></tr> | |||
</table></td></tr> | |||
<tr style="vertical-align:top"> | |||
<td><font color="green">outdir</font></td> | |||
<td>The output directory, defaults to the current working directory (.)</td> | |||
<td>STRING</td> | |||
</tr> | |||
</table> | |||
'''Example:''' | |||
java -jar GeMoMa-1.8.jar CLI AddAttribute a=<annotation> attribute=<attribute> t=<table> i=<ID_column> ac=<attribute_column> | |||
=== GAFComparison === | |||
This tool allows to compare results from GAF based on the attributed ref-gene and alternative. | |||
Hence, you can compare the annotation of different genomes or the effect of different parameters on the annotation of one genome. | |||
'' | ''GAFComparison'' may be called with | ||
java -jar GeMoMa-1. | java -jar GeMoMa-1.8.jar CLI GAFComparison | ||
and has the following parameters | and has the following parameters | ||
Line 1,533: | Line 1,694: | ||
<tr><td colspan=3><hr></td></tr> | <tr><td colspan=3><hr></td></tr> | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green"> | <td><font color="green">t</font></td> | ||
<td> | <td>tag (the tag used to read the GAF annotations, default = mRNA)</td> | ||
<td style="width:100px;"> | <td style="width:100px;">STRING</td> | ||
</tr> | </tr> | ||
<tr><td colspan=3>The following parameter(s) can be used multiple times:</td></tr> | |||
<tr><td></td><td colspan=2><table border=0 cellpadding=0 align="center" width="100%"> | |||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green"> | <td><font color="green">n</font></td> | ||
<td> | <td>name (a simple name for the organism)</td> | ||
<td style="width:100px;">STRING</td> | <td style="width:100px;">STRING</td> | ||
</tr> | </tr> | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green"> | <td><font color="green">g</font></td> | ||
<td> | <td>gene annotation file (GFF file containing the gene annotations (predicted by GAF), type = gff,gff3,gff.gz.gff3.gz)</td> | ||
<td style="width:100px;"> | <td style="width:100px;">FILE</td> | ||
</tr> | </tr> | ||
</table> | |||
</td></tr> | |||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green"> | <td><font color="green">s</font></td> | ||
<td> | <td>split prefix (a switch to decide whether the prefix should be split and writen in a separat column, default = false)</td> | ||
<td style="width:100px;"> | <td style="width:100px;">BOOLEAN</td> | ||
</tr> | </tr> | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green"> | <td><font color="green">d</font></td> | ||
<td> | <td>differences (a switch to decide whether only genes with difference should be returned, default = true)</td> | ||
<td style="width:100px;"> | <td style="width:100px;">BOOLEAN</td> | ||
</tr> | </tr> | ||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green"> | <td><font color="green">outdir</font></td> | ||
<td> | <td>The output directory, defaults to the current working directory (.)</td> | ||
<td | <td>STRING</td> | ||
</tr> | |||
<tr><td colspan=3>< | </table> | ||
'''Example:''' | |||
java -jar GeMoMa-1.8.jar CLI GAFComparison n=<name> g=<gene_annotation_file> | |||
=== Analyzer === | |||
This tools allows to compare true annotation with predicted annotation as it is frequently done in benchmark studies. Furthermore, it can return a detailed table comparing true annotation and predicted annotation which might help to identify systematical errors or biases in the predictions. Hence, this tool might help to detect weaknesses of the prediction algorithm. | |||
True and predicted transcripts are evaluated based on nucleotide F1 measure. For each predicted transcript, the true transcript with highest nucleotide F1 measure is listed. A negative value in a F1 measure column indicates that there is a predicted transcript that matches the true transcript with a F1 measure value that is the absolute value of this entry, but there is another true transcript that matches this predicted transcript with an even better F1. Also true and predicted transcripts are listed that do not overlap with any transcript from the predicted and true annotation, respectively. The table contains the attributes of the true and the predicted annotation besides some additional columns allowing to easily filter interesting examples and to do statistics. | |||
The evaluation can be based on CDS (default) or exon features. The tool also reports sensitivity and precision for the categories gene and transcript. | |||
''Analyzer'' may be called with | |||
java -jar GeMoMa-1.8.jar CLI Analyzer | |||
and has the following parameters | |||
<table border=0 cellpadding=10 align="center" width="100%"> | |||
<tr> | |||
<td>name</td> | |||
<td>comment</td> | |||
<td>type</td> | |||
</tr> | |||
<tr><td colspan=3><hr></td></tr> | |||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green"> | <td><font color="green">t</font></td> | ||
<td> | <td>truth (the true annotation, type = gff,gff3,gff.gz,gff3.gz)</td> | ||
<td style="width:100px;"> | <td style="width:100px;">FILE</td> | ||
</tr> | |||
<tr><td colspan=3>The following parameter(s) can be used multiple times:</td></tr> | |||
<tr><td></td><td colspan=2><table border=0 cellpadding=0 align="center" width="100%"> | |||
<tr style="vertical-align:top"> | |||
<td><font color="green">n</font></td> | |||
<td>name (can be used to distinguish different predictions, OPTIONAL)</td> | |||
<td style="width:100px;">STRING</td> | |||
</tr> | |||
<tr style="vertical-align:top"> | |||
<td><font color="green">p</font></td> | |||
<td>predicted annotation (GFF file containing the predicted annotation, type = gff,gff3,gff.gz,gff3.gz)</td> | |||
<td style="width:100px;">FILE</td> | |||
</tr> | |||
</table> | |||
</td></tr> | |||
<tr style="vertical-align:top"> | |||
<td><font color="green">c</font></td> | |||
<td>CDS (if true CDS features are used otherwise exon features, default = true)</td> | |||
<td style="width:100px;">BOOLEAN</td> | |||
</tr> | |||
<tr style="vertical-align:top"> | |||
<td><font color="green">w</font></td> | |||
<td>write (write detailed table comparing the true and the predicted annotation, range={NO, YES}, default = NO)</td> | |||
<td style="width:100px;">STRING</td></tr> | |||
<tr><td></td><td colspan=2><table border=0 cellpadding=0 align="center" width="100%"> | |||
<tr><td colspan=3><b>No parameters for selection "NO"</b></td></tr> | |||
<tr><td colspan=3><b>Parameters for selection "YES":</b></td></tr> | |||
<tr style="vertical-align:top"> | |||
<td><font color="green">ca</font></td> | |||
<td>common attributes (Only gff attributes of mRNAs are included in the result table, that can be found in the given portion of all mRNAs. Attributes and their portion are handled independently for truth and prediction. This parameter allows to choose between a more informative table or compact table., valid range = [0.0, 1.0], default = 0.5)</td> | |||
<td style="width:100px;">DOUBLE</td> | |||
</tr> | </tr> | ||
</table></td></tr> | </table></td></tr> | ||
<tr style="vertical-align:top"> | |||
<td><font color="green">r</font></td> | |||
<td>reliable (additionally evaluate sensitivity for reliable transcripts, range={NO, YES}, default = NO)</td> | |||
<td style="width:100px;">STRING</td></tr> | |||
<tr><td></td><td colspan=2><table border=0 cellpadding=0 align="center" width="100%"> | |||
<tr><td colspan=3><b>No parameters for selection "NO"</b></td></tr> | |||
<tr><td colspan=3><b>Parameters for selection "YES":</b></td></tr> | |||
<tr style="vertical-align:top"> | |||
<td><font color="green">f</font></td> | |||
<td>filter (A filter for deciding which transcript from the truth are reliable or not. The filter is applied to the GFF attributes of the truth. You probably need to run AnnotationEvidence on the truth GFF. The default filter decides based on the completeness of the prediction (start=='M' and stop=='*'), no premature stop codons (nps==0), RNA-seq coverage (tpc==1) and intron evidence (isNaN(tie) or tie==1)., default = start=='M' and stop=='*' and nps==0 and (tpc==1 and (isNaN(tie) or tie==1)), OPTIONAL)</td> | |||
<td style="width:100px;">STRING</td> | |||
</tr> | |||
</table></td></tr> | |||
<tr style="vertical-align:top"> | |||
<td><font color="green">outdir</font></td> | |||
<td>The output directory, defaults to the current working directory (.)</td> | |||
<td>STRING</td> | |||
</tr> | |||
</table> | |||
'''Example:''' | |||
java -jar GeMoMa-1.8.jar CLI Analyzer t=<truth> p=<predicted_annotation> | |||
=== BUSCORecomputer === | |||
This tool can be used to compute BUSCO statistics for genes instead of transcripts. Proteins of an annotation file can be extracted with '''Exctractor''', Proteins can be used to compute BUSCO statistics with BUSCO. The full BUSCO table and the assignment file from the '''Extractor''' can be used as input for this tool. Alternatively, a table can be generated from the annotation file that can be used instead of the assignment file. | |||
''BUSCORecomputer'' may be called with | |||
java -jar GeMoMa-1.8.jar CLI BUSCORecomputer | |||
and has the following parameters | |||
<table border=0 cellpadding=10 align="center" width="100%"> | |||
<tr> | |||
<td>name</td> | |||
<td>comment</td> | |||
<td>type</td> | |||
</tr> | |||
<tr><td colspan=3><hr></td></tr> | |||
<tr style="vertical-align:top"> | |||
<td><font color="green">b</font></td> | |||
<td>BUSCO (the BUSCO full table based on transcripts/proteins, type = tabular)</td> | |||
<td style="width:100px;">FILE</td> | |||
</tr> | |||
<tr style="vertical-align:top"> | |||
<td><font color="green">i</font></td> | |||
<td>IDs (a table with at leat two columns, the first is the gene ID, the second is the transcript/protein ID. The assignment file from the Extractor can be used or a table can be derived by the user from the gene annotation file (gff,gtf), type = tabular)</td> | |||
<td style="width:100px;">FILE</td> | |||
</tr> | |||
<tr style="vertical-align:top"> | <tr style="vertical-align:top"> | ||
<td><font color="green">outdir</font></td> | <td><font color="green">outdir</font></td> | ||
Line 1,579: | Line 1,853: | ||
'''Example:''' | '''Example:''' | ||
java -jar GeMoMa-1. | java -jar GeMoMa-1.8.jar CLI BUSCORecomputer b=<BUSCO> i=<IDs> |
Revision as of 12:16, 7 October 2021
This page describes the parameters of all GeMoMa modules.
If you have any questions, comments or bugs, please check the FAQs, our github page or contact Jens Keilwagen.
GeMoMa pipeline
This tool can be used to run the complete GeMoMa pipeline. The tool is multi-threaded and can utilize all compute cores on one machine, but not distributed as for instance in a compute cluster. It basically runs: Extract RNA-seq evidence (ERE), DenoiseIntrons, Extractor, external search (tblastn or mmseqs), Gene Model Mapper (GeMoMa), GeMoMa Annotation Filter (GAF), and AnnnotationFinalizer.
GeMoMa pipeline may be called with
java -jar GeMoMa-1.8.jar CLI GeMoMaPipeline
and has the following parameters
name | comment | type | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
t | target genome (Target genome file (FASTA), type = fasta,fa,fas,fna,fasta.gz,fa.gz,fas.gz,fna.gz) | FILE | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
The following parameter(s) can be used zero or multiple times: | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
The following parameter(s) can be used zero or multiple times: | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
selected | selected (The path to list file, which allows to make only a predictions for the contained transcript ids. The first column should contain transcript IDs as given in the annotation. Remaining columns can be used to determine a target region that should be overlapped by the prediction, if columns 2 to 5 contain chromosome, strand, start and end of region, type = tabular,txt, OPTIONAL) | FILE | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
gc | genetic code (optional user-specified genetic code, type = tabular, OPTIONAL) | FILE | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
tblastn | tblastn (if *true* tblastn is used as search algorithm, otherwise mmseqs is used. Tblastn and mmseqs need to be installed to use the corresponding option, default = false) | BOOLEAN | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
tag | tag (A user-specified tag for transcript predictions in the third column of the returned gff. It might be beneficial to set this to a specific value for some genome browsers., default = mRNA) | STRING | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
r | RNA-seq evidence (data for RNA-seq evidence, range={NO, MAPPED, EXTRACTED}, default = NO) | STRING | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
d | denoise (removing questionable introns that have been extracted by ERE, range={DENOISE, RAW}, default = DENOISE) | STRING | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Extractor.u | upcase IDs (whether the IDs in the GFF should be upcased, default = false) | BOOLEAN | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Extractor.r | repair (if a transcript annotation can not be parsed, the program will try to infer the phase of the CDS parts to repair the annotation, default = false) | BOOLEAN | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Extractor.a | Ambiguity (This parameter defines how to deal with ambiguities in the DNA. There are 3 options: EXCEPTION, which will remove the corresponding transcript, AMBIGUOUS, which will use an X for the corresponding amino acid, and RANDOM, which will randomly select an amnio acid from the list of possibilities., range={EXCEPTION, AMBIGUOUS, RANDOM}, default = AMBIGUOUS) | STRING | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Extractor.d | discard pre-mature stop (if *true* transcripts with pre-mature stop codon are discarded as they often indicate misannotation, default = true) | BOOLEAN | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Extractor.s | stop-codon excluded from CDS (A flag that states whether the reference annotation contains the stop codon in the CDS annotation or not, default = false) | BOOLEAN | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Extractor.f | full-length (A flag which allows for choosing between only full-length and all (i.e., full-length and partial) transcripts, default = true) | BOOLEAN | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Extractor.l | long fasta comment (whether a short (transcript ID) or a long (transcript ID, gene ID, chromosome, strand, interval) fasta comment should be written for proteins, CDSs, and genomic regions, default = false) | BOOLEAN | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
GeMoMa.r | reads (if introns are given by a GFF, only use those which have at least this number of supporting split reads, valid range = [1, 2147483647], default = 1) | INT | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
GeMoMa.s | splice (if no intron is given by RNA-seq, compute candidate splice sites or not, default = true) | BOOLEAN | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
GeMoMa.sm | substitution matrix (optional user-specified substitution matrix, type = tabular, OPTIONAL) | FILE | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
GeMoMa.g | gap opening (The gap opening cost in the alignment, default = 11) | INT | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
GeMoMa.ge | gap extension (The gap extension cost in the alignment, default = 1) | INT | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
GeMoMa.m | maximum intron length (The maximum length of an intron, default = 15000) | INT | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
GeMoMa.sil | static intron length (A flag which allows to switch between static intron length, which can be specified by the user and is identical for all genes, and dynamic intron length, which is based on the gene-specific maximum intron length in the reference organism plus the user given maximum intron length, default = true) | BOOLEAN | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
GeMoMa.i | intron-loss-gain-penalty (The penalty used for intron loss and gain, default = 25) | INT | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
GeMoMa.e | e-value (The e-value for filtering blast results, default = 100.0) | DOUBLE | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
GeMoMa.c | contig threshold (The threshold for evaluating contigs, valid range = [0.0, 1.0], default = 0.4) | DOUBLE | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
GeMoMa.rt | region threshold (The threshold for evaluating regions, valid range = [0.0, 1.0], default = 0.9) | DOUBLE | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
GeMoMa.h | hit threshold (The threshold for adding additional hits, valid range = [0.0, 1.0], default = 0.9) | DOUBLE | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
GeMoMa.p | predictions (The (maximal) number of predictions per transcript, default = 10) | INT | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
GeMoMa.a | avoid stop (A flag which allows to avoid (additional) pre-mature stop codons in a transcript, default = true) | BOOLEAN | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
GeMoMa.approx | approx (whether an approximation is used to compute the score for intron gain, default = true) | BOOLEAN | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
GeMoMa.pa | protein alignment (whether a protein alignment between the prediction and the reference transcript should be computed. If so two additional attributes (iAA, pAA) will be added to predictions in the gff output. These might be used in GAF. However, since some transcripts are very long this can increase the needed runtime and memory (RAM)., default = true) | BOOLEAN | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
GeMoMa.prefix | prefix (A prefix to be used for naming the predictions, default = ) | STRING | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
GeMoMa.v | verbose (A flag which allows to output a wealth of additional information per transcript, default = false) | BOOLEAN | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
GeMoMa.t | timeout (The (maximal) number of seconds to be used for the predictions of one transcript, if exceeded GeMoMa does not output a prediction for this transcript., valid range = [0, 604800], default = 3600) | LONG | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
GeMoMa.ru | replace unknown (Replace unknown amino acid symbols by X, default = false) | BOOLEAN | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
GeMoMa.Score | Score (A flag which allows to do nothing, re-score or re-align the search results, range={Trust, ReScore, ReAlign}, default = ReAlign) | STRING | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
GAF.d | default attributes (Comma-separated list of attributes that is set to NaN if they are not given in the annotation file. This allows to use these attributes for sorting or filter criteria. It is especially meaningful if the gene annotation files were received fom different software packages (e.g., GeMoMa, Braker, ...) having different attributes., default = tie,tde,tae,iAA,pAA,score,lpm,maxGap,bestScore,maxScore,raa,rce) | STRING | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
GAF.f | filter (A filter can be applied to transcript predictions to receive only reasonable predictions. The filter is applied to the GFF attributes. The default filter decides based on the completeness of the prediction (start=='M' and stop=='*') and the relative score (score/aa>=0.75) whether a prediction is used or not. In addition, predictions without score (isNaN(score)) will be used as external annotations do not have the attribute score. Different criteria can be combined using 'and' and 'or'. A more sophisticated filter could be applied for instance using the completeness, the relative score, the evidence as well as statistics based on RNA-seq: start=='M' and stop=='*' and score/aa>=0.75 and (evidence>1 or tpc==1.0), default = start=='M' and stop=='*' and (isNaN(score) or score/aa>=0.75), OPTIONAL) | STRING | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
GAF.s | sorting (comma-separated list that defines the way predictions are sorted within a cluster, default = sumWeight,score) | STRING | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
GAF.a | alternative transcript filter (If a prediction is suggested as an alternative transcript, this additional filter will be applied. The filter works syntactically like the 'filter' parameter and allows you to keep the number of alternative transcripts small based on meaningful criteria. Reasonable filter could be based on RNA-seq data (tie==1) or on sumWeight (sumWeight>1). A more sophisticated filter could be applied combining several criteria: tie==1 or sumWeight>1, default = tie==1 or sumWeight>1, OPTIONAL) | STRING | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
GAF.c | common border filter (the filter on the common borders of transcripts, the lower the more transcripts will be checked as alternative splice isoforms, valid range = [0.0, 1.0], default = 0.75) | DOUBLE | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
GAF.m | maximal number of transcripts per gene (the maximal number of allowed transcript predictions per gene, valid range = [1, 2147483647], default = 2147483647) | INT | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
GAF.aat | add alternative transcripts (a switch to decide whether the IDs of alternative transcripts that have the same CDS should be listed for each prediction, default = false) | BOOLEAN | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
GAF.t | transfer features (if true, additional features like UTRs will be transfered from the input to the output. Only features of the representatives will be transfered. The UTRs of identical CDS predictions listed in "alternative" will not be transfered or combined, default = false) | BOOLEAN | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
AnnotationFinalizer.u | UTR (allows to predict UTRs using RNA-seq data, range={NO, YES}, default = NO) | STRING | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
AnnotationFinalizer.r | rename (allows to generate generic gene and transcripts names (cf. parameter "name attribute"), range={COMPOSED, SIMPLE, NO}, default = COMPOSED) | STRING | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
AnnotationFinalizer.n | name attribute (if true the new name is added as new attribute "Name", otherwise "Parent" and "ID" values are modified accordingly, default = true) | BOOLEAN | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
sc | synteny check (run SyntenyChecker if possible, default = true) | BOOLEAN | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
p | predicted proteins (If *true*, returns the predicted proteins of the target organism as fastA file, default = true) | BOOLEAN | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
pc | predicted CDSs (If *true*, returns the predicted CDSs of the target organism as fastA file, default = false) | BOOLEAN | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
pgr | predicted genomic regions (If *true*, returns the genomic regions of predicted gene models of the target organism as fastA file, default = false) | BOOLEAN | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
o | output individual predictions (If *true*, returns the predictions for each reference species, default = false) | BOOLEAN | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
debug | debug (If *false* removes all temporary files even if the jobs exits unexpected, default = true) | BOOLEAN | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
restart | restart (can be used to restart the latest GeMoMaPipeline run, which was finished without results, with very similar parameters, e.g., after an exception was thrown (cf. parameter debug), default = false) | BOOLEAN | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
b | BLAST_PATH (allows to set a path to the blast binaries if not set in the environment, default = , OPTIONAL) | STRING | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
m | MMSEQS_PATH (allows to set a path to the blast binaries if not set in the environment, default = , OPTIONAL) | STRING | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
outdir | The output directory, defaults to the current working directory (.) | STRING | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
threads | The number of threads used for the tool, defaults to 1 | INT |
Example:
java -jar GeMoMa-1.8.jar CLI GeMoMaPipeline t=<target_genome> AnnotationFinalizer.p=<prefix>
Extract RNA-seq Evidence
This tools extracts introns and coverage from mapped RNA-seq reads. Introns might be denoised by the tool DenoiseIntrons. Introns and coverage results can be used in GeMoMa to improve the predictions and might help to select better gene models in GAF. In addition, introns and coverage can be used to predict UTRs by AnnotationFinalizer.
Extract RNA-seq Evidence may be called with
java -jar GeMoMa-1.8.jar CLI ERE
and has the following parameters
name | comment | type | |||||||||||||||
s | Stranded (Defines whether the reads are stranded. In case of FR_FIRST_STRAND, the first read of a read pair or the only read in case of single-end data is assumed to be located on forward strand of the cDNA, i.e., reverse to the mRNA orientation. If you are using Illumina TruSeq you should use FR_FIRST_STRAND., range={FR_UNSTRANDED, FR_FIRST_STRAND, FR_SECOND_STRAND}, default = FR_UNSTRANDED) | STRING | |||||||||||||||
The following parameter(s) can be used multiple times: | |||||||||||||||||
| |||||||||||||||||
v | ValidationStringency (Defines how strict to be when reading a SAM or BAM, beyond bare minimum validation., range={STRICT, LENIENT, SILENT}, default = LENIENT) | STRING | |||||||||||||||
u | use secondary alignments (allows to filter flags in the SAM or BAM, default = true) | BOOLEAN | |||||||||||||||
c | coverage (allows to output the coverage, default = true) | BOOLEAN | |||||||||||||||
mmq | minimum mapping quality (reads with a mapping quality that is lower than this value will be ignored, valid range = [0, 255], default = 40) | INT | |||||||||||||||
mc | minimum context (only introns that have evidence of at least one split read with a minimal M (=(mis)match) stretch in the cigar string larger than or equal to this value will be used, valid range = [1, 1000000], default = 1) | INT | |||||||||||||||
maximumcoverage | maximum coverage (optional parameter to reduce the size of coverage output files, coverage higher than this value will be reported as this value, valid range = [1, 10000], OPTIONAL) | INT | |||||||||||||||
f | filter by intron mismatches (filter reads by the number of mismatches around splits, range={NO, YES}, default = NO) | STRING | |||||||||||||||
| |||||||||||||||||
e | evidence long splits (require introns to have at least this number of times the supporting reads as their length deviates from the mean split length, valid range = [0.0, 100.0], default = 0.0) | DOUBLE | |||||||||||||||
mil | minimum intron length (introns shorter than the minimum length are discarded and considered as contiguous, valid range = [0, 1000], default = 0) | INT | |||||||||||||||
repositioning | repositioning (due to limitations in BAM/SAM format huge chromosomes need to be split before mapping. This parameter allows to undo the split mapping to real chromosomes and coordinates. The repositioning file has 3 columns: split_chr_name, original_chr_name, offset_in_original_chr, type = tabular, OPTIONAL) | FILE | |||||||||||||||
outdir | The output directory, defaults to the current working directory (.) | STRING |
Example:
java -jar GeMoMa-1.8.jar CLI ERE m=<mapped_reads_file>
CheckIntrons
The tool checks the distribution of introns on the strands and the dinucleotide distribution at splice sites.
CheckIntrons may be called with
java -jar GeMoMa-1.8.jar CLI CheckIntrons
and has the following parameters
name | comment | type | |||
t | target genome (The target genome file (FASTA), i.e., the target sequences in the blast run. Should be in IUPAC code, type = fasta) | FILE | |||
The following parameter(s) can be used multiple times: | |||||
| |||||
v | verbose (A flag which allows to output a wealth of additional information per transcript, default = false) | BOOLEAN | |||
outdir | The output directory, defaults to the current working directory (.) | STRING |
Example:
java -jar GeMoMa-1.8.jar CLI CheckIntrons t=<target_genome> i=<introns>
DenoiseIntrons
This module allows to analyze introns extracted by ERE. Introns with a large intron size or a low relative expression are possibly artefacts and will be removed. The result of this module can be used in the module GeMoMa, AnnotationEvidence, and AnnotationFinalizer.
DenoiseIntrons may be called with
java -jar GeMoMa-1.8.jar CLI DenoiseIntrons
and has the following parameters
name | comment | type | |||||||||||||||||||||
The following parameter(s) can be used multiple times: | |||||||||||||||||||||||
| |||||||||||||||||||||||
The following parameter(s) can be used multiple times: | |||||||||||||||||||||||
| |||||||||||||||||||||||
m | maximum intron length (The maximum length of an intron, default = 15000) | INT | |||||||||||||||||||||
me | minimum expression (The threshold for removing introns, valid range = [0.0, 1.0], default = 0.01) | DOUBLE | |||||||||||||||||||||
context | context (The context upstream a donor and donwstream an acceptor site that is used to determine the expression of the region, valid range = [0, 100], default = 10) | INT | |||||||||||||||||||||
outdir | The output directory, defaults to the current working directory (.) | STRING |
Example:
java -jar GeMoMa-1.8.jar CLI DenoiseIntrons i=<introns> coverage_unstranded=<coverage_unstranded>
NCBI Reference Retriever
This tool can be used to download or update assembly and annotation files of reference organsims from NCBI. This way it allows to easily collect all data necessary to start GeMoMaPipeline or Extractor.
NCBI Reference Retriever may be called with
java -jar GeMoMa-1.8.jar CLI NRR
and has the following parameters
name | comment | type |
r | reference directory (the directory where the genome and annotation files of the reference organisms should be stored, default = references/) | STRING |
n | number of tries (the number of tries for downloading a reference file, valid range = [1, 100], default = 10) | INT |
rl | reference list (a list of reference organisms, type = txt) | FILE |
outdir | The output directory, defaults to the current working directory (.) | STRING |
Example:
java -jar GeMoMa-1.8.jar CLI NRR rl=<reference_list>
Extractor
This tool can be used to create input files for GeMoMa, i.e., it creates at least a fasta file containing the translated parts of the CDS and a tabular file containing the assignment of transcripts to genes and parts of CDS to transcripts. In addition, Extractor can be used to create several additional files from the final prediction, e.g. proteins, CDSs, ... . Two inputs are mandatory: The genome as fasta or fasta.gz and the corresponding annotation as gff or gff.gz. The gff file should be sorted. If you like to set a user-specific genetic code, please use a tab-delimited file with two columns. The first column contains the amino acid in one letter code, the second a list of tripletts.
Extractor may be called with
java -jar GeMoMa-1.8.jar CLI Extractor
and has the following parameters
name | comment | type |
a | annotation (Reference annotation file (GFF or GTF), which contains gene models annotated in the reference genome, type = gff,gff3,gtf,gff.gz,gff3.gz,gtf.gz) | FILE |
g | genome (Reference genome file (FASTA), type = fasta,fa,fas,fna,fasta.gz,fa.gz,fas.gz,fna.gz) | FILE |
gc | genetic code (optional user-specified genetic code, type = tabular, OPTIONAL) | FILE |
p | proteins (whether the complete proteins sequences should returned as output, default = false) | BOOLEAN |
c | cds (whether the complete CDSs should returned as output, default = false) | BOOLEAN |
genomic | genomic (whether the genomic regions should be returned (upper case = coding, lower case = non coding), default = false) | BOOLEAN |
i | introns (whether introns should be extracted from annotation, that might be used for test cases, default = false) | BOOLEAN |
identical | identical (if CDS is identical Extractor only used one transcript. This parameter allows to return a table that lists in the first column the used transcript and in the second column the discarded transcript. If no transcript is discarded, the list is empty., default = false) | BOOLEAN |
u | upcase IDs (whether the IDs in the GFF should be upcased, default = false) | BOOLEAN |
r | repair (if a transcript annotation can not be parsed, the program will try to infer the phase of the CDS parts to repair the annotation, default = false) | BOOLEAN |
s | selected (The path to list file, which allows to make only a predictions for the contained transcript ids. The first column should contain transcript IDs as given in the annotation. Remaining columns will be ignored., type = tabular,txt, OPTIONAL) | FILE |
Ambiguity | Ambiguity (This parameter defines how to deal with ambiguities in the DNA. There are 3 options: EXCEPTION, which will remove the corresponding transcript, AMBIGUOUS, which will use an X for the corresponding amino acid, and RANDOM, which will randomly select an amnio acid from the list of possibilities., range={EXCEPTION, AMBIGUOUS, RANDOM}, default = EXCEPTION) | STRING |
d | discard pre-mature stop (if *true* transcripts with pre-mature stop codon are discarded as they often indicate misannotation, default = true) | BOOLEAN |
sefc | stop-codon excluded from CDS (A flag that states whether the reference annotation contains the stop codon in the CDS annotation or not, default = false) | BOOLEAN |
f | full-length (A flag which allows for choosing between only full-length and all (i.e., full-length and partial) transcripts, default = true) | BOOLEAN |
l | long fasta comment (whether a short (transcript ID) or a long (transcript ID, gene ID, chromosome, strand, interval) fasta comment should be written for proteins, CDSs, and genomic regions, default = false) | BOOLEAN |
v | verbose (A flag which allows to output a wealth of additional information, default = false) | BOOLEAN |
outdir | The output directory, defaults to the current working directory (.) | STRING |
Example:
java -jar GeMoMa-1.8.jar CLI Extractor a=<annotation> g=<genome>
GeneModelMapper
This tool is the main part of, a homology-based gene prediction tool. GeMoMa builds gene models from search results (e.g. tblastn or mmseqs).
As first step, you should run Extractor obtaining cds parts and assignment. Second, you should run a search algorithm, e.g. tblastn or mmseqs, with cds parts as query. Finally, these search results are then used in GeMoMa. Search results should be clustered according to the reference genes. The most easiest way is to sort the search results accoring to the first column. If the search results are not sorted by default (e.g. mmseqs), you should the parameter sort. If you like to run GeMoMa ignoring intron position conservation, you should blast protein sequences and feed the results in query cds parts and leave assignment unselected.
If you like to run GeMoMa using RNA-seq evidence, you should map your RNA-seq reads to the genome and run ERE on the mapped reads. For several reasons, spurious introns can be extracted from RNA-seq data. Hence, we recommend to run DenoiseIntrons to remove such spurious introns. Finally, you can use the obtained introns (and coverage) in GeMoMa.
If you like to obtain multiple predictions per gene model of the reference organism, you should set predictions accordingly. In addition, we suggest to decrease the value of contig threshold allowing GeMoMa to evaluate more candidate contigs/chromosomes.
If you change the values of contig threshold, region threshold and hit threshold, this will influence the predictions as well as the runtime of the algorithm. The lower the values are, the slower the algorithm is.
You can filter your predictions using GAF, which also allows for combining predictions from different reference organismns.
Finally, you can predict UTRs and rename predictions using AnnotationFinalizer.
If you like to run the complete GeMoMa pipeline and not only specific module, you can run the multi-threaded module GeMoMaPipeline.
GeneModelMapper may be called with
java -jar GeMoMa-1.8.jar CLI GeMoMa
and has the following parameters
name | comment | type | |||||||||||||||||||||
s | search results (The search results, e.g., from tblastn or mmseqs, type = tabular) | FILE | |||||||||||||||||||||
t | target genome (The target genome file (FASTA), i.e., the target sequences in the blast run. Should be in IUPAC code, type = fasta,fas,fa,fna,fasta.gz,fas.gz,fa.gz,fna.gz) | FILE | |||||||||||||||||||||
c | cds parts (The query CDS parts file (protein FASTA), i.e., the CDS parts that have been searched in the target genome using for instance BLAST or mmseqs, type = fasta,fa,fas,fna) | FILE | |||||||||||||||||||||
a | assignment (The assignment file, which combines CDS parts to proteins, type = tabular, OPTIONAL) | FILE | |||||||||||||||||||||
The following parameter(s) can be used zero or multiple times: | |||||||||||||||||||||||
| |||||||||||||||||||||||
r | reads (if introns are given by a GFF, only use those which have at least this number of supporting split reads, valid range = [1, 2147483647], default = 1) | INT | |||||||||||||||||||||
splice | splice (if no intron is given by RNA-seq, compute candidate splice sites or not, default = true) | BOOLEAN | |||||||||||||||||||||
The following parameter(s) can be used zero or multiple times: | |||||||||||||||||||||||
| |||||||||||||||||||||||
g | genetic code (optional user-specified genetic code, type = tabular, OPTIONAL) | FILE | |||||||||||||||||||||
sm | substitution matrix (optional user-specified substitution matrix, type = tabular, OPTIONAL) | FILE | |||||||||||||||||||||
go | gap opening (The gap opening cost in the alignment, default = 11) | INT | |||||||||||||||||||||
ge | gap extension (The gap extension cost in the alignment, default = 1) | INT | |||||||||||||||||||||
m | maximum intron length (The maximum length of an intron, default = 15000) | INT | |||||||||||||||||||||
sil | static intron length (A flag which allows to switch between static intron length, which can be specified by the user and is identical for all genes, and dynamic intron length, which is based on the gene-specific maximum intron length in the reference organism plus the user given maximum intron length, default = true) | BOOLEAN | |||||||||||||||||||||
intron-loss-gain-penalty | intron-loss-gain-penalty (The penalty used for intron loss and gain, default = 25) | INT | |||||||||||||||||||||
e | e-value (The e-value for filtering blast results, default = 100.0) | DOUBLE | |||||||||||||||||||||
ct | contig threshold (The threshold for evaluating contigs, valid range = [0.0, 1.0], default = 0.4) | DOUBLE | |||||||||||||||||||||
rt | region threshold (The threshold for evaluating regions, valid range = [0.0, 1.0], default = 0.9) | DOUBLE | |||||||||||||||||||||
h | hit threshold (The threshold for adding additional hits, valid range = [0.0, 1.0], default = 0.9) | DOUBLE | |||||||||||||||||||||
p | predictions (The (maximal) number of predictions per transcript, default = 10) | INT | |||||||||||||||||||||
selected | selected (The path to list file, which allows to make only a predictions for the contained transcript ids. The first column should contain transcript IDs as given in the annotation. Remaining columns can be used to determine a target region that should be overlapped by the prediction, if columns 2 to 5 contain chromosome, strand, start and end of region, type = tabular,txt, OPTIONAL) | FILE | |||||||||||||||||||||
as | avoid stop (A flag which allows to avoid (additional) pre-mature stop codons in a transcript, default = true) | BOOLEAN | |||||||||||||||||||||
approx | approx (whether an approximation is used to compute the score for intron gain, default = true) | BOOLEAN | |||||||||||||||||||||
pa | protein alignment (whether a protein alignment between the prediction and the reference transcript should be computed. If so two additional attributes (iAA, pAA) will be added to predictions in the gff output. These might be used in GAF. However, since some transcripts are very long this can increase the needed runtime and memory (RAM)., default = true) | BOOLEAN | |||||||||||||||||||||
prefix | prefix (A prefix to be used for naming the predictions, default = ) | STRING | |||||||||||||||||||||
tag | tag (A user-specified tag for transcript predictions in the third column of the returned gff. It might be beneficial to set this to a specific value for some genome browsers., default = mRNA) | STRING | |||||||||||||||||||||
v | verbose (A flag which allows to output a wealth of additional information per transcript, default = false) | BOOLEAN | |||||||||||||||||||||
timeout | timeout (The (maximal) number of seconds to be used for the predictions of one transcript, if exceeded GeMoMa does not output a prediction for this transcript., valid range = [0, 604800], default = 3600) | LONG | |||||||||||||||||||||
sort | sort (A flag which allows to sort the search results, default = false) | BOOLEAN | |||||||||||||||||||||
ru | replace unknown (Replace unknown amino acid symbols by X, default = false) | BOOLEAN | |||||||||||||||||||||
Score | Score (A flag which allows to do nothing, re-score or re-align the search results, range={Trust, ReScore, ReAlign}, default = Trust) | STRING | |||||||||||||||||||||
outdir | The output directory, defaults to the current working directory (.) | STRING |
Example:
java -jar GeMoMa-1.8.jar CLI GeMoMa s=<search_results> t=<target_genome> c=<cds_parts>
GeMoMa Annotation Filter
This tool combines and filters gene predictions from different sources yielding a common gene prediction. The tool does not modify the predictions, but filters redundant and low-quality predictions and selects relevant predictions. In addition, it adds attributes to the annotation of transcript predictions.
The algorithm does the following: First, redundant predictions are identified (and additional attributes (evidence, sumWeight) are introduced). Second, the predictions are filtered using the user-specified criterium based on the attributes from the annotation. Third, clusters of overlapping predictions are determined, the predictions are sorted within the cluster and relevant predictions are extracted.
Optionally, annotation info can be added for each reference organism enabling a functional prediction for predicted transcripts based on the function of the reference transcript. Phytozome provides annotation info tables for plants, but annotation info can be used from any source as long as they are tab-delimited files with at least the following columns: transcriptName, GO and .*defline.
Initially, GAF was build to combine gene predictions obtained from GeMoMa. It allows to combine the predictions from multiple reference organisms, but works also using only one reference organism. However, GAF also allows to integrate predictions from ab-initio or purely RNA-seq-based gene predictors as well as manually curated annotation. If you like to do so, we recommend to run AnnotationEvidence for each of these input files to add additional attributes that can be used for sorting and filtering within GAF. The sort and filter criteria need to be carefully revised in this case. Default values can be set for missing attributes.
GeMoMa Annotation Filter may be called with
java -jar GeMoMa-1.8.jar CLI GAF
and has the following parameters
name | comment | type | ||||||||||||
t | tag (the tag used to read the GeMoMa annotations, default = mRNA) | STRING | ||||||||||||
The following parameter(s) can be used multiple times: | ||||||||||||||
| ||||||||||||||
d | default attributes (Comma-separated list of attributes that is set to NaN if they are not given in the annotation file. This allows to use these attributes for sorting or filter criteria. It is especially meaningful if the gene annotation files were received fom different software packages (e.g., GeMoMa, Braker, ...) having different attributes., default = tie,tde,tae,iAA,pAA,score,lpm,maxGap,bestScore,maxScore,raa,rce) | STRING | ||||||||||||
f | filter (A filter can be applied to transcript predictions to receive only reasonable predictions. The filter is applied to the GFF attributes. The default filter decides based on the completeness of the prediction (start=='M' and stop=='*') and the relative score (score/aa>=0.75) whether a prediction is used or not. In addition, predictions without score (isNaN(score)) will be used as external annotations do not have the attribute score. Different criteria can be combined using 'and' and 'or'. A more sophisticated filter could be applied for instance using the completeness, the relative score, the evidence as well as statistics based on RNA-seq: start=='M' and stop=='*' and score/aa>=0.75 and (evidence>1 or tpc==1.0), default = start=='M' and stop=='*' and (isNaN(score) or score/aa>=0.75), OPTIONAL) | STRING | ||||||||||||
s | sorting (comma-separated list that defines the way predictions are sorted within a cluster, default = sumWeight,score) | STRING | ||||||||||||
atf | alternative transcript filter (If a prediction is suggested as an alternative transcript, this additional filter will be applied. The filter works syntactically like the 'filter' parameter and allows you to keep the number of alternative transcripts small based on meaningful criteria. Reasonable filter could be based on RNA-seq data (tie==1) or on sumWeight (sumWeight>1). A more sophisticated filter could be applied combining several criteria: tie==1 or sumWeight>1, default = tie==1 or sumWeight>1, OPTIONAL) | STRING | ||||||||||||
c | common border filter (the filter on the common borders of transcripts, the lower the more transcripts will be checked as alternative splice isoforms, valid range = [0.0, 1.0], default = 0.75) | DOUBLE | ||||||||||||
m | maximal number of transcripts per gene (the maximal number of allowed transcript predictions per gene, valid range = [1, 2147483647], default = 2147483647) | INT | ||||||||||||
aat | add alternative transcripts (a switch to decide whether the IDs of alternative transcripts that have the same CDS should be listed for each prediction, default = false) | BOOLEAN | ||||||||||||
tf | transfer features (if true, additional features like UTRs will be transfered from the input to the output. Only features of the representatives will be transfered. The UTRs of identical CDS predictions listed in "alternative" will not be transfered or combined, default = false) | BOOLEAN | ||||||||||||
outdir | The output directory, defaults to the current working directory (.) | STRING |
Example:
java -jar GeMoMa-1.8.jar CLI GAF g=<gene_annotation_file>
AnnotationFinalizer
This tool finalizes an annotation. It allows to predict for UTRs for annotated coding sequences and to generate generic gene and transcript names. UTR prediction might be negatively influenced (i.e. too long predictions) by genomic contamination of RNA-seq libraries, overlapping genes or genes in close proximity as well as unstranded RNA-seq libraries. Please use ERE to preprocess the mapped reads.
AnnotationFinalizer may be called with
java -jar GeMoMa-1.8.jar CLI AnnotationFinalizer
and has the following parameters
name | comment | type | |||||||||||||||||||||||||||||||||||||||||||||||||||
g | genome (The genome file (FASTA), i.e., the target sequences in the blast run. Should be in IUPAC code, type = fasta,fa,fas,fna,fasta.gz,fa.gz,fas.gz,fna.gz) | FILE | |||||||||||||||||||||||||||||||||||||||||||||||||||
a | annotation (The predicted genome annotation file (GFF), type = gff,gff3) | FILE | |||||||||||||||||||||||||||||||||||||||||||||||||||
t | tag (A user-specified tag for transcript predictions in the third column of the returned gff. It might be beneficial to set this to a specific value for some genome browsers., default = mRNA) | STRING | |||||||||||||||||||||||||||||||||||||||||||||||||||
u | UTR (allows to predict UTRs using RNA-seq data, range={NO, YES}, default = NO) | STRING | |||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||
rename | rename (allows to generate generic gene and transcripts names (cf. parameter "name attribute"), range={COMPOSED, SIMPLE, NO}, default = COMPOSED) | STRING | |||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||
n | name attribute (if true the new name is added as new attribute "Name", otherwise "Parent" and "ID" values are modified accordingly, default = true) | BOOLEAN | |||||||||||||||||||||||||||||||||||||||||||||||||||
outdir | The output directory, defaults to the current working directory (.) | STRING |
Example:
java -jar GeMoMa-1.8.jar CLI AnnotationFinalizer g=<genome> a=<annotation> p=<prefix>
Annotation evidence
This tool adds attributes to the annotation, e.g., tie, tpc, aa, start, stop. These attributes can be used, for instance, if the annotation is used in GAF. All predictions of the annotation are used. The predictions are not filtered for internal stop codons, missing start or stop codons, frame-shifts, ... . Please use ERE to preprocess the mapped reads.
Annotation evidence may be called with
java -jar GeMoMa-1.8.jar CLI AnnotationEvidence
and has the following parameters
name | comment | type | ||||||||||||||||||||||||
a | annotation (The genome annotation file (GFF,GTF), type = gff,gff3,gtf,gff.gz,gff3.gz,gtf.gz) | FILE | ||||||||||||||||||||||||
t | tag (A user-specified tag for transcript predictions in the third column of the returned gff. It might be beneficial to set this to a specific value for some genome browsers., default = mRNA) | STRING | ||||||||||||||||||||||||
g | genome (The genome file (FASTA), i.e., the target sequences in the blast run. Should be in IUPAC code, type = fasta,fas,fa,fna,fasta.gz,fas.gz,fa.gz,fna.gz) | FILE | ||||||||||||||||||||||||
The following parameter(s) can be used multiple times: | ||||||||||||||||||||||||||
| ||||||||||||||||||||||||||
r | reads (if introns are given by a GFF, only use those which have at least this number of supporting split reads, valid range = [1, 2147483647], default = 1) | INT | ||||||||||||||||||||||||
The following parameter(s) can be used multiple times: | ||||||||||||||||||||||||||
| ||||||||||||||||||||||||||
ao | annotation output (if the annotation should be returned with attributes tie, tpc, and aa, default = true) | BOOLEAN | ||||||||||||||||||||||||
gc | genetic code (optional user-specified genetic code, type = tabular, OPTIONAL) | FILE | ||||||||||||||||||||||||
outdir | The output directory, defaults to the current working directory (.) | STRING |
Example:
java -jar GeMoMa-1.8.jar CLI AnnotationEvidence a=<annotation> g=<genome>
Synteny checker
This tool can be used to determine syntenic regions between target organism and reference organism based on similiarity of genes. The tool returns a table of reference genes per predicted gene. This table can be easily visualized with an R script that is included in the GeMoMa package.
Synteny checker may be called with
java -jar GeMoMa-1.8.jar CLI SyntenyChecker
and has the following parameters
name | comment | type | ||||||
t | tag (the tag used to read the GeMoMa annotations, default = mRNA) | STRING | ||||||
The following parameter(s) can be used multiple times: | ||||||||
| ||||||||
g | gene annotation file (GFF file containing the gene annotations predicted by GAF, type = gff,gff3) | FILE | ||||||
outdir | The output directory, defaults to the current working directory (.) | STRING |
Example:
java -jar GeMoMa-1.8.jar CLI SyntenyChecker a=<assignment> g=<gene_annotation_file>
AddAttribute
This tool allows to add an additional attribute to specific features of an annotation.
Those additional attributes might be used in GAF for filtering or sorting or might be displayed in genome browsers like IGV or WebApollo. The user can choose binary attributes (true or false) or attributes with values according to given tab-delimited table.
AddAttribute may be called with
java -jar GeMoMa-1.8.jar CLI AddAttribute
and has the following parameters
name | comment | type | |||||||||
a | annotation (annotation file, type = gff,gff3) | FILE | |||||||||
f | feature (a feature of the annotation, e.g., gene, transcript or mRNA, default = mRNA) | STRING | |||||||||
attribute | attribute (the name of the attribute that is added to the annotation) | STRING | |||||||||
t | table (a tab-delimited file containing IDs and additional attribute, type = tabular) | FILE | |||||||||
i | ID column (the ID column in the tab-delimited file, valid range = [0, 2147483647]) | INT | |||||||||
type | type (type of addition attribute, range={VALUES, BINARY}, default = VALUES) | STRING | |||||||||
| |||||||||||
outdir | The output directory, defaults to the current working directory (.) | STRING |
Example:
java -jar GeMoMa-1.8.jar CLI AddAttribute a=<annotation> attribute=<attribute> t=<table> i=<ID_column> ac=<attribute_column>
GAFComparison
This tool allows to compare results from GAF based on the attributed ref-gene and alternative. Hence, you can compare the annotation of different genomes or the effect of different parameters on the annotation of one genome.
GAFComparison may be called with
java -jar GeMoMa-1.8.jar CLI GAFComparison
and has the following parameters
name | comment | type | ||||||
t | tag (the tag used to read the GAF annotations, default = mRNA) | STRING | ||||||
The following parameter(s) can be used multiple times: | ||||||||
| ||||||||
s | split prefix (a switch to decide whether the prefix should be split and writen in a separat column, default = false) | BOOLEAN | ||||||
d | differences (a switch to decide whether only genes with difference should be returned, default = true) | BOOLEAN | ||||||
outdir | The output directory, defaults to the current working directory (.) | STRING |
Example:
java -jar GeMoMa-1.8.jar CLI GAFComparison n=<name> g=<gene_annotation_file>
Analyzer
This tools allows to compare true annotation with predicted annotation as it is frequently done in benchmark studies. Furthermore, it can return a detailed table comparing true annotation and predicted annotation which might help to identify systematical errors or biases in the predictions. Hence, this tool might help to detect weaknesses of the prediction algorithm.
True and predicted transcripts are evaluated based on nucleotide F1 measure. For each predicted transcript, the true transcript with highest nucleotide F1 measure is listed. A negative value in a F1 measure column indicates that there is a predicted transcript that matches the true transcript with a F1 measure value that is the absolute value of this entry, but there is another true transcript that matches this predicted transcript with an even better F1. Also true and predicted transcripts are listed that do not overlap with any transcript from the predicted and true annotation, respectively. The table contains the attributes of the true and the predicted annotation besides some additional columns allowing to easily filter interesting examples and to do statistics.
The evaluation can be based on CDS (default) or exon features. The tool also reports sensitivity and precision for the categories gene and transcript.
Analyzer may be called with
java -jar GeMoMa-1.8.jar CLI Analyzer
and has the following parameters
name | comment | type | |||||||||
t | truth (the true annotation, type = gff,gff3,gff.gz,gff3.gz) | FILE | |||||||||
The following parameter(s) can be used multiple times: | |||||||||||
| |||||||||||
c | CDS (if true CDS features are used otherwise exon features, default = true) | BOOLEAN | |||||||||
w | write (write detailed table comparing the true and the predicted annotation, range={NO, YES}, default = NO) | STRING | |||||||||
| |||||||||||
r | reliable (additionally evaluate sensitivity for reliable transcripts, range={NO, YES}, default = NO) | STRING | |||||||||
| |||||||||||
outdir | The output directory, defaults to the current working directory (.) | STRING |
Example:
java -jar GeMoMa-1.8.jar CLI Analyzer t=<truth> p=<predicted_annotation>
BUSCORecomputer
This tool can be used to compute BUSCO statistics for genes instead of transcripts. Proteins of an annotation file can be extracted with Exctractor, Proteins can be used to compute BUSCO statistics with BUSCO. The full BUSCO table and the assignment file from the Extractor can be used as input for this tool. Alternatively, a table can be generated from the annotation file that can be used instead of the assignment file.
BUSCORecomputer may be called with
java -jar GeMoMa-1.8.jar CLI BUSCORecomputer
and has the following parameters
name | comment | type |
b | BUSCO (the BUSCO full table based on transcripts/proteins, type = tabular) | FILE |
i | IDs (a table with at leat two columns, the first is the gene ID, the second is the transcript/protein ID. The assignment file from the Extractor can be used or a table can be derived by the user from the gene annotation file (gff,gtf), type = tabular) | FILE |
outdir | The output directory, defaults to the current working directory (.) | STRING |
Example:
java -jar GeMoMa-1.8.jar CLI BUSCORecomputer b=<BUSCO> i=<IDs>