0.1.1 — PNG logo + presidential-speech allotaxonograph gallery

CHANGELOG.md

@@ -4,7 +4,16 @@ All notable changes to this project are documented here. The format follows
 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and the project adheres
 to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [Unreleased]
+## [0.1.1] - 2026-07-01
+
+### Added
+
+- Presidential-speech allotaxonograph gallery: `examples/presidential_speeches.py`
+  (+ executed notebook and saved figures under `examples/gallery/`) comparing
+  U.S. presidential speech vocabulary across eras, with a matching docs page.
+- PNG logo (`imgs/logo.png`) so the README logo renders on PyPI.
+
+## [0.1.0] - 2026-06-30
 
 ### Added
 

README.md

@@ -1,5 +1,5 @@
 <p align="center">
-  <img src="https://raw.githubusercontent.com/crow-intelligence/keyflux/main/imgs/logo.svg" alt="keyflux logo" width="440">
+  <img src="https://raw.githubusercontent.com/crow-intelligence/keyflux/main/imgs/logo.png" alt="keyflux logo" width="440">
 </p>
 
 # keyflux

docs/examples/presidential_speeches.md

@@ -0,0 +1,66 @@
+# Presidential speech across eras
+
+A worked gallery: comparing the vocabulary of U.S. presidential speeches across
+25-year eras with keyness, rank-turbulence divergence, and the allotaxonograph.
+
+The data are compact frequency tables under `examples/data/`, built from the
+public-domain [Miller Center](https://data.millercenter.org/) presidential speech
+corpus (lemmatised, lowercased, punctuation stripped) bundled with
+[chronowords](https://github.com/crow-intelligence/chronowords), loaded with
+`keyflux.load_counts`. A light filter drops clitic fragments and transcription
+markers; genuine function words stay in (they populate the lockword diagonal).
+
+The full, executed notebook — with every figure inline — is at
+[`examples/presidential_speeches.ipynb`](https://github.com/crow-intelligence/keyflux/blob/main/examples/presidential_speeches.ipynb).
+
+## 1. The nineteenth century vs. the twenty-first
+
+The starkest shift: formal 19th-century governmental prose against modern
+televised address. Positive keywords for **2000–2024**: *job, help, today,
+tonight, worker, terrorist, afghanistan, billion*. For **1825–1849**:
+*appropriation, intercourse, specie, heretofore, receipt, treasury*. The
+contribution panel reads first-person modern (*we, get, help, thank, americans*)
+against formal 19th-century register (*which, upon, shall, duty, treaty*).
+
+![1825–1849 vs 2000–2024](https://raw.githubusercontent.com/crow-intelligence/keyflux/main/examples/gallery/era_2000-2024_vs_1825-1849.png)
+
+## 2. The Progressive era vs. the Cold War
+
+**1950–1974** keywords: *vietnam, soviet, kennedy, communist, nuclear, nixon*.
+**1900–1924** keywords: *railway, isthmus, philippine, hague, reclamation,
+banking* — the vocabulary of the Panama Canal, imperial expansion, and early
+regulation.
+
+![1900–1924 vs 1950–1974](https://raw.githubusercontent.com/crow-intelligence/keyflux/main/examples/gallery/era_1950-1974_vs_1900-1924.png)
+
+## 3. The Cold War vs. the modern era
+
+A more recent, subtler shift. **2000–2024**: *afghanistan, iraqi, qaeda, virus,
+ukraine, biden*. **1950–1974**: *viet, nam, communists, khrushchev, watergate,
+laos, mcnamara*.
+
+![1950–1974 vs 2000–2024](https://raw.githubusercontent.com/crow-intelligence/keyflux/main/examples/gallery/era_2000-2024_vs_1950-1974.png)
+
+## How alpha reframes the map
+
+`alpha` tunes what the divergence emphasises — small `alpha` surfaces churn among
+rare, low-rank words; large `alpha` surfaces shifts among common, high-rank words.
+The 19thC↔21stC pair at three settings (divergence rises from 0.39 to 0.54):
+
+**alpha = 0** (logarithmic limit — rare, low-rank churn)
+
+![alpha 0](https://raw.githubusercontent.com/crow-intelligence/keyflux/main/examples/gallery/alpha_sweep_0.png)
+
+**alpha = 1/3** (the text default)
+
+![alpha 1/3](https://raw.githubusercontent.com/crow-intelligence/keyflux/main/examples/gallery/alpha_sweep_0.33.png)
+
+**alpha = 1** (emphasises common, high-rank words)
+
+![alpha 1](https://raw.githubusercontent.com/crow-intelligence/keyflux/main/examples/gallery/alpha_sweep_1.png)
+
+## The script
+
+```python title="examples/presidential_speeches.py"
+--8<-- "examples/presidential_speeches.py"
+```