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