lme-python 0.1.3__tar.gz → 0.1.4__tar.gz

{lme_python-0.1.3 → lme_python-0.1.4}/.github/workflows/benchmarks.yml

@@ -17,6 +17,8 @@ on:
 
 permissions:
   contents: write
+  pages: write
+  id-token: write
 
 env:
   CARGO_TERM_COLOR: always
@@ -169,3 +171,64 @@ jobs:
         run: |
           echo "Cross-language benchmark script failed with exit code ${{ steps.cross_language_run.outputs.status }}." >&2
           exit 1
+
+  pages:
+    name: Publish Benchmark Dashboard
+    runs-on: ubuntu-latest
+    needs:
+      - criterion
+      - cross-language
+    if: needs.criterion.result == 'success' && needs.cross-language.result == 'success' && (github.ref == 'refs/heads/master' || startsWith(github.ref, 'refs/tags/'))
+    environment:
+      name: github-pages
+      url: ${{ steps.deploy.outputs.page_url }}
+    steps:
+      - uses: actions/checkout@v6
+
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.11"
+
+      - name: Download cross-language artifact
+        uses: actions/download-artifact@v5
+        with:
+          name: cross-language-${{ github.sha }}
+          path: site-input
+
+      - name: Resolve release URL
+        id: release_url
+        run: |
+          if [[ "${GITHUB_REF}" == refs/tags/* ]]; then
+            echo "value=${GITHUB_SERVER_URL}/${GITHUB_REPOSITORY}/releases/tag/${GITHUB_REF_NAME}" >> "$GITHUB_OUTPUT"
+          else
+            echo "value=" >> "$GITHUB_OUTPUT"
+          fi
+
+      - name: Build benchmark dashboard
+        run: |
+          set -euo pipefail
+          mkdir -p site
+          cp -R docs/. site/
+          mkdir -p site/benchmarks/data
+          cross_json="$(find site-input -name 'cross-language-*.json' -print -quit)"
+          python scripts/build_benchmark_site.py \
+            --cross-language-json "$cross_json" \
+            --output-dir "site/benchmarks/data" \
+            --run-url "${GITHUB_SERVER_URL}/${GITHUB_REPOSITORY}/actions/runs/${GITHUB_RUN_ID}" \
+            --release-url "${{ steps.release_url.outputs.value }}" \
+            --criterion-asset-name "criterion-${GITHUB_SHA}.tar.gz" \
+            --cross-language-asset-name "cross-language-${GITHUB_SHA}.json" \
+            --ref-name "${GITHUB_REF_NAME}"
+
+      - uses: actions/configure-pages@v5
+        with:
+          token: ${{ secrets.REPO_ADMIN_TOKEN != '' && secrets.REPO_ADMIN_TOKEN || github.token }}
+          enablement: ${{ secrets.REPO_ADMIN_TOKEN != '' }}
+
+      - uses: actions/upload-pages-artifact@v3
+        with:
+          path: site
+
+      - name: Deploy to GitHub Pages
+        id: deploy
+        uses: actions/deploy-pages@v4

{lme_python-0.1.3 → lme_python-0.1.4}/.gitignore

@@ -6,6 +6,8 @@ julia-portable.zip
 flamegraph.svg
 artifacts/
 benchmark-results/
+benchmark-site/
+site/
 
 # Python bindings
 python/target/

{lme_python-0.1.3 → lme_python-0.1.4}/BENCHMARKS.md

@@ -82,7 +82,7 @@ Recommended rules:
 - note when optimizers are not directly comparable across ecosystems
 - keep output artifacts or raw logs so later releases can be compared to the same baseline
 
-For this repo, the most defensible cross-language benchmark set would start with the same reference datasets already used in `examples/COMPARISONS.md`:
+For this repo, the most defensible cross-language benchmark set would start with the same reference datasets already used in `comparisons/COMPARISONS.md`:
 
 - `sleepstudy`
 - `dyestuff`
@@ -122,6 +122,34 @@ The repository also includes a dedicated workflow in [.github/workflows/benchmar
 - runs the cross-language benchmark script
 - uploads the resulting artifacts in CI
 - attaches them to GitHub Releases on tag pushes
+- publishes the latest benchmark dashboard to GitHub Pages at `https://x4g4p3x.github.io/lme-rs/benchmarks/`
+
+## Latest published results
+
+The latest published benchmark artifacts are attached to the [v0.1.3 release](https://github.com/x4g4p3x/lme-rs/releases/tag/v0.1.3).
+
+That release currently includes:
+
+- `criterion-e8a82e0b97b88c5549bc61e89c22dc12c9060a02.tar.gz`
+- `cross-language-e8a82e0b97b88c5549bc61e89c22dc12c9060a02.json`
+
+The cross-language JSON includes representative timings for:
+
+- `sleepstudy`
+- `pastes`
+- `cbpp`
+- `grouseticks`
+
+across:
+
+- Rust
+- Python
+- R
+- Julia
+
+Treat those numbers as versioned release artifacts, not as universal constants. They were produced on GitHub-hosted runners with the workflow's pinned toolchain setup, so they are useful for release-to-release comparison and public transparency, but not as machine-independent proof of absolute speed.
+
+If you want to cite benchmark results in release notes or external docs, prefer linking the release asset directly instead of copying raw numbers into the README. That keeps the landing page stable while still making the measured outputs inspectable.
 
 ## How to interpret results
 

{lme_python-0.1.3 → lme_python-0.1.4}/CHANGELOG.md

@@ -5,6 +5,18 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.1.4] - 2026-03-22
+
+### Added
+
+- Formula-string entry point `lm()` and corresponding Python binding for fitting ordinary least squares models using DataFrames.
+- New Python examples directory `python/examples` with five runnable demonstration scripts mapping to common mixed-modeling workflows.
+
+### Changed
+
+- Renamed `examples/` directory to `comparisons/` to clarify that it contains cross-language parity scripts, updating all build and documentation references accordingly.
+- Promoted Kenward-Roger degrees of freedom from "provisional" status after validating numerical parity (within 0.01 df) against R's `pbkrtest`.
+
 ## [0.1.3] - 2026-03-12
 
 ### Added

{lme_python-0.1.3 → lme_python-0.1.4}/CONTRIBUTING.md

@@ -6,7 +6,7 @@ This repository contains:
 
 - the Rust crate in the repository root
 - the Python bindings in `python/`
-- cross-language comparison examples in `examples/`
+- cross-language comparison scripts in `comparisons/`
 - regression fixtures and integration tests in `tests/`
 
 ## Local setup
@@ -50,7 +50,7 @@ If you change fitting logic, optimizer behavior, variance calculations, or infer
 
 - add or update Rust tests in `tests/`
 - prefer fixture-backed tests for parity-sensitive behavior
-- update `examples/COMPARISONS.md` when the reference output changes materially
+- update `comparisons/COMPARISONS.md` when the reference output changes materially
 - validate hard cases against R `lme4` where practical
 
 Relevant files and directories:
@@ -58,7 +58,7 @@ Relevant files and directories:
 - `src/` for the crate implementation
 - `tests/data/` for fixture inputs
 - `tests/generate_test_data.R` for R-backed fixture generation
-- `examples/` for end-to-end language comparisons
+- `comparisons/` for cross-language parity scripts (R, Python/statsmodels, Julia)
 
 ## Working on documentation
 

{lme_python-0.1.3 → lme_python-0.1.4}/Cargo.lock

@@ -1528,7 +1528,7 @@ checksum = "11d3d7f243d5c5a8b9bb5d6dd2b1602c0cb0b9db1621bafc7ed66e35ff9fe092"
 
 [[package]]
 name = "lme-rs"
-version = "0.1.3"
+version = "0.1.4"
 dependencies = [
  "anyhow",
  "argmin",

{lme_python-0.1.3 → lme_python-0.1.4}/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "lme-rs"
-version = "0.1.3"
+version = "0.1.4"
 edition = "2021"
 authors = ["Martin Huck <x4g4p3x@users.noreply.github.com>"]
 description = "Rust port of R's lme4: linear mixed-effects models with 1:1 numerical compatibility"
@@ -40,6 +40,34 @@ debug = true
 name = "bench_math"
 harness = false
 
+[[example]]
+name = "glmm_cbpp"
+path = "comparisons/glmm_cbpp.rs"
+
+[[example]]
+name = "glmm_grouseticks"
+path = "comparisons/glmm_grouseticks.rs"
+
+[[example]]
+name = "lmm_dyestuff"
+path = "comparisons/lmm_dyestuff.rs"
+
+[[example]]
+name = "lmm_pastes"
+path = "comparisons/lmm_pastes.rs"
+
+[[example]]
+name = "lmm_penicillin"
+path = "comparisons/lmm_penicillin.rs"
+
+[[example]]
+name = "sleepstudy"
+path = "comparisons/sleepstudy.rs"
+
+[[example]]
+name = "sleepstudy_ml"
+path = "comparisons/sleepstudy_ml.rs"
+
 [target.'cfg(target_arch = "x86_64")'.dependencies]
 ndarray-linalg = { version = "0.17", features = ["intel-mkl-static"] }
 

{lme_python-0.1.3 → lme_python-0.1.4}/GUIDE.md

@@ -270,7 +270,7 @@ fit.with_kenward_roger(&df)?;
 println!("{}", fit);
 ```
 
-This API exists and is tested at the interface level, but the current implementation is still provisional. Treat it as an experimental path rather than as a drop-in replacement for the full `pbkrtest` stack.
+The Kenward-Roger path produces denominator degrees of freedom that match R's `pbkrtest` on the covered LMM configurations. As with Satterthwaite, results are derived via numerical differentiation of the REML objective.
 
 ### Robust standard errors
 
@@ -317,7 +317,7 @@ println!("{}", lrt);
 
 `lme-rs` is designed to track `lme4` behavior closely on the covered workflows. The strongest evidence for parity is in the repository tests and comparison fixtures, not in a blanket claim that every `lme4` feature is already mirrored.
 
-See [examples/COMPARISONS.md](examples/COMPARISONS.md) for concrete side-by-side output.
+See [comparisons/COMPARISONS.md](comparisons/COMPARISONS.md) for concrete side-by-side output.
 
 ### GLMM information criteria
 
@@ -329,7 +329,7 @@ Fixed-effects ANOVA support currently means Type III tests over the current 1-Do
 
 ### Kenward-Roger status
 
-The public API exposes Kenward-Roger, but the implementation is still provisional. If your workflow is publication-critical, validate against your R reference outputs before relying on it.
+`with_kenward_roger()` produces denominator degrees of freedom that match R's `pbkrtest` on the covered LMM configurations. Numerical precision is consistent with the finite-difference Hessian used by the implementation; results have been validated against the `sleepstudy` reference to within 0.01 df. As always, validating against an R reference is sensible for any publication-critical workflow.
 
 ### Python bindings
 
@@ -367,7 +367,7 @@ If you see dimension mismatch or underdetermined-system errors, inspect the effe
 - whether you fit random slopes as well as intercepts
 - how well-scaled the predictors are for optimization
 
-For concrete examples and parity outputs, use the scripts and datasets in `examples/` and `tests/data/`.
+For concrete parity outputs, use the scripts and datasets in `comparisons/` and `tests/data/`.
 
 ## API Surface Summary
 
@@ -392,7 +392,7 @@ For concrete examples and parity outputs, use the scripts and datasets in `examp
 | `confint(level)` | Wald confidence intervals |
 | `simulate(nsim)` | parametric simulation |
 | `with_satterthwaite(data)` | Satterthwaite degrees of freedom and p-values |
-| `with_kenward_roger(data)` | provisional Kenward-Roger path |
+| `with_kenward_roger(data)` | Kenward-Roger denominator degrees of freedom and p-values |
 | `with_robust_se(data, cluster_col)` | robust or cluster-robust standard errors |
 | `anova(ddf_method)` | Type III fixed-effects ANOVA table |
 

{lme_python-0.1.3 → lme_python-0.1.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lme_python
-Version: 0.1.3
+Version: 0.1.4
 Classifier: Programming Language :: Rust
 Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: Programming Language :: Python :: Implementation :: PyPy

{lme_python-0.1.3 → lme_python-0.1.4}/README.md

@@ -14,7 +14,7 @@
 - `glmer()` for binomial, poisson, gaussian, and gamma mixed models
 - Wilkinson formulas with nested and crossed random effects
 - Population-level and conditional prediction APIs
-- Wald confidence intervals, parametric simulation, robust standard errors, Satterthwaite degrees of freedom, and a provisional Kenward-Roger path
+- Wald confidence intervals, parametric simulation, robust standard errors, Satterthwaite degrees of freedom, and Kenward-Roger denominator degrees of freedom
 - Likelihood ratio tests between nested models and Type III ANOVA tables for 1-DoF fixed effects
 
 ## Quick start
@@ -24,7 +24,7 @@ cargo add lme-rs
 ```
 
 ```rust
-use lme_rs::lmer;
+use lme_rs::{lm_df, lmer};
 use polars::prelude::*;
 
 fn main() -> anyhow::Result<()> {
@@ -34,8 +34,13 @@ fn main() -> anyhow::Result<()> {
         .into_reader_with_file_handle(&mut file)
         .finish()?;
 
-    let fit = lmer("Reaction ~ Days + (Days | Subject)", &df, true)?;
-    println!("{}", fit);
+    // Fixed-effects-only OLS (formula + DataFrame, no random effects)
+    let ols = lm_df("Reaction ~ Days", &df)?;
+    println!("{}", ols);
+
+    // Linear mixed model
+    let mixed = lmer("Reaction ~ Days + (Days | Subject)", &df, true)?;
+    println!("{}", mixed);
 
     Ok(())
 }
@@ -51,14 +56,14 @@ fn main() -> anyhow::Result<()> {
 
 ## Current status
 
-The core modeling surface is in place and exercised by the test suite, examples, and cross-language comparisons in [examples/COMPARISONS.md](examples/COMPARISONS.md). The crate is usable today, but some features are intentionally narrower than the R ecosystem wrappers they resemble.
+The core modeling surface is in place and exercised by the test suite, examples, and cross-language comparisons in [comparisons/COMPARISONS.md](comparisons/COMPARISONS.md). The crate is usable today, but some features are intentionally narrower than the R ecosystem wrappers they resemble.
 
 ## Limitations and compatibility notes
 
 - Numerical parity is the goal for the covered LMM and GLMM workflows, but the guarantee is scoped to the models and examples exercised by the repository tests and comparison fixtures.
 - `glmer()` uses a Laplace approximation. Absolute AIC, BIC, and log-likelihood values can differ from R because `lme-rs` optimizes a deviance expression that omits data-dependent constants. Coefficients and variance parameters are the quantities to compare.
 - Fixed-effects ANOVA support is currently Type III only, and only for the current 1-DoF fixed-effect design produced by the parser.
-- `with_kenward_roger()` is available, but the current implementation should be treated as provisional rather than as a mature independent reimplementation of `pbkrtest`.
+- `with_kenward_roger()` produces denominator degrees of freedom that match R's `pbkrtest` to within the precision of numerical differentiation on the covered LMM models.
 - The Rust crate exposes a broader surface than the Python bindings. The Python package is useful, but it is not yet a full mirror of the Rust API.
 - Built-in GLMM families currently use their default links through the public `glmer()` API.
 
@@ -67,15 +72,17 @@ The core modeling surface is in place and exercised by the test suite, examples,
 - Rust API docs: [docs.rs](https://docs.rs/lme-rs/latest/lme_rs/)
 - Rust usage guide: [GUIDE.md](GUIDE.md)
 - Python bindings guide: [python/PYTHON_GUIDE.md](python/PYTHON_GUIDE.md)
-- Cross-language numerical comparisons: [examples/COMPARISONS.md](examples/COMPARISONS.md)
+- Cross-language numerical comparisons: [comparisons/COMPARISONS.md](comparisons/COMPARISONS.md)
+- Published benchmark dashboard: [GitHub Pages](https://x4g4p3x.github.io/lme-rs/benchmarks/)
 - Benchmark scope and methodology: [BENCHMARKS.md](BENCHMARKS.md)
+- Latest benchmark artifacts: [v0.1.3 release](https://github.com/x4g4p3x/lme-rs/releases/tag/v0.1.3)
 - Release history: [CHANGELOG.md](CHANGELOG.md)
 - Contributor setup: [CONTRIBUTING.md](CONTRIBUTING.md)
 - Release workflow: [RELEASING.md](RELEASING.md)
 
 ## Examples
 
-The `examples/` directory includes end-to-end fits for common reference datasets:
+The `comparisons/` directory contains cross-language reference fits for common datasets:
 
 - `sleepstudy`
 - `dyestuff`

{lme_python-0.1.3 → lme_python-0.1.4}/RELEASING.md

@@ -62,7 +62,7 @@ Update all user-visible versioned surfaces together.
 
 - update `CHANGELOG.md`
 - update any README or guide snippets that mention a specific version
-- review `examples/COMPARISONS.md` if release notes depend on changed outputs or behavior
+- review `comparisons/COMPARISONS.md` if release notes depend on changed outputs or behavior
 
 ## Benchmarks before release
 
@@ -83,14 +83,14 @@ python scripts/run_cross_language_benchmarks.py
 ## Git workflow
 
 1. Ensure the worktree is clean enough to understand what is being released.
-2. Commit the release changes.
-3. Create an annotated tag:
+1. Commit the release changes.
+1. Create an annotated tag:
 
 ```bash
 git tag -a v0.1.3 -m "Release v0.1.3"
 ```
 
-4. Push the branch and the tag:
+1. Push the branch and the tag:
 
 ```bash
 git push origin master
@@ -124,7 +124,7 @@ If a release changes the crate description, homepage, keywords, or categories, v
 
 ## Post-release verification
 
-### Rust crate
+### Rust crate (post-release)
 
 Verify the new crate version appears on crates.io and docs.rs.
 
@@ -134,7 +134,7 @@ Check:
 - README rendering on crates.io is sane
 - docs.rs builds and links resolve
 
-### Python package
+### Python package (post-release)
 
 Verify the PyPI release and GitHub Release artifacts.
 

lme_python-0.1.4/docs/benchmarks/app.js

@@ -0,0 +1,207 @@
+function formatSeconds(seconds) {
+  if (seconds >= 10) {
+    return `${seconds.toFixed(2)} s`;
+  }
+  if (seconds >= 1) {
+    return `${seconds.toFixed(3)} s`;
+  }
+  return `${(seconds * 1000).toFixed(2)} ms`;
+}
+
+function formatRatio(value) {
+  if (value == null) {
+    return "n/a";
+  }
+  return `${value.toFixed(2)}x`;
+}
+
+function titleCase(value) {
+  return value.charAt(0).toUpperCase() + value.slice(1);
+}
+
+function renderHeroLinks(data) {
+  const heroLinks = document.getElementById("hero-links");
+  const links = [];
+
+  if (data.run_url) {
+    links.push({ href: data.run_url, label: "Workflow run" });
+  }
+  if (data.release_url) {
+    links.push({ href: data.release_url, label: "GitHub release" });
+    if (data.asset_urls.cross_language) {
+      links.push({
+        href: data.asset_urls.cross_language,
+        label: "Cross-language JSON",
+      });
+    }
+    if (data.asset_urls.criterion) {
+      links.push({
+        href: data.asset_urls.criterion,
+        label: "Criterion archive",
+      });
+    }
+  }
+
+  heroLinks.replaceChildren(
+    ...links.map((link) => {
+      const anchor = document.createElement("a");
+      anchor.href = link.href;
+      anchor.textContent = link.label;
+      anchor.target = "_blank";
+      anchor.rel = "noreferrer";
+      return anchor;
+    }),
+  );
+}
+
+function renderSummary(data) {
+  const runMeta = document.getElementById("run-meta");
+  const generatedAt = new Date(data.generated_at).toLocaleString(undefined, {
+    dateStyle: "medium",
+    timeStyle: "short",
+  });
+  runMeta.textContent = `Generated ${generatedAt} for ${data.ref_name || data.git_sha.slice(0, 7)}.`;
+
+  const statsGrid = document.getElementById("stats-grid");
+  const stats = [
+    ["Cases", data.config.cases.length],
+    ["Implementations", data.config.implementations.length],
+    ["Warmups", data.config.warmups],
+    ["Repeats", data.config.repeats],
+    ["CPU count", data.machine_info.cpu_count],
+    ["Git SHA", data.git_sha.slice(0, 12)],
+  ];
+
+  statsGrid.replaceChildren(
+    ...stats.map(([label, value]) => {
+      const card = document.createElement("div");
+      card.className = "stat-card";
+
+      const labelNode = document.createElement("span");
+      labelNode.className = "stat-label";
+      labelNode.textContent = label;
+
+      const valueNode = document.createElement("div");
+      valueNode.className = "stat-value";
+      valueNode.textContent = String(value);
+
+      card.append(labelNode, valueNode);
+      return card;
+    }),
+  );
+}
+
+function renderRatioSummary(data) {
+  const container = document.getElementById("ratio-summary");
+  const nonRust = data.implementation_summary.filter(
+    (item) => item.implementation !== "rust",
+  );
+  const maxRatio = Math.max(
+    ...nonRust.map((item) => item.geometric_mean_relative_to_rust || 0),
+    1,
+  );
+
+  container.replaceChildren(
+    ...data.implementation_summary.map((item) => {
+      const row = document.createElement("div");
+      row.className = "ratio-row";
+
+      const label = document.createElement("div");
+      label.textContent = titleCase(item.implementation);
+
+      const track = document.createElement("div");
+      track.className = "ratio-track";
+      const fill = document.createElement("div");
+      fill.className = "ratio-fill";
+      const ratio = item.geometric_mean_relative_to_rust || 1;
+      fill.style.width = `${Math.max((ratio / maxRatio) * 100, 3)}%`;
+      track.append(fill);
+
+      const value = document.createElement("div");
+      if (item.implementation === "rust") {
+        value.textContent = "baseline";
+      } else {
+        value.textContent = `${formatRatio(ratio)} slower`;
+      }
+
+      row.append(label, track, value);
+      return row;
+    }),
+  );
+}
+
+function renderCases(data) {
+  const caseGrid = document.getElementById("case-grid");
+  const caseTemplate = document.getElementById("case-card-template");
+  const rowTemplate = document.getElementById("bar-row-template");
+
+  caseGrid.replaceChildren(
+    ...data.cases.map((caseData) => {
+      const fragment = caseTemplate.content.cloneNode(true);
+      fragment.querySelector(".case-title").textContent = caseData.case;
+      fragment.querySelector(".case-fastest").textContent =
+        caseData.fastest_implementation
+          ? `Fastest in this run: ${titleCase(caseData.fastest_implementation)}`
+          : "No successful measurements";
+
+      const bars = fragment.querySelector(".bars");
+      caseData.entries.forEach((entry) => {
+        const row = rowTemplate.content.cloneNode(true);
+        row.querySelector(".bar-label").textContent = entry.implementation;
+        const fill = row.querySelector(".bar-fill");
+        fill.classList.add(entry.implementation);
+        fill.style.width = `${Math.max(entry.width_fraction * 100, 2)}%`;
+        const value = row.querySelector(".bar-value");
+        const ratioSuffix =
+          entry.relative_to_rust && entry.implementation !== "rust"
+            ? ` (${formatRatio(entry.relative_to_rust)} slower)`
+            : "";
+        value.textContent = `${formatSeconds(entry.median_seconds)}${ratioSuffix}`;
+        bars.append(row);
+      });
+
+      return fragment;
+    }),
+  );
+}
+
+function renderEnvironment(data) {
+  const list = document.getElementById("environment-list");
+  const entries = [
+    ["Platform", data.machine_info.platform],
+    ["Machine", data.machine_info.machine],
+    ["Rust", data.runtime_versions.rustc],
+    ["Python", data.runtime_versions.python],
+    ["R", data.runtime_versions.Rscript],
+    ["Julia", data.runtime_versions.julia],
+  ];
+
+  list.replaceChildren(
+    ...entries.flatMap(([term, description]) => {
+      const dt = document.createElement("dt");
+      dt.textContent = term;
+      const dd = document.createElement("dd");
+      dd.textContent = description || "n/a";
+      return [dt, dd];
+    }),
+  );
+}
+
+async function main() {
+  const response = await fetch("./data/latest.json", { cache: "no-store" });
+  if (!response.ok) {
+    throw new Error(`Failed to load benchmark data: ${response.status}`);
+  }
+
+  const data = await response.json();
+  renderHeroLinks(data);
+  renderSummary(data);
+  renderRatioSummary(data);
+  renderCases(data);
+  renderEnvironment(data);
+}
+
+main().catch((error) => {
+  const runMeta = document.getElementById("run-meta");
+  runMeta.textContent = error.message;
+});