Catalog / Global Carbon Budget, Global Carbon Project (lead: University of Exeter / P. Friedlingstein et al.)

gcb

Global Carbon Budget, Global Carbon Project (lead: University of Exeter / P. Friedlingstein et al.)

Name: Global Carbon Budget, Global Carbon Project (lead: University of Exeter / P. Friedlingstein et al.)
Creator: Global Carbon Budget, Global Carbon Project
License: https://creativecommons.org/licenses/by/4.0/

Open · redistributedCreative Commons Attribution 4.0 (CC BY 4.0)Environment & Climate

Redistributable. This source is served as canonical Parquet under the license below, with attribution and provenance preserved.

Coverage

Series catalogued

3,092

Temporal coverage

1750-12-31 – 2024-12-31

Licensing & provenance

License: Creative Commons Attribution 4.0 (CC BY 4.0)
License URL: https://creativecommons.org/licenses/by/4.0/
Required attribution: Global Carbon Project (Global Carbon Budget)
Redistribution: Permitted (served here)
Commercial use: Yes
Modification: Permitted
Provider homepage: https://globalcarbonbudget.org/
Provider terms: https://essd.copernicus.org/articles/17/965/2025/

How to cite

Global Carbon Budget, Global Carbon Project (lead: University of Exeter / P. Friedlingstein et al.). Retrieved from https://globalcarbonbudget.org/. Compiled and redistributed by the Elkassabgi Data Library.

Processing: Retrieved from the official source, normalized to a long {series_key, obs_date, value} schema (period-start dates), de-duplicated, and stored as zstd Parquet. Compiled and redistributed by the Elkassabgi Data Library.

Access & mirrors

Download: Select & download gcb series as CSV →
API: Get a free API key, then GET /v1/series/<id>.csv
Canonical landing: https://econdatalibrary.com/gcb
Update cadence: annual
Automated refresh: live — this database is on the daily update run
Update strategy: overwrite if changed
Storage layout: multi-file under data/clean_full/gcb/: gcb_budget.parquet, gcb_national_fossil.parquet, gcb_luc.parquet, gcb_fossil_flat.parquet (all zstd). Common schema: series_key, obs_date(date32, Dec-31), value(float64). Each written by save() with a single pq.write_table (non-atomic).

Full description

Global Carbon Budget (GCB) 2024 ingest. Sources: Global Carbon Budget spreadsheet: https://globalcarbonbudget.org/download/1725/ National fossil CO2 emissions: https://globalcarbonbudget.org/download/1728/ National land-use change: https://globalcarbonbudget.org/download/1731/ GCP fossil flat CSV (Zenodo): https://zenodo.org/records/14106218 -> GCB2024v18_MtCO2_flat.csv Output: data/clean_full/gcb/gcb_budget.parquet data/clean_full/gcb/gcb_country.parquet Series key format: GCB:global:{var} – global budget aggregates (GtC/yr), 1959-2023 GCB:historical:{var} – historical budget (GtC/yr), 1750-2023 GCB:fossil_cat:{var} – global fossil by fuel category (MtC/yr), 1850-2023 GCB:ocean:{model} – ocean sink by model (GtC/yr) GCB:land:{model} – terrestrial sink by DGVM (GtC/yr) GCB:cement_carb:{model} – cement carbonation by model (GtC/yr) GCB:territorial:{country} – national territorial emissions (MtC/yr), 1850-2023 GCB:consumption:{country} – national consumption emissions (MtC/yr), 1990-2022 GCB:transfers:{country} – national emissions transfers (MtC/yr) GCB:luc_BLUE:{country} – LUC BLUE model by country (TgC/yr), 1850-2023 GCB:luc_HNC:{country} – LUC H&C2023 model by country GCB:luc_OSCAR:{country} – LUC OSCAR model by country GCB:luc_LUCE:{country} – LUC LUCE model by country GCB:fossil_flat:{country} – GCP flat CSV country fossil CO2 (MtCO2), redundant check Run: python jobs/ingest_gcb.py

Structured metadata

schema.org/Dataset (Google Dataset Search)

{
  "@context": "https://schema.org/",
  "@type": "Dataset",
  "name": "Global Carbon Budget, Global Carbon Project (lead: University of Exeter / P. Friedlingstein et al.)",
  "description": "Territorial fossil CO2 emissions; Flaring CO2 emissions. Global Carbon Budget, Global Carbon Project. 3,092 series, 1750–2024. Free download.",
  "url": "https://econdatalibrary.com/gcb",
  "identifier": "gcb",
  "isAccessibleForFree": true,
  "publisher": {
    "@type": "Organization",
    "name": "Econ Data Library",
    "url": "https://econdatalibrary.com"
  },
  "includedInDataCatalog": {
    "@type": "DataCatalog",
    "@id": "https://econdatalibrary.com/#catalog",
    "name": "Econ Data Library",
    "url": "https://econdatalibrary.com/catalog"
  },
  "creator": {
    "@type": "Organization",
    "name": "Global Carbon Budget, Global Carbon Project",
    "url": "https://globalcarbonbudget.org/"
  },
  "license": "https://creativecommons.org/licenses/by/4.0/",
  "keywords": [
    "Environment & Climate",
    "gcb"
  ],
  "temporalCoverage": "1750-12-31/2024-12-31",
  "creditText": "Global Carbon Project (Global Carbon Budget)",
  "citation": "Global Carbon Budget, Global Carbon Project (lead: University of Exeter / P. Friedlingstein et al.). Retrieved from https://globalcarbonbudget.org/. Compiled and redistributed by the Elkassabgi Data Library.",
  "sameAs": [
    "https://huggingface.co/datasets/econdatalibrary-gcb",
    "https://zenodo.org/communities/econdatalibrary"
  ],
  "distribution": [
    {
      "@type": "DataDownload",
      "name": "gcb — CSV",
      "encodingFormat": "text/csv",
      "contentUrl": "https://econdatalibrary.com/download.html?source=gcb",
      "license": "https://creativecommons.org/licenses/by/4.0/"
    }
  ]
}

Croissant (ML-ready, schema.org JSON-LD)

{
  "@context": {
    "@language": "en",
    "@vocab": "https://schema.org/",
    "cr": "http://mlcommons.org/croissant/",
    "data": {
      "@id": "cr:data",
      "@type": "@json"
    },
    "dataType": {
      "@id": "cr:dataType",
      "@type": "@vocab"
    },
    "sc": "https://schema.org/",
    "conformsTo": "dct:conformsTo",
    "dct": "http://purl.org/dc/terms/"
  },
  "@type": "sc:Dataset",
  "conformsTo": "http://mlcommons.org/croissant/1.0",
  "name": "gcb",
  "description": "Territorial fossil CO2 emissions; Flaring CO2 emissions. Global Carbon Budget, Global Carbon Project. 3,092 series, 1750–2024. Free download.",
  "url": "https://econdatalibrary.com/gcb",
  "creator": {
    "@type": "sc:Organization",
    "name": "Global Carbon Budget, Global Carbon Project",
    "url": "https://globalcarbonbudget.org/"
  },
  "publisher": {
    "@type": "sc:Organization",
    "name": "Econ Data Library",
    "url": "https://econdatalibrary.com"
  },
  "license": "https://creativecommons.org/licenses/by/4.0/",
  "keywords": [
    "Environment & Climate"
  ],
  "temporalCoverage": "1750-12-31/2024-12-31",
  "citation": "Global Carbon Budget, Global Carbon Project (lead: University of Exeter / P. Friedlingstein et al.). Retrieved from https://globalcarbonbudget.org/. Compiled and redistributed by the Elkassabgi Data Library.",
  "distribution": [
    {
      "@type": "cr:FileObject",
      "@id": "gcb-csv",
      "name": "gcb-csv",
      "description": "Per-series CSV, downloadable with a free API key.",
      "contentUrl": "https://econdatalibrary.com/download.html?source=gcb",
      "encodingFormat": "text/csv"
    }
  ]
}

Part of the Econ Data Library catalog · metadata generated 2026-08-02 from the central registry · browse all datasets