Tutorial

Tutorial - How to Run your First Optimisation in Tarot Routing

So, you've created an account, started a Free Trial. This tutorial will detail how to run your first optimisation in Tarot Routing

Tarot Routing tracking stage showing a central Sydney delivery run with its stops and the Tracking panel

So, you’ve created an account, started a Free Trial and (hopefully) completed our walkthrough tutorial. Congratulations!!!! Now it’s time to get Tarot Routing setup for your business and run an optimisation with your own Jobs.

(If you haven’t yet started a Free Trial, what are you waiting for? - Click here and get started)

This tutorial will detail how to setup an Optimisation Scenario then Create Jobs, activate Drivers and start an Optimisation.

Log in

First, log in to your account if you are not already there. Head to https://route.optimiser.app/ and use the email and password you signed up with

Create a Scenario

Next, we need to create a new optimisation Scenario from the Scenarios Map Panel on the right hand side of your screen.

A Scenario is a list of Jobs that are to be Planned, Routed and Dispatched together. Every Scenario has a Name and Scheduled Date. It might be best to think of a Scenario as a Delivery Wave or a day’s activity.

Tarot Routing tracking view of a delivery scenario across central Sydney, with the Tracking and Scenarios panels open

Open the Scenario Action Bar and click Add Scenario. Give the Scenario a Name and Scheduled Date and Create the Scenario. (Don’t worry about Scenario Templates now, you can learn about them later here)

Creating a scenario: open the Scenarios action bar, click Add scenario, complete the Create scenario form, and the new scenario appears in the list

Your New Scenario will be created and set Active, ready for you to create Jobs, Activate Drivers and Optimise.

Tip - Active Scenario. Make sure you’re working in the right Scenario. The Active Scenario will be highlighted with a blue bar and will default to the top of the Scenario Panel. To set another Scenario Active, hover your mouse over it and click Activate

Scenarios panel with the new active scenario highlighted by a blue bar above the Default Scenario

Create Jobs

Now we have a Scenario we can create some Jobs into it. There are a few ways to create Jobs in Tarot Routing, but the Bulk Create Jobs modal or Excel upload are the fastest way for a new User to get started.

Jobs in Tarot Routing are places to be visited during a Driver’s Run. At a minimum a Job has a UID (unique identifier, e.g. order number, client number etc.), Location (address) and Duration (estimated time in minutes spent stopped). A Job may have multiple other Optimisation Constraints which impact how the Optimiser plans Runs.

Job Attachments are Units to be loaded and delivered, or Returns to be picked-up from, a Job. Units and Returns are additional modules in Tarot Routing if you wish to use these modules please Book a Demo and a Tarot Team Members can add them to your account

Bulk Create Jobs

To create Jobs with the Bulk Create Jobs modal Open the Jobs Action Bar and click Bulk Create Jobs.

Jobs panel action menu with Bulk create jobs highlighted

To create a Job in the Bulk Create Job modal you need to fill in at least the Job UID, Address and Duration. Other fields are optimisation constraints or used in delivery management functionality.

Create Job form with the required Job UID, Duration and Address fields highlighted

Once a Job has been Created it will be added to the Job list below. To add another Job, click New Job to clear the form and go again.

Excel Upload

Using Excel to upload Jobs can be the fastest way to get your deliveries into Tarot Routing without an API or automated data connection. To create Jobs from Excel, open the Jobs Panel and navigate to the Load Tab. Click Download Sample Spreadsheet to get an example excel upload template.

Jobs panel Load tab with the Download sample spreadsheet link highlighted

Open the Excel file once the download is complete. It should look something like this, populated with example data.

Sample Excel job upload spreadsheet populated with example Paris jobs

Feel free to clear the example data and start to add some of your own. Comments have been added to each of the columns in the file to help you understand the required data.

Required Fields

Required spreadsheet columns: uid, address and duration

At a minimum the upload must include:

  • A uid - Unique Identifier of the Job, can be anything.
  • Address - Street address that can be geocoded.
  • Duration - Estimated time in minutes it will take to complete the Job.

Optimisation Constraints

Optional optimisation constraint columns: arrive_after, leave_by, size, type, priority and pickup_from

Optimisation Constraints are optional fields. If you have complex optimisation constraints, we recommend that you book a demo with a member of the Tarot Analytics team.

Customer Information

Customer information columns: customer_name, phone_number, comments and extra_fields

Customer information is not considered by the optimisation but can be uploaded so that you can inform you drivers of important delivery information through the Driver App and so that you can communicate delivery status and ETAs with your customers.

Activate Drivers

Drivers in Tarot Routing are best thought of as a template the Optimiser uses to build Runs (Driver plus Jobs in an optimised sequence). Before starting an optimisation, you need to Activate the Drivers who are working so the optimiser knows which Drivers can have Jobs allocated to them.

A Run is unique to the Scenario it was optimised in, while a Driver will persist to be activated and optimised daily.

Create Drivers

If you completed the onboarding tutorial, then you would have automatically created 3 drivers. If not, or to create more, Open the Drivers Panel Action Bar and click Add Driver.

Drivers panel action menu with Add driver highlighted

At a minimum a Driver has a UID, Start and End Location (these may be different locations) as well as a Shift Start (planned departure time from Start Location) and a Shift End (latest possible arrival time at End Location). A Driver may have other Optimisation Constraints which impact how the Optimiser plans Runs.

Add Driver form with the address, driver UID and shift start and end fields highlighted

Edit Driver

To edit (or delete) an existing Driver right click and select Edit Driver

Drivers panel right-click menu with Edit Driver highlighted

You can Copy Driver, a faster way to create drivers leaving from the same location at the same time.

Activate Drivers

With your Drivers setup finished, select the checkbox next to the Drivers who are working to set them Active, ready to be optimised.

Drivers panel with two of the three drivers selected as active

Optimise

With Jobs uploaded and Drivers active you’re ready to optimise. Click Let’s Route to start an optimisation.

Tarot Routing planning map with jobs loaded across Sydney and drivers selected, ready to optimise

The Optimisation Algorithm will take the Active Drivers and Jobs to calculate which driver should do which Job in what order so to minimise the driving time across the fleet. Once the calculation has finished the Scenario will advance from the Planning Stage to the Routing Stage ready for you to review the Runs planned and dispatch them to your Drivers.

Optimised routes across Sydney after clicking Let’s Route, with each run listed in the Runs panel

Optimisation Settings

If you are optimising lots of Jobs you might want to let the optimisation calculate for longer so a better result can be found. To adjust Optimisation Settings go to the Admin Panel > Organisation Settings > Optimisation Settings

Opening Optimisation Settings from the Admin panel, with Quick Optimisation ticked

By default Quick Optimisation will be set to True. Uncheck this box to set a Maximum Optimisaiton Time (in seconds) and an Improvement Threshold per second.

Optimisation Settings with Quick Optimisation unticked and the Improvement threshold per second and Max optimisation time fields highlighted

Decreasing the Improvement Threshold per second or increasing the Max optimisation time will let the calculation run for longer, improving the results.

Book a Demo

And that is it! You’ve now Run your first optimisation in Tarot Routing. Go and do another one or Book a Demo with our team so we can help you get setup and optimising every delivery.

See it working in your operation.

We will show you how Tarot Routing fits your routes and constraints.

Book a Demo