Metrics and optimization goals
Why metrics matter
Timefold Platform helps you solve complex planning problems by searching for the best possible solution given your constraints. But how do you determine if one solution is better than another?
Each generated schedule is assigned a score based on hard, medium, and soft constraints. However, this score is primarily used by the solver to guide optimization and helps identify the impact of different constraints, but it doesn’t have a meaningful interpretation in your day-to-day operations. Read more about constraints and constraint scores.
That’s why the Timefold Platform provides a set of metrics that help you evaluate and compare different scheduling solutions in a way that aligns with your business objectives.
Example metrics
Some example metrics for Field Service Routing are:
-
Total Travel Time: The combined travel time of all the vehicles in the schedule.
-
Total Travel Distance: The sum of the distances each of the vehicles will travel in this schedule.
-
Unassigned Visits: The number of visits that could not be assigned a vehicle in this schedule.
-
Working Time Fairness: A percentage indicating how evenly work is distributed among technicians.
We continuously update and refine available metrics. You can view the most up-to-date list in the Timefold Platform UI or check the OpenAPI specifications for Field Service Routing.
Where to find metrics
You can access and analyze metrics in multiple places within Timefold Platform:
-
Run Detail Page: The sidebar displays five top-level metrics, with an option to expand and see all available metrics.
-
Model Runs Overview Table: Customize which metrics appear in the table to compare solutions across multiple runs. Use tagging and filtering features to focus on certain segments.
-
Model Output: Metrics are included as part of the JSON output file for deeper analysis.
Goal Alignment
Real-world scheduling is a balancing act between multiple competing objectives. Optimization is not a zero-sum game, improving one objective doesn’t always mean sacrificing another. Instead, constraint weights can be tuned to prioritize different goals. Metrics help you choose to decide between different runs with different optimization objectives.
Example optimization goals
Some example optimization goals for Field Service Routing are:
-
Reducing travel time or distance.
-
Focusing on a fair distribution of work between different technicians.
-
Maximizing the number of visits, by priority.
-
Reducing costs (e.g. by preventing visits by overqualified technicians).
-
Minimizing the completion risk of visits (e.g. by scheduling visits as early in the day as possible).
An optimization goal is often a combination of the above. In Timefold the optimization goal is represented by the relative weights of the constraints.
Using configuration profiles for goal alignment
Our platform supports configuration profiles that allow you to define these objectives. This feature allows you to:
-
Compare how different priorities impact the final solution.
-
Identify solutions that balance objectives effectively.
-
Adjust trade-offs dynamically based on evolving business needs.
By using metrics and configuration profiles together, you can gain deeper insights into your scheduling challenges and ensure your optimization efforts align with your strategic goals.