Incomplete / Failed Annotations
Monitor your annotation progress and troubleshoot issues when annotations don't complete successfully. Bystro provides dedicated pages to track incomplete jobs and diagnose failures.
In Progress: Check the Incomplete page for annotations currently processing.
Failed: Visit the Failed page for annotations that encountered errors.
Tracking Annotation Progress
The Incomplete page shows real-time progress for your running annotations, allowing you to monitor large jobs and estimate completion times.
Progress tracking interface showing annotation status and completion estimates
Incomplete Annotations
Currently processing jobs with progress indicators and estimated completion times. Large datasets may take several hours to complete.
Completed Annotations
Successful annotations automatically move to the Results page where you can download and analyze your annotated data.
Understanding Failed Annotations
Failed annotations are rare but can occur due to file format issues, incompatible genome builds, or other technical problems. When they do happen, the system provides specific error information to help you resolve the issue.
Wrong genome build: VCF coordinates do not match the selected reference genome.
File format issues: Malformed VCF headers or invalid file structure.
Incompatible file types: Files that appear to upload but contain unsupported data.
Corrupted uploads: Files damaged during transfer or compression.
Troubleshooting Steps
Check the error message
Review the specific error type displayed on the Failed page. This usually indicates the root cause of the problem.
Verify your genome build
Double-check that you selected the correct assembly (hg19, hg38, GRCh37, or GRCh38) that matches your VCF file coordinates.
Validate your file format
Ensure your VCF file has proper headers and follows standard formatting. Test with a smaller subset of your data if possible.
Resubmit
After addressing potential issues, try resubmitting your file. Most problems can be resolved by correcting the genome build or file format.
Getting Additional Help
If you continue to experience issues after following the troubleshooting steps:
Test with small files first: Validate your workflow with a subset of data before submitting large jobs.
Use standard tools: Generate VCFs with well-established pipelines to ensure proper formatting.
Double-check genome builds: Verify the reference genome before submission.
Monitor progress: Check the Incomplete page for long-running jobs.