time based vehicle utilization

[emilyeros]

Vehicle utilization is described as "total vehicle on-street time divided by total trip duration for all vehicles"

Here's an example of one day of data:

Let's say there are 10 operational hours in this day. Then total vehicle on-street time = 624 vehicles x 10 hrs = 6240 hours

Total trip duration for all vehicles = 22m7s per trip / 60 min per hr * 544 trips = 200 hours

I think there's an error in the description; the numerator and the denominator should be reversed, otherwise you'll always get a utilization of over 100%. But even if I do that, I'd have:

utilization = 200 hours / 6240 hours = 3.2%. Not 34%, like in the example.

I think the calculation has a math error somewhere.

[morganherlocker]

Vehicle Utilization is currently calculated with the following formula:

Math.round((ActiveVehicles / TotalVehicles) * 100)

This is different than the time based utilization calculation currently described in the docs. I'm going to update the docs to accurately reflect this, then prioritize moving the calculation to the new metric. This will require calculating the total time available, which is not currently implemented.