Simulation/Output/FCDOutput
The FCD (floating car data) export contains location and speed along with other information for every vehicle in the network at every time step. The output behaves somewhat like a super-accurate high-frequency GPS device for each vehicle. The outputs can be processed further using the TraceExporter tool for adapting frequency, equipment rates, accuracy and data format.
Instantiating within the Simulation
The simulation is forced to generate this output using the option --fcd-output <FILE>. <FILE> is the name of the file the output will be written to. Any other file with this name will be overwritten, the destination folder must exist.
Generated Output
The generated XML file looks like this:
<fcd-export>
<timestep time="<TIME_STEP>">
<vehicle id="<VEHICLE_ID>" x="<VEHICLE_POS_X>" y="<VEHICLE_POS_Y>" angle="<VEHICLE_ANGLE>" type="<VEHICLE_TYPE>"
speed="<VEHICLE_SPEED>"/>
... more vehicles ...
</timestep>
... next timestep ...
</fcd-export>
| Name | Type | Description |
|---|---|---|
| timestep | (simulation) seconds | The time step described by the values within this timestep-element |
| id | id | The id of the vehicle |
| type | id | The name of the vehicle type |
| speed | m/s | The speed of the vehicle |
| angle | degree | The angle of the vehicle |
| x | m or longitude | The absolute X coordinate of the vehicle (center of front bumper). The value depends on the given geographic projection |
| y | m or lattitude | The absolute Y coordinate of the vehicle (center of front bumper). The value depends on the given geographic projection |
| z | m | The z value of the vehicle (center of front bumper). Note:
This value is only present if the network contains elevation data |
| pos | m | The running position of the vehicle measured from the start of the current lane. |
| lane | id | The id of the current lane. |
| slope | degree | The slope of the vehicle (equals the slope of the road at the current position) |
When the option --fcd-output.geo is set, the written (x,y)-coordinates will be the lon/lat geo-coordinates.
Further Options
- using the option --fcd-output.geo will toggle output coordinates to WGS84 (for geo-referenced networks)
- using the option --fcd-output.signals will add signal state information to the output
NOTES
In combination with the given geometry of the vehicles (shapes) you can build some nice animations, e.g NASA WorldWind or Google Earth.