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.

📍 Where to Find Your Annotations

⏳ 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.

Annotation progress tracking interface with progress bars and status indicators

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.

Common Failure Causes

  • Wrong genome build: VCF coordinates do not match 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

Step 1: Check the Error Message

Review the specific error type displayed on the Failed page. This usually indicates the root cause of the problem.

Step 2: Verify Genome Build

Double-check that you selected the correct assembly/genome build (e.g., hg19, hg38, GRCh37, GRCh38) that matches your VCF file coordinates.

Step 3: Validate File Format

Ensure your VCF file has proper headers and follows standard formatting. Test with a smaller subset of your data if possible.

Step 4: 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:

  • Check our FAQ:Visit theFAQ pagefor common issues and solutions
  • Contact support: Reach out with specific error messages and file details
  • Community forum: Search for similar issues or ask the community

💡 Prevention Tips

  • Test with small files first: Validate your workflow with a subset of data
  • Use standard tools: Generate VCFs with well-established pipelines
  • Double-check genome builds: Verify reference genome before submission
  • Monitor progress: Check the Incomplete page for long-running jobs