This commit updates documentation across the board, introducing definitions for kmer constraints, super-kmers, k-mer set distances, SNP models, and sampling design principles. It also clarifies the index construction pipeline and the underlying mathematical models used for genome pair calibration.
597 B
597 B
Kmers
A kmer is a DNA subsequence of fixed length k. Two constraints apply to k, both enforced when a command starts (an invalid value exits immediately with an error):
k \in [11, 31]: long enough to be specific, short enough to fit in a single 64-bit word at 2 bits/base (k \le 32is the hard limit;k < 11gives insufficient specificity).kis odd: an odd-length sequence can never equal its own reverse complement, so the two orientations of any kmer are always distinct. This is required for the canonical form (see DNA encoding) to be well defined.