Command 0xa3: Get Lane Variable#
Asks for the value of a certain variable of the named lane.
The following variable values can be retrieved, the type of the return value is also shown in the table.
|id list (0x00)||stringList||Returns a list of ids of all lanes within the scenario (the given Lane ID is ignored)||getIDList|
|count (0x01)||int||Returns the number of lanes within the scenario (the given Lane ID is ignored)||getIDCount|
|link number (0x30)||ubyte||Returns the number of links outgoing from this lane [#]||getLinkNumber|
|edge id (0x31)||string||Returns the id of the edge this lane belongs to||getEdgeID|
|links (0x33)||compound||Returns descriptions of the links outgoing from this lane [m]||getLinks|
|allowed vehicle classes (0x34)||stringList||Returns the mml-definitions of vehicle classes allowed on this lane||getAllowed|
|disallowed vehicle classes (0x35)||stringList||Returns the mml-definitions of vehicle classes not allowed on this lane||getDisallowed|
|length (0x44)||double||Returns the length of the named lane [m]||getLength|
|vmax (0x41)||double||Returns the maximum speed allowed on this lane [m/s]||getMaxSpeed|
|shape (0x4e)||shape||Returns this lane's shape||getShape|
|width (0x4d)||double||Returns the width of the named lane [m]||getWidth|
|CO2 emissions (id 0x60)||double||Sum of CO2 emissions on this lane in mg during this time step.||getCO2Emission|
|CO emissions (id 0x61)||double||Sum of CO emissions on this lane in mg during this time step.||getCOEmission|
|HC emissions (id 0x62)||double||Sum of HC emissions on this lane in mg during this time step.||getHCEmission|
|PMx emissions (id 0x63)||double||Sum of PMx emissions on this lane in mg during this time step.||getPMxEmission|
|NOx emissions (id 0x64)||double||Sum of NOx emissions on this lane in mg during this time step.||getNOxEmission|
|fuel consumption (id 0x65)||double||Sum of fuel consumption on this lane in ml during this time step.||getFuelConsumption|
|noise emission (id 0x66)||double||Sum of noise generated on this lane in dBA.||getNoiseEmission|
|electricity consumption (id 0x71)||double||Sum of electricity consumption on this lane in kWh during this time step.||getElectricityConsumption|
|last step vehicle number (0x10)||int||The number of vehicles on this lane within the last time step.||getLastStepVehicleNumber|
|last step mean speed (0x11)||double||Returns the mean speed of vehicles that were on this lane within the last simulation step [m/s]||getLastStepMeanSpeed|
|last step vehicle ids (0x12)||stringList||Returns the list of ids of vehicles that were on this lane in the last simulation step||getLastStepVehicleIDs|
|last step occupancy (0x13)||double||Returns the total lengths of vehicles on this lane during the last simulation step divided by the length of this lane||getLastStepOccupancy|
|last step mean vehicle length (0x15)||double||The mean length of vehicles which were on this lane in the last step [m]||getLastStepLength|
|waiting time (0x7a)||double||Returns the waiting time for all vehicles on the lane [s]||getWaitingTime|
|traveltime (0x5a)||double||Returns the estimated travel time for the last time step on the given lane [s]||getTraveltime|
|last step halting number (0x14)||int||Returns the total number of halting vehicles for the last time step on the given lane. A speed of less than 0.1 m/s is considered a halt.||getLastStepHaltingNumber|
Response 0xb3: Lane Variable#
|Variable||Lane ID||Return type of the variable||<VARIABLE_VALUE>|
The respond to a "Command Get Lane Variable".
command links 0x33 compound response value#
If you request the list of links, an compound object is returned, structured as following. Attention, each part is forwarded by a byte which represents its data type, except "length".
|integer||type + integer||link||...||link|
|Length||Number of links||Link 1||...||Link n|
where length is the total number of following elements -- counting each element of link separately -- and link is described by:
|type + string||type + string||type + ubyte||type + ubyte||type + ubyte||type + string||type + string||type + double|
|consecutive not internal lane||consecutive internal lane||has priority (=1) or not (=0)||is opened (=1) or not (=0)||has approaching foe (=1) or not (=0)||(current) state||direction||length [m] - only valid if not using internal lanes|
Please note that the information "is opened" and "has approaching foe" currently refer to the current time step; this is rather inappropriate and will be probably changed in the next future.
Extended retrieval messages#
Some further messages require additional parameters.
|Variable||Request ValueType||Response ValueType||Description||Python Method|
|foes (0x37)||toLane (string)||stringVector||Returns the list of foe lanes. There are two modes for calling this method. If toLane is a normal road lane that is reachable from the laneID argument, the list contains all lanes that are the origin of a connection with right-of-way over the connection between laneID and toLane. If toLane is empty and laneID is an internal lane, the list contains all internal lanes that intersect with laneID.||getFoes|