Skip to content

docs(gfql): re-vendor the pyg-bench numbers; withdraw the GPlus GPU/CPU PageRank ratio - #2114

Open
lmeyerov wants to merge 1 commit into
masterfrom
fix/docs-revendor-bench-numbers
Open

lmeyerov wants to merge 1 commit into
masterfrom
fix/docs-revendor-bench-numbers

Conversation

@lmeyerov

Copy link
Copy Markdown
Contributor

Why master is red today

docs/source/_data/gfql_benchmarks.json — the vendored copy of pyg-bench's published/docs-numbers.json — carried GraphBench q1–q9 runs measured 2026-07-26. The publication policy allows 60 days; 2026-09-25 is day 61, so docs/test_bench_numbers.py::test_no_published_number_is_stale fails in every lane that runs it — test-minimal-python, test-docs, the Read the Docs build — on master, for any change. Found because #2113 touched a path routed into those lanes; #2110–#2112 ran on days 59–60 and passed.

What this does

pyg-bench already re-measured those lanes on 2026-09-17 (graphbench-q1q9-{20k,100k}-master-f283a305e-20260917, pyg-bench 7057a170). This vendors that artifact. The contract file is byte-identical to pyg-bench's manifests/docs-numbers.contract.json. Chart SVGs regenerated with the documented gfql_bench_charts.py --write. docs/test_bench_numbers.py: 26/26.

Two documented numbers change status — the docs follow the artifact

Withdrawn (for your review — this removes a published comparison): pagerank.gplus.gfql_gpu_vs_gfql_cpu is no longer published upstream, and pagerank.gplus.gfql_gpu is diagnostic-only, with pyg-bench's disclosure:

Its selected-node set differs from the GFQL CPU (pandas + igraph) arm's on gplus (Jaccard 0.91065, gate 0.95); this is a direct pipeline time, not a comparison.

benchmark_filter_pagerank.rst and its chart stop claiming a GPlus GPU-vs-CPU speedup and show the GPU time as :bench-diag: with that reason. Twitter's cells are unchanged upstream and untouched.

Promoted (mechanical): graphbench.{20k,100k}.q8.{pandas,polars} moved from diagnostic to published upstream; performance.rst upgrades them from :bench-diag: to :bench:.

For the publisher

snb-is3-single-query-20260727 is at 60 days in both this artifact and upstream and crosses the same policy tomorrow. Needs a re-measure, a drop, or a policy decision in pyg-bench.

Not self-merged: it withdraws a published claim.

🤖 Generated with Claude Code

https://claude.ai/code/session_017ropeBMLJUuy6ViYwy15ud

@lmeyerov
lmeyerov force-pushed the fix/docs-revendor-bench-numbers branch from fa79338 to 7ef80c1 Compare September 25, 2026 08:17
…PU PageRank ratio

The vendored `docs/source/_data/gfql_benchmarks.json` carried GraphBench q1-q9 runs measured
2026-07-26. The publication policy allows 60 days; today is day 61, so every CI lane that runs
`docs/test_bench_numbers.py` -- test-minimal-python, test-docs, the Read the Docs build -- fails
on master for any change. pyg-bench re-measured those lanes on 2026-09-17
(`graphbench-q1q9-{20k,100k}-master-f283a305e-20260917`); this vendors that artifact. The
contract file is unchanged (identical to pyg-bench `manifests/docs-numbers.contract.json`).

Two documented numbers change status with it, and the docs follow the artifact rather than
the other way round:

* `pagerank.gplus.gfql_gpu_vs_gfql_cpu` is no longer published, and `pagerank.gplus.gfql_gpu`
  is now diagnostic-only, with pyg-bench's disclosure: the GPU arm's selected-node set differs
  from the CPU arm's on gplus (Jaccard 0.91065 against a 0.95 gate), so it is a direct pipeline
  time, not a comparison. `benchmark_filter_pagerank.rst` and its chart stop claiming a GPlus
  GPU-vs-CPU speedup and present the GPU time as `:bench-diag:`. Twitter's cells are unchanged
  upstream and untouched here.
* `graphbench.{20k,100k}.q8.{pandas,polars}` were promoted from diagnostic to published
  results upstream; `performance.rst` upgrades their role from `:bench-diag:` to `:bench:`.

This withdraws a published comparison, so it is for review rather than self-merge. Note for the
publisher: `snb-is3-single-query-20260727` is at 60 days in both this artifact and upstream and
crosses the same policy tomorrow.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017ropeBMLJUuy6ViYwy15ud
@lmeyerov
lmeyerov force-pushed the fix/docs-revendor-bench-numbers branch from 7ef80c1 to 69c6a0d Compare September 25, 2026 08:25

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant