The deeper technical documentation

The Climate Equity Reference Calculator is implemented as a web applications, and as a supporting database.  There are also a number of spreadsheets implicated in parts of the analysis that we have not yet been able to integrate into the Calculator.   In general, the algorithms are largely implemented by the Calculator, but the results of the analysis depend in significant ways on the time-series indicators in the database. The treatment of GDP and emissions baselines are notable in this regard.

The database

The Calculator database features a large set of key, national-level, time-series indicators such as historic emissions, GDP, population, PPP and MER exchange rates, embodied carbon flows, and income distribution data.  These time-series indicators are taken from, or based upon, the most authoritative data available.

In all cases, the contents of the database are fully documented.  In some cases, this simply means that they are sourced.  In other cases – for example, national emissions baselines and global mitigation pathways – they are projected from or based upon authoritative, externally-sourced data.  In such cases, the algorithms by which they are projected are fully documented as well.

See The Climate Equity Reference Calculator database for more information.

Definition, sourcing, and updating of emissions baselines

The essential framework here is effort-sharing as opposed to a resource sharing. Thus, calculations of fair shares are sensitive to assumptions about baselines – assumptions about “business-as-usual,” or BAU, as projected into the future.  This is because effort-sharing approaches, by definition, allocate obligations in terms of reductions below a BAU situation in which no special climate-related efforts are being taken; i.e., a national emissions baseline.

What this means in practice is that a country’s actual mitigation obligation in any given year is relative to a projected baseline.  Two countries with the same Responsibility and Capacity Index (or RCI) and thus the same mitigation obligation would have different emission allocations in a given year – say 2020 – if they had different BAU emissions projections for that year.

See Definition, sourcing, and updating of the emissions baselines for more information.

The Equity Reference Calculator

Behind the Calculator‘s web interface is an “engine” written in the C programming language. The full code is available under a permissive Apache license and is documented in detail.

Working with the code

To check out the code from Sourceforge using Subversion, execute the following command:

  • svn co https://gdrs.svn.sourceforge.net/svnroot/gdrs/gdrsclib gdrs

The code is developed in NetBeans and can be loaded directly into NetBeans by pointing to the URL above. However, running the code requires a copy of the underlying SQLite3 database. Please contact us if you need a copy of the database.

The Web API

The Equity Reference Calculator can be accessed through a web application programming interface (API). This API is useful for web developers who wish to use the Calculator functionality but avoid the calculator interface itself.

The Web API Documentation is available as a PDF (150 kB).