Skip to content
Go to file

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

The Global Carbon Budget is an annual living data publication of carbon cycle sources and sinks, generated from multiple data sources and by multiple organisations and research groups.

This Data Package makes the data from the 2019 Global Carbon Budget and National Emissions Excel files v1.0 available as CSV files. For updates of the original data and further information refer to the Global Carbon Budget website.

Maintainer of this Data Package is Robert Gieseke ( See below for license information


Global Carbon Budget

Notes and Methods


Fossil fuel and cement production emissions by fuel type

Notes and Methods



Land-use change emissions

Notes and Model References


Ocean CO2 sink (positive values represent a flux from the atmosphere to the ocean)

Notes and Model References


Terrestrial CO2 sink (positive values represent a flux from the atmosphere to the land)

Notes and Model References


Historical CO2 budget

Notes and References


Territorial Emissions

Notes and Methods


Consumption Emissions GCB

Notes and Methods


Emissions Transfers GCB

Notes and Methods


Country Definitions

Details of the geographical information corresponding to countries and regions used in this database for Consumption and Transfer emissions



To update or regenerate the CSV files the following steps need to be run:

make clean

To validate the Data Package:

make validate


The Global Carbon Budget data is written to CSV files using the accuracy used for display in the original Excel, or one digit more files assuming this to be the implied precision.

The National Emissions are written to CSV files with three significant digits as this is the accuracy used for the CDIAC data in the Excel file, thus rounding the numbers derived from splitting up countries or using trend data as with BP emissions data.

If other accuracy is needed adjust the processing scripts accordingly.


The Global Carbon Budget data page states:

The use of data is conditional on citing the original data sources. Full details on how to cite the data are given at the top of each page. For research projects, if the data are essential to the work, or if an important result or conclusion depends on the data, co-authorship may need to be considered. The Global Carbon Project facilitates access to data to encourage its use and promote a good understanding of the carbon cycle. Respecting original data sources is key to help secure the support of data providers to enhance, maintain and update valuable data.

The primary reference for the full Global Carbon Budget 2019 is:

Global Carbon Budget 2019, by Pierre Friedlingstein, Matthew W. Jones, Michael O’Sullivan, Robbie M. Andrew, Judith Hauck, Glen P. Peters, Wouter Peters, Julia Pongratz, Stephen Sitch, Corinne Le Quéré, Dorothee C. E. Bakker, Josep G. Canadell, Philippe Ciais, Rob Jackson, Peter Anthoni, Leticia Barbero, Ana Bastos, Vladislav Bastrikov, Meike Becker, Laurent Bopp, Erik Buitenhuis, Naveen Chandra, Frédéric Chevallier, Louise P. Chini, Kim I. Currie, Richard A. Feely, Marion Gehlen, Dennis Gilfillan, Thanos Gkritzalis, Daniel S. Goll, Nicolas Gruber, Sören Gutekunst, Ian Harris, Vanessa Haverd, Richard A. Houghton, George Hurtt, Tatiana Ilyina, Atul K. Jain, Emilie Joetzjer, Jed O. Kaplan, Etsushi Kato, Kees Klein Goldewijk, Jan Ivar Korsbakken, Peter Landschützer, Siv K. Lauvset, Nathalie Lefèvre, Andrew Lenton, Sebastian Lienert, Danica Lombardozzi, Gregg Marland, Patrick C. McGuire, Joe R. Melton, Nicolas Metzl, David R. Munro, Julia E. M. S. Nabel, Shin-Ichiro Nakaoka, Craig Neill, Abdirahman M. Omar, Tsuneo Ono, Anna Peregon, Denis Pierrot, Benjamin Poulter, Gregor Rehder, Laure Resplandy, Eddy Robertson, Christian Rödenbeck, Roland Séférian, Jörg Schwinger, Naomi Smith, Pieter P. Tans, Hanqin Tian, Bronte Tilbrook, Francesco N Tubiello, Guido R. van der Werf, Andrew J. Wiltshire, and Sönke Zaehle (2019), Earth System Science Data, 11, 1783-1838, 2019,

Otherwise please refer as:

Global Carbon Project. (2019). Supplemental data of Global Carbon Budget 2019 (Version 1.0) [Data set]. Global Carbon Project.


Global Carbon Project (2019) Carbon budget and trends 2019. <> published on 4 December 2019, along with any other original peer-reviewed papers and data sources as appropriate.

See also the Global Carbon Budget Publications page.

The source code in scripts and the metadata in this Data Package itself are released under a CC0 Public Dedication License.


Global Carbon Budget Data Package



You can’t perform that action at this time.