This is the source code repository for the Ecosystem Climate Regulation Services Calculator. Contributions, comments, bug reports, and feature requests are welcome!
This project uses Docker to manage dependencies.
-
Install Docker Community Edition for your OS
-
Clone the rails application:
git clone git@github.com:rubyforgood/ghgvc.git --depth 1 && cd ghgvc
Ensure Docker is running, the ghgvc app is cloned, and you've navigated to your ghgvc repo.
-
Build Docker:
docker-compose build
-
Download the required netcdf files
docker-compose run --rm ghgvcr ./download-netcdf.sh
This stores the netcdf data in a volume that will persist across containers
-
Bundle install:
docker-compose run --rm app bundle
This stores the downloaded gems in a volume that will persist across containers
-
Run the application:
docker-compose up app
-
Navigate to http://localhost:3000/ in your web browser.
- If clicking on the map does not return ecosystems, ensure that data was downloaded:
docker-compose run --rm ghgvcr bash
cd data
ls
- This should show a file
name_indexed_ecosystems.json
, and two directories:maps
andnetcdf
. If it is empty, try:
docker-compose down # stop everything
docker-compose up get_data # should re-download & un-zip the data
- If there is still an issue, try:
docker-compose down # stop everything
docker-compose volume rm ghgvc_netcdf-data # removes the volume
docker-compose up get_data # should re-download & un-zip the data
ghgvc_netcdf-data
name should be the name of the volume. If that command fails, trydocker volume ls
and look for one that matches on the netcdf-data- If all of the above fails (if you can't force it to stop with docker-compose or docker commands), try restarting either docker or your machine (sometimes both; it usually means the container was put into a state that it shouldn't be).
- Enter the Rails console:
docker-compose run --rm app bin/rails c
- Run all tests:
docker-compose run --rm app rspec
- Run a singular test:
docker-compose run --rm app rspec spec/<test file path>
Ecosystems regulate climate through both greenhouse-gas exchange with
the atmosphere (biogeochemical mechanisms) and regulation of land
surface energy and water balances (biophysical mechanisms). The exchange
of carbon dioxide (CO2) and other greenhouse gases (N2O, CH4)
between ecosystems and the atmosphere influences climate. For example,
forests remove CO2 from the atmosphere as they grow, croplands release
the potent greenhouse gas N2O as a byproduct of fertilization, and
deforestation releases large amounts of CO2 and other greenhouse
gasses to the atmosphere. Beyond this, ecosystems also influence climate
through absorption of incoming solar radiation (dependent upon their
reflectivity, or albedo) and the transfer of heat by evaporation
(latent heat flux-a process analogous to sweating). Efforts aimed at
climate change mitigation through land management quantify greenhouse
gas exchange, but do not account for the biophysical exchanges, which in
some cases can be quite significant.
Recently, researchers proposed an integrated index of the climate
regulation value (CRV) of terrestrial ecosystems (Anderson-Teixeira et
al., 2012a; Hungate & Hampton, 2012), which combines a previous metric
of the greenhouse gas value of ecosystems (GHGV; Anderson-Teixeira &
DeLucia, 2011) with biophysical climate regulation services to show the
climate regulation services of ecosystems in CO2 equivalents - a
common currency for carbon accounting. This is the most comprehensive
existing metric of ecosystem climate regulation services, and it sets
the stage for thorough accounting of climate regulation services in
initiatives aimed at climate protection through land management
(Anderson-Teixeira et al., 2011; Hungate & Hampton, 2012).
The CRV calculator is a publically available web-based tool for estimating CRV (or GHGV) for ecosystems globally. It uses global maps of climatically significant ecosystem properties (for example, biomass, soil carbon, biophysical services) to provide location-specific CRV estimates.
The Ecosystem Climate Regulation Services Calculator has potential applications in a variety of fields. Below are some examples.
This calculator can be used to determine which areas of potential conservation interest are the most beneficial in terms of their net effect on the climate. This information can then be used to help make land conservation decisions and inform the general public about the climate benefits of conserving lands.
The calculator can be used to evaluate the climate consequences of various land use decisions. For instance, the calculator can be used to evaluate the impacts of various bioenergy production strategies (Anderson-Teixeira et al., 2012b; Buckeridge et al., 2012). It could also be used in determining the value of land when designing infrastructure projects, such as dams or highways.
The calculator can be used to educate students or the general public about the climate regulation services of ecosystems around the globe. For example, by using the calculator to research ecosystems in areas where land use change is occurring, students will gain a greater understanding of the issues surrounding land use and conservation decisions. They can also use the calculator to learn more about the local ecosystems with which they are familiar.
Increasing public interest in sustainable business practices creates a need for conscientious businesses to evaluate the climate impact of business decisions, including those that affect land use patterns. For example, the calculator might be used to evaluate the climate impacts of land use change related to bioenergy production.
Policy decisions regarding the conservation of domestic lands or those affecting international land use patterns can benefit from the most complete information possible regarding the impact of those decisions on climate. Policies aimed at climate protection through land management, including REDD+ and bioenergy sustainability standards, account for greenhouse gasses but not for biophysical processes that can sometimes outweigh greenhouse gas effects (Anderson-Teixeira et al., 2011, 2012a). This calculator incorporates both greenhouse gases and biophysical climate regulation services, thereby providing a better understanding of the climate impacts of various policies.
Anderson-Teixeira KJ, Snyder PK, DeLucia EH (2011) Do biofuels life cycle analyses accurately quantify the climate impacts of biofuels-related land use change? Illinois Law Review, 2011, 589-622.
Anderson-Teixeira KJ, Snyder PK, Twine TE, Cuadra SV, Costa MH, DeLucia EH (2012a) Climate-regulation services of natural and agricultural ecoregions of the Americas. Nature Climate Change, 2, 177-181.
Anderson-Teixeira KJ, Duval BD, Long SP, DeLucia EH (2012b) Biofuels on the landscape: Is land sharing? preferable to land sparing? Ecological Applications, 22, 2035-2048.
Anderson-Teixeira KJ, DeLucia EH (2011) The greenhouse gas value of ecosystems. Global Change Biology, 17, 425-438.
Buckeridge MS, Souza AP, Arundale RA, Anderson-Teixeira KJ, DeLucia E (2012) Ethanol from sugarcane in Brazil: a "midway"? strategy for increasing ethanol production while maximizing environmental benefits. GCB Bioenergy, 4, 119-126.
Hungate BA, Hampton HM (2012) Ecosystem services: Valuing ecosystems for climate. Nature Climate Change, 2, 151-152.