@spec duration(t()) :: integer()

Returns the total duration of the whole segment.

@spec end_early(t()) :: integer()

Returns the earliest end time of the current trip.

@spec end_late(t()) :: integer()

Returns the latest end time of the current trip.

@spec finalise_back(t()) :: t()

Finalises this segment at the back (end of segment).

Returns a new segment where release times have been reset, and all other statistics have been suitably adjusted. This is useful with multiple trips because the finalised segment can be concatenated with segments of later trips.

@spec finalise_front(t()) :: t()

Finalises this segment at the front (start of segment).

Returns a new segment where release times have been reset, and all other statistics have been suitably adjusted. This is useful with multiple trips because the finalised segment can be concatenated with segments of earlier trips.

@spec merge(integer(), t(), t()) :: t()

Merges two duration segments with an edge duration.

Parameters

• edge_duration - Duration to travel between the segments
• first - First duration segment
• second - Second duration segment

Returns

A new merged duration segment.

@spec new(
  integer(),
  integer(),
  integer(),
  integer(),
  integer(),
  integer(),
  integer(),
  integer()
) :: t()

Creates a new duration segment.

Parameters

• duration - Total duration of current trip
• time_warp - Total time warp on current trip
• start_early - Earliest start time of current trip
• start_late - Latest start time of current trip
• release_time - Earliest moment to start this trip segment
• cum_duration - Cumulative duration of other trips (default 0)
• cum_time_warp - Cumulative time warp of other trips (default 0)
• prev_end_late - Latest end time of previous trip (default INT_MAX)

@spec prev_end_late(t()) :: integer()

Returns the latest end time of the previous trip.

@spec release_time(t()) :: integer()

Returns the release time of clients on the current trip.

@spec slack(t()) :: integer()

Returns the slack in the route schedule.

This is the amount of time by which the start of the current trip can be delayed without increasing the overall route duration.

@spec start_early(t()) :: integer()

Returns the earliest start time for the current trip.

@spec start_late(t()) :: integer()

Returns the latest start time for the current trip.

@spec time_warp(t(), integer()) :: integer()

Returns the time warp on this whole segment.

If max_duration is provided, any excess duration beyond it is also counted as time warp.