FastaGuard: FASTA preflight QC for modern bioinformatics pipelines
- 1Umeå Plant Science Centre, Department of Plant Physiology, Umeå University
Abstract
FastaGuard is a streaming, explainable FASTA preflight QC tool that validates assembly FASTA files, detects structural and composition red flags, and emits a versioned multi-format report with an explicit pipeline gate before expensive downstream analysis. We evaluated v1.1.0 in four analyses whose design was fixed before data collection. On 700 public NCBI assemblies the pipeline gate stopped 19.7% (1.9% weighted to the population), always on its high-N rule and mostly in scaffold-level genomes; the NCBI submission gate stopped 2.0%, and an independent recount confirmed every stop. Among 1,040 faults injected into real assemblies, the NCBI gate flagged 520 of 520 in 13 error classes (table2asn: 280 at error level) and blocked none of 120 benign changes. Across seven downstream tools, 46 of 182 defect cells failed and 12 altered the records without a warning, all in classes the pipeline gate blocks. Stopping a mismatched reference at the gate avoided about 54-62 s of mapping and sorting at a cost of 0.05-0.06 s. Availability and Implementation: Source code and documentation are freely available under the MIT license at https://github.com/ehsanestaji/FastaGuard (release tag v1.1.0: https://github.com/ehsanestaji/FastaGuard/releases/tag/v1.1.0; archived at doi:10.5281/zenodo.23728753). Install via Bioconda (mamba install -c conda-forge -c bioconda fastaguard=1.1.0), BioContainers, or GitHub release binaries. Implemented in Rust; supported on Linux and macOS, including Bioconda builds for linux-64, linux-aarch64, osx-64, and osx-arm64. Contact: [email protected]; [email protected] Supplementary information: Supplementary Note (designs, all results, deviations from the pre-registered protocol); scripts, manifests and result tables at Zenodo, doi:10.5281/zenodo.23729530.
Related
- SCAR: Controlled mutations, ancient DNA damage, and fragmentation of fasta and fastq sequences
- Model Context Protocol: The unexpected catalyst of a bioinformatics interoperability revolution
- Hidden assumptions in nascent RNA sequencing pipelines define reproducibility states
- Identification of Crohn’s disease-associated molecular signatures by integrative bioinformatics analysis and experimental validation
- A Scientific Claim Stability Framework for Evaluating MRI Morphometry Pipelines
BibTeX
@misc{estaji2026fastaguard,
title = {{FastaGuard: FASTA preflight QC for modern bioinformatics pipelines}},
author = {E. Estaji and J.-F. Mao},
howpublished = {bioRxiv},
year = {2026},
month = oct,
doi = {10.64898/2026.10.28.761563},
url = {https://www.biorxiv.org/content/10.64898/2026.10.28.761563v1},
note = {CC BY},
}
RIS
TY - UNPB
TI - FastaGuard: FASTA preflight QC for modern bioinformatics pipelines
AU - E. Estaji
AU - J.-F. Mao
PY - 2026
DA - 2026/10/28
PB - bioRxiv
DO - 10.64898/2026.10.28.761563
UR - https://www.biorxiv.org/content/10.64898/2026.10.28.761563v1
AB - FastaGuard is a streaming, explainable FASTA preflight QC tool that validates assembly FASTA files, detects structural and composition red flags, and emits a versioned multi-format report with an explicit pipeline gate before expensive downstream analysis. We evaluated v1.1.0 in four analyses whose design was fixed before data collection. On 700 public NCBI assemblies the pipeline gate stopped 19.7% (1.9% weighted to the population), always on its high-N rule and mostly in scaffold-level genomes; the NCBI submission gate stopped 2.0%, and an independent recount confirmed every stop. Among 1,040 faults injected into real assemblies, the NCBI gate flagged 520 of 520 in 13 error classes (table2asn: 280 at error level) and blocked none of 120 benign changes. Across seven downstream tools, 46 of 182 defect cells failed and 12 altered the records without a warning, all in classes the pipeline gate blocks. Stopping a mismatched reference at the gate avoided about 54-62 s of mapping and sorting at a cost of 0.05-0.06 s. Availability and Implementation: Source code and documentation are freely available under the MIT license at https://github.com/ehsanestaji/FastaGuard (release tag v1.1.0: https://github.com/ehsanestaji/FastaGuard/releases/tag/v1.1.0; archived at doi:10.5281/zenodo.23728753). Install via Bioconda (mamba install -c conda-forge -c bioconda fastaguard=1.1.0), BioContainers, or GitHub release binaries. Implemented in Rust; supported on Linux and macOS, including Bioconda builds for linux-64, linux-aarch64, osx-64, and osx-arm64. Contact: [email protected]; [email protected] Supplementary information: Supplementary Note (designs, all results, deviations from the pre-registered protocol); scripts, manifests and result tables at Zenodo, doi:10.5281/zenodo.23729530.
ER -