pycorpdiff 0.1.0a3__tar.gz → 0.1.0a5__tar.gz

{pycorpdiff-0.1.0a3 → pycorpdiff-0.1.0a5}/.gitignore

@@ -30,12 +30,12 @@ Thumbs.db
 *.swo
 *~
 
-# AI workflow artefacts (kept local, never published)
-.claude/
-
 # Hypothesis example database (auto-managed)
 .hypothesis/
 
+# Local tooling
+.claude/
+
 # Jupyter checkpoints
 .ipynb_checkpoints/
 
@@ -56,5 +56,5 @@ examples/*.patched.ipynb
 # Stray uv lockfiles created outside the repo root
 **/uv.lock.tmp
 
-# Mkdocs build output (legacy; mkdocs.yml itself is gone)
+# Static site build output
 site/

{pycorpdiff-0.1.0a3 → pycorpdiff-0.1.0a5}/CHANGELOG.md

@@ -4,13 +4,13 @@ All notable changes to `pycorpdiff` are documented in this file. The format
 follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this
 project adheres to [Semantic Versioning](https://semver.org/).
 
-## [0.1.0a3] — initial release
+## [0.1.0a5] — initial release
 
 The initial public release of `pycorpdiff` — comparative corpus analysis
 for modern Python workflows. Three public verbs (`compare`, `track`,
-`compare.before_after`), nine `Result` dataclasses with a uniform
-six-method contract (`.to_df / .plot / .explain / .summary / .to_html /
-.to_json`), two `typing.Protocol` extension points (`Tokenizer`,
+`compare.before_after`), nine `Result` dataclasses each implementing the
+relevant subset of `.to_df / .plot / .explain / .summary / .to_html /
+.to_json`, two `typing.Protocol` extension points (`Tokenizer`,
 `Embedder`), and opt-in extras for visualisation, semantic embedding,
 temporal modelling, polars interop, DuckDB ingestion, and 🤗 Datasets.
 
@@ -33,12 +33,12 @@ temporal modelling, polars interop, DuckDB ingestion, and 🤗 Datasets.
 
 ### Cross-validated
 
-Numerically agrees with Rayson's LL Wizard (15 reference triples),
-NLTK's `BigramAssocMeasures` (≤ 1e-12 on PMI / t-score / MI³),
+Numerically agrees with Rayson's LL Wizard on hand-derived reference
+triples, NLTK's `BigramAssocMeasures` (≤ 1e-12 on PMI / t-score / MI³),
 Scattertext on the 2012 US conventions, `quanteda` via `rpy2`, and
 the HistWords COHA replication.
 
 ### Infrastructure
 
-519 tests, `ruff` + `mypy --strict` clean across 55 source files,
-matrix CI on three Python versions × two operating systems.
+Hundreds of tests, `ruff` + `mypy --strict` clean across the source
+tree, matrix CI on three Python versions × two operating systems.

{pycorpdiff-0.1.0a3 → pycorpdiff-0.1.0a5}/CITATION.cff

@@ -4,8 +4,8 @@ message: >
   entry. GitHub renders a "Cite this repository" widget directly from
   this file.
 title: "pycorpdiff: Comparative Corpus Analysis for Modern Python Workflows"
-version: 0.1.0a3
-date-released: 2026-05-22
+version: 0.1.0a5
+date-released: 2026-05-25
 authors:
   - family-names: Turner
     given-names: Jason

{pycorpdiff-0.1.0a3 → pycorpdiff-0.1.0a5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pycorpdiff
-Version: 0.1.0a3
+Version: 0.1.0a5
 Summary: Comparative corpus analysis for Python: keyness, collocations, semantic shift, temporal trajectories with changepoints + causal inference.
 Project-URL: Homepage, https://github.com/jturner-uofl/pycorpdiff
 Project-URL: Documentation, https://github.com/jturner-uofl/pycorpdiff
@@ -49,6 +49,7 @@ Provides-Extra: all
 Requires-Dist: altair>=5; extra == 'all'
 Requires-Dist: datasets>=2.14; extra == 'all'
 Requires-Dist: duckdb>=0.10; extra == 'all'
+Requires-Dist: jupyter>=1.0; extra == 'all'
 Requires-Dist: matplotlib>=3.8; extra == 'all'
 Requires-Dist: networkx>=3.1; extra == 'all'
 Requires-Dist: polars>=1.0; extra == 'all'
@@ -110,9 +111,9 @@ platform, and the fragmented Python NLP stack
 consolidate keyness, collocations, dispersion, temporal trajectories,
 changepoint detection, interrupted time series, causal-impact analysis,
 forecasting, online changepoint detection, and embedding-based semantic
-shift under a single notebook-native API. Every result carries its own
-KWIC evidence: `.explain(term)` returns the source-text concordances
-behind any ranked term.
+shift under a single notebook-native API. Keyness and collocation
+results carry their own KWIC evidence: `.explain(term)` returns the
+source-text concordances behind any ranked term.
 
 The package answers the questions corpus linguistics, digital humanities,
 and computational social science routinely have:
@@ -130,7 +131,7 @@ points — one-line adapters, no plugin registry. The base install pulls
 only `numpy`, `pandas`, `scipy`, and `pyarrow`; everything else is opt-in
 via extras.
 
-> **Status: alpha (0.1.0a3).** Public API is stable for the features
+> **Status: alpha (0.1.0a5).** Public API is stable for the features
 > described below; on PyPI as `pip install pycorpdiff`.
 
 ## The three-layer architecture
@@ -139,7 +140,7 @@ via extras.
 |---|---|---|
 | **1 — Ingestion + `Corpus`** | get text in, slice it, hash it | `from_dataframe`, `read_csv`, `read_parquet`, `read_txt`, `read_duckdb`, `from_huggingface`, `fetch_hansard`, `Corpus.slice/by_time/__hash__/doc_term_counts(_sparse)/to_polars` |
 | **2 — Pure math** | statistics with no I/O | `keyness.{log_likelihood,chi_squared,log_ratio,percent_diff,bayes_factor,permutation_pvalues,keyness_multi,juilland_d,benjamini_hochberg}`; `collocation.{logdice,pmi,t_score,mi_three,collocation_shift,cooccurrence_network}`; `semantic.{HashEmbedder,SBERTEmbedder,semantic_trajectory,neighborhood_drift}`; `temporal.{changepoints,interrupted_time_series,forecast,causal_impact,bocpd}` |
-| **3 — Verbs + Results** | public API | `compare`, `track`, `compare.before_after`, `keyness_multi`, plus 9 frozen-dataclass Result types each with `.to_df() / .plot() / .explain() / .summary() / .to_html() / .to_json()` |
+| **3 — Verbs + Results** | public API | `compare`, `track`, `compare.before_after`, `keyness_multi`, plus 9 frozen-dataclass Result types each implementing the relevant subset of `.to_df() / .plot() / .explain() / .summary() / .to_html() / .to_json()` |
 
 ## Quick start
 
@@ -150,7 +151,7 @@ pip install "pycorpdiff[viz]"
 ```python
 import pycorpdiff as pcd
 
-# Bundled UK-Hansard sample — runs offline, no data download.
+# Bundled synthetic Hansard-style sample — runs offline, no data download.
 corpus = pcd.load_hansard_sample()
 immigration = corpus.slice(topic="immigration")
 
@@ -170,19 +171,21 @@ compare two slices, plot the result. Every other analytical method —
 collocation shifts, semantic drift, temporal trajectories, changepoint
 detection, causal-impact analysis, forecasting, co-occurrence networks,
 N-way keyness — follows the same shape. See
-[the showcase notebook](docs/rendered/pycorpdiff_showcase.html) for the
-full feature tour, or the cheat sheet below for one-line API previews.
+[the showcase notebook](https://github.com/jturner-uofl/pycorpdiff/blob/main/examples/pycorpdiff_showcase.ipynb)
+for the full feature tour, or the cheat sheet below for one-line API previews.
 
 ### Cheat sheet — every analytical surface in one block
 
 ```python
-# Compare verbs (returns Result objects with .plot / .to_df / .explain / .summary)
+# Compare verbs (returns Result objects; methods exposed vary by Result)
 pcd.compare(a, b).keyness()
-pcd.compare(a, b).collocation_shift("migrant")
-pcd.compare(a, b).semantic_shift("migrant", embedder=pcd.SBERTEmbedder())   # [semantic]
+pcd.compare(a, b).collocation_shift("immigrant")
+pcd.compare(a, b).semantic_shift("immigrant", embedder=pcd.SBERTEmbedder())   # [semantic]
+# SBERTEmbedder downloads a sentence-transformers model on first call;
+# use pcd.HashEmbedder() for offline / deterministic-test settings.
 
 # Track over time (requires [temporal] for the changepoint + ITS + forecast + causal_impact methods)
-tr = pcd.track(corpus, "migrant").over_time(freq="Y")
+tr = pcd.track(corpus, "immigrant").over_time(freq="Y")
 tr.changepoints()                                  # offline PELT
 tr.changepoints_online(hazard=1/24)                # Bayesian online (Adams & MacKay 2007)
 tr.interrupted_time_series(event_date="2016")      # segmented OLS
@@ -199,10 +202,9 @@ pcd.keyness_multi([a, b, c, d], labels=["A", "B", "C", "D"])
 pcd.cooccurrence_network(corpus, top_n=30).plot()
 ```
 
-See [`examples/pycorpdiff_showcase.ipynb`](examples/pycorpdiff_showcase.ipynb)
-([rendered HTML](docs/rendered/pycorpdiff_showcase.html)) for a
-walkthrough on a synthetic UK Hansard corpus exercising every analytical
-surface.
+See [`examples/pycorpdiff_showcase.ipynb`](https://github.com/jturner-uofl/pycorpdiff/blob/main/examples/pycorpdiff_showcase.ipynb)
+for a walkthrough on the synthetic Hansard-style corpus exercising
+every analytical surface.
 
 ## Installation
 
@@ -232,7 +234,7 @@ pytest -q
 
 The math agrees with the standard tools — by automated test:
 
-- **Rayson's LL Wizard** — 15 hand-derived contingency-table reference triples
+- **Rayson's LL Wizard** — hand-derived contingency-table reference triples
 - **NLTK** `BigramAssocMeasures` — PMI + t-score to ≤ 1e-12 on every adjacent bigram
 - **Scattertext (Kessler 2017)** — behavioural agreement on the 2012 US Conventions corpus
 - **quanteda (R)** via `rpy2` — byte-for-byte G² agreement (slow tier)
@@ -246,11 +248,11 @@ repository" widget directly from it.
 
 ## License
 
-MIT — see [LICENSE](LICENSE).
+MIT — see [LICENSE](https://github.com/jturner-uofl/pycorpdiff/blob/main/LICENSE).
 
 ## Further reading
 
-- [`docs/design.md`](docs/design.md) — three-layer architecture
-- [`docs/statistical-methods.md`](docs/statistical-methods.md) — every metric's formula + citation
-- [`examples/pycorpdiff_showcase.ipynb`](examples/pycorpdiff_showcase.ipynb) — full feature tour as a notebook
-- [`docs/rendered/`](docs/rendered/) — self-contained HTML renders of the example notebooks
+- [`docs/design.md`](https://github.com/jturner-uofl/pycorpdiff/blob/main/docs/design.md) — three-layer architecture
+- [`docs/statistical-methods.md`](https://github.com/jturner-uofl/pycorpdiff/blob/main/docs/statistical-methods.md) — every metric's formula + citation
+- [`examples/pycorpdiff_showcase.ipynb`](https://github.com/jturner-uofl/pycorpdiff/blob/main/examples/pycorpdiff_showcase.ipynb) — full feature tour as a notebook
+- [`docs/rendered/`](https://github.com/jturner-uofl/pycorpdiff/tree/main/docs/rendered) — static HTML renders for offline viewing

{pycorpdiff-0.1.0a3 → pycorpdiff-0.1.0a5}/README.md

@@ -15,9 +15,9 @@ platform, and the fragmented Python NLP stack
 consolidate keyness, collocations, dispersion, temporal trajectories,
 changepoint detection, interrupted time series, causal-impact analysis,
 forecasting, online changepoint detection, and embedding-based semantic
-shift under a single notebook-native API. Every result carries its own
-KWIC evidence: `.explain(term)` returns the source-text concordances
-behind any ranked term.
+shift under a single notebook-native API. Keyness and collocation
+results carry their own KWIC evidence: `.explain(term)` returns the
+source-text concordances behind any ranked term.
 
 The package answers the questions corpus linguistics, digital humanities,
 and computational social science routinely have:
@@ -35,7 +35,7 @@ points — one-line adapters, no plugin registry. The base install pulls
 only `numpy`, `pandas`, `scipy`, and `pyarrow`; everything else is opt-in
 via extras.
 
-> **Status: alpha (0.1.0a3).** Public API is stable for the features
+> **Status: alpha (0.1.0a5).** Public API is stable for the features
 > described below; on PyPI as `pip install pycorpdiff`.
 
 ## The three-layer architecture
@@ -44,7 +44,7 @@ via extras.
 |---|---|---|
 | **1 — Ingestion + `Corpus`** | get text in, slice it, hash it | `from_dataframe`, `read_csv`, `read_parquet`, `read_txt`, `read_duckdb`, `from_huggingface`, `fetch_hansard`, `Corpus.slice/by_time/__hash__/doc_term_counts(_sparse)/to_polars` |
 | **2 — Pure math** | statistics with no I/O | `keyness.{log_likelihood,chi_squared,log_ratio,percent_diff,bayes_factor,permutation_pvalues,keyness_multi,juilland_d,benjamini_hochberg}`; `collocation.{logdice,pmi,t_score,mi_three,collocation_shift,cooccurrence_network}`; `semantic.{HashEmbedder,SBERTEmbedder,semantic_trajectory,neighborhood_drift}`; `temporal.{changepoints,interrupted_time_series,forecast,causal_impact,bocpd}` |
-| **3 — Verbs + Results** | public API | `compare`, `track`, `compare.before_after`, `keyness_multi`, plus 9 frozen-dataclass Result types each with `.to_df() / .plot() / .explain() / .summary() / .to_html() / .to_json()` |
+| **3 — Verbs + Results** | public API | `compare`, `track`, `compare.before_after`, `keyness_multi`, plus 9 frozen-dataclass Result types each implementing the relevant subset of `.to_df() / .plot() / .explain() / .summary() / .to_html() / .to_json()` |
 
 ## Quick start
 
@@ -55,7 +55,7 @@ pip install "pycorpdiff[viz]"
 ```python
 import pycorpdiff as pcd
 
-# Bundled UK-Hansard sample — runs offline, no data download.
+# Bundled synthetic Hansard-style sample — runs offline, no data download.
 corpus = pcd.load_hansard_sample()
 immigration = corpus.slice(topic="immigration")
 
@@ -75,19 +75,21 @@ compare two slices, plot the result. Every other analytical method —
 collocation shifts, semantic drift, temporal trajectories, changepoint
 detection, causal-impact analysis, forecasting, co-occurrence networks,
 N-way keyness — follows the same shape. See
-[the showcase notebook](docs/rendered/pycorpdiff_showcase.html) for the
-full feature tour, or the cheat sheet below for one-line API previews.
+[the showcase notebook](https://github.com/jturner-uofl/pycorpdiff/blob/main/examples/pycorpdiff_showcase.ipynb)
+for the full feature tour, or the cheat sheet below for one-line API previews.
 
 ### Cheat sheet — every analytical surface in one block
 
 ```python
-# Compare verbs (returns Result objects with .plot / .to_df / .explain / .summary)
+# Compare verbs (returns Result objects; methods exposed vary by Result)
 pcd.compare(a, b).keyness()
-pcd.compare(a, b).collocation_shift("migrant")
-pcd.compare(a, b).semantic_shift("migrant", embedder=pcd.SBERTEmbedder())   # [semantic]
+pcd.compare(a, b).collocation_shift("immigrant")
+pcd.compare(a, b).semantic_shift("immigrant", embedder=pcd.SBERTEmbedder())   # [semantic]
+# SBERTEmbedder downloads a sentence-transformers model on first call;
+# use pcd.HashEmbedder() for offline / deterministic-test settings.
 
 # Track over time (requires [temporal] for the changepoint + ITS + forecast + causal_impact methods)
-tr = pcd.track(corpus, "migrant").over_time(freq="Y")
+tr = pcd.track(corpus, "immigrant").over_time(freq="Y")
 tr.changepoints()                                  # offline PELT
 tr.changepoints_online(hazard=1/24)                # Bayesian online (Adams & MacKay 2007)
 tr.interrupted_time_series(event_date="2016")      # segmented OLS
@@ -104,10 +106,9 @@ pcd.keyness_multi([a, b, c, d], labels=["A", "B", "C", "D"])
 pcd.cooccurrence_network(corpus, top_n=30).plot()
 ```
 
-See [`examples/pycorpdiff_showcase.ipynb`](examples/pycorpdiff_showcase.ipynb)
-([rendered HTML](docs/rendered/pycorpdiff_showcase.html)) for a
-walkthrough on a synthetic UK Hansard corpus exercising every analytical
-surface.
+See [`examples/pycorpdiff_showcase.ipynb`](https://github.com/jturner-uofl/pycorpdiff/blob/main/examples/pycorpdiff_showcase.ipynb)
+for a walkthrough on the synthetic Hansard-style corpus exercising
+every analytical surface.
 
 ## Installation
 
@@ -137,7 +138,7 @@ pytest -q
 
 The math agrees with the standard tools — by automated test:
 
-- **Rayson's LL Wizard** — 15 hand-derived contingency-table reference triples
+- **Rayson's LL Wizard** — hand-derived contingency-table reference triples
 - **NLTK** `BigramAssocMeasures` — PMI + t-score to ≤ 1e-12 on every adjacent bigram
 - **Scattertext (Kessler 2017)** — behavioural agreement on the 2012 US Conventions corpus
 - **quanteda (R)** via `rpy2` — byte-for-byte G² agreement (slow tier)
@@ -151,11 +152,11 @@ repository" widget directly from it.
 
 ## License
 
-MIT — see [LICENSE](LICENSE).
+MIT — see [LICENSE](https://github.com/jturner-uofl/pycorpdiff/blob/main/LICENSE).
 
 ## Further reading
 
-- [`docs/design.md`](docs/design.md) — three-layer architecture
-- [`docs/statistical-methods.md`](docs/statistical-methods.md) — every metric's formula + citation
-- [`examples/pycorpdiff_showcase.ipynb`](examples/pycorpdiff_showcase.ipynb) — full feature tour as a notebook
-- [`docs/rendered/`](docs/rendered/) — self-contained HTML renders of the example notebooks
+- [`docs/design.md`](https://github.com/jturner-uofl/pycorpdiff/blob/main/docs/design.md) — three-layer architecture
+- [`docs/statistical-methods.md`](https://github.com/jturner-uofl/pycorpdiff/blob/main/docs/statistical-methods.md) — every metric's formula + citation
+- [`examples/pycorpdiff_showcase.ipynb`](https://github.com/jturner-uofl/pycorpdiff/blob/main/examples/pycorpdiff_showcase.ipynb) — full feature tour as a notebook
+- [`docs/rendered/`](https://github.com/jturner-uofl/pycorpdiff/tree/main/docs/rendered) — static HTML renders for offline viewing

{pycorpdiff-0.1.0a3 → pycorpdiff-0.1.0a5}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "pycorpdiff"
-version = "0.1.0a3"
+version = "0.1.0a5"
 description = "Comparative corpus analysis for Python: keyness, collocations, semantic shift, temporal trajectories with changepoints + causal inference."
 readme = "README.md"
 license = { file = "LICENSE" }
@@ -45,7 +45,7 @@ dependencies = [
 ]
 
 [project.optional-dependencies]
-# Visualisation: altair-first, matplotlib retained for paper-grade figures.
+# Visualisation: altair-first, matplotlib retained for publication-quality figures.
 viz = ["altair>=5", "matplotlib>=3.8", "networkx>=3.1"]
 # Embedding-based semantic shift. sentence-transformers pulls torch
 # transitively, which is why this is opt-in rather than a base dep.
@@ -67,7 +67,8 @@ huggingface = ["datasets>=2.14"]
 # static SVG/PNG export of altair charts, `pysofra` renders the showcase's
 # result tables in JAMA-style typography.
 notebooks = ["jupyter>=1.0", "vl-convert-python>=1.5", "pysofra>=0.1.0a3"]
-# Meta-extra so `pycorpdiff[all]` exercises every optional code path.
+# Meta-extra: `pycorpdiff[all]` pulls in every optional code path
+# including the notebook runtime.
 all = [
     "altair>=5",
     "matplotlib>=3.8",
@@ -81,6 +82,7 @@ all = [
     "pyarrow>=15",
     "duckdb>=0.10",
     "spacy>=3.7",
+    "jupyter>=1.0",
     "vl-convert-python>=1.5",
     "pysofra>=0.1.0a3",
 ]

{pycorpdiff-0.1.0a3 → pycorpdiff-0.1.0a5}/src/pycorpdiff/__init__.py

@@ -14,12 +14,12 @@ Example
 
 >>> import pycorpdiff as pcd
 >>> pcd.__version__
-'0.1.0a3'
+'0.1.0a5'
 """
 
 from __future__ import annotations
 
-__version__ = "0.1.0a3"
+__version__ = "0.1.0a5"
 
 from .collocation.network import NetworkResult, cooccurrence_network
 from .compare import Comparison, compare

{pycorpdiff-0.1.0a3 → pycorpdiff-0.1.0a5}/src/pycorpdiff/collocation/network.py

@@ -16,12 +16,14 @@ from __future__ import annotations
 from collections import Counter
 from collections.abc import Sequence
 from dataclasses import dataclass, field
-from typing import TYPE_CHECKING, Literal
+from pathlib import Path
+from typing import TYPE_CHECKING, Any, Literal
 
 import numpy as np
 import pandas as pd
 
 from ..corpus import Corpus, CorpusSlice
+from ..results import _table_to_html, _table_to_json
 from .measures import logdice, mi_three, pmi, t_score
 
 if TYPE_CHECKING:
@@ -54,6 +56,17 @@ class NetworkResult:
         """Return the edges as a flat tidy DataFrame (for round-trips)."""
         return self.edges.copy()
 
+    def to_html(self, path: str | Path | None = None, **kw: Any) -> str:
+        """Render the edge table as HTML (returns the string and,
+        optionally, writes to ``path``). Extra kwargs forward to
+        :meth:`pandas.DataFrame.to_html`."""
+        return _table_to_html(self.edges, path, **kw)
+
+    def to_json(self, path: str | Path | None = None, **kw: Any) -> str:
+        """Render the edge table as JSON (default ``orient="records"``).
+        Returns the JSON string and, optionally, writes to ``path``."""
+        return _table_to_json(self.edges, path, **kw)
+
     def summary(self) -> str:
         return (
             f"NetworkResult(measure={self.measure}, window={self.window}, "

{pycorpdiff-0.1.0a3 → pycorpdiff-0.1.0a5}/src/pycorpdiff/compare.py

@@ -66,7 +66,7 @@ class Comparison:
             require ``effect_size=True`` and sort by that column.
         effect_size
             If True (default), also compute LogRatio (Hardie),
-            %DIFF (Gabrielatos), and the BIC-Bayes factor (Wilson).
+            %DIFF (Gabrielatos), and the BIC-approximated Bayes factor.
         dispersion
             If True, compute Juilland's D for both corpora and flag
             terms where ``D < 0.5`` in either — the canonical "this is

{pycorpdiff-0.1.0a3 → pycorpdiff-0.1.0a5}/src/pycorpdiff/datasets/__init__.py

@@ -3,7 +3,7 @@
 What ships with the package
 ---------------------------
 
-- :func:`load_hansard_sample` — a 200-speech synthetic corpus designed
+- :func:`load_hansard_sample` — a 193-speech synthetic corpus designed
   to mimic UK Hansard's structure across two decades, four topics, and
   four parties, with topical language shifts around real-world events
   (Brexit referendum, COVID-19, the climate-emergency declarations).

{pycorpdiff-0.1.0a3 → pycorpdiff-0.1.0a5}/src/pycorpdiff/datasets/_generate_hansard.py

@@ -172,7 +172,7 @@ TOPICS = ["immigration", "brexit", "nhs", "climate"]
 
 
 def generate(seed: int = 20260522) -> pd.DataFrame:
-    """Return a deterministic 200-speech synthetic Hansard sample."""
+    """Return a deterministic 193-speech synthetic Hansard sample."""
     rng = np.random.default_rng(seed)
     rows: list[dict[str, object]] = []
     speech_id = 0

{pycorpdiff-0.1.0a3 → pycorpdiff-0.1.0a5}/src/pycorpdiff/keyness/bayes.py

@@ -26,9 +26,10 @@ def bayes_factor(
 ) -> pd.Series:
     """BIC-approximated Bayes factor for each term's frequency difference.
 
-    Uses Wilson's BIC approximation: ``BIC = |G²| - ln(N)`` where ``N``
-    is the total tokens across both corpora and ``G²`` is the unsigned
-    log-likelihood. The Bayes factor is then ``exp(BIC / 2)``.
+    The BIC approximation (Kass & Raftery 1995): ``BIC = |G²| - ln(N)``
+    where ``N`` is the total tokens across both corpora and ``G²`` is
+    the unsigned log-likelihood. The Bayes factor is then
+    ``exp(BIC / 2)``. Wilson (2013) is the keyness application.
 
     Interpret with Kass & Raftery (1995):
 

{pycorpdiff-0.1.0a3 → pycorpdiff-0.1.0a5}/src/pycorpdiff/viz/__init__.py

@@ -1,4 +1,4 @@
-"""Visualisation helpers — altair-first, matplotlib for paper-grade figures.
+"""Visualisation helpers — altair-first, matplotlib for publication-quality figures.
 
 Every Result type's ``.plot()`` method delegates here. Plot functions
 also accept a bare DataFrame so users can call

{pycorpdiff-0.1.0a3 → pycorpdiff-0.1.0a5}/tests/integration/test_crossval_rayson.py

@@ -6,8 +6,10 @@ single-cell keyness computation in corpus linguistics. Every value
 asserted below was either computed from Rayson's exact formula or
 copy-pasted from his calculator on a clean dataset.
 
-This file extends ``test_loglikelihood.py`` with the broader sweep
-called for by the audit's #15 item (cross-validation receipts).
+This file extends ``test_loglikelihood.py`` with a broader sweep of
+canonical reference triples covering edge cases (lopsided counts,
+sparse cells, mid-sized over-representation) so that any future
+refactor of the LL formula trips multiple assertions simultaneously.
 """
 
 from __future__ import annotations