cuopt-routing-api-python

cuOpt Routing — Python API

This skill is Python only. Routing has no C API in cuOpt.

Required questions

Ask these if not already clear:

Problem type — TSP, VRP, or PDP?
Locations — How many? Depot(s)? Cost or distance between pairs (matrix or derived)?
Orders / tasks — Which locations must be visited? Demand or service per stop?
Fleet — Number of vehicles, capacity per vehicle (and per dimension if multiple), start/end locations?
Constraints — Time windows (earliest/latest arrival), service times, precedence (order A before B)?

Minimal VRP Example

import cudf
from cuopt import routing
 
cost_matrix = cudf.DataFrame([...], dtype=

Adding Constraints

Solution Checking

Data Types (use explicit dtypes)

Solver Settings

Common Issues

Problem	Fix
Empty solution	Widen time windows or check travel times
Infeasible orders	Increase fleet or capacity
Status != 0 with time windows	Add `add_transit_time_matrix()`
Wrong cost	Check cost_matrix is symmetric
`compute_waypoint_sequence` alters route_df	It replaces the `location` column with waypoint ids in place — pass `route_df.copy()` if you still need cost-matrix indices (e.g. when iterating per truck)

Debugging

When status != 0: print(solution.get_error_message()) and print(solution.get_infeasible_orders().to_list()) to see which orders are infeasible.

Data types: Use explicit dtypes (float32, int32) for matrices and series to avoid silent errors.

Examples

examples.md — VRP, PDP, multi-depot
server_examples.md — REST client (curl, Python)
Reference models: This skill's assets/ — vrp_basic, pdp_basic. See assets/README.md.

Escalate

For contribution or build-from-source, see the developer skill.

cuOpt Routing — Python API

This skill is Python only. Routing has no C API in cuOpt.

Required questions

Ask these if not already clear:

Problem type — TSP, VRP, or PDP?
Locations — How many? Depot(s)? Cost or distance between pairs (matrix or derived)?
Orders / tasks — Which locations must be visited? Demand or service per stop?
Fleet — Number of vehicles, capacity per vehicle (and per dimension if multiple), start/end locations?
Constraints — Time windows (earliest/latest arrival), service times, precedence (order A before B)?

Minimal VRP Example

import cudf
from cuopt import routing
 
cost_matrix = cudf.DataFrame([...], dtype=

Adding Constraints

Solution Checking

Data Types (use explicit dtypes)

Solver Settings

Common Issues

Problem	Fix
Empty solution	Widen time windows or check travel times
Infeasible orders	Increase fleet or capacity
Status != 0 with time windows	Add `add_transit_time_matrix()`
Wrong cost	Check cost_matrix is symmetric
`compute_waypoint_sequence` alters route_df	It replaces the `location` column with waypoint ids in place — pass `route_df.copy()` if you still need cost-matrix indices (e.g. when iterating per truck)

Debugging

When status != 0: print(solution.get_error_message()) and print(solution.get_infeasible_orders().to_list()) to see which orders are infeasible.

Data types: Use explicit dtypes (float32, int32) for matrices and series to avoid silent errors.

Examples

examples.md — VRP, PDP, multi-depot
server_examples.md — REST client (curl, Python)
Reference models: This skill's assets/ — vrp_basic, pdp_basic. See assets/README.md.

Escalate

For contribution or build-from-source, see the developer skill.

cuopt-routing-api-python

Documentation

Documentation

cuOpt Routing — Python API

Required questions

Minimal VRP Example

Adding Constraints

Solution Checking

Data Types (use explicit dtypes)

Solver Settings

Common Issues

Debugging

Examples

Escalate

Documentation

cuopt-routing-api-python

Documentation

cuOpt Routing — Python API

Required questions

Minimal VRP Example

Adding Constraints

Solution Checking

Data Types (use explicit dtypes)

Solver Settings

Common Issues

Debugging

Examples

Escalate