This section explains the functionalities of CO2MPAS GUI through some video tutorials:


This section shows the utilities to generate and populate the CO2MPAS input file.

Get input template

Check the video to see how to download an empty input excel-file. The generated file contains the instructions on how to fill the required inputs. For more information use the command co2mpas template -h or check the link.

Synchronize time-series

If you have time-series not well synchronized and/or with different sampling rates, the model might fail. As an aid tool, you may use the syncing tool to “synchronize” and “re-sample” your data. To use the tool you should execute the following steps:

  • Generate and download an empty input excel-file (see the video). For more information use the command co2mpas syncing template -h or check the link.


    All sheets must contain values for columns times and velocities because they are the reference signals used to synchronize the data with the theoretical velocity profile.

  • Run data synchronization, see the video. For more information use the command co2mpas syncing sync -h or check the link.


The synchronized signals are saved into the synced sheet.

Download demo files

CO2MPAS contains 4 demo-files that can be used as a starting point to try out:

  1. co2mpas_conventional.xlsx: conventional vehicle,

  2. co2mpas_simplan.xlsx: sample simulation plan,

  3. co2mpas_hybrid.xlsx: hybrid parallel vehicle,

  4. co2mpas_plugin.xlsx: hybrid plugin vehicle.

Check the video to see how to download them. For more information use the command co2mpas demo -h or check the link.


This section explains how to run CO2MPAS:

  1. Upload excel file/s (see previous video),

  2. click run:


5 advanced options are available: use only declaration mode, hard validation, enable selector, only summary, and use custom configuration file. Flag the box to activate them.

|co2mpas| advanced options
  1. Get the results (see the previous video).

Output files.

  • A CO2MPAS output per file, named as <timestamp>-<file-name>.xlsx.

  • A summary file like above.

Physical model configuration file

The configuration file (.yaml) is used to overwrite the default variables of the physical model.

Input file:

  • download the conf.yaml template from the GUI as shown in the image below.

|co2mpas| configuration file
  • modify it according to your parameters.

How to use it:

  • Upload a new configuration file as shown in the picture.

|co2mpas| configuration file
  • Flag the checkbox use custom configuration file under Advanced options.

|co2mpas| configuration file


  • the file will be rewritten every time you upload a new one, and it will always be named conf.yaml

Simulation plan

The simulation plan is an input file containing some extra parameters/sheets with a scope plan. (see data naming convention). It defines the list of variations (i.e., inputs to be overwritten) that have to be applied to a base dataset (i.e., a normal input file of CO2MPAS).

The simulation plan can save you time! It is able to calibrate the models just once and re-use them for other subsequent predictions, where only some inputs are different (e.g., times, velocities, vehicle_mass, etc.).

To run the simulation plan upload it as an input file, and run it as described in the previous section.

Output files

  • A CO2MPAS output per file like above.

  • A CO2MPAS output per variation, named as <timestamp>-<variation-id>-<file-name>.xlsx.

  • A summary file like above.

Model plot

This section shows the utility to investigate the CO2MPAS model. For more information check CO2MPAS Model and API Reference.