get_headways: Calculate Scheduled Headways

In GTFSwizard: Creating, Exploring, and Manipulating GTFS Files

Calculate Scheduled Headways

Description

Calculates elapsed minutes between successive service instances. Frequency based trips are expanded according to 'frequencies.txt'.

Usage

get_headways(gtfs, method = "by_trip")

Arguments

gtfs	A GTFS object.
method	One of '"by_trip"', '"by_route"', '"by_hour"', '"by_stop"', '"by_shape"', or '"detailed"'. Legacy dotted values remain accepted.

Details

Route, hour, and trip methods compare first departures. Stop and detailed methods compare arrivals at the same stop, route, direction, and service pattern. The first service instance in each group has no headway and is omitted.

Value

A tibble. Headway values are always returned in 'headway_minutes'; 'valid_trips' is the number of intervals summarized.

References

[GTFS Schedule Reference](https://gtfs.org/documentation/schedule/reference/#frequenciestxt)

See Also

[GTFSwizard::get_frequency()]

Examples

get_headways(for_rail_gtfs, "by_route")
get_headways(for_rail_gtfs, "by_hour")

GTFSwizard documentation built on Aug. 21, 2026, 5:16 p.m.