energyusage 0.0.3

Measuring the environmental impact of computation

energyusage

A Python package that measures the environmental impact of computation. Provides a function to evaluate the energy usage and related carbon emissions of another function. Emissions are calculated based on the user's location via the GeoJS API and that location's energy mix data (sources: US E.I.A and eGRID for the year 2016).

Installation

To install, simply $ pip install energyusage.

Usage

To evaluate the emissions of a function, just call energyusage.evaluate with the function name and the arguments it requires.

import energyusage

# user function to be evaluated
def recursive_fib(n):
    if (n <= 2): return 1
    else: return recursive_fib(n-1) + recursive_fib(n-2)

energyusage.evaluate(recursive_fib, 40, pdf=True)
# returns 102,334,155

It will return the value of your function, while also printing out the energy usage report on the command line. If the keyword argument pdf is set to True, then a PDF report will also be generated, alongside the command-line utility.

Energy Report

The report that will be printed out will look like the one below. The second and third lines will show a real-time reading that disappears once the process has finished evaluating.

Location:                                                           Pennsylvania
Baseline wattage:                                                     1.61 watts
Process wattage:                                                     17.27 watts
--------------------------------------------------------------------------------
-------------------------------  Final Readings  -------------------------------
--------------------------------------------------------------------------------
Average baseline wattage:                                             1.75 watts
Average total wattage:                                               19.18 watts
Average process wattage:                                             17.42 watts
Process duration:                                                        0:00:19
--------------------------------------------------------------------------------
-------------------------------   Energy Data    -------------------------------
--------------------------------------------------------------------------------
                           Energy mix in Pennsylvania                           
Coal:                                                                     25.40%
Oil:                                                                       0.20%
Natural Gas:                                                              31.60%
Low Carbon:                                                               42.50%
--------------------------------------------------------------------------------
-------------------------------    Emissions     -------------------------------
--------------------------------------------------------------------------------
Effective emission:                                              3.66e-05 kg CO2
Equivalent miles driven:                                          1.50e-11 miles
Equivalent minutes of 32-inch LCD TV watched:                   2.27e-02 minutes
Percentage of CO2 used in a US household/day:                          1.20e-11%
--------------------------------------------------------------------------------
------------------------- Assumed Carbon Equivalencies -------------------------
--------------------------------------------------------------------------------
Coal:                                                       0.3248635 kg CO2/kwh
Petroleum:                                                       0.23 kg CO2/kwh
Natural gas:                                                0.0885960 kg CO2/kwh

The report is divided into several sections.

• Final Readings: Presents an average of:

  • Average baseline wattage: your computer's average power usage minus the process, ran for 10 seconds before starting your process
  • Average total wattage: your computer's average power usage while the process runs
  • Average process usage: the difference between the baseline and total, highlighting the usage solely from the specific process you evaluated
  • Process duration: how long your program ran for

• Energy Data: The energy mix of the location.

• Emissions: The effective CO₂ emissions of running the program one time and some real-world equivalents to those emissions.

• Assumed Carbon Equivalencies: The formulas used to convert from kWh to CO₂ based on the energy mix of the location (for international locations, see below for more information).

The PDF report contains the same sections, but does not include the process duration.

Methodology

Power Measurement

CPU

We calculate CPU power usage via the RAPL (Running Average Power Limit) interfaces found on Intel processors. These are non-architectural model-specific registers that provide power-related information about the CPU. They are used primarily for limiting power consumption, but the Energy Status register (MSR_PKG_ENERGY_STATUS) allows for power measurement.

The RAPL interface differentiates between several domains, based on the number of processors. For a single processor machine:

• Package
• Power planes:
  • Core
  • Uncore
• DRAM

For a machine with multiple processors:

• Package 0
• Package 1
• ...
• Package n
• DRAM

Presently, we use the Package domain (or a sum of all of the domains, for a multi-processor machine), which represents the complete processor package.

As outlined by Vince Weaver, there are multiple ways to access the RAPL interface data, namely:

• Using perf_event interface
• Reading the underlying MSR
• Reading the files under /sys/class/powercap/intel-rapl/

We elected to use the final method because it is the only one that does not require sudo access. We read the energy_uj.txt files inside the package folder(s) intel-rapl:*. These files represent the energy used in microjoules, and they update roughly every millisecond. The value in the file increases to the point of overflow and then resets. We take 2 readings with a delay in-between, and then calculate the wattage based on the difference (energy) and the delay (time). To avoid errors due to the reset of the file, we discard negative values.

For more information on the RAPL interface, consult the Intel® 64 and IA-32 Architectures Software Developer's Manual.

GPU

To the package measurement we also add the power usage of the GPU for machines that have an Nvidia GPU that support the NVIDIA-smi program.

The NVIDIA-smi is a command-line utility that allows for the querying of information about the GPU. If the GPU is identified as valid, we use the built-in method to query the current wattage, and then convert the output into a float.

More information on NVIDIA-smi can be found on the Nvidia website.

Calculating CO₂ Emissions

Location

In order to accurately calculate the CO₂ emissions associated with the computational power used, we determine the geographical location of the user via their IP address with the help of the GeoJS API. If the location cannot be determined, we use the United States as the default.

Location is especially important as the emissions differ based on the country's (and, in the case of the United States, the state's) energy mix.

Energy Mix Information

We obtained international energy mix data from the U.S. Energy Information Administration data for the year 2016. Specifically, we looked at the energy consumption of countries worldwide, broken down by energy source. For the data points labeled (s) (meaning that the value is too small for the number of decimal places shown), we approximated those amounts to 0. No data was available for, and thus we removed from consideration, the following: Former Czechoslovakia, Former Serbia and Montenegro, Former U.S.S.R., Former Yugoslavia, Hawaiian Trade Zone, East Germany and West Germany.

Our United States energy mix and emissions data was obtained from the U.S. Environmental Protection Agency eGRID data for the year 2016. We used the State Resource Mix section for displaying the energy mix, and the State Output Emission Rates section for calculating emissions in the United States. We did not use the otherFossil data as the values were predominantly 0 (and in cases in which the value was nonzero, it was below 1%).

As of July 2019, the most recent eGRID data was from the year 2016. We elected to use 2016 U.S. E.I.A. data for consistency between the data sources.

Conversion to CO₂

Since the international data only contained an energy mix, and no emission data, we used formulas from the Environmental Protection Agency and volker-quaschning.de to convert from energy to CO₂ emitted based on which fossil fuel was used.

• EPA:
  • Coal: 21.11 mmbtu/metric ton coal × 26.05 kg C/mmbtu × 44 kg CO2/12 kg C × 90.89 metric tons coal/railcar × 1 metric ton/1,000 kg = 183.29 metric tons CO2/railcar
  • Natural gas: 0.1 mmbtu/1 therm × 14.46 kg C/mmbtu × 44 kg CO2/12 kg C × 1 metric ton/1,000 kg = 0.0053 metric tons CO2/therm
• volker-quaschning.de:
  • Petroleum: .23 kgCO2/kWh

Related Work

• In their paper Energy and Policy Considerations for Deep Learning in NLP, Strubell et. al not only analyze the computational power needed for training deep learning models in NLP, but further convert the data into carbon emissions and cost. Our tool aims to facilitate this analysis for developers in a single package. We do not consider cost, instead choosing to focus solely on the environmental impact. Further, we do not focus on a specific computational area. We also extend their analysis of carbon emissions by including international data on energy consumption and CO₂ emissions for localized analysis of the carbon footprint of the tested program.

Limitations

• Due to the methods in which the energy measurement is being done (through the Intel RAPL interface and NVIDIA-smi), our package is only available on Linux kernels that have the RAPL interface and/or machines with an Nvidia GPU.

• A country’s overall energy consumption mix is not necessarily representative of the mix of energy sources used to produce electricity (and even electricity production is not necessarily representative of electricity consumption due to imports/exports). However, the E.I.A. data is the most geographically comprehensive that we have found. We are working on obtaining even more accurate data.

Acknowledgements

We would like to thank Jon Wilson for all his valuable insight with regards to the environmental aspect of our project.