Release Notes

Release Notes#

Version 0.0.1#

Initial Release - QOBLIB Dataset Collection

Overview#

This initial release establishes OMMX Quantum Benchmarks as a collection of optimization benchmark datasets in OMMX format. The first collection includes selected datasets from the QOBLIB (Quantum Optimization Benchmarking Library).

Scope: This release focuses on QOBLIB datasets, with framework designed to accommodate additional benchmark sources in future releases.

Features#

  • Python API for accessing quantum optimization benchmark datasets

  • OMMX format conversion and standardization

  • GitHub Container Registry integration for distributed data access

  • Consistent interface across all dataset categories

  • Comprehensive documentation with usage guides and examples

  • Bilingual documentation (English and Japanese)

Documentation#

  • Quick Start Guide: Installation instructions and basic usage examples

  • Usage Guide:

    • QOBLIB collections and dataset access patterns

  • Examples:

    • QOBLIB with SCIP solver integration

  • API Reference: Complete documentation of the Python API

Currently Available Data#

From QOBLIB Collection:

  • Marketsplit (01): 120 instances per model for binary linear and binary unconstrained formulations

  • Labs (02): 99 instances per model for integer and quadratic unconstrained formulations

  • Birkhoff (03): 800 instances with integer linear formulations

  • Steiner (04): 31 instances with integer linear formulations

  • Independent Set (07): 42 instances per model for binary linear and binary unconstrained formulations

  • Network (08): 20 instances for integer LP formulations

  • Routing (09): 55 instances for integer linear formulations

  • Topology (10): 16 instances per model for flow MIP, Seidel linear, and Seidel quadratic formulations

Framework Defined for Future Expansion:

  • Sports (05): Mixed integer linear sports scheduling problems

  • Portfolio (06): Binary quadratic and quadratic unconstrained portfolio optimization

Attribution#

All converted data is derived from the original QOBLIB repository created by Thorsten Koch, David E. Bernal Neira, Ying Chen, Giorgio Cortiana, Daniel J. Egger, Raoul Heese, Narendra N. Hegade, Alejandro Gomez Cadavid, Rhea Huang, Toshinari Itoko, Thomas Kleinert, Pedro Maciel Xavier, Naeimeh Mohseni, Jhon A. Montanez-Barrera, Koji Nakano, Giacomo Nannicini, Corey O’Meara, Justin Pauckert, Manuel Proissl, Anurag Ramesh, Maximilian Schicker, Noriaki Shimada, Mitsuharu Takeori, Victor Valls, David Van Bulck, Stefan Woerner, and Christa Zoufal, licensed under CC BY 4.0.

Contents