Add first version of the tutorial for solving the market split proble…

[murilo-kipu]

Tutorial: Solving the market split problem with Iskay Quantum Optimizer

This is the first version of the tutorial related to the market split use case. It is close related to the challenge being developed for the QDC 2025.

In this tutorial we give a brief introduction and background to the market split problem, to the algorithm behind Kipu's Qiskit Function and show how the users can solve instances of that problem in IBM. We also go a little further and analyse the result and compare it to different (simple) classical solvers, and by the end, hopefully the users are able to apply this knowledge to solve larger and harder instances, or even different problems.

I haven't run the full notebook with the Qiskit function yet, but here is the current notebook structure:

1. Solve Market Split Problem
   Introduction to the problem and Iskay optimizer.

2. Background
   Overview of the Market Split problem, its formulation, and computational challenges.

3. Requirements
   List of dependencies and setup instructions.

4. Setup
   Import libraries and configure credentials.

5. Step 1: Connect to Iskay Quantum Optimizer
   Establish connection to the optimizer.

6. Step 2: Load and Formulate the Problem
   Load problem data and convert it to QUBO format.

7. Step 3: Understanding bf-DCQO Algorithm
   Explanation of the quantum optimization algorithm.

8. Step 4: Configure and Run Optimization
   Set up and execute the optimization process.

9. Step 5: Analyze Results
   Validate and interpret the solution.

10. Step 6: Benchmark Against Classical Approaches
    Compare quantum results with classical methods.

11. Comparison Results and Analysis
    Evaluate solution quality and execution time.

12. Conclusion
    Summary of findings and next steps.

[qiskit-bot]

Thanks for contributing to Qiskit documentation!

Before your PR can be merged, it will first need to pass continuous integration tests and be reviewed. Sometimes the review process can be slow, so please be patient. Thanks! 🙌

[review-notebook-app]

Check out this pull request on 

See visual diffs & provide feedback on Jupyter Notebooks.

---

Powered by ReviewNB

[miamico]

Quick overall comments:

• let's follow the qiskit patterns for the steps. In my reading, your steps 1,2,3 are Step 1. in the qiskit pattern framework; your step 4 is Step 2,3 in the qiskit patterns; Step 5 and onwards are Step 4 in the qiskit patterns
• could you comment on why the brute force calculation takes less than any of the other methods?
• add the QPU usage (4s?) to the top of the notebook
• if this example takes so little qpu time but is still too easy for classical, can we go to a larger/more difficult example?