---
name: "emissionsMap"
section: "1"
platform: "linux"
package: "sumo"
version: "1.18.0+dfsg-4+b2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/emissionsMap"
---

# emissionsMap(1)

Builds and writes an emissions map for SUMO's emission models

## NAME

Eclipse - Builds and writes an emissions map for SUMO's emission models

## SYNOPSIS

**emissionsMap** \[*OPTION*\]*\**

## DESCRIPTION

Eclipse SUMO emissionsMap Version 1.18.0

-

  Copyright (C) 2001-2023 German Aerospace Center (DLR) and others; https://sumo.dlr.de

Builds and writes an emissions map for SUMO's emission models.

### Configuration Options:

- **-c**, **--configuration-file** FILE

  Loads the named config on startup

- **-C**, **--save-configuration** FILE

  Saves current configuration into FILE

- **--save-configuration**.relative

  Enforce relative paths when saving the configuration

- **--save-template** FILE

  Saves a configuration template (empty) into FILE

- **--save-schema** FILE

  Saves the configuration schema into FILE

- **--save-commented**

  Adds comments to saved template, configuration, or schema

### Processing Options:

- **-i**, **--iterate**

  If set, maps for all available emissions are written.

- **-e**, **--emission-class** STR

  Defines the name of the emission class to generate the map for.

- **--v-min** FLOAT

  Defines the minimum velocity boundary of the map to generate (in m/s).

- **--v-max** FLOAT

  Defines the maximum velocity boundary of the map to generate (in m/s).

- **--v-step** FLOAT

  Defines the velocity step size (in m/s).

- **--a-min** FLOAT

  Defines the minimum acceleration boundary of the map to generate (in m/s^2).

- **--a-max** FLOAT

  Defines the maximum acceleration boundary of the map to generate (in m/s^2).

- **--a-step** FLOAT

  Defines the acceleration step size (in m/s^2).

- **--s-min** FLOAT

  Defines the minimum slope boundary of the map to generate (in deg).

- **--s-max** FLOAT

  Defines the maximum slope boundary of the map to generate (in deg).

- **--s-step** FLOAT

  Defines the slope step size (in deg).

### Output Options:

- **-o**, **--output** STR

  Defines the file (or the path if **--iterate** was set) to write the map(s) into.

- **--write-license**

  Include license info into every output file

- **--output-prefix** STR

  Prefix which is applied to all output files. The special string 'TIME' is replaced by the current time.

- **--precision** INT

  Defines the number of digits after the comma for floating point output

- **--precision**.geo INT

  Defines the number of digits after the comma for lon,lat output

- **-H**, **--human-readable-time**

  Write time values as hour:minute:second or day:hour:minute:second rather than seconds

### Emissions Options:

- **--emissions**.volumetric-fuel

  Return fuel consumption values in (legacy) unit l instead of mg

- **--phemlight-path** FILE

  Determines where to load PHEMlight definitions from

- **--phemlight-year** INT

  Enable fleet age modelling with the given reference year in PHEMlight5

- **--phemlight-temperature** FLOAT

  Set ambient temperature to correct NOx emissions in PHEMlight5

### Report Options:

- **-v**, **--verbose**

  Switches to verbose output

- **--print-options**

  Prints option values before processing

- \-?, **--help**

  Prints this screen or selected topics

- **-V**, **--version**

  Prints the current version

- **-X**, **--xml-validation** STR

  Set schema validation scheme of XML inputs ("never", "local", "auto" or "always")

- **-W**, **--no-warnings**

  Disables output of warnings

- **--aggregate-warnings** INT

  Aggregate warnings of the same type whenever more than INT occur

- **-l**, **--log** FILE

  Writes all messages to FILE (implies verbose)

- **--message-log** FILE

  Writes all non-error messages to FILE (implies verbose)

- **--error-log** FILE

  Writes all warnings and errors to FILE

- **--language** STR

  Language to use in messages

## REPORTING BUGS

Report bugs at \<https://github.com/eclipse/sumo/issues\>.\
 Get in contact via \<sumo@dlr.de\>.

-

  Build features: Linux-6.1.0-28-amd64 x86\_64 GNU 14.2.0 None FMI Proj GUI Intl SWIG GDAL FFmpeg OSG GL2PS Eigen\
   Copyright (C) 2001-2023 German Aerospace Center (DLR) and others; https://sumo.dlr.de

Eclipse SUMO emissionsMap Version 1.18.0 is part of SUMO.\
 This program and the accompanying materials are made available under the terms of the Eclipse Public License v2.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v20.html\
 This program may also be made available under the following Secondary\
 Licenses when the conditions for such availability set forth in the Eclipse\
 Public License 2.0 are satisfied: GNU General Public License, version 2 or later which is available at https://www.gnu.org/licenses/old-licenses/gpl-2.0-standalone.html\
 SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-or-later