ExVrp.ScheduledVisit (ExVrp v0.4.2)

Copy Markdown View Source

Represents a scheduled visit in a route.

A ScheduledVisit contains timing information about when a location is visited, including service start/end times, waiting time, and any time warp (lateness).

Fields

  • location - The location index (depot or client) in ProblemData
  • trip - The trip index within the route (for multi-trip routes)
  • start_service - Time when service begins at this location
  • end_service - Time when service ends at this location
  • wait_duration - Time spent waiting before service can begin
  • time_warp - Amount of "time travel" needed (indicates infeasibility if > 0)

Computed Properties

  • service_duration - Duration of service (end_service - start_service)

Example

# Get schedule for route 0
schedule = Solution.route_schedule(solution, 0)

# Iterate through visits
Enum.each(schedule, fn visit ->
  IO.puts("Location #{visit.location}: service #{visit.start_service}-#{visit.end_service}")
  if visit.time_warp > 0 do
    IO.puts("  WARNING: #{visit.time_warp} time warp (late arrival)")
  end
end)

Summary

Types

t()

Functions

from_tuple(arg)

Creates a ScheduledVisit from a tuple returned by the NIF.

has_time_warp?(scheduled_visit)

Returns true if this visit has time warp (late arrival).

has_wait?(scheduled_visit)

Returns true if the vehicle had to wait at this location.

service_duration(scheduled_visit)

Returns the service duration (end_service - start_service).

Types

t()

@type t() :: %ExVrp.ScheduledVisit{
  end_service: non_neg_integer(),
  location: non_neg_integer(),
  start_service: non_neg_integer(),
  time_warp: non_neg_integer(),
  trip: non_neg_integer(),
  wait_duration: non_neg_integer()
}

Functions

from_tuple(arg)

@spec from_tuple(
  {non_neg_integer(), non_neg_integer(), non_neg_integer(), non_neg_integer(),
   non_neg_integer(), non_neg_integer()}
) :: t()

Creates a ScheduledVisit from a tuple returned by the NIF.

The tuple format is: {location, trip, start_service, end_service, wait_duration, time_warp}

has_time_warp?(scheduled_visit)

@spec has_time_warp?(t()) :: boolean()

Returns true if this visit has time warp (late arrival).

A visit with time warp indicates the vehicle arrived after the time window closed, making the route infeasible.

has_wait?(scheduled_visit)

@spec has_wait?(t()) :: boolean()

Returns true if the vehicle had to wait at this location.

service_duration(scheduled_visit)

@spec service_duration(t()) :: non_neg_integer()

Returns the service duration (end_service - start_service).