Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Upstream PR Status

This table cross-references every change carried in bwa-mem3 main to its corresponding upstream bwa-mem2 PR or issue. “Fork-only” means no upstream PR exists; the change may be submitted upstream in the future or may be fork-specific by design. “Open” means the upstream PR or issue existed at the time of bwa-mem3’s implementation but had not been merged. Upstream status is current as of the bwa-mem3 0.1.0-pre release.

For prose descriptions of each change, follow the links in the “bwa-mem3 PR” column to the relevant deep-dive page section.

Full cross-reference table

Topicbwa-mem3 PRUpstream PR / IssueUpstream status
Correctness
@PG CL: tab escaping#54bwa-mem2#293open issue
SMEM buffer overflow on >151 bp reads#55bwa-mem2#238, bwa-mem2#210PR closed without merge; issue open
kswv nrow==0 guard (all 5 kernels)#51bwa-mem2#289open PR (upstream covers AVX-512BW only)
AVX-512BW dispatch guard (!__AVX512BW__)#26fork-only
AVX2 score2 plateau consolidation#28fork-only
NEON + AVX-512BW 8-bit score2 fix#29fork-only
AVX-512BW 16-bit score2 fix#30fork-only
NEON 16-bit kernel rewrite#31fork-only
kseq2bseq1 zero-initialization#22fork-only
Proper-pair flag from emitted alignment#17fork-only
Performance
Lockstep SMEM batching#33fork-only
Batched -H header ingestion (O(n) fix)#49bwa-mem2#204open PR
libsais FM-index construction#57fork-only
Consolidated mapping speedups#58fork-only
Features
--bam=LEVEL direct BAM output#12fork-only
--meth bisulfite alignment mode#13fork-only
Vendored mimalloc allocator#19fork-only
HN:i hit count tag#42lh3/bwa#438analogous to bwa aln; no direct upstream port
--supp-rep-hard-cap MAPQ rescoring#56bwa-mem2#260open issue
bwa-mem3 shm shared-memory index#65fork-only (v1 feature port)
shm --meth symmetry#67fork-only
Architecture support
Linux ARM64 / aarch64 build + CI#1bwa-mem2#288open PR
arch=avx512bw explicit Makefile target#16fork-only
NEON kswv mate-rescue kernel#18fork-only
AVX2 kswv mate-rescue kernel#20fork-only
Build & infrastructure
doctest framework + Codecov#34fork-only
PACKAGE_VERSION from git describe#52bwa-mem2#283, bwa-mem2#284open issue + open PR
PGO target parameterization#59fork-only
CXXFLAGS/CPPFLAGS/LDFLAGS forwarding#50bwa-mem2#290open upstream PR
Unit-test harness + ARM CI#23fork-only
CI matrix expansion (7 rows)#24fork-only

Upstream issues tracked but not yet fixed in bwa-mem3

The following upstream issues are tracked in the bwa-mem3 issue list but do not yet have corresponding fixes in main:

IssueUpstream referenceNotes
Split-alignment evidence loss vs bwa 0.7.17bwa-mem2#273issue #47 — under investigation
MAPQ/coordinate parity vs bwa mem 0.7.18bwa-mem2#262, bwa-mem2#246, bwa-mem2#239issue #48 — tracking only

See also: Correctness fixes · Performance improvements · Features · Architecture support · Build & infrastructure