bwa
Finds where short sequencing reads align on a reference sequence.
API/CLI tool ID: bwa
The input fields depend on the value of command.
Understanding inputs and outputs
A read is a short nucleotide sequence produced by a sequencer. FASTQ stores reads and per-base quality information; the reference FASTA contains the sequences to align against. The SAM output records where each read aligns on the reference.
Put single-end reads in read1. For paired-end data, which reads both ends of the same DNA fragment, provide matching files in read1 and read2. Records in the two files must refer to the same fragments in the same order.
With command=index, the tool creates a reference index archive (index_files, TAR). With command=mem, it aligns reads to the reference and returns output.sam. Building an index alone does not align any reads.
Input settings
| Setting | Format | Required | Default | Description and constraints |
|---|---|---|---|---|
command | task | Optional | "mem" | bwa subcommand — Allowed values mem · index |
referenceFasta | file | Required | — | Reference sequence (FASTA) — Extensions fa · fasta |
read1 | file | Optional | — | First read (FASTQ) — Extensions fastq · fq · gz |
read2 | file | Optional | — | Second read (FASTQ, paired-end only) — Extensions fastq · fq · gz |
threads | number | Optional | 4 | Thread count — Minimum 1, Maximum 64 |
Output files
| Column | Display name | Description |
|---|---|---|
output_file | Output file | Index build: index_files (TAR); alignment: output.sam |
This field contains an output filename, not a score or confidence value. Open the file to inspect its contents.
Execution availability
Open an execution plan in your project to see available tool versions and costs. Review and approve the inputs, settings, and terms before running.
License
Code, model weights, and accompanying data have their own terms. The table summarizes terms from official sources; check your execution plan for the configuration you will use. License texts are available in Third-party notices.
| Component | License | Commercial use | Source | Notes |
|---|---|---|---|---|
| Code | GPL-3.0-only | Conditional; see notes | License text | bwa 0.7.17 is licensed under GPL-3.0. Distributing its executable or container to customers entails notice and source-code obligations. |
Checked on 2026-10-21.