Spawner Features
PreRunSpawner
Spawning on roads, lanes and ranges
Non-existent roads
- Requirement
Road IDs specified in the configuration, but not part of the scenery file are igored.
- Verified by
Unit Test SpawnerPreRunCommonParameterExtractor_GetWayToNextRoad_NoPossibleWay
Single road
- Requirement
Spawning on the given road takes place.
- Requirement
No agents are spawned on other roads in the scenery.
- Verified by
End-to-end Test SpawnerPreRun_Highway_SingleRoad
Consecutive roads
- Precondition
Spawner configuration specifies a list of consecutively connected roads in a single ListItem.
- Requirement
Spawning on the given roads takes place.
- Requirement
No agents spawned on other roads in the scenery.
- Requirement
Agents are spawned on all drivable lanes (which are part of the roads being specified in the configuration).
- Requirement
Agents are spawned in the correct driving direction.
- Verified by
End-to-end Test SpawnerPreRun_Highway_FullStream End-to-end Test SpawnerPreRun_SingleRoad_DrivingDirection
Non-consecutive roads
- Precondition
Spawner configuration specifies a list of non-consecutively connected roads.
- Requirement
Spawning on the given roads takes place.
- Requirement
Missing roads between the specified ones are automatically determined by the Spawner and handled like they were specified in the configuration in the first place. The resulting path being spawned on is arbitrary if multiple solutions exist for a scenery, but only one path shall be used.
- Verified by
Covered by Roads across junction
Roads across junction
- Precondition
Spawner configuration specifies a list of (not necessarily consecutively) connected roads in a single ListItem.
- Precondition
The chain of roads specified has to cross a single junction.
- Requirement
Spawning on the given roads takes place.
- Requirement
Missing roads between the specified ones are automatically determined by the Spawner and handled like they were specified in the configuration in the first place. The resulting path being spawned on is arbitrary if multiple solutions exist for a scenery, but only one path shall be used.
- Verified by
End-to-end Test SpawnerPreRun_Highway_EntryExit
Multiple roads (including non existent IDs)
- Precondition
Spawner configuration specifies a list of (at least partially) consecutively connected roads in a single ListItem.
- Precondition
At least one road id given in the configuration is not present in the scenery.
- Requirement
Spawning on the given roads takes place up to the first non-existent road that is encountered.
- Requirement
No spawning takes place, if the first road of the list doesn’t exist.
- Verified by
End-to-end Test SpawnerPreRun_Highway_IncorrectStreamBegin End-to-end Test SpawnerPreRun_Highway_IncorrectStreamMid
Specified lanes
- Precondition
Basic setup as as in Consecutive roads.
- Precondition
A list of lanes to be spawned on is specified in the Spawner configuration.
- Precondition
The list of lanes contains at least one lane IDs which exist for the first specified road.
- Precondition
The list of lanes contains at least one lane IDs which doesn’t exist for the first specified road.
- Requirement
Spawning takes place on the specified lane IDs (on drivable lanes).
- Requirement
Spawning does not take place on other lane IDs.
- Requirement
Lane IDs not present for one or more roads do not lead to an error.
- Verified by
End-to-end Test SpawnerPreRun_SingleRoad_SpecifiedLanes
Multiple overlapping road streams
- Precondition
Two road streams are specified in the Spawner configuration (as in Consecutive roads).
- Precondition
The two road streams have at least one road in common.
- Precondition
The Spawner configuration specifies the lanes to spawn on in such a way that there are no overlapping lanes (on the road being common to both streams).
- Requirement
Spawning on the given roads and all given lanes takes place.
- Verified by
End-to-end Test SpawnerPreRun_Highway_RoadOverlap
Spawning on range (SStart + SEnd within road boundaries)
- Precondition
Basic setup as as in Consecutive roads.
- Precondition
SStart and SEnd are set to values within the road boundaries (with the effective start s-coordinate being lower than the effective end s-coordinate when taking the whole road stream into account).
- Requirement
Agents are spawned within the specified range.
- Requirement
No agents are spawned outside of the specified range.
- Verified by
Unit Test SpawnerPreRunCommonParameterExtractor_ExtractSpawnAreas_AllOptionalParameters End-to-end Test SpawnerPreRun_SingleRoad_SpecifiedRange
Spawning on range (SStart + SLength within road boundaries)
- Precondition
Basic setup as as in Consecutive roads.
- Precondition
SStart and SLength are set to values within the road boundaries (with the effective start s-coordinate being lower than the effective end s-coordinate when taking the whole road stream into account).
- Requirement
Agents are spawned within the specified range.
- Requirement
No agents are spawned outside of the specified range.
- Verified by
Unit Test SpawnerPreRunCommonParameterExtractor_ExtractSpawnAreas_AllOptionalParameters
Spawning on range (SEnd outside of road boundaries)
- Precondition
Basic setup as as in Consecutive roads.
- Precondition
SStart is set set to a value within the road boundaries, SEnd is set greater than the length of the last road given.
- Requirement
Agents are spawned within the specified range.
- Requirement
The specified range is capped to the length of the last road.
- Verified by
Unit Test SpawnerPreRunCommonParameterExtractor_ExtractSpawnAreasWithSOutOfRange_ReturnsValidS
Spawning on range (SLength outside of road boundaries)
- Precondition
Basic setup as as in Consecutive roads.
- Precondition
SStart is set set to a value within the road boundaries, SLength is set greater than the accumulated length of all roads given.
- Requirement
Agents are spawned within the specified range.
- Requirement
The specified range is capped to the length of the roads.
- Verified by
Unit Test SpawnerPreRunCommonParameterExtractor_ExtractSpawnAreasWithSOutOfRange_ReturnsValidS
Right lane only
- Precondition
Basic setup as as in Consecutive roads.
- Precondition
RightLaneOnlyset totruein the Spawner configuration.- Requirement
Spawning takes place on the specified roads.
- Requirement
Spawning takes place on the rightmost lanes only.
- Verified by
End-to-end Test SpawnerPreRun_SingleRoad_RightLaneOnly
Traffic parameters
Separation buffer specified
- Precondition
Basic setup as as in Single road.
- Precondition
MinimumSeparationBufferis set in the Spawner configuration.- Requirement
No two agents are spawned with a net distance lower than the specified separation buffer.
- Verified by
UNTESTED
Separation buffer not specified
- Precondition
Basic setup as as in Single road.
- Precondition
MinimumSeparationBufferis not set in the Spawner configuration.- Requirement
No two agents are spawned with a net distance lower than 5 m.
- Verified by
UNTESTED
Time to collision
- Precondition
Basic setup as as in Single road.
- Requirement
No agent is spawned with a TTC lower than the configured threshold (with respect to end of lane).
- Verified by
UNTESTED Also has to be checked by analysis of simulation output by an external tool
Stochastics
Traffic groups
- Requirement
The selection of traffic groups is randomized using a uniform distribution.
- Verified by
UNTESTED
Agent profiles
- Requirement
The selection of agent profiles is randomized using a uniform distribution.
- Verified by
UNTESTED
Velocity distribution
- Requirement
The distribution of the velocities of a traffic group has to match the configured distribution.
- Verified by
UNTESTED Also has to be checked by analysis of simulation output by an external tool
TGap distribution
- Requirement
The distribution of the TGaps of a traffic group has to match the configured distribution.
- Verified by
UNTESTED Also has to be checked by analysis of simulation output by an external tool
RuntimeSpawner
Spawning on roads, lanes and ranges
Non-existent roads
- Requirement
Road IDs specified in the configuration, but not part of the scenery file are igored.
- Verified by
UNTESTED
Single road
- Requirement
Spawning on the given road takes place.
- Requirement
No agents are spawned on other roads in the scenery.
- Requirement
Agents are spawned in the correct driving direction.
- Verified by
End-to-end Test SpawnerRuntime_Highway_SingleRoad
Driving direction
- Requirement
Agents are spawned in the correct driving direction (matching lane direction).
- Verified by
End-to-end Test SpawnerRuntime_Highway_SingleRoad_DrivingDirection
Multiple roads (including non existent IDs)
- Precondition
Spawner configuration specifies a list of roads in a single ListItem.
- Precondition
At least one road id given in the configuration is not present in the scenery.
- Requirement
Spawning on the given roads takes place.
- Requirement
Non-existent road IDs are ignored.
- Verified by
End-to-end Test SpawnerRuntime_Highway_MultipleRoads
Specified lanes
- Precondition
Basic setup as as in Single road.
- Precondition
A list of lanes to be spawned on is specified in the Spawner configuration.
- Precondition
The list of lanes contains lane IDs which don’t exist for the specified road.
- Requirement
Spawning takes place on the specified lane IDs (on drivable lanes).
- Requirement
Spawning does not take place on other lane IDs.
- Requirement
Lane IDs not present for the specified road do not lead to an error.
- Verified by
End-to-end Test SpawnerRuntime_SingleRoad_SpecifiedLanes
Right lane only
- Precondition
Basic setup as as in Single road.
- Precondition
RightLaneOnlyset totruein the Spawner configuration.- Requirement
Spawning takes place on the specified road.
- Requirement
Spawning takes place on the rightmost lane only.
- Verified by
End-to-end Test SpawnerRuntime_SingleRoad_RightLaneOnly
Traffic parameters
Separation buffer specified
- Precondition
Basic setup as as in Single road.
- Precondition
MinimumSeparationBufferis set in the Spawner configuration.- Requirement
No two agents are spawned with a net distance lower than the specified separation buffer.
- Verified by
Unit Test SpawnerRuntimeCommonParameterExtractor_ExtractMinimumSeparationBuffer_FixedValue
Separation buffer not specified
- Precondition
Basic setup as as in Single road.
- Precondition
MinimumSeparationBufferis not set in the Spawner configuration.- Requirement
No two agents are spawned with a net distance lower than 5 m.
- Verified by
Unit Test SpawnerRuntimeCommonParameterExtractor_ExtractMinimumSeparationBuffer_NoValue_SetsDefault
Stochastics
Traffic groups
- Requirement
The selection of traffic groups is randomized using a uniform distribution.
- Verified by
UNTESTED
Agent profiles
- Requirement
The selection of agent profiles is randomized using a uniform distribution.
- Verified by
UNTESTED
Velocity distribution
- Requirement
The distribution of the velocities of a traffic group has to match the configured distribution.
- Verified by
UNTESTED Also has to be checked by analysis of simulation output by an external tool
TGap distribution
- Requirement
The distribution of the TGaps of a traffic group has to match the configured distribution.
- Verified by
UNTESTED Also has to be checked by analysis of simulation output by an external tool