.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.3.
.TH ECLIPSE "1" "December 2022" "Eclipse SUMO emissionsDrivingCycle Version 1.15.0" "User Commands"
.SH NAME
Eclipse \- Computes emissions by driving a time line using SUMO's emission models
.SH SYNOPSIS
.B emissionsDrivingCycle
[\fI\,OPTION\/\fR]\fI\,*\/\fR
.SH DESCRIPTION
Eclipse SUMO emissionsDrivingCycle Version 1.15.0
.IP
Copyright (C) 2001\-2022 German Aerospace Center (DLR) and others; https://sumo.dlr.de
.PP
Computes emissions by driving a time line using SUMO's emission models.
.SS "Configuration Options:"
.TP
\fB\-c\fR, \fB\-\-configuration\-file\fR FILE
Loads the named config on startup
.TP
\fB\-C\fR, \fB\-\-save\-configuration\fR FILE
Saves current configuration into FILE
.TP
\fB\-\-save\-configuration\fR.relative
Enforce relative paths when saving the
configuration
.TP
\fB\-\-save\-template\fR FILE
Saves a configuration template (empty) into
FILE
.TP
\fB\-\-save\-schema\fR FILE
Saves the configuration schema into FILE
.TP
\fB\-\-save\-commented\fR
Adds comments to saved template,
configuration, or schema
.SS "Input Options:"
.TP
\fB\-t\fR, \fB\-\-timeline\-file\fR FILE
Defines the file to read the driving cycle
from.
.TP
\fB\-\-timeline\-file\fR.skip INT
Skips the firs NUM lines.
.TP
\fB\-\-timeline\-file\fR.separator STR
Defines the entry separator.
.TP
\fB\-n\fR, \fB\-\-netstate\-file\fR FILE
Defines the netstate, route and trajectory
files to read the driving cycles from.
.TP
\fB\-\-additional\-files\fR FILE
Load emission parameters (vTypes) from
FILE(s)
.TP
\fB\-e\fR, \fB\-\-emission\-class\fR STR
Defines for which emission class the
emissions shall be generated.
.TP
\fB\-\-vtype\fR STR
Defines the vehicle type to use for emission
parameters.
.SS "Processing Options:"
.TP
\fB\-a\fR, \fB\-\-compute\-a\fR
If set, the acceleration is computed instead
of being read from the file.
.TP
\fB\-\-compute\-a\fR.forward
If set, the acceleration for time t is
computed from v(t+1) \- v(t) instead of v(t)
\- v(t\-1).
.TP
\fB\-\-compute\-a\fR.zero\-correction
If set, the acceleration for time t is set
to 0 if the speed is 0.
.TP
\fB\-s\fR, \fB\-\-skip\-first\fR
If set, the first line of the read file is
skipped.
.TP
\fB\-\-kmh\fR
If set, the given speed is interpreted as
being given in km/h.
.TP
\fB\-\-have\-slope\fR
If set, the fourth column is read and used
as slope (in deg).
.TP
\fB\-\-slope\fR FLOAT
Sets a global slope (in deg) that is used if
the file does not contain slope information.
.TP
\fB\-\-begin\fR TIME
Defines the begin time in seconds;
.TP
\fB\-\-end\fR TIME
Defines the end time in seconds;
.SS "Output Options:"
.TP
\fB\-o\fR, \fB\-\-output\fR STR
Defines the file to write the emission cycle
results into.
.TP
\fB\-\-output\fR.attributes STR[]
Defines the attributes to write.
.TP
\fB\-\-emission\-output\fR FILE
Save the emission values of each vehicle in
XML
.TP
\fB\-\-sum\-output\fR FILE
Save the aggregated and normed emission
values of each vehicle in CSV
.TP
\fB\-\-write\-license\fR
Include license info into every output file
.TP
\fB\-\-output\-prefix\fR STR
Prefix which is applied to all output files.
The special string 'TIME' is replaced by the
current time.
.TP
\fB\-\-precision\fR INT
Defines the number of digits after the comma
for floating point output
.TP
\fB\-\-precision\fR.geo INT
Defines the number of digits after the comma
for lon,lat output
.TP
\fB\-H\fR, \fB\-\-human\-readable\-time\fR
Write time values as hour:minute:second or
day:hour:minute:second rather than seconds
.SS "Emissions Options:"
.TP
\fB\-\-emissions\fR.volumetric\-fuel
Return fuel consumption values in (legacy)
unit l instead of mg
.TP
\fB\-\-phemlight\-path\fR FILE
Determines where to load PHEMlight
definitions from
.TP
\fB\-\-phemlight\-year\fR INT
Enable fleet age modelling with the given
reference year in PHEMlight5
.TP
\fB\-\-phemlight\-temperature\fR FLOAT
Set ambient temperature to correct NOx
emissions in PHEMlight5
.SS "Report Options:"
.TP
\fB\-v\fR, \fB\-\-verbose\fR
Switches to verbose output
.TP
\fB\-\-print\-options\fR
Prints option values before processing
.TP
\-?, \fB\-\-help\fR
Prints this screen or selected topics
.TP
\fB\-V\fR, \fB\-\-version\fR
Prints the current version
.TP
\fB\-X\fR, \fB\-\-xml\-validation\fR STR
Set schema validation scheme of XML inputs
("never", "local", "auto" or "always")
.TP
\fB\-W\fR, \fB\-\-no\-warnings\fR
Disables output of warnings
.TP
\fB\-\-aggregate\-warnings\fR INT
Aggregate warnings of the same type whenever
more than INT occur
.TP
\fB\-l\fR, \fB\-\-log\fR FILE
Writes all messages to FILE (implies
verbose)
.TP
\fB\-\-message\-log\fR FILE
Writes all non\-error messages to FILE
(implies verbose)
.TP
\fB\-\-error\-log\fR FILE
Writes all warnings and errors to FILE
.TP
\fB\-q\fR, \fB\-\-quiet\fR
Not writing anything.
.SH "REPORTING BUGS"
Report bugs at <https://github.com/eclipse/sumo/issues>.
.br
Get in contact via <sumo@dlr.de>.
.IP
.br
Build features: Linux\-5.10.0\-19\-amd64 x86_64 GNU 12.2.0 None FMI Proj GUI Intl SWIG GDAL FFmpeg OSG GL2PS Eigen
.br
Copyright (C) 2001\-2022 German Aerospace Center (DLR) and others; https://sumo.dlr.de
.PP
.br
Eclipse SUMO emissionsDrivingCycle Version 1.15.0 is part of SUMO.
.br
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
.br
This program may also be made available under the following Secondary
.br
Licenses when the conditions for such availability set forth in the Eclipse
.br
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
.br
SPDX\-License\-Identifier: EPL\-2.0 OR GPL\-2.0\-or\-later