Introduction

Generic parameters allow an arbitrary mapping of string keys to string values. They can be used for user-defined data storage but some key/value pairs also affect the simulation.

The following objects support the definition of custom parameters in their XML definitions:

• Edge
• Lane
• Person
• Vehicle
• Stop
• VehicleType
• PoI
• Polygon
• Route
• TrafficLight
• ChargingStation
• ParkingArea
• Calibrator
• Rerouter
• VariableSpeedSign

Parameters support the following functionality

• editing in netedit
• Supplying additional information to the user (via sumo-gui dialogs, text annotations or when inspecting XML files)
• reading and writing via TraCI.
• retaining custom information when saving and loading simulation state

XML Parameter Definition

Parameters are always defined as child elements of the respective object:

<vType id="t0" maxSpeed="12.3">
  <param key="last paint job" value="1959"/>
</vType>

<vehicle id="v0" route="route0" depart="0">
  <param key="answer to everything" value="42"/>
</vehicle>

Special parameters that affect behavior

Some parameters are special and affect (or reflect) simulation behavior in the following ways:

• setting up devices on a per-vehicle basis
• customizing the functionality of actuated traffic lights
• configuring vehicle types for use with the electric vehicle model
• tracking the public transport 'tripId' that may change at stops.
• setting transient junction model parameters
• customizing parking search traffic (cruising for parking) and charging station search
• customizing emission model PHEMlight5 parameters
• customizing emission behavior with respect to engine-shutoff
• configuring parameters of carFollowModel and laneChangeModel via TraCI
• retrieving parameters of carFollowModel and laneChangeModel via TraCI
• configuring device parameters via TraCI
• retrieving device parameters via TraCI (some devices have read-only parameters)
• modeling dynamic mass,length,shape and vClass when attaching trailers or railcars during simulation

Special parameters that affect visualization

Some parameters are special and affect how vehicles and other objects are drawn in sumo-gui:

• configuring the visualization of trains
• defining public transport stops that are sometimes invisible
• configuring the visualization of persons waiting at a busStop
• configuring seats, doors and optical scaling