Chapters and reference
Data and workflows
Four modules and concepts β- 6.1Import sequences and annotations
- 6.2Import intervals and paired intervals
- 6.3Signals and coverage data
- 6.4Aligned characters and source coordinates
- 6.5Relationships, variants and annotations
- 6.6Import nucleotide and protein alignments
- 6.7BLASTp protein comparisons
- 6.8Protein-to-genome coordinate projection
- 6.9Data workflows
- 6.10Sequence comparisons from source files
- 6.11Flagship data sources and construction
Data and workflows Β· Section 10 of 12
6.9 Data workflows
1 Choose by input and goal
Identify the original input and the intended plot. Every path preserves source IDs, complete lengths and coordinate units. Readers do not run alignments or generate missing relationships or annotations.
| Input available | Shortest processing path | Result and plotting entry |
|---|---|---|
| Existing R tables | Organize minimal fields, check endpoint/annotation IDs and inspect validation reports | Length, HSP and annotation tables β shared data and layers |
| FASTA, GFF3 and BLAST/PAF | Import sequences and annotations, then alignments; check lengths, units and IDs, retaining reverse endpoints | Source tables β relationship plot or HSP Dotplot |
| One GenBank record | Use read_genbank() in sequence import; inspect lengths, annotation hierarchy and original segments |
One sequence and annotations β circular backbone and annotations |
| Protein BLASTp and complete lengths | Declare aa units and read alignments; verify both protein IDs; supply actual CDS/phase before projecting to DNA | Protein positions β protein comparison; DNA positions β projection |
| BED/BEDPE intervals | Read intervals or paired intervals and check the readerβs one-based conversion without converting twice | Annotation intervals or paired links β features and links |
| bedGraph/BigWig signals | Import signals, retaining units, missingness and source intervals without filling unknown regions with zero | Signals β tracks; counts/bins β track statistics |
| Existing character alignment | Import aligned characters, checking gaps, source positions and alphabet | Observed alignment columns β magnification and character details |
2 Checks before plotting
- Sequence
accvervalues are unique and lengths come from complete sources, never the last annotation endpoint. - Link
qaccver/saccverand annotationaccvermatch the sequence table. Explicitly distinguish repeated contig names across samples; readers do not guess membership. - DNA uses bp and proteins use aa; BED/PAF readers already convert coordinates. Ascending/descending link endpoints can encode direction and must not be uniformly sorted.
- Draw a minimal plot before adding layers, local settings and target-size output. Use symptom-based diagnostics for problems.
3 Complete source-backed example
Sequence comparison from FASTA/GFF3/BLAST retains paths, display filters, inputs and results. Obtain originals from the input archive, extract it and run downloaded scripts from a directory containing examples/.