OneBusAway/onebusaway-application-modules — pull request #108 by kurtraschke (2014-12-09 02:34:42+00:00)
Title: Prevent assignment of backwards-traveling distance-along-shape values.

Under [certain circumstances](https://groups.google.com/d/topic/onebusaway-developers/HvnZ8ig2aNw/discussion) `DistanceAlongShapeLibrary` can return a sequence of values which would result in (invalid) backwards travel along a shape. While `DistanceAlongShapeLibrary` should ultimately be fixed to be more robust in those cases and produce correct assignments, as a stopgap solution this PR introduces a check such that backwards travel results in an exception being thrown.

If the user [intends to proceed anyway](https://github.com/OneBusAway/onebusaway-application-modules/wiki/Stop-to-Shape-Matching) they can run the bundle builder with `-P tripEntriesFactory.throwExceptionOnInvalidStopToShapeMappingException=false`, in which case distance-along-trip values (as well as interpolated stoptimes, where used) cannot be relied upon, as they will be based on the straight-line distances between stops, without the use of shape data.