road_traffic¶
- road_traffic … end_road_traffic¶
road_traffic network <route-network-name> vehicle_count <number> vehicle_density <number> per <length-unit> maximum_speed <speed-value> mean_travel_time <time-value> sigma_travel_time <time-value> minimum_distance_off_road <length-unit> maximum_distance_off_road <length-unit> pause_time_off_road <time-value> end_of_path_option [respawn | reverse_direction] vehicle <platform-type> fraction <fractional-quantity> mean_speed <speed-value> sigma_speed <speed-value> end_vehicle convoy start_position <latitude> <longitude> end_position <latitude> <longitude> spacing <length-unit> speed <speed-value> use_closest_waypoint vehicle <number> <platform-type> end_convoy weighted_region latitude <latitude> longitude <longitude> inner_radius <length-unit> outer_radius <length-unit> inner_weight <fractional-quantity> outer_weight <fractional-quantity> end_weighted_region end_network end_road_traffic
Overview¶
The road_traffic command generates background road traffic via ground moving platforms during the simulation on a predefined route_network.
Commands¶
- network <route-network-name> … end_network¶
Defines the attributes and vehicles that are generated on the defined route_network as specified by the <route-network-name>.
- vehicle_count <number>¶
The number of vehicles generated and placed on the road network. If the <vehicle_count> is not specified, it will be set using <vehicle_density>.
- vehicle_density <number> per <length-unit>¶
Instead of specifying a specific number of vehicles, a density number of vehicles per unit length can be specified (i.e., 5 per 1km)
- maximum_speed <speed-value>¶
The maximum speed any vehicle on the network can travel even if a faster speed is specified in the vehicle block. This could simulate a speed limit.
- mean_travel_time <time-value>¶
The average travel time of all the vehicles in the network.
- sigma_travel_time <time-value>¶
The travel time magnitude of one standard deviation. When a vehicle reaches the end of its path or travel time, it travels off road by some amount and then pauses for a given amount of time before being removed from the simulation. The following three items (<minimum_distance_off_road>, maximum_distance_off_road, and pause_time_off_road) define the parameters, which define this process.
- minimum_distance_off_road <length-unit>¶
The minimum distance that a vehicle travels off-road.
- maximum_distance_off_road <length-unit>¶
The maximum distance that a vehicle travels off-road.
- pause_time_off_road <time-value>¶
The time that a vehicle pauses at the end of its route after traveling off-road.
- end_of_path_option [respawn | reverse_direction]¶
This determines what should be done to vehicles at the end of their route. By default vehicles are re-spawned with a different route.
- vehicle <platform-type> end_vehicle¶
Defines the attributes of a specific vehicle type within the context of this net work. To define multiple vehicle types, create multiple vehicle blocks. The <platform-type> must be a previously defined platform_type.
- fraction <fractional-quantity>¶
If multiple vehicle blocks are defined, the fraction is the percentage (as a decimal value) of this specific vehicle type that would populate the road network. The sum of all the vehicle fractions must add up to 1.
- mean_speed <speed-value>¶
The average speed of all the vehicles defined by this vehicle block.
- sigma_speed <speed-value>¶
The speed magnitude of one standard deviation.
- convoy … end_convoy¶
This command defines a convoy (a series of vehicles that follow each other), that moves between two endpoints.
- start_position <latitude> <longitude>¶
This defines the initial location of the convoy with a latitude and longitude value.
- end_position <latitude> <longitude>¶
This defines the final location of the convoy as a latitude and longitude value.
- spacing <length-unit>¶
This defines the spacing between each of the vehicles in the convoy.
- speed <speed-value>¶
This defines the speed that the convoy will travel.
- use_closest_waypoint¶
If this option is present, the convoy will start at the closest waypoint to the specified start position and end at the closest waypoint to the end position.
- vehicle <number> <platform-type>¶
This defines a specific vehicle type and the number of that type in the convoy. This option can be specified multiple times to create multiple vehicle types.
- weighted_region … end_weighted_region¶
This command defines a region in the network where a higher density of vehicles will be created. For instance, this command can be used to generate more vehicles in a city region than in the country. Weighted regions have an inner and outer radius and weight. The weights are linearly interpolated between the inner and outer radii. This allows the simulation to vary the density of vehicles linearly between the inner and outer radii.
- latitude <latitude>¶
Specifies the center latitude of the weighted region.
- longitude <longitude>¶
Specifies the center longitude of the weighted region.
- inner_radius <length-unit>¶
Specifies the inner radius of the weighted region.
- outer_radius <length-unit>¶
Specifies the outer radius of the weighted region.
- inner_weight <fractional-quantity>¶
Specifies the weight that corresponds to the inner radius. The larger the weight number, the higher the density of vehicles.
- outer_weight <fractional-quantity>¶
Specifies the weight that corresponds to the outer radius. The larger the weight number, the higher the density of vehicles.
Example¶
road_traffic network stl_roadnetwork vehicle_count 500 maximum_speed 75 mi/h minimum_distance_off_road 1 nm maximum_distance_off_road 2 nm pause_time_off_road 240 min mean_travel_time 40.0 min sigma_travel_time 5.0 min vehicle Car fraction 0.80 mean_speed 60 mi/h sigma_speed 5 mi/h end_vehicle vehicle Pickup_Truck fraction 0.15 mean_speed 60 mi/h sigma_speed 10 mi/h end_vehicle vehicle School_Bus fraction 0.05 mean_speed 50 mi/h sigma_speed 10 mi/h end_vehicle end_network end_road_traffic
