KangRouter UI

General

Resource
Transportation jobs use vehicle resources. Examples are seats, area, volume, weight, etc.
Break
A work break of a given duration to be performed within a given time window. Breaks are not associated with a specific location - the scheduling algorithm simply allocates the required amount of free time.
Vehicle overspeed

Adjusts travel times between locations. A vehicle overspeed of X means vehicles will be allowed to travel X times faster than what is permited for the reference vehicle (a car).

Tip

Use this to adjust traveling times for vehicles with special speed limits (such as ambulances).

Note

Default vehicle overspeed may be set in Settings, and customized by vehicle.

Short notation for time intervals

Abbreviated form for denoting time intervals. Examples:

Notation Meaning
08:00-09:00 From 08:00 to 09:00.
>09:00 After 09:00.
<18:00 Before 18:00.
=13:30 Exactly at 13:30.

Locations

Location name
A convenient identifier for a location, such as “Home”, “Warehouse”, or “Depot”.
Location address
The postal address of a location.
Location GPS
The GPS coordinates of a location in the form Latitude, Longitude given in decimal degrees.
Location visibility

A location may be set private or public. Public locations are typically shared among several cargo/passengers or vehicles. Examples are Hospitals, multi-vehicle depots, etc. A private location is associated with a given cargo/passenger or vehicle, such as a patient or driver’s home.

Location visibility helps to reference locations unambiguosly by a given location name. Names of public locations must be unique, but the system allows assigning the same location name to different private locations. This allows the use of short descriptors such as “Home”, or “Depot” for private locations.

Settings

Day start time

Sets the time a day begins/ends.

Warning

This attribute influences the chronological ordering of events occurring in the same day. Consider for example two events A and B occurring in the same day at 01:00 and 23:00, respectively. If Day Start Time is 00:00, then event A is before event B. However, if Day Start Time is 04:00, then event A is after event B.

Default pickup maximum waiting time

Sets the pickup time window when only one of the window bounds is given. Consider for example a job with earliest pickup time set to 07:00 and where latest pickup time is left undefined. Then, setting Pickup Maximum Waiting Time to 01:00 will ensure the pickup must happen before 08:00.

Note

This attribute has no effect when both bounds of the job pickup time window are specified.

Default delivery maximum waiting time

Sets the delivery time window when only one of the window bounds is given. Consider for example a job with earliest delivery time set to 19:00 and where latest delivery time is left undefined. Then, setting Delivery Maximum Waiting Time to 01:00 will ensure the delivery must occur before 20:00.

Note

This attribute has no effect when both bounds of the delivery time window are specified.

Default job maximum waiting time

Sets the job time window when only exactly one of the earliest pickup time or latest delivery time is specified. Consider for example a job with earliest pickup time set to 07:00 at location A, and unspeficied delivery time window at location B. Then, setting Job Maximum Waiting Time to 01:00 will ensure the job must end before 07:00+01:00+T, where T is the shortest travel time from A to B.

Note

This attribute has no effect when both pickup time window and delivery time window are specified.

Load/unload duration per resource unit

Load/unload duration associated with a unit of a Resource. This parameter is used to estimate the total cargo/passenger load/unload duration based on the set of resources that it requires. For example, a passenger requiring a seat resource may take 1 minute to load/unload, while a passenger requiring a wheelchair resource may take 5 minutes.

Note

Load/Unload durations set here may be overriden per specific cargo/passenger or job.

Time interval layout
Selects the layout of time intervals on tables. When set to “Two columns”, time interval fields [a, b] are displayed in two columns a, b. When set to “One column”, time interval fields are displayed in just one column using the short notation for time intervals.
Resource consumption/capacity layout
Selects the layout of resource consumption/capacity fields on tables. When set to “Multiple columns”, a column is allocated to each resource. When set to “One column”, a single column is used to describe the consumption/capacity of multiple resources, in the form Resource1:Quantity1, Resource2:Quantity2, etc.
Locations layout
Selects the layout of location fields on tables. Tables displaying locations may display one or two columns with the location GPS coordinates and/or the location name.

Cargo/Passenger

Cargo/passenger resource consumption
Number of units of each resource required by a specific cargo/passenger. For example 1 seat or 3 kg.
Cargo/passenger load/unload duration

An estimation of the amount of time required to load/unload the cargo/passenger.

Note

Cargo/passenger load/unload duration defaults to the duration computed from the load/unload duration per resource unit.

Job

Job
A job is the transportation of cargo/passengers from one location to another. The job starts at the pickup location, the job’s origin, and ends at the delivery location, the job’s destination.
Job origin
The pickup location.
Job destination
The delivery location.
Earliest pickup time
The earliest possible time for the pickup, that is, the earliest possible time a job is allowed to start.
Latest pickup time
The latest possible time for the pickup, that is, the latest possible time a job is allowed to start.
Earliest delivery time
The earliest possible time for the delivery, that is, the earliest possible time a job is allowed to end.
Latest delivery time
The latest possible time for the delivery, that is, the latest possible time a job is allowed to end.
Pickup time window
Time window for the pickup (job start time), defined by the pair [earliest pickup time, latest delivery time]. It may be given using the short notation for time intervals.
Delivery time window
Time window for the delivery (job end time), defined by the pair [earliest delivery time, latest delivery time]. It may be given using the short notation for time intervals.
Job load duration

An estimation of the amount of time required to load the cargo/passenger for a specific job.

Note

Job load duration defaults to the cargo/passenger load/unload duration.

Job unload duration

An estimation of the amount of time required to unload the cargo/passenger for a specific job.

Note

Job unload duration defaults to the cargo/passenger load/unload duration.

Job resource consumption

Number of units of each resource required by a specific job. For example 1 seat or 3 kg.

Note

Job resource consumption defaults to the resource consumption associated with the transported cargo/passenger. This behaviour can be disabled by clearing Inherits cargo/passenger resource consumption.

Inherits cargo/passenger resource consumption
Sets the default job resource consumption to the resource consumption associated with the transported cargo/passenger.

Vehicle

Vehicle earliest time available
The earliest possible time a vehicle is avaiable for work.
Vehicle latest time available
The latest possible time a vehicle is avaiable for work.
Vehicle availability window
Time window in which a specific vehicle is available for work, given in the short notation for time intervals.
Vehicle maximum working time
Maximum time duration a specific vehicle is available for work per day.
Vehicle resource capacity
Number of units of each resource made available by a specific vehicle. For example 12 seats or 500 kg.
Vehicle breaks
List of breaks assigned to a specific vehicle.
Inherits general breaks
Sets vehicle breaks to the set of breaks defined in global settings.

Availability

Inherits vehicle resource capacity
Sets the resource capacity of a specific availability slot to the resource capacity of the vehicle.
Inherits vehicle depot
Sets the depot of a specific availability slot to the depot of the vehicle.
Inherits vehicle breaks
Sets the set of breaks of a specific availability slot to the set of breaks of the vehicle.

Plan table

Scheduled event
Symbol Event
Pickup
Delivery
Break
Depot
Scheduled event time window
Time window in which an event is scheduled to occur, defined by the pair [earliest time, latest time]. It may be displayed using the short notation for time intervals.
Scheduled event earliest time
Earliest possible time an event may occur.
Scheduled event latest time
Latest possible time an event may occur.

Stats table

Number of jobs per vehicle
Number of jobs assigned to a vehicle.
Distance per vehicle
Total distance a vehicle must travel.
Driving time per vehicle
Total amount of time a vehicle is travelling.
Traffic impact
Percent of driving time caused by expected traffic conditions.
Load/Unload time per vehicle
Total amount of time a vehicle is loading or unloading.
Idle time per vehicle
Total amount of time a vehicle is idle, i.e. not traveling, not loading/unloading, and not having a scheduled work break.
Break time per vehicle
Total amount of time the vehicle is having a scheduled work break.