_images/CO2MPAS_banner.svg

CO2MPAS: Vehicle simulator predicting NEDC CO2 emissions from WLTP

official:
AIO-1.7.X: from 31-Oct-2017 to 15-Nov-2018
AIO-2.0.X: from 24-Sept-2018
version:

2.0.0.post0

rel_date:

2018-09-01T09:52:12.980217

home:

http://co2mpas.io/

repository:

https://github.com/JRCSTU/CO2MPAS-TA

pypi-repo:

https://pypi.org/project/co2mpas/

keywords:

CO2, fuel-consumption, WLTP, NEDC, vehicle, automotive, EU, JRC, IET, STU, correlation, back-translation, policy, monitoring, M1, N1, simulator, engineering, scientific

developers:
copyright:

2015-2018 European Commission (JRC)

license:

EUPL 1.1+

CO2MPAS is backward-looking longitudinal-dynamics CO2 and fuel-consumption simulator for light-duty M1 & N1 vehicles (cars and vans), specially crafted to estimate the CO2 emissions of vehicles undergoing NEDC testing based on the emissions produced WLTP testing during type-approval, according to the EU legislations 1152/EUR/2017 and 1153/EUR/2017 (see History section, below).

It is an open-source project(EUPL 1.1+) developed for Python-3.6+ using WinPython & Anaconda under Windows 7, Anaconda under MacOS, and standard python environment & Anaconda under Linux. It runs either as a console command or as a desktop GUI application, and it uses Excel-files or pure python structures (dictionary and lists) for its input & output data.

Quick Start

Attention

Installing and using ALLINONE is the official procedure for running CO2MPAS for Type Approval (TA).

The quick-start below is just for evaluating the latest release.

You may find usage Guidelines in the wiki: https://github.com/JRCSTU/CO2MPAS-TA/wiki/CO2MPAS-user-guidelines

IF you are familiar with Python, AND IF you already have a full-blown python-3 environment (i.e. Linux or the ALLINONE archive), AND IF you have familiarity with previous releases, THEN you can immediately start working with the following bash commands; otherwise follow the detailed instructions under sections co2mpas-install and co2mpas-usage.

## Install co2mpas:
$ pip uninstall co2mpas
$ pip install co2mpas

## Create a template excel-file for inputs:
$ co2mpas template vehicle_1.xlsx

###################################################
## Edit generated `./input/vehicle_1.xlsx` file. ##
###################################################

## Launch GUI, select the edited template as Input, and click `Run`:
$ co2gui

And the GUI pops up:

_images/CO2MPAS_GUI.png

Further command-line alternatives:

## To synchronize the Dyno and OBD data with the theoretical:
$ datasync template --cycle wltp.class3b template.xlsx
$ datasync -O ./output times velocities template.xlsx#ref! dyno obd -i alternator_currents=integral -i battery_currents=integral

## Run batch simulator.
$ co2mpas batch vehicle_1.xlsx -O output -f

###################################################
## Inspect generated results inside `./output/`. ##
###################################################

## Run type approval command.
$ co2mpas ta vehicle_1.xlsx -O output -f

## Start using the DICE command-line tool:
$ co2dice --help

History

The European Commission has introduced the WLTP as test procedure for the type I test of the European type-approval of Light-duty vehicles as of September 2017. Its introduction has required the adaptation of CO2 certification and monitoring procedures set by European regulations (443/2009, 510/2011, 1152/EUR/2017 and 1153/EUR/2017). European Commission’s Joint Research Centre (JRC) has been assigned the development of this vehicle simulator to facilitate this adaptation.

The European Regulation setting the conditions for using CO2MPAS can be found in the Comitology Register after its adoption by the Climate Change Committee which took place on June 23, 2016 and its 2nd vote for modifications, on April 27, 2017.

For recent activity, check the Changes.

Licensing

The European Commission (JRC) compiles and distributes 2 “packages”:

  1. the CO2MPAS python package,
  2. the ALLINONE archive (AIO).

CO2MPAS’s package licensing terms

Commission is the exclusive copyright holder of the first CO2MPAS package, and have set its licensing terms to the “copylefted” as EUPL, so it will remain for ever free.

EUPL license compatibility

EUPL is “eventually” compatible with all major open-source licenses, whether “permissive”[1] or “copylefted”[2], but usually EUPL must be applied on the resulting combination (one certain exception is the GPL family of licenses, where GPL takes precedence).

The ALLINONE archive contains many python libraries installed in its standard python -folder, (co2mpas_ALLINONE-XXX\Apps\WinPython\python-YYY.amd64\Lib\) so CO2MPAS only “links dynamically” to them. plus those manually installed by JRC when installing CO2MPAS in ALLINONE. We are certain that all of them are open-source and can be freely re-distributed.

ALLINONE archive’s licensing terms

The ALLINONE is a “fat” archive (~1.4GB when inflated) containing a myriad of 3rd-party applications and python packages (e.g. see folder co2mpas_ALLINONE-XXX\Apps\WinPython\python-YYY.amd64\Lib\). These applications comprise the ecosystem needed to launch CO2MPAS for official purposes. Different licenses apply to each application in ALLINONE, but have all been checked to be free for redistribution, with “permissive”[1] or “copylefted”[2] licenses.

A non-exhaustive list of python-libraries contained is listed in WinPython site

The ALLINONE contains also the MS redistributable (Apps/vc_redist.x64.exe file) which is explicitly exempted from the usual restrictive MS Licenses.

Licensing terms for other material

All the logo and graphic work is our own, but without having registered for trademark; we are discouraged by the EU guidelines on the subject; subsequently we discourage their use without our consent, beyond their intended usage, which is to run CO2MPAS.

[1](1, 2) https://en.wikipedia.org/wiki/Permissive_software_licence
[2](1, 2) https://en.wikipedia.org/wiki/Copyleft

Table of Contents

Indices and tables