Raises the speed of the specified trips: each part of a trip that is slower
than min_speed is sped up to min_speed, by changing the arrival_time
and departure_time columns in stop_times. Parts of the trips that are
already faster are left unchanged.
Usage
set_min_speed(
gtfs,
min_speed,
unit = "km/h",
route_id = NULL,
trip_id = NULL,
first_stop = NULL,
last_stop = NULL,
from = NULL,
to = NULL,
route_type = NULL
)Arguments
- gtfs
A GTFS object, as created by
read_gtfs().- min_speed
A number. The minimum speed allowed, in the unit given by
unit.- unit
A string representing the unit in which the speed is given. One of
"km/h"(the default),"m/s"or"mph"(miles per hour).- route_id
A character vector including the
route_ids whose trips have their speeds raised. Ifroute_id,trip_idandroute_typeare allNULL(the default), the speeds of every trip in the GTFS are raised.route_ids not listed intripsare ignored, with a warning.- trip_id
A character vector including the
trip_ids to have their speeds raised. When given together withroute_id, the trips of both are raised.- first_stop
A string. The
stop_idwhere the segment whose speeds are raised starts. IfNULL(the default), the segment starts at each trip's first stop.- last_stop
A string. The
stop_idwhere the segment ends. IfNULL(the default), the segment ends at each trip's last stop.- from
A string, in the "HH:MM:SS" format. Only trips that depart from the segment's first stop at or after
fromare changed. IfNULL(the default), there is no lower limit.- to
A string, in the "HH:MM:SS" format. Only trips that depart from the segment's first stop at or before
toare changed. IfNULL(the default), there is no upper limit.- route_type
An integer vector of
route_types (seefilter_by_route_type()). If given, only trips of routes of these types are changed; together with the other selection arguments, it restricts their selection.route_types not listed inroutesare ignored. IfNULL(the default), trips of any type are changed.
Details
A span is the part of a trip between two consecutive stops with times;
stops with blank times inside it are kept blank. Its speed is its length,
calculated by get_trip_length() along the trip's shape (or, with a
warning, as straight lines between stops if there are no shapes; the
stops table is required), divided by the time from the departure at its
first stop to the arrival at its second. Spans whose length is NA (e.g.
in trips not linked to a shape) or 0 (e.g. between stops at the same
place) are left unchanged.
Each span slower than min_speed has its duration lowered to its length
divided by min_speed, rounded down to the whole second (so a very
short span may end up with a duration of 0). All the later times of the
trip are shifted earlier by the accumulated saved time, so dwell times are
kept. Times after midnight written as early morning times (e.g.
"00:30:00" instead of "24:30:00") are first fixed with
fix_overnight_times() in every trip, so the returned GTFS has them fixed.
Spans whose arrival is still earlier than the previous departure (by 12
hours or less) are left unchanged, with a warning. An error is raised if a
shift would result in a time earlier than "00:00:00". Only stop_times
is modified; its existing _secs columns are updated to match.
With first_stop and last_stop, matched as in set_trip_speed(), only
the spans between them are raised: times before first_stop don't change,
and the times at and after last_stop are shifted. The given stops must
have a time, so that no span crosses them (if only last_stop is given,
the trip's first stop needs none). Trips that don't visit first_stop and
then last_stop, or have blank times there, are left unchanged, with a
warning if they were given in trip_id or route_id.
from and to are compared with the departure at the segment's first stop
(or its arrival, if the departure is blank) as written in stop_times
(template times, for trips listed in frequencies), so use times past
"24:00:00" for departures after midnight. Trips without a time there are
left unchanged.
Examples
data_path <- system.file("extdata/spo_gtfs.zip", package = "gtfstools")
gtfs <- read_gtfs(data_path)
# the trip is slower than 20 km/h between some of its stops
get_trip_speed(gtfs, "CPTM L07-0", by = "segment")
#> route_id trip_id segment from_stop_id to_stop_id speed
#> <char> <char> <int> <char> <char> <num>
#> 1: CPTM L07 CPTM L07-0 1 18940 18920 26.60738
#> 2: CPTM L07 CPTM L07-0 2 18920 18919 18.18377
#> 3: CPTM L07 CPTM L07-0 3 18919 18917 11.93590
#> 4: CPTM L07 CPTM L07-0 4 18917 18916 15.07881
#> 5: CPTM L07 CPTM L07-0 5 18916 18965 16.28882
#> 6: CPTM L07 CPTM L07-0 6 18965 18923 21.31043
#> 7: CPTM L07 CPTM L07-0 7 18923 18922 15.08821
#> 8: CPTM L07 CPTM L07-0 8 18922 4114459 17.68714
#> 9: CPTM L07 CPTM L07-0 9 4114459 18921 31.53864
#> 10: CPTM L07 CPTM L07-0 10 18921 18924 32.98105
#> 11: CPTM L07 CPTM L07-0 11 18924 18925 36.47943
#> 12: CPTM L07 CPTM L07-0 12 18925 18926 20.48514
#> 13: CPTM L07 CPTM L07-0 13 18926 18971 26.54381
#> 14: CPTM L07 CPTM L07-0 14 18971 18972 52.84955
#> 15: CPTM L07 CPTM L07-0 15 18972 18973 28.27469
#> 16: CPTM L07 CPTM L07-0 16 18973 18974 44.78676
#> 17: CPTM L07 CPTM L07-0 17 18974 18975 38.29072
gtfs_raised <- set_min_speed(gtfs, min_speed = 20, trip_id = "CPTM L07-0")
get_trip_speed(gtfs_raised, "CPTM L07-0", by = "segment")
#> route_id trip_id segment from_stop_id to_stop_id speed
#> <char> <char> <int> <char> <char> <num>
#> 1: CPTM L07 CPTM L07-0 1 18940 18920 26.60738
#> 2: CPTM L07 CPTM L07-0 2 18920 18919 20.01883
#> 3: CPTM L07 CPTM L07-0 3 18919 18917 20.03227
#> 4: CPTM L07 CPTM L07-0 4 18917 18916 20.04939
#> 5: CPTM L07 CPTM L07-0 5 18916 18965 20.04778
#> 6: CPTM L07 CPTM L07-0 6 18965 18923 21.31043
#> 7: CPTM L07 CPTM L07-0 7 18923 18922 20.00646
#> 8: CPTM L07 CPTM L07-0 8 18922 4114459 20.02318
#> 9: CPTM L07 CPTM L07-0 9 4114459 18921 31.53864
#> 10: CPTM L07 CPTM L07-0 10 18921 18924 32.98105
#> 11: CPTM L07 CPTM L07-0 11 18924 18925 36.47943
#> 12: CPTM L07 CPTM L07-0 12 18925 18926 20.48514
#> 13: CPTM L07 CPTM L07-0 13 18926 18971 26.54381
#> 14: CPTM L07 CPTM L07-0 14 18971 18972 52.84955
#> 15: CPTM L07 CPTM L07-0 15 18972 18973 28.27469
#> 16: CPTM L07 CPTM L07-0 16 18973 18974 44.78676
#> 17: CPTM L07 CPTM L07-0 17 18974 18975 38.29072
# the later stops are shifted, so the trip ends earlier
get_start_and_end_times(gtfs, trip_id = "CPTM L07-0")
#> start_time end_time
#> "04:00:00" "06:16:00"
get_start_and_end_times(gtfs_raised, trip_id = "CPTM L07-0")
#> start_time end_time
#> "04:00:00" "06:05:39"
# raise the speed only between two stops. the spans before and after them
# are not raised
gtfs_raised <- set_min_speed(
gtfs,
min_speed = 20,
trip_id = "CPTM L07-0",
first_stop = "18917",
last_stop = "18922"
)
get_trip_speed(gtfs_raised, "CPTM L07-0", by = "segment")
#> route_id trip_id segment from_stop_id to_stop_id speed
#> <char> <char> <int> <char> <char> <num>
#> 1: CPTM L07 CPTM L07-0 1 18940 18920 26.60738
#> 2: CPTM L07 CPTM L07-0 2 18920 18919 18.18377
#> 3: CPTM L07 CPTM L07-0 3 18919 18917 11.93590
#> 4: CPTM L07 CPTM L07-0 4 18917 18916 20.04939
#> 5: CPTM L07 CPTM L07-0 5 18916 18965 20.04778
#> 6: CPTM L07 CPTM L07-0 6 18965 18923 21.31043
#> 7: CPTM L07 CPTM L07-0 7 18923 18922 20.00646
#> 8: CPTM L07 CPTM L07-0 8 18922 4114459 17.68714
#> 9: CPTM L07 CPTM L07-0 9 4114459 18921 31.53864
#> 10: CPTM L07 CPTM L07-0 10 18921 18924 32.98105
#> 11: CPTM L07 CPTM L07-0 11 18924 18925 36.47943
#> 12: CPTM L07 CPTM L07-0 12 18925 18926 20.48514
#> 13: CPTM L07 CPTM L07-0 13 18926 18971 26.54381
#> 14: CPTM L07 CPTM L07-0 14 18971 18972 52.84955
#> 15: CPTM L07 CPTM L07-0 15 18972 18973 28.27469
#> 16: CPTM L07 CPTM L07-0 16 18973 18974 44.78676
#> 17: CPTM L07 CPTM L07-0 17 18974 18975 38.29072
