PyEmission

PyEmission is a Python library for estimating vehicular emissions and fuel consumption. This tool covers a range of light-duty motor vehicles including motorcycles, passenger cars, passenger trucks and light commercial trucks. The tool takes second-by-second driving cycle and vehicle characteristics data and generates results of vehicular emissions (carbon dioxide, carbon monoxide, nitrogen oxide and hydrocarbon) and fuel consumption. This tool can estimate tailpipe and corresponding upstream (well-to-pump) emissions.

There are two distinct versions of this tool: (a) PyEmission library, which can be easily integrated into a python program; (b) PyEmission GUI, which provides a user-friendly interface equipped with functional capabilities similar to the original python library. Using the GUI requires no programming skills.

First, we calculated the tractive force required at wheels to propel a vehicle forward by overcoming different resistance forces including vehicle acceleration, hill climbing, rolling resistance, inertia and aerodynamic drag. Next, we calculated vehicle specific power (VSP), a convenient single measure of vehicle activity to model the relationship between the power demand per unit of vehicle mass and environmental emission. Finally, we calculated different types of tailpipe emissions and fuel consumption based on VSP. 

Detailed description of the model can be found in here​.

Following is the list of prerequisites to use the PyEmission library:

• Python >= 3.8
• Numpy >= 1.19.2
• Pandas >= 1.1.3
• Matplotlib >= 3.3.2

This Python library has been licensed under Apache License 2.0. To learn more about the terms and conditions for use, reproduction, and distribution, please read the LICENSE.txt file available in the Model files section.

 Please download the user manual here.

This computer software was prepared by Battelle Energy Alliance, LLC, hereinafter the Contractor, under Contract No. AC07-05ID14517 with the United States (U. S.) Department of Energy (DOE). The Government is granted for itself and others acting on its behalf a nonexclusive, paid-up, irrevocable worldwide license in this data to reproduce, prepare derivative works, and perform publicly and display publicly, by or on behalf of the Government. There is a provision for the possible extension of the term of this license. Subsequent to that period or any extension granted, the Government is granted for itself and others acting on its behalf a nonexclusive, paid-up, irrevocable worldwide license in this data to reproduce, prepare derivative works, distribute copies to the public, perform publicly and display publicly, and to permit others to do so. The specific term of the license can be identified by inquiry made to Contractor or DOE. Neither the United States nor the United States Department of Energy, nor contractor makes any warranty, express or implied, or assumes any liability or responsibility for the use, accuracy, completeness, or usefulness or any information, apparatus, product, or process disclosed, or represents that its use would not infringe privately owned rights.