Files
partridge-cpp/README.md
T
Codex instance 0b65501c73 test: add independent placement validation
Establish a CTest harness before changing solver behavior. Validate board dimensions, multiplicities, bounds, overlap and coverage against independent placement data, including known order-8 and constructed order-9 fixtures.

Document Debug and sanitizer workflows while keeping the defects tracked by #7 and #14 separate. Prepare a result adapter so the feasible solver regression can be enabled with the completion fix.

Tests: Release, ASan and UBSan CTest suites (3 passed each)

Refs: #1
2026-07-30 16:40:29 +01:00

66 lines
2.1 KiB
Markdown

# Partridge
The inspiration for this project is Stand-up Maths' YouTube video
[The impossible 2025 puzzle with over a million solutions](https://youtu.be/eqyuQZHfNPQ?si=hbOQdVKBC-jwvysk).
In the video Matt Parker shows solutions to the 8th and 9th Partridge
problems, and claims that solutions exist for all Partridge problems from
size eight and above. (There are no solutions to Partridge problems when N < 8).
Whilst I could see how you can get from a solution to the 2N-th problem to the
(2N+1)th problem I couldn't immediately see that a solution to the 8th & 9th
problems indicate that there would be a solution to the 10th or 12th.
So I set out to write some code that finds a solution to the Partridge problem.
Originally
[I wrote an OCaml version](https://gitea.gretton-dann.org.uk/mgrettondann/partridge-cpp.git)
of the code. However, my estimate of how long it would take to calculate a
solution to the 10th Partridge problem was around 36 hours on my Macbook Air.
So I moved to C++ which seems to be providing a 3x speed-up just by doing a
straight translation of the code. There are some further optimisations in the
C++ source which suggest finding a solution to the 10th Partridge problem will take
around 6 hours.
Some results can be seen in [results.md](./results.md)
## Copyright & Licence
This code is copyright 2025 Matthew Gretton-Dann. Licensed under the
[Apache-2.0 license](./LICENSE).
## Running the code
### Prerequisites
You must have `git`, `cmake`, `make` and a compiler capable of compiling C++20 code
on your path.
### Code checkout and setup.
It is strongly recommended that you make a Release build as shown in the
instructions below. The code is extremely slow in debug builds.
```sh
git clone https://gitea.gretton-dann.org.uk/mgrettondann/partridge-cpp.git
cmake -B build -S partridge-cpp -DCMAKE_BUILD_TYPE=Release
```
### Building
```sh
cmake --build build
```
### Executing
```sh
N=9 # Set N to largest size of square.
./build/partridge_cpp $N
```
### Testing
See [TESTING.md](./TESTING.md) for CTest, Debug, and sanitizer
instructions.