/Euro-NeurIPS-2022

OptiML's contribution to the EURO meets NeurIPS 2022 vehicle routing competition.

Primary LanguageJupyter NotebookOtherNOASSERTION

CI

EURO Meets NeurIPS 2022 Vehicle Routing Competition

This repository hosts OptiML's contribution to the 2022 Euro meets NeurIPS vehicle routing competition, where we finished second overall (1st on the static problem variant and 3rd on the dynamic one).

Solver

Our static solver is based on the hybrid genetic search baseline we received as part of the quickstart code here. We have refactored this solver significantly, making it much more modular and more performant. We also:

  • Introduced a generalised $(N, M)$-Exchange operator
  • Added statistics collection
  • Separated local search and intensification
  • Improved parent selection for crossover by focussing on the diversity of both parents
  • Simplified solution state
  • Removed many ineffective parameters and constructive heuristics
  • And more!

Our dynamic strategy (simulate) simulates requests from future epochs. In each epoch, we simulate multiple scenarios and quickly solve the resulting simulation instances using the static solver (in a few hundred milliseconds). We use the simulation solutions to determine which requests to postpone, and which to dispatch. In particular, we postpone a request if it was infrequently paired with must-dispatch requests, otherwise we dispatch it. We then solve the resulting dispatch instance, again using the static solver. We also:

  • Apply the simulation strategy in a recursive fashion
  • Use epoch-specific thresholds to determine which requests to postpone
  • Postpone routes from dispatch solutions if they do not contain any must-dispatch requests
  • And more!

Finally, we tuned the static and dynamic parameters in several large-scale numerical experiments.

How to use

First, one needs to install the required poetry dependencies:

poetry install

Then, one needs to compile the static solver. Assuming the pybind submodule has been initialised, and cmake is available, the following should work:

cmake -Brelease -Shgs_vrptw -DCMAKE_BUILD_TYPE=Release
make --directory=release

Then, the solver (both static and dynamic) can be called using the solver.py script. It is easiest to run this via the controller.py script, as (e.g.):

python controller.py --instance instances/ORTEC-VRPTW-ASYM-0bdff870-d1-n458-k35.txt --epoch_tlim 5 -- python solver.py

This runs the solver on the given dynamic instance, with a 5s time limit per epoch. Solving the static instance is achieved by also passing in the --static flag. Additional command line options are available, and can be found in the respective scripts.

We also offer several standalone scripts running multiple instances in parallel, which is useful for benchmarking. These scripts are:

  • analysis.py, which runs the static solver on all instances, collects statistics, and outputs lots of useful data to a given folder.
  • benchmark.py, which benchmarks the static solver over all instances.
  • benchmark_dynamic.py, which benchmarks the dynamic solver over all instances.

Finally, for tuning, we used the make_dynamic_parameters.py and make_static_parameters.py scripts. These produce configuration files that can be passed into any of the other scripts mentioned above. To run the tuning scripts, the optional tune dependency group should be installed, using:

poetry install --only tune

Contributors

Team

Supervision