blast-formatter
Quick Start
- Command:
blast_formatter -archive <archive.asn> -outfmt <format> -out <output> - Local executable:
/home/vimalinx/miniforge3/envs/bio/bin/blast_formatter - Version: 2.17.0+
- Full reference: See
references/help.md
When To Use This Tool
- Reformat a saved BLAST archive (
outfmt 11) into tabular, XML, JSON, SAM, pairwise text, or HTML output. - Render the same search result in multiple formats without recomputing the alignment search.
- Pull results by RID after a remote BLAST job finishes.
- Define custom tabular field lists once the archive already exists.
Common Patterns
# 1) Reformat a saved archive as tabular output
blast_formatter \
-archive search.asn \
-outfmt "6 qaccver saccver pident length evalue bitscore" \
-out hits.tsv
# 2) Generate an HTML report from the same archive
blast_formatter \
-archive search.asn \
-html \
-outfmt 0 \
-out report.html
# 3) Retrieve and format a completed remote search by RID
blast_formatter \
-rid RID_VALUE \
-outfmt 5 \
-out result.xml
Recommended Workflow
- Save BLAST searches as archive format (
-outfmt 11) whenever you may want multiple downstream renderings. - Reformat the archive into the specific machine-readable or human-readable representation you need.
- Use custom field lists with
-outfmt 6,7,10,17, or20instead of accepting defaults blindly. - Keep the original archive so you can regenerate other views later.
Guardrails
-archiveand-ridare mutually exclusive inputs.- This tool does not rerun BLAST; it only formats an archive or completed remote request.
-max_target_seqscannot be combined with-num_descriptionsor-num_alignments.- The command name on disk is
blast_formattereven though this skill is namedblast-formatter.