This is a convenience function that creates an adaptive bandwidth test in order to saturate
and determine a link's capacity. By default, the parameters of the test are
- one-way test (not roundtrip)
- uses ROS for return path instead of UDP
- update_interval: 0.2 seconds
- packet loss threshold: 0.5%
- latency threshold: 30ms
- initial bandwidth: 0.5Mbit/s
- maximum duration: 30 seconds
This function should return faster than the specified timeout if the conditions for link saturation
are fulfilled (i.e. it hits a bandwidth ceiling for a specified period of time).
@type kwargs: dict
@param kwargs: a list of test parameters
@rtype: float
@return: the link capacity if it could be determined or 0.0, otherwise.
|