Getting Started with Genetica Viewer — A Beginner’s Guide
What is Genetica Viewer?
Genetica Viewer is a desktop and web application for visualizing, exploring, and annotating genomic data. It helps researchers, clinicians, and students inspect sequence alignments, variant calls, gene models, and read-level evidence in an interactive, graphical interface.
Key features at a glance
- Sequence alignment visualization: Browse BAM/CRAM alignments with per-base quality and coverage.
- Variant inspection: View VCF records with supporting read evidence and allele frequencies.
- Gene models & annotations: Overlay GTF/GFF annotations, repeat regions, and custom tracks.
- Interactive navigation: Zoom, pan, and jump to coordinates or genes quickly.
- Export & sharing: Save images, export selected regions, and share session files.
Installation and first run
- Download the latest Genetica Viewer installer from the official website (Windows, macOS, Linux).
- Install using default options; accept required permissions for file access.
- Launch the app — the first run will offer an optional sample dataset. Load it to explore features without configuring your own files.
Preparing your data
- Required file types: BAM/CRAM (alignments), VCF (variants), FASTA (reference genome), and GTF/GFF (annotations).
- Index files: Ensure BAM/CRAM have corresponding .bai/.crai index and VCFs are bgzipped and tabix-indexed (.tbi).
- Reference: Load the same reference FASTA used during alignment; a mismatched reference causes coordinate/sequence discrepancies.
Loading files and creating a workspace
- Create a new workspace (File → New Workspace).
- Add a reference FASTA (File → Add Reference).
- Import alignment files (File → Add Alignments) and confirm sample names.
- Add variant VCFs and annotation tracks (File → Add Variant Track / Annotation).
- Save the workspace to preserve loaded tracks and view settings.
Basic navigation and controls
- Zoom: Mouse wheel or trackpad pinch to change scale from whole-chromosome to single-base view.
- Pan: Click-and-drag the ruler or use arrow keys for small shifts.
- Jump: Use the search box to jump to gene names, coordinates, or variant IDs.
- Context menu: Right-click on reads, variants, or features to view details, copy coordinates, or flag items.
Inspecting variants and reads
- Click a variant to open the detail pane: shows genotype, quality metrics, allele depth, and annotated consequences.
- Toggle the “Show supporting reads” option to see individual reads colored by allele and base quality.
- Use filters to hide low-quality variants or low-coverage regions (Filters → Variant Quality / Coverage).
Annotations and customization
- Load GTF/GFF to display gene exons, transcripts, and untranslated regions.
- Add custom BED tracks for regions of interest (e.g., CNV calls, regulatory elements).
- Adjust track order and height to prioritize important data (drag tracks in the sidebar).
- Customize colors for mismatches, insertions, and deletions in Settings → Appearance.
Exporting results
- Export figure: File → Export Image to save the current viewport as PNG, SVG, or PDF.
- Export region sequence or reads: Select region → Export → FASTA/FASTQ/BAM subset.
- Share workspace: File → Export Workspace to create a session file that colleagues can load.
Troubleshooting common issues
- Missing index errors: Create .bai/.crai for BAM/CRAM and .tbi for bgzipped VCFs using samtools/tabix.
- Reference mismatch: Verify chromosome names (chr1 vs 1) and reference version; use a matching FASTA.
- Slow performance: Reduce displayed depth, enable read sampling, or use a pre-filtered region.
Tips for efficient use
- Use keyboard shortcuts: learn zoom, pan, and annotation toggles for faster inspection.
- Create track presets for recurrent projects (Settings → Presets).
- Regularly save workspaces to avoid reloading large files repeatedly.
Next steps and learning resources
- Explore included sample datasets to practice variant review workflows.
- Consult the user manual and tutorial videos on the Genetica Viewer website for advanced features (e.g., custom plugins, scripting API).
- Join the community forum or mailing list to ask questions and share session files.
This guide gets you from installation to confidently inspecting alignments, variants, and annotations in Genetica Viewer. Start with a small region and sample, then scale up to whole-exome or whole-genome projects as you become comfortable.
Leave a Reply