Global Carbon Budget Data Package
Python Makefile
Clone or download
Latest commit e6312b7 May 30, 2018

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 2017 Global Carbon Budget v1.3 and National Emissions Excel files v1.2 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 CDIAC

Notes and Methods


Territorial Emissions GCB

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:

Install requirements:

pip install -r scripts/requirements.txt

Run the script to generate CSV files:

python scripts/


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 script 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 2017 is:

Global Carbon Budget 2017, by Le Quéré, C., Andrew, R. M., Friedlingstein, P., Sitch, S., Pongratz, J., Manning, A. C., Korsbakken, J. I., Peters, G. P., Canadell, J. G., Jackson, R. B., Boden, T. A., Tans, P. P., Andrews, O. D., Arora, V. K., Bakker, D. C. E., Barbero, L., Becker, M., Betts, R. A., Bopp, L., Chevallier, F., Chini, L. P., Ciais, P., Cosca, C. E., Cross, J., Currie, K., Gasser, T., Harris, I., Hauck, J., Haverd, V., Houghton, R. A., Hunt, C. W., Hurtt, G., Ilyina, T., Jain, A. K., Kato, E., Kautz, M., Keeling, R. F., Klein Goldewijk, K., Körtzinger, A., Landschützer, P., Lefèvre, N., Lenton, A., Lienert, S., Lima, I., Lombardozzi, D., Metzl, N., Millero, F., Monteiro, P. M. S., Munro, D. R., Nabel, J. E. M. S., Nakaoka, S.-I., Nojiri, Y., Padin, X. A., Peregon, A., Pfeil, B., Pierrot, D., Poulter, B., Rehder, G., Reimer, J., Rödenbeck, C., Schwinger, J., Séférian, R., Skjelvan, I., Stocker, B. D., Tian, H., Tilbrook, B., Tubiello, F. N., van der Laan-Luijkx, I. T., van der Werf, G. R., van Heuven, S., Viovy, N., Vuichard, N., Walker, A. P., Watson, A. J., Wiltshire, A. J., Zaehle, S., and Zhu, D.: Global Carbon Budget 2017, Earth Syst. Sci. Data, 10, 405-448,, 2018.

Otherwise please refer as:

Global Carbon Project (2017) Carbon budget and trends 2017. published on 13 November 2017, 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 this data package itself are released under a CC0 Public Dedication License.