Skip to content

docs(benchmarking): add coverage and review summary table - #31

Merged
WesIngwersen merged 5 commits into
mainfrom
benchmark-results-table
Oct 27, 2026
Merged

WesIngwersen merged 5 commits into
mainfrom
benchmark-results-table

Conversation

@briantobin-99

@briantobin-99 briantobin-99 commented Oct 26, 2026 •

Copy link
Copy Markdown
Contributor

Follow-up to #22.

  • Redraws the results donut (figures/diagrams/benchmark-2026-rc1.png) from a script, figures/scripts/benchmark_figures.py, in the same style as before. The centre label read 70%, but the legend and the data give 69% (61 of 88 sectors). The caption and alt text now say 69% and "the 88 benchmarked sectors".
  • Adds a short summary under the donut: how many sectors were benchmarked (88) and the share of global direct emissions they cover (about 52%). It also adds a table of sectors within 25% of the benchmark, sectors manually reviewed, and sectors that are either, each with its share of the 88 sectors and of global direct emissions.

Where the numbers come from

Model D values are from the v1.0 release diagnostics (cornerstone_2026_v0_7, ceda commit 03facf41). The gap is |model − benchmark| ÷ benchmark. Shares of global emissions are each sector's direct emissions over the model's global total of 42,625 Mt CO2e.

Measure Sectors Share of sectors Share of global direct emissions
Within 25% 61 69.32% 45.8%
25–50% gap 18 20.45% 3.7%
50% or more gap 9 10.23% 2.9%
Manually reviewed 47 53.4% 36.4%
Manually reviewed or within 25% 78 88.6% 50.1%
All benchmarked sectors 88 100% 52.4%

The donut rounds each gap band to the nearest whole percent (69% / 20% / 10%), so the labels add to 99%.

🤖 Generated with Claude Code

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@github-actions

github-actions Bot commented Oct 26, 2026 •

Copy link
Copy Markdown
PR Preview Action v1.8.2
Preview removed because the pull request was closed.
2026-10-27 17:41 UTC

briantobin-99 and others added 2 commits October 26, 2026 11:00
The centre label read 70% while the legend and the data give 69%
(61 of 88 sectors). Redrawn from a script so it can be regenerated.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
18 of 88 sectors is 20.45%, which rounds to 20%, not 21%.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@briantobin-99
briantobin-99 marked this pull request as ready for review October 26, 2026 18:34
Comment thread benchmarking/index.md Outdated
Comment on lines +95 to +101
| Measure | Sectors | Share of the 88 sectors | Share of global direct emissions |
|---|---|---|---|
| Within 25% of the benchmark | 61 | 69% | 46% |
| Manually reviewed | 47 | 53% | 36% |
| Manually reviewed, or within 25% of the benchmark | 78 | 89% | 50% |

A sector counts as manually reviewed when someone investigated its gap and reached one of the three outcomes above: a sharper benchmark, a model improvement, or a documented difference. Sectors within 25% of the benchmark were not all reviewed in this depth, because the gap gave no reason to.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm wondering if we want to include this content or if this just adds confusion (distinguishing between manually reviewed or not). @Yohanna1906 @WesIngwersen what do you think?

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think it makes sense

@bl-young

Copy link
Copy Markdown
Member

Thank you for this! Left a comment for us to consider but thanks for updating the figure.

@WesIngwersen

Copy link
Copy Markdown
Member

@bl-young @briantobin-99 I prefer to have this content in https://docs.cornerstonedata.org/eeio/releases/rc/ because its a result. We don't have any results in other sections under Technical Documentation at this point, so I'd rather keep it in the release details content

bl-young and others added 2 commits October 26, 2026 21:15
Resolve conflicts by keeping the corrected 69%/88-sector results and adopting main's 2026-rc figure naming.

Co-authored-by: Cursor <cursoragent@cursor.com>
Comment thread releases/rc.md

Together these make the 2017–2026 time series possible.

## Benchmarking results

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@WesIngwersen - the content got moved here

@WesIngwersen
WesIngwersen merged commit ebec8b1 into main Oct 27, 2026
1 of 2 checks passed
@WesIngwersen
WesIngwersen deleted the benchmark-results-table branch October 27, 2026 17:41
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.

3 participants