Files
obikmer/doc/theory/kmer_indexing/minimizer_selection/index.html
T

1756 lines
35 KiB
HTML
Raw Normal View History

2026-04-16 22:38:20 +02:00
<!doctype html>
<html lang="en" class="no-js">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<link rel="prev" href="../kmers/">
2026-04-16 22:38:20 +02:00
<link rel="next" href="../superkmers/">
2026-04-16 22:38:20 +02:00
<link rel="icon" href="../../../assets/images/favicon.png">
2026-04-16 22:38:20 +02:00
<meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.7.6">
2026-08-15 20:56:29 +02:00
<title>Minimizer selection - obikmer — User Guide</title>
2026-04-16 22:38:20 +02:00
<link rel="stylesheet" href="../../../assets/stylesheets/main.484c7ddc.min.css">
2026-04-16 22:38:20 +02:00
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
<style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
<script>__md_scope=new URL("../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
2026-04-16 22:38:20 +02:00
</head>
<body dir="ltr">
<input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
<input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
<label class="md-overlay" for="__drawer"></label>
<div data-md-component="skip">
2026-08-15 20:56:29 +02:00
<a href="#minimizer-selection" class="md-skip">
2026-04-16 22:38:20 +02:00
Skip to content
</a>
</div>
<div data-md-component="announce">
</div>
<header class="md-header md-header--shadow" data-md-component="header">
<nav class="md-header__inner md-grid" aria-label="Header">
<a href="../../.." title="obikmer — User Guide" class="md-header__button md-logo" aria-label="obikmer — User Guide" data-md-component="logo">
2026-04-16 22:38:20 +02:00
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg>
</a>
<label class="md-header__button md-icon" for="__drawer">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg>
</label>
<div class="md-header__title" data-md-component="header-title">
<div class="md-header__ellipsis">
<div class="md-header__topic">
<span class="md-ellipsis">
2026-08-15 20:56:29 +02:00
obikmer — User Guide
2026-04-16 22:38:20 +02:00
</span>
</div>
<div class="md-header__topic" data-md-component="header-topic">
<span class="md-ellipsis">
2026-08-15 20:56:29 +02:00
Minimizer selection
2026-04-16 22:38:20 +02:00
</span>
</div>
</div>
</div>
<script>var palette=__md_get("__palette");if(palette&&palette.color){if("(prefers-color-scheme)"===palette.color.media){var media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']");palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent")}for(var[key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
</nav>
</header>
<div class="md-container" data-md-component="container">
<main class="md-main" data-md-component="main">
<div class="md-main__inner md-grid">
<div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
<div class="md-sidebar__scrollwrap">
<div class="md-sidebar__inner">
<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
<label class="md-nav__title" for="__drawer">
<a href="../../.." title="obikmer — User Guide" class="md-nav__button md-logo" aria-label="obikmer — User Guide" data-md-component="logo">
2026-04-16 22:38:20 +02:00
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg>
</a>
2026-08-15 20:56:29 +02:00
obikmer — User Guide
2026-04-16 22:38:20 +02:00
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="../../.." class="md-nav__link">
2026-04-16 22:38:20 +02:00
<span class="md-ellipsis">
Home
</span>
</a>
</li>
2026-08-15 20:56:29 +02:00
<li class="md-nav__item">
<a href="../../../installation/" class="md-nav__link">
2026-08-15 20:56:29 +02:00
<span class="md-ellipsis">
Installation
</span>
</a>
</li>
2026-04-16 22:38:20 +02:00
<li class="md-nav__item md-nav__item--active md-nav__item--nested">
2026-08-15 20:56:29 +02:00
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" checked>
2026-04-16 22:38:20 +02:00
2026-08-15 20:56:29 +02:00
<label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="0">
2026-04-16 22:38:20 +02:00
<span class="md-ellipsis">
Theory
</span>
<span class="md-nav__icon md-icon"></span>
</label>
2026-08-15 20:56:29 +02:00
<nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="true">
<label class="md-nav__title" for="__nav_3">
2026-04-16 22:38:20 +02:00
<span class="md-nav__icon md-icon"></span>
Theory
</label>
<ul class="md-nav__list" data-md-scrollfix>
2026-04-16 22:38:20 +02:00
<li class="md-nav__item md-nav__item--active md-nav__item--nested">
2026-04-16 22:38:20 +02:00
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3_1" checked>
<label class="md-nav__link" for="__nav_3_1" id="__nav_3_1_label" tabindex="0">
2026-04-16 22:38:20 +02:00
<span class="md-ellipsis">
Kmer indexing
2026-04-16 22:38:20 +02:00
</span>
<span class="md-nav__icon md-icon"></span>
</label>
<nav class="md-nav" data-md-level="2" aria-labelledby="__nav_3_1_label" aria-expanded="true">
<label class="md-nav__title" for="__nav_3_1">
<span class="md-nav__icon md-icon"></span>
Kmer indexing
2026-04-16 22:38:20 +02:00
</label>
<ul class="md-nav__list" data-md-scrollfix>
2026-04-16 22:38:20 +02:00
<li class="md-nav__item">
<a href="../encoding/" class="md-nav__link">
<span class="md-ellipsis">
DNA encoding
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../kmers/" class="md-nav__link">
2026-04-16 22:38:20 +02:00
<span class="md-ellipsis">
Kmers
</span>
</a>
</li>
2026-04-16 22:38:20 +02:00
<li class="md-nav__item md-nav__item--active">
<input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
<label class="md-nav__link md-nav__link--active" for="__toc">
<span class="md-ellipsis">
2026-08-15 20:56:29 +02:00
Minimizer selection
2026-04-16 22:38:20 +02:00
</span>
<span class="md-nav__icon md-icon"></span>
</label>
<a href="./" class="md-nav__link md-nav__link--active">
<span class="md-ellipsis">
2026-08-15 20:56:29 +02:00
Minimizer selection
2026-04-16 22:38:20 +02:00
</span>
</a>
<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
<label class="md-nav__title" for="__toc">
<span class="md-nav__icon md-icon"></span>
Table of contents
</label>
<ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
<li class="md-nav__item">
2026-08-15 20:56:29 +02:00
<a href="#definition" class="md-nav__link">
2026-04-16 22:38:20 +02:00
<span class="md-ellipsis">
2026-08-15 20:56:29 +02:00
Definition
2026-04-16 22:38:20 +02:00
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#hash-based-minimizer-ordering" class="md-nav__link">
2026-04-16 22:38:20 +02:00
<span class="md-ellipsis">
Hash-based minimizer ordering
2026-08-15 20:56:29 +02:00
</span>
</a>
<nav class="md-nav" aria-label="Hash-based minimizer ordering">
2026-08-15 20:56:29 +02:00
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#hash-function" class="md-nav__link">
<span class="md-ellipsis">
Hash function
</span>
</a>
</li>
</ul>
</nav>
2026-04-16 22:38:20 +02:00
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="../superkmers/" class="md-nav__link">
<span class="md-ellipsis">
Super-kmers
</span>
</a>
</li>
2026-04-16 22:38:20 +02:00
<li class="md-nav__item">
2026-08-15 20:56:29 +02:00
<a href="../indexing_architecture/" class="md-nav__link">
2026-04-16 22:38:20 +02:00
<span class="md-ellipsis">
2026-08-15 20:56:29 +02:00
Partitioning and indexing architecture
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../entropy_filter/" class="md-nav__link">
<span class="md-ellipsis">
Low-complexity kmer filter
</span>
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item md-nav__item--nested">
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3_2" >
<label class="md-nav__link" for="__nav_3_2" id="__nav_3_2_label" tabindex="0">
<span class="md-ellipsis">
Phylogeny
</span>
<span class="md-nav__icon md-icon"></span>
</label>
<nav class="md-nav" data-md-level="2" aria-labelledby="__nav_3_2_label" aria-expanded="false">
<label class="md-nav__title" for="__nav_3_2">
<span class="md-nav__icon md-icon"></span>
Phylogeny
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item md-nav__item--nested">
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3_2_1" >
<label class="md-nav__link" for="__nav_3_2_1" id="__nav_3_2_1_label" tabindex="0">
<span class="md-ellipsis">
Kmer-based
</span>
<span class="md-nav__icon md-icon"></span>
</label>
<nav class="md-nav" data-md-level="3" aria-labelledby="__nav_3_2_1_label" aria-expanded="false">
<label class="md-nav__title" for="__nav_3_2_1">
<span class="md-nav__icon md-icon"></span>
Kmer-based
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="../../phylogeny/kmer_based/kmer_set_distances/" class="md-nav__link">
<span class="md-ellipsis">
Whole k-mer set distances
</span>
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item md-nav__item--nested">
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3_2_2" >
<label class="md-nav__link" for="__nav_3_2_2" id="__nav_3_2_2_label" tabindex="0">
<span class="md-ellipsis">
SNP-based
</span>
<span class="md-nav__icon md-icon"></span>
</label>
<nav class="md-nav" data-md-level="3" aria-labelledby="__nav_3_2_2_label" aria-expanded="false">
<label class="md-nav__title" for="__nav_3_2_2">
<span class="md-nav__icon md-icon"></span>
SNP-based
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="../../phylogeny/snp_based/central_snp_model/" class="md-nav__link">
<span class="md-ellipsis">
Central-position SNP model
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../phylogeny/snp_based/gamma_rate_heterogeneity/" class="md-nav__link">
<span class="md-ellipsis">
Gamma rate heterogeneity
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../phylogeny/snp_based/sankoff_model/" class="md-nav__link">
<span class="md-ellipsis">
Sankoff model
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../phylogeny/snp_based/sampling_design/" class="md-nav__link">
<span class="md-ellipsis">
Sampling design
</span>
</a>
</li>
</ul>
</nav>
</li>
</ul>
</nav>
</li>
2026-04-16 22:38:20 +02:00
</ul>
</nav>
</li>
<li class="md-nav__item md-nav__item--nested">
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
<label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
<span class="md-ellipsis">
2026-08-15 20:56:29 +02:00
Usage
2026-04-16 22:38:20 +02:00
</span>
<span class="md-nav__icon md-icon"></span>
</label>
<nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
<label class="md-nav__title" for="__nav_4">
<span class="md-nav__icon md-icon"></span>
2026-08-15 20:56:29 +02:00
Usage
2026-04-16 22:38:20 +02:00
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="../../../usage/superkmer/" class="md-nav__link">
2026-04-16 22:38:20 +02:00
<span class="md-ellipsis">
2026-08-15 20:56:29 +02:00
superkmer
2026-04-16 22:38:20 +02:00
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../usage/index_command/" class="md-nav__link">
<span class="md-ellipsis">
2026-08-15 20:56:29 +02:00
index
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../usage/merge/" class="md-nav__link">
2026-08-15 20:56:29 +02:00
<span class="md-ellipsis">
merge
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../usage/filter/" class="md-nav__link">
2026-08-15 20:56:29 +02:00
<span class="md-ellipsis">
filter
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../usage/select/" class="md-nav__link">
2026-08-15 20:56:29 +02:00
<span class="md-ellipsis">
select
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../usage/query/" class="md-nav__link">
2026-08-15 20:56:29 +02:00
<span class="md-ellipsis">
query
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../usage/dump/" class="md-nav__link">
2026-08-15 20:56:29 +02:00
<span class="md-ellipsis">
dump
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../usage/annotate/" class="md-nav__link">
2026-08-15 20:56:29 +02:00
<span class="md-ellipsis">
annotate
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../usage/phylo/" class="md-nav__link">
2026-08-15 20:56:29 +02:00
<span class="md-ellipsis">
phylo
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../usage/unitig/" class="md-nav__link">
2026-08-15 20:56:29 +02:00
<span class="md-ellipsis">
unitig
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../usage/estimate/" class="md-nav__link">
2026-08-15 20:56:29 +02:00
<span class="md-ellipsis">
estimate
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../usage/convert/" class="md-nav__link">
2026-08-15 20:56:29 +02:00
<span class="md-ellipsis">
convert
2026-08-15 20:56:29 +02:00
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../usage/utils/" class="md-nav__link">
2026-08-15 20:56:29 +02:00
<span class="md-ellipsis">
utils
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../usage/pack/" class="md-nav__link">
2026-08-15 20:56:29 +02:00
<span class="md-ellipsis">
pack
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../usage/predicates/" class="md-nav__link">
2026-08-15 20:56:29 +02:00
<span class="md-ellipsis">
Predicates and taxonomy paths
</span>
</a>
</li>
2026-04-16 22:38:20 +02:00
</ul>
</nav>
</li>
2026-08-15 20:56:29 +02:00
<li class="md-nav__item md-nav__item--nested">
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
<label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
<span class="md-ellipsis">
Formats
</span>
<span class="md-nav__icon md-icon"></span>
</label>
<nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
<label class="md-nav__title" for="__nav_5">
<span class="md-nav__icon md-icon"></span>
Formats
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="../../../formats/index_layout/" class="md-nav__link">
2026-08-15 20:56:29 +02:00
<span class="md-ellipsis">
Index construction and on-disk layout
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../formats/vcf/" class="md-nav__link">
<span class="md-ellipsis">
VCF pseudo-alignment
</span>
</a>
</li>
2026-08-15 20:56:29 +02:00
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="../../../architecture/" class="md-nav__link">
2026-08-15 20:56:29 +02:00
<span class="md-ellipsis">
Architecture notes
</span>
</a>
</li>
2026-04-16 22:38:20 +02:00
</ul>
</nav>
</div>
</div>
</div>
<div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
<div class="md-sidebar__scrollwrap">
<div class="md-sidebar__inner">
<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
<label class="md-nav__title" for="__toc">
<span class="md-nav__icon md-icon"></span>
Table of contents
</label>
<ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
<li class="md-nav__item">
2026-08-15 20:56:29 +02:00
<a href="#definition" class="md-nav__link">
2026-04-16 22:38:20 +02:00
<span class="md-ellipsis">
2026-08-15 20:56:29 +02:00
Definition
2026-04-16 22:38:20 +02:00
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#hash-based-minimizer-ordering" class="md-nav__link">
2026-04-16 22:38:20 +02:00
<span class="md-ellipsis">
Hash-based minimizer ordering
2026-08-15 20:56:29 +02:00
</span>
</a>
<nav class="md-nav" aria-label="Hash-based minimizer ordering">
2026-08-15 20:56:29 +02:00
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#hash-function" class="md-nav__link">
<span class="md-ellipsis">
Hash function
</span>
</a>
</li>
</ul>
</nav>
2026-04-16 22:38:20 +02:00
</li>
</ul>
</nav>
</div>
</div>
</div>
<div class="md-content" data-md-component="content">
<article class="md-content__inner md-typeset">
2026-08-15 20:56:29 +02:00
<h1 id="minimizer-selection">Minimizer selection</h1>
<h2 id="definition">Definition</h2>
<p>The <strong>minimizer</strong> of a k-mer is the canonical form of the m-mer that is smallest according to a chosen ordering among the <span class="arithmatex">\(k-m+1\)</span> overlapping m-mers contained in the k-mer, with <span class="arithmatex">\(m&lt;k\)</span> (Roberts <em>et al.</em> 2004)<sup id="fnref:Roberts2004-rz"><a class="footnote-ref" href="#fn:Roberts2004-rz">1</a></sup>. Canonical form is the same operation defined for a full kmer (see <a href="../encoding/">DNA encoding</a>), applied here to an m-mer <span class="arithmatex">\(s\)</span> instead: <span class="arithmatex">\(s^c = \min_{\mathrm{lex}}\left(s,\operatorname{RC}(s)\right)\)</span>.</p>
<p>In <strong>OBIkmer</strong>, canonical m-mers are ordered according to a deterministic hash function <span class="arithmatex">\(H\)</span> applied to their canonical form:</p>
<div class="arithmatex">\[
s_1^c &lt;_h s_2^c
\quad\Longleftrightarrow\quad
H(s_1^c) &lt; H(s_2^c).
\]</div>
<p>Thus, for a k-mer <span class="arithmatex">\(K\)</span>, let</p>
<div class="arithmatex">\[
M(K)=(s_1,\ldots,s_{k-m+1})
\]</div>
<p>be its sequence of overlapping m-mers. The minimizer is</p>
<div class="arithmatex">\[
\operatorname{minimizer}(K) = s_j^c,
\qquad
j=\underset{i}{\operatorname{argmin}}\;H(s_i^c).
\]</div>
<p>In other words, the hash function defines the ordering of canonical m-mers, while the minimizer itself is the canonical form of the m-mer selected by that ordering.</p>
<p>Applying the minimizer to consecutive k-mers partitions a sequence into super-kmers (see <a href="../superkmers/">Super-kmers</a>).</p>
<h2 id="hash-based-minimizer-ordering">Hash-based minimizer ordering</h2>
<p><code>obikmer</code> selects minimizers by hash order rather than plain lexicographic order. Ordering m-mers lexicographically on their 2-bit encoding systematically favors AT-rich m-mers (an all-A m-mer always encodes to 0), which causes low-complexity regions to dominate as minimizers and produces unbalanced partitions (Zheng <em>et al.</em> 2020, 2021; Kille <em>et al.</em> 2023; Pan &amp; Reinert 2024; Golan &amp; Shur 2025)<sup id="fnref:Zheng2020-ji"><a class="footnote-ref" href="#fn:Zheng2020-ji">2</a></sup> <sup id="fnref:Zheng2021-cc"><a class="footnote-ref" href="#fn:Zheng2021-cc">3</a></sup> <sup id="fnref:Pan2024-hb"><a class="footnote-ref" href="#fn:Pan2024-hb">4</a></sup> <sup id="fnref:Kille2023-px"><a class="footnote-ref" href="#fn:Kille2023-px">5</a></sup> <sup id="fnref:Golan2025-xf"><a class="footnote-ref" href="#fn:Golan2025-xf">6</a></sup>.</p>
<p>Instead, a well-distributed hash function <span class="arithmatex">\(H\)</span> is applied to the canonical (lexicographically minimal) form of each m-mer, and the m-mer with the smallest <span class="arithmatex">\(H\)</span> value wins. Because <span class="arithmatex">\(H\)</span> is a bijective mixing function with good avalanche properties (Steele <em>et al.</em> 2014)<sup id="fnref:Steele2014-cz"><a class="footnote-ref" href="#fn:Steele2014-cz">7</a></sup>, its output behaves approximately as a composition-independent pseudorandom ordering of distinct m-mers. Under the usual random-hash assumption, each distinct m-mer in a window has approximately the same probability of being the minimum, independently of nucleotide composition.</p>
2026-08-15 20:56:29 +02:00
<p>The canonical form used as input to <span class="arithmatex">\(H\)</span> is still the lexicographic minimum of forward/reverse-complement — hashing is applied on top of it, not used to redefine it. Defining canonicity by hash value instead would bias the <em>distribution of hash values themselves</em> toward small values (the minimum of two independent hashes is not uniformly distributed), reintroducing a bias one layer down.</p>
<h3 id="hash-function">Hash function</h3>
<p>The hash function <span class="arithmatex">\(H\)</span> applies Stafford's 64-bit mixing function, variant 13 (Stafford 2011)<sup id="fnref:Stafford2011"><a class="footnote-ref" href="#fn:Stafford2011">8</a></sup>, to the m-mer encoding XORed with a seed <span class="arithmatex">\(\sigma\)</span>:</p>
2026-08-15 20:56:29 +02:00
<div class="highlight"><pre><span></span><code>H(x):
x ← x ⊕ σ
2026-08-15 20:56:29 +02:00
x ← x ⊕ (x &gt;&gt; 30)
x ← x × 0xbf58476d1ce4e5b9
x ← x ⊕ (x &gt;&gt; 27)
x ← x × 0x94d049bb133111eb
return x ⊕ (x &gt;&gt; 31)
2026-04-16 22:38:20 +02:00
</code></pre></div>
<p>The hash uses a fixed non-zero seed</p>
<div class="arithmatex">\[ \sigma=\texttt{0x9e3779b97f4a7c15}. \]</div>
<p>The choice of <span class="arithmatex">\(\sigma\)</span> is not arbitrary. Low-complexity m-mers (homopolymers and short tandem repeats) are disproportionately abundant in real genomes. If one of them happened to be the global argmin of <span class="arithmatex">\(H\)</span>, it could therefore occur as the minimizer in far more windows than expected from the composition-uniform behavior described above. This is not a bias of the mixing function itself, but a consequence of the repeated occurrence of the same input in real sequence data.</p>
<p>In particular, with <span class="arithmatex">\(\sigma=0\)</span>, the all-A m-mer is encoded as <span class="arithmatex">\(0\)</span>, and</p>
<div class="arithmatex">\[ \operatorname{Mix13}(0)=0, \]</div>
<p>This makes it the global argmin of the hash function. The non-zero seed eliminates the particular pathological correspondence between the all-A m-mer and the zero output of the mixer.</p>
<p>Exhaustive enumeration of all <span class="arithmatex">\(4^m\)</span> m-mers confirms that, with <span class="arithmatex">\(\sigma=\texttt{0x9e3779b97f4a7c15}\)</span>, the global argmin is neither a homopolymer nor a periodic repeat for any tested <span class="arithmatex">\(m\)</span>:</p>
<table>
<thead>
<tr>
<th><span class="arithmatex">\(m\)</span></th>
<th>argmin (canonical)</th>
<th>decoded sequence</th>
<th>minimal period</th>
</tr>
</thead>
<tbody>
<tr>
<td>3</td>
<td>16</td>
<td><code>CAA</code></td>
<td>3</td>
</tr>
<tr>
<td>5</td>
<td>78</td>
<td><code>ACATG</code></td>
<td>5</td>
</tr>
<tr>
<td>7</td>
<td>5512</td>
<td><code>CCCGAGA</code></td>
<td>7</td>
</tr>
<tr>
<td>9</td>
<td>108760</td>
<td><code>CGGGATCGA</code></td>
<td>9</td>
</tr>
<tr>
<td>11</td>
<td>179014</td>
<td><code>AAGGTGTCACG</code></td>
<td>11</td>
</tr>
<tr>
<td>13</td>
<td>33759044</td>
<td><code>GAAATACTTCACA</code></td>
<td>13</td>
</tr>
<tr>
<td>15</td>
<td>29869313</td>
<td><code>AACTACTTACCAAAC</code></td>
<td>15</td>
</tr>
</tbody>
</table>
<p>When the minimal period of the sequence is <span class="arithmatex">\(m\)</span>, as observed in the table above, the sequence is primitive: it cannot be represented as repetitions of a shorter sequence.</p>
<p>See <a href="../indexing_architecture/">Partitioning and indexing architecture</a> for how this hash routes a super-kmer to a partition.</p>
<div class="footnote">
<hr />
<ol>
<li id="fn:Roberts2004-rz">
<p>Roberts M, Hayes W, Hunt BR, Mount SM, Yorke JA (2004) <a href="https://doi.org/10.1093/bioinformatics/bth408">[Reducing storage requirements for biological sequence comparison]{.nocase}</a>. <em>Bioinformatics (Oxford, England)</em>, <strong>20</strong>, 3363--3369.&#160;<a class="footnote-backref" href="#fnref:Roberts2004-rz" title="Jump back to footnote 1 in the text">&#8617;</a></p>
</li>
<li id="fn:Zheng2020-ji">
<p>Zheng H, Kingsford C, Marçais G (2020) <a href="https://doi.org/10.1093/bioinformatics/btaa472">Improved design and analysis of practical minimizers</a>. <em>Bioinformatics (Oxford, England)</em>, <strong>36</strong>, i119--i127.&#160;<a class="footnote-backref" href="#fnref:Zheng2020-ji" title="Jump back to footnote 2 in the text">&#8617;</a></p>
</li>
<li id="fn:Zheng2021-cc">
<p>Zheng H, Kingsford C, Marçais G (2021) <a href="https://doi.org/10.1093/bioinformatics/btab313">Sequence-specific minimizers via polar sets</a>. <em>Bioinformatics (Oxford, England)</em>, <strong>37</strong>, i187--i195.&#160;<a class="footnote-backref" href="#fnref:Zheng2021-cc" title="Jump back to footnote 3 in the text">&#8617;</a></p>
</li>
<li id="fn:Pan2024-hb">
<p>Pan C, Reinert K (2024) <a href="https://doi.org/10.1093/bioinformatics/btae045">A simple refined DNA minimizer operator enables 2-fold faster computation</a>. <em>Bioinformatics (Oxford, England)</em>, <strong>40</strong>.&#160;<a class="footnote-backref" href="#fnref:Pan2024-hb" title="Jump back to footnote 4 in the text">&#8617;</a></p>
</li>
<li id="fn:Kille2023-px">
<p>Kille B, Garrison E, Treangen TJ, Phillippy AM (2023) <a href="https://doi.org/10.1093/bioinformatics/btad512">Minmers are a generalization of minimizers that enable unbiased local jaccard estimation</a>. <em>Bioinformatics (Oxford, England)</em>, <strong>39</strong>.&#160;<a class="footnote-backref" href="#fnref:Kille2023-px" title="Jump back to footnote 5 in the text">&#8617;</a></p>
</li>
<li id="fn:Golan2025-xf">
<p>Golan S, Shur AM (2025) <a href="https://doi.org/10.1007/978-3-031-82670-2\_25">Expected density of random minimizers</a>. In: <em>Lecture notes in computer science</em> Lecture notes in computer science., pp. 347--360. Springer Nature Switzerland, Cham.&#160;<a class="footnote-backref" href="#fnref:Golan2025-xf" title="Jump back to footnote 6 in the text">&#8617;</a></p>
</li>
<li id="fn:Steele2014-cz">
<p>Steele GL Jr, Lea D, Flood CH (2014) <a href="https://doi.org/10.1145/2660193.2660195">[Fast splittable pseudorandom number generators]{.nocase}</a>. In: <em>[Proceedings of the 2014 ACM International Conference on Object Oriented Programming Systems Languages\ &amp; Applications]{.nocase}</em>. ACM, New York, NY, USA.&#160;<a class="footnote-backref" href="#fnref:Steele2014-cz" title="Jump back to footnote 7 in the text">&#8617;</a></p>
</li>
<li id="fn:Stafford2011">
<p>Stafford D (2011) Better bit mixing - improving on MurmurHash3's 64-bit finalizer. Available at: <a href="https://zimbry.blogspot.com/2011/09/better-bit-mixing-improving-on.html">https://zimbry.blogspot.com/2011/09/better-bit-mixing-improving-on.html</a> (accessed 12 September 2026).&#160;<a class="footnote-backref" href="#fnref:Stafford2011" title="Jump back to footnote 8 in the text">&#8617;</a></p>
</li>
</ol>
</div>
2026-04-16 22:38:20 +02:00
</article>
</div>
<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
</div>
</main>
<footer class="md-footer">
<div class="md-footer-meta md-typeset">
<div class="md-footer-meta__inner md-grid">
<div class="md-copyright">
Made with
<a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
Material for MkDocs
</a>
</div>
</div>
</div>
</footer>
</div>
<div class="md-dialog" data-md-component="dialog">
<div class="md-dialog__inner md-typeset"></div>
</div>
<script id="__config" type="application/json">{"annotate": null, "base": "../../..", "features": [], "search": "../../../assets/javascripts/workers/search.2c215733.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script>
2026-04-16 22:38:20 +02:00
<script src="../../../assets/javascripts/bundle.79ae519e.min.js"></script>
2026-04-16 22:38:20 +02:00
<script src="https://unpkg.com/mathjax@3/es5/tex-mml-chtml.js"></script>
</body>
</html>