Data Governance

Data Governance & Editorial Standards

GreenCalculus is an independent technical resource implementing the GHG Protocol Corporate Standard, the IPCC Assessment Reports, and the DEFRA UK conversion factors into accessible calculation tools. It is not a target-setting body, not a verification or certification body, and not a consultancy.

This document is the public record of how the data layer is sourced, how the prose is reviewed, and how errors are corrected — written for procurement officers, sustainability auditors, and any practitioner who needs to cite a GreenCalculus calculation in a compliance document.

§1 · The MasterBrain: Data Integrity Protocol

GreenCalculus runs a single canonical data layer — the MasterBrain — that supplies every calculator on the platform with emission factors, global warming potential values, and grid intensity figures. The protocol below describes how that data layer is updated, traced, version-stamped, archived, and disclosed.

30 days Maximum window from Tier-1 source release to MasterBrain deployment
Pillar 1

Update SLA

≤ 30 days

Every IPCC, DEFRA, and IEA release reaches the data layer within 30 calendar days of publication.

Pillar 2

Provenance

100%

Every canonical row carries a source object naming the publication, the exact place within it, and the retrieval date.

Pillar 3

Version stamps

100%

Every calculator output links to the exact MasterBrain version that produced it, traceable in the public changelog.

Pillar 4

Archive

65 versions

Superseded factors are never deleted from the public record. Point-in-time snapshots resolve by API from v2026.111 onward.

The 30-Day Update Rule

Data Freshness Guarantee

All Tier-1 source updates — IPCC, DEFRA, and IEA — are deployed to the MasterBrain within 30 calendar days of publication. Affected calculator pages receive simultaneous version bumps and changelog entries.

GreenCalculus commits in writing to updating all affected emission factors and GWP values within 30 calendar days of a major publication event. The qualifying events are: a new IPCC Assessment Report cycle release (e.g., AR7 on publication), the annual DEFRA conversion factor update published each June, and the IEA Global Energy Review annual release.

The most recent test of this rule was the DEFRA 2026 release. DESNZ published the 2026 conversion factors in June 2026; the refresh reached the MasterBrain on 18 June 2026, moving 1,458 rows onto the new edition. The largest single movement was the UK grid electricity factor, which fell from 0.177 to 0.13096 kg CO₂e/kWh — a 26% decrease reflecting real decarbonisation of the 2024 generation mix, and a change large enough that any page still quoting the old figure is materially wrong rather than merely dated. Every affected calculator was version-bumped in the same pass.

The 30-day window is chosen deliberately. Shorter would not allow cell-by-cell verification against the source workbook before deployment. Longer would risk calculators serving stale data during an active reporting cycle, when practitioners are actively citing GreenCalculus values in their own GHG inventories. The window covers the time required to cross-check every changed value against the primary source, update the MasterBrain, propagate version stamps to affected pages, and publish the corresponding changelog entries.

Cell-by-Cell Provenance

Every entry in the MasterBrain carries a machine-readable source object. This is not documentation aspiration — it is the live data structure, embedded against every fuel, every global warming potential value, and every grid intensity figure on the platform. Coverage is total, not typical: all 16,686 canonical rows carry it.

The source object records three things against every value: the publication it was read from (source.id, which resolves in the source registry to publisher, edition, licence and a link to the document), the exact place it was read from — a cell, a table, an annex clause or a page (source.cell_ref), and the date it was retrieved (source.retrieved). Multi-gas rows carry the same fields again on each component, so a CO₂e figure can be decomposed to the individual CO₂, CH₄ and N₂O cells behind it — the AR6 or AR5 basis applied is recorded on the row itself.

The exhibit below is not a transcript. It is read from the live MasterBrain when this page is served, so it cannot fall out of step with the data it describes:

Live MasterBrain row — UK diesel (average biofuel blend), per litre
FieldLive value
MasterBrain keyfuels.gbr.diesel_average_biofuel_blend.litre
NameUK Diesel (average biofuel blend) — combustion (litres)
Value2.58354 kg CO2e per litre
GWP basisAR5_100
GasCO2e
GHG Protocol scopescope1
SourceUK Government GHG Conversion Factors 2026
Published byDepartment for Energy Security and Net Zero (DESNZ)
Source cell'Fuels'!D72
Retrieved2026-06-18
LicenceOpen Government Licence v3.0
CO2 component2.55035 kg CO2e per litre · 'Fuels'!E72
CH4 component0.00029 kg CO2e per litre · 'Fuels'!F72
N2O component0.0329 kg CO2e per litre · 'Fuels'!G72

Read live from MasterBrain v2026.203. Verify against the publisher: UK Government GHG Conversion Factors 2026.

A practitioner who wishes to verify that figure can download the DESNZ workbook named above, open the tab and cell it names, and confirm the number directly against the source publication — including the individual gas components, each of which carries its own cell. The same rows are queryable programmatically: GET /wp-json/greencalculus/v1/factors returns the canonical corpus with its source attribution, and GET /wp-json/greencalculus/v1/gwp-values returns the GWP set, so any practitioner, auditor, or downstream developer can check the data layer without reading this page at all.

Version Stamping and Audit Trail

Every calculator, methodology page, and data page carries a version stamp at the top of the article body — for example, MasterBrain v2026.203 · DEFRA 2026 · IPCC AR6 GWP-100 — that links directly to the corresponding entry in the public changelog.

When the MasterBrain version bumps, every affected page receives a Major version bump simultaneously and its _gc_last_reviewed date is updated. This means a practitioner who used a GreenCalculus calculator in Q3 2025 to populate a corporate GHG inventory can return to the public changelog, identify the exact data version that underpinned the result, and reproduce the calculation if challenged during external assurance.

Archival and Reproducibility

Two things are preserved here, and they are not the same thing. The record is permanent: every value change is published in the changelog with the old and new figures stated, and no superseded value is deleted or quietly migrated out of it. The machine-resolvable archive is narrower and newer: it holds point-in-time snapshots that an API call can resolve directly, and it begins at MasterBrain v2026.111.

What the archive can and cannot do

An auditor checking a disclosure built on a MasterBrain version from v2026.111 onward can resolve the exact factor as it stood, through the endpoint below. For anything earlier, reproduction is a documentary exercise rather than an API call: the changelog states what changed and when, and the version stamp on the page names the data layer the figure came from. We would rather say where the boundary is than let a reader assume there is none.

Every superseded value is retained with its original source reference and the version in which it was retired. The archive is served from the API edge rather than the open corpus endpoint: GET https://api.greencalculus.com/v1/factors/<key>?as_of=<version> resolves a single factor key as it stood at a past MasterBrain version, and requires an API key. The open /wp-json/greencalculus/v1/factors endpoint serves the current corpus only and rejects an as_of parameter outright rather than silently returning today’s value.

Current archive coverage. Every published MasterBrain version from v2026.111 to the live v2026.203 is resolvable — 70 versions, with no gaps. Five had been unreadable (2026.137, 2026.138, 2026.151, 2026.154 and 2026.177) and were restored on 31 August 2026 by rebuilding each corpus from the data layer’s own version history. The last of those records the Ember grid-lifecycle revision, the largest data event of the year.

Two numbers that look like gaps are not. 2026.141 and 2026.176 were never published: the release history runs 140 to 142 and 175 to 177, so those version numbers were allocated and skipped rather than lost. Nothing was archived for them because nothing ever existed at them. We state that rather than counting them as a shortfall we intend to make good — an archive that quietly counts phantom versions as gaps is no more honest than one that hides real ones.

This policy applies equally to corrections (per §4 below) and to scheduled source updates (per the 30-day rule above). Even when a value is corrected because it was wrong, the wrong value is preserved in the archive — because removing it would silently invalidate every report built on it.

Dual GWP Basis Disclosure

GreenCalculus operates two concurrent GWP bases transparently — a practice rare among public environmental calculators. Both are declared in every calculator’s audit trail and every data export. Neither is hidden, and neither is treated as a silent default.

Engineering mode

IPCC AR6 GWP-100

CH₄ = 29.8

Used when practitioners need current scientific consensus for internal methodology, scenario analysis, or science-based target work. Source: IPCC AR6 Table 7.SM.7.

Regulatory mode

IPCC AR5 GWP-100

CH₄ = 28.0

Used when calculations must align with DEFRA’s pre-aggregated UK conversion factors — the statutory basis for UK SECR reporting.

Practitioners choose the basis appropriate to their reporting framework. Both bases are published in full at our IPCC AR6 GWP reference table and applied within our published DEFRA emission factors.

§2 · Editorial and Quality Control Standards

GreenCalculus content is produced and reviewed against a three-layer model. Each layer has a defined role, a defined output, and a defined point of accountability.

Layer 1

Sourcing

Tier-1 only. IPCC, IEA, DEFRA / DESNZ, US EPA, and the GHG Protocol. Secondary aggregators, industry lobbying bodies, and consultancy white papers are never used as data sources. Source conflicts are disclosed explicitly in the relevant methodology page.

Layer 2

Implementation

Hard-coded from primary documents. Jeremiah Say translates each source PDF and workbook directly into calculation logic — never from summaries or third-party interpretations. Source-cell-to-output mapping is recorded in the provenance block at the time of build.

Layer 3

Institutional verification

Prose-vs-data cross-check. Engineering reviews methodology prose against the underlying code and source documents. Source integrity is confirmed by cell-by-cell traceability to the issuing body’s published workbook, with an automated validation suite that runs structural and controlled-vocabulary checks on every MasterBrain release before publication.

Policy on AI Assistance

Hard boundary

AI tools are never used to determine emission factors, write methodology logic, select GWP values, or produce any numerical output that appears in a published calculator. AI hallucination on a compliance tool creates legal risk for every practitioner who cites a GreenCalculus value in a CDP disclosure or CSRD report.

GreenCalculus is explicit about where AI tools are used and where they are not. AI tools may assist with formatting HTML, scaffolding code structure, and identifying candidate internal links between pages. All methodological decisions and all numerical outputs are hard-coded by Jeremiah Say from primary source documents.

Review Depth by Content Type

Different content types are subject to different review depths. The bar chart below shows the relative depth applied to each surface, followed by the full review matrix.

Calculators Full audit
Methodology Logic audit
Data pages Factor audit
Standards Version audit
Glossary Definition audit
Guides / Tools Workflow audit
Content type Review standard applied
Calculators Full numerical audit: every factor traced to its exact place in the source before publication.
Methodology pages Logic audit: prose checked against the calculator implementation it describes. See the natural gas combustion methodology page for an example of full source attribution.
Data pages Factor audit: every value verified against the current source publication.
Standards pages Version audit: standard version, publication date, and scope confirmed against the issuing body.
Glossary Definition audit: each definition checked against the source standard’s own glossary or defined-term register.
Guides and tools Workflow audit: steps verified against current calculator behaviour at the time of publication.

§3 · Independence and Conflict of Interest

No organisation can pay to have specific emission factors, preferred methodologies, or favourable assumptions featured on GreenCalculus. The factors used on this platform are those published by the relevant Tier-1 regulatory body — full stop.

GreenCalculus editorial policy

Independence

GreenCalculus is an independent technical resource. It is not a target-setting body — it does not set emissions reduction targets and does not validate corporate pledges, and is therefore distinct from organisations such as the Science Based Targets initiative. It is not a verification or certification body — it does not issue certificates, does not audit third-party emissions claims, and does not assert assurance opinions. It is not a consultancy — it does not provide bespoke paid advice. Its sole function is the impartial, accurate implementation of existing global standards into accessible calculation tools.

No pay-to-rank

No organisation can pay to have specific emission factors, preferred methodologies, or favourable assumptions featured on GreenCalculus. The factors used on this platform are those published by the relevant Tier-1 regulatory body — DEFRA for the United Kingdom, US EPA for the United States, IEA for grid intensity, IPCC for global warming potentials. No commercial relationship influences the data layer or the methodology documentation. If GreenCalculus ever receives sponsorship or advertising revenue from a party with an interest in any specific emission factor, that relationship is disclosed separately in standard site disclosures and does not affect editorial or data decisions.

Revenue model transparency

GreenCalculus is supported by display advertising and is building toward premium API access for enterprise users who require programmatic access to the MasterBrain data layer. Neither revenue stream creates editorial conflicts. Advertisers do not influence content selection, content ordering, or the values published in the data layer. API consumers query the same data layer that all public users see — there is no premium-tier divergence in the underlying numbers.

GreenCalculus data integrity protocol — four pillars: a 30-day or less Tier-1 update SLA, 10-field cell-by-cell provenance on every factor, 100% version-stamped outputs, and an append-only archive of superseded factors.
MB v2026.203 · updated 22 Sep 2026

§4 · Correction and Feedback Policy

The Errata Process

When an error is identified — whether through internal review, an external practitioner challenge, or a MasterBrain audit — the following six steps are taken without exception. No silent fixes; no exceptions.

Step 1

Verify against primary source

Source-side change, or GreenCalculus implementation diverged from a stable source? Determine which, and record.

Step 2

Apply correction

Correction is staged on the affected page or pages. Not yet published.

Step 3

Write public changelog entry

Old value and new value both stated explicitly. The changelog records what changed, not just that something changed. Written before the page is republished.

Step 4

Credit the reporter

Practitioner who identified the error is credited by name in the changelog entry, with their consent.

Step 5

Bump version, update date

Major version bump for any numerical correction. _gc_last_reviewed updated to the publication date.

Step 6

Preserve in archive

Superseded value is preserved in the MasterBrain archive — any historical report that relied on the original value remains reproducible.

The changelog entry is written before the corrected page is published. Any practitioner who subscribed to the changelog RSS feed at the time of the error will see the correction in their feed.

Worked example: the v2025.2 CH₄ correction

Real correction · May 2026

The MasterBrain v2025.2 update corrected the AR5 GWP-100 value for methane from 25.0 to 28.0 — a legacy value carried over from IPCC AR4 (2007) that should have been updated when AR5 (2014) became the regulatory basis for DEFRA’s UK conversion factor workbook.

Field Before After Basis
CH4_fossil.ar5_100 25.0 28.0 IPCC AR5 (2014) WG1 Ch. 8
CH4_biogenic.ar5_100 25.0 28.0 IPCC AR5 (2014) WG1 Ch. 8
CH4_*.ar6_100 Unaffected — already on AR6 basis IPCC AR6 (2021) Table 7.SM.7

Every calculator that referenced the affected fields received a Major version bump, and the v2025.1 snapshot — including the incorrect 25.0 value — remains resolvable through the archive endpoint above for any practitioner reproducing a pre-correction figure. See the corresponding changelog entry for the full attribution.

Technical Feedback Channel

Found a discrepancy? Challenge a methodology?

The dedicated channel for technical feedback is governance@greencalculus.com. Confirmed corrections are publicly credited in the corresponding changelog entry. Response within 10 business days.

Email the governance team

A useful submission includes the URL of the affected page, the specific value or methodology step in question, and the source document being cited as authority for the proposed correction. Challenges are reviewed by Jeremiah Say. For general site enquiries unrelated to data or methodology, see the standard contact page.

§5 · Compliance Framework Alignment

GreenCalculus’s internal governance is modelled on principles drawn from two internationally recognised verification frameworks: ISO 14064-3 (the standard for verification and validation of GHG statements) and the GHG Protocol Corporate Standard. The principles below are not aspirational. They describe how the data layer, the editorial process, and the correction policy already operate today.

ISO 14064-3 Principles

Principle GreenCalculus implementation
Independence GreenCalculus has no commercial interest in any specific emissions outcome. It neither validates targets nor issues credits. See ISO 14064-1 for the related inventory standard.
Ethical conduct No emission factor or methodology on this platform has been influenced by any commercial relationship. The no-pay-to-rank policy is stated above in §3.
Fair presentation Where two valid methodological approaches exist — most visibly the AR5 versus AR6 GWP basis — both are disclosed and the calculator allows the practitioner to choose.
Due professional care Every value in the MasterBrain is traced to a specific cell in a named source workbook before publication, with cell-level traceability validated on every MasterBrain release. No factor is published on best-guess or industry-consensus reasoning alone.

GHG Protocol Principles

Principle GreenCalculus implementation
Accuracy Cell-by-cell provenance tracing. Dual GWP basis disclosed in every calculator audit trail. Version stamps on every output, linked to the changelog.
Completeness Scope 1, 2, and Scope 3 coverage is provided per the GHG Protocol Corporate Standard and the Scope 3 Standard. FLAG emissions (agriculture, forestry, and other land use) are covered per the 2026 GHG Protocol Land Sector and Removals Standard — see the FLAG emissions calculator as evidence of this coverage.
Consistency All calculators within the same scope use the same MasterBrain data version at any given time. Cross-scope comparisons within a single reporting boundary use a consistent GWP basis.
Relevance Emission factors are sourced from the jurisdiction-specific Tier-1 body: DEFRA for the United Kingdom, US EPA for the United States, IEA for grid factors, IPCC for global warming potentials.
Transparency Methodology pages explain every calculation step. Factors are published openly at the DEFRA factor archive and the IPCC AR6 GWP reference. The changelog records every change. CSRD ESRS E1 reporting frameworks — see the ESRS E1 standards page — explicitly require these GHG Protocol principles for in-scope EU undertakings.

§6 · Citing GreenCalculus

Every published calculator and methodology page exposes the live MasterBrain version stamp at the bottom of the page. Cite that stamp in any disclosure (CDP, SECR, CSRD/ESRS, internal audit) so the reader can reproduce the exact calculation.

The homepage provides three ready-to-copy formats:

  • ISO 690 — EU compliance default, recommended for CSRD/ESRS reports.
  • APA 7 — corporate sustainability academia.
  • Vancouver — life-cycle assessment and science journals.

If your house style requires a different format, three principles let you build it:

  1. Always include the MasterBrain version (e.g. v2025.55). The version stamp pins the exact data layer the calculation ran against, even after subsequent updates.
  2. Always include the access date. Combined with the version stamp, this gives a reproducible audit trail for any output.
  3. Always include the URL — root-relative or absolute. Each calculator and methodology page is a stable permalink.

Errata and corrections to past versions are documented in the public changelog and follow our Correction and Feedback Policy above — superseded factors remain queryable indefinitely so historical reports stay reproducible without needing to rerun any calculation.

§7 · Current Data Version Status

The table below shows the edition of each Tier-1 source currently loaded in the MasterBrain, and the date that edition was retrieved from its publisher. Retrieval dates are recorded in the data itself — each is the source.retrieved field on the rows drawn from that publication, not an editorial assertion about them. The review column states a cadence rather than a date, because a fixed date on this table becomes an accusation the moment it passes.

Data source Edition loaded Retrieved Review cadence
IPCC GWP values AR6 (2021) 1 Sep 2025 On AR7 publication (~2028)
DEFRA UK conversion factors 2026 18 Jun 2026 Annual, each June
IEA grid emission factors Global Energy Review 2026 30 Apr 2026 Annual
MasterBrain data layer v2026.203 22 Sep 2026 On every source update

§8 · Frequently Asked Questions

Every Tier-1 source release — IPCC, DEFRA/DESNZ and IEA — reaches the data layer within 30 calendar days of publication. The most recent test was the DEFRA 2026 release: DESNZ published in June 2026 and the refresh landed on 18 June 2026, moving 1,458 rows onto the new edition. Each source’s currently loaded edition and its retrieval date are listed in §7.

Every canonical row carries a source object naming the publication, the exact worksheet-and-cell reference, and the date it was retrieved. Open the publisher’s workbook at that cell and the number should match. Multi-gas factors carry a separate cell reference for each of their CO₂, CH₄ and N₂O components. The live exhibit in §1 shows a real row, read from the data layer as this page is served. The corpus is also queryable at GET /wp-json/greencalculus/v1/factors without an API key.

Six steps, without exception: verify against the primary source, stage the correction, write the public changelog entry stating both the old and new values, credit the practitioner who reported it, bump the version and review date, and preserve the superseded value in the archive. The changelog entry is written before the corrected page is republished. There are no silent fixes — see §4 for the process and a worked example.

Yes for a single factor. Superseded values are never overwritten; they are version-stamped at supersession and retained. GET https://api.greencalculus.com/v1/factors/<key>?as_of=<version> resolves a key as it stood at a past MasterBrain version and requires an API key. Cite the MasterBrain version stamp shown on every calculator and methodology page, and that stamp is what pins the data your figure was produced against.

No. AI tools are never used to determine an emission factor, write methodology logic, select a GWP value, or produce any number that appears in a published calculator. They may assist with formatting markup, scaffolding code structure, and suggesting candidate internal links. Every methodological decision and every published number is taken from a primary source document by a named person. See §2.

No. The factors published here are those issued by the relevant Tier-1 body — DEFRA for the United Kingdom, US EPA for the United States, IEA and Ember for grid intensity, IPCC for global warming potentials. No commercial relationship influences the data layer or the methodology documentation. GreenCalculus is not a target-setting body, not a verification or certification body, and not a consultancy. See §3.

Include three things: the MasterBrain version stamp shown on the page, the access date, and the URL. Together they pin the exact data layer the figure was produced against, so the calculation stays reproducible after later updates. Ready-to-copy ISO 690, APA 7 and Vancouver forms are given in §6.

GreenCalculus is an independent technical resource. Calculations and methodology documentation on this site are provided for informational purposes. They do not constitute professional advice. For regulatory compliance decisions, consult a qualified GHG accounting professional.

Scroll to Top