# 切出し問題（Cutting Stock Problem）
:::{container} prog-cpp
固定長 $L$ の同一の棒が $M$ 本と,ペア $(l_j,c_j)$ ($0\leq j\leq N-1$) で指定される $N$ 件の注文が与えられるとします.ここで $l_j$ は必要な長さ,$c_j$ は注文 $j$ の必要数量です.
**切出し問題**は,$M$ 本の棒をどのように切断すればすべての注文を満たせるかを決定することを目的とします.
一般に,切出し問題は使用する棒の本数を最小化する最小化問題として定式化されます.
簡単のため,この例では $M$ 本の棒で $N$ 件のすべての注文を満たせるかどうかを判定する実行可能性問題を考えます.
$x_{i,j}$ ($0\leq i\leq M-1, 0\leq j\leq N-1$) を棒 $i$ から切り出す注文 $j$ のピース数とします.
以下の制約を満たす必要があります.
### 注文制約：
各注文 $j$ について,すべての棒に割り当てられたピースの合計は $c_j$ に等しくなければなりません：
$$
\begin{aligned}
\sum_{i=0}^{M-1}x_{i,j} &= c_j & &(0\leq j\leq N-1)
\end{aligned}
$$
### 棒制約
各棒 $i$ について,割り当てられたピースの合計長は $L$ を超えてはなりません：
$$
\begin{aligned}
\sum_{j=0}^{N-1}l_jx_{i,j} &\leq L & &(0\leq i\leq M-1)
\end{aligned}
$$
## Hi-QUBOプログラム
以下のHi-QUBOプログラムは,長さ $L=60$ の $M=6$ 本の棒と以下の $N=4$ 件の注文に対する実行可能な切断計画を求めます：
| 注文 $j$ | 0 | 1 | 2 | 3 |
|:---:|:---:|:---:|:---:|:---:|
| 長さ $l_j$ | 13 | 23 | 8 | 11 |
| 数量 $c_j$ | 10 | 4 | 8 | 6 |
この切出し問題のHi-QUBOプログラムは以下のとおりです：
```{literalinclude} /../programFiles/cppPrograms/example/real/cutting-stock-program1.cpp
:language: cpp
:caption: cutting-stock-program1.cpp
```
このプログラムは整数変数の `M`$\times$`N` 行列 `x` を作成し,定数値0で初期化します.
ネストされたforループにより,各エントリ `x[i][j]` に上限付き整数変数 `0 <= qbpp::var_int(...) <= c[j]` が割り当てられ,`x[i][j]` は `c[j]` 以下の非負整数値をとります.
制約は以下のように定義されます：
- `order_fulfilled_count`: $N$ 個の式の配列で,`order_fulfilled_count[j]` は注文 $j$ について生産されたピースの合計数を表します.
- `order_constraint`: すべての $j$ に対して `order_fulfilled_count[j] == c[j]` を強制する $N$ 個の制約式の配列です.
- `bar_length_used`: $M$ 個の式の配列で,`bar_length_used[i]` は棒 $i$ で使用された合計長を表します.
- `bar_constraint`: すべての $i$ に対して `0 <= bar_length_used[i] <= L` を強制する $M$ 個の制約式の配列です.
- `f`: すべての制約式の和です.`f.simplify_as_binary()` を呼び出した後,Easy Solverはターゲットエネルギー0（すなわちすべての制約が満たされた状態）の解を探索します.
以下の出力は実行可能解の例です：
```{include} /../programFiles/markDown/example/real/cutting-stock.md
:start-after:
:end-before:
```
$N=4$ 件のすべての注文が $M=6$ 本の棒で満たされていることがわかります.
$M=5$ に設定すると,ソルバーは以下の実行不可能な解を返し,すべての注文が満たされていません：
```{include} /../programFiles/markDown/example/real/cutting-stock.md
:start-after:
:end-before:
```
## `qbpp::cons()` で制約を表す
注文制約と長さ制約は,`qbpp::cons()` で囲むことで制約として印を付けられます.
`qbpp::cons()` は制約の配列を合計するので,`qbpp::sum(...)` は不要になります.
`sol(bar_length_used[i])` や `sol(order_fulfilled_count[j])` による報告を含む
残りの部分はそのままです:
```{literalinclude} /../programFiles/cppPrograms/example/real/cutting-stock-program2.cpp
:language: cpp
:caption: cutting-stock-program2.cpp
```
このプログラムは,例えば次のような実行可能な切り出し計画を見つけます:
```{include} /../programFiles/markDown/example/real/cutting-stock.md
:start-after:
:end-before:
```
2つの定式化は等価です.制約を `qbpp::cons()` で囲むことで,バンドルされた
ソルバーがそれらを制約として扱います.`f.cons(sol)` は違反した制約の本数を
返します（実行可能な計画では `0`）.
:::
:::{container} prog-python
固定長 $L$ の同一の棒が $M$ 本と,ペア $(l_j,c_j)$ ($0\leq j\leq N-1$) で指定される $N$ 件の注文が与えられるとします.ここで $l_j$ は必要な長さ,$c_j$ は注文 $j$ の必要数量です.
**切出し問題**は,$M$ 本の棒をどのように切断すればすべての注文を満たせるかを決定することを目的とします.
一般に,切出し問題は使用する棒の本数を最小化する最小化問題として定式化されます.
簡単のため,この例では $M$ 本の棒で $N$ 件のすべての注文を満たせるかどうかを判定する実行可能性問題を考えます.
$x_{i,j}$ ($0\leq i\leq M-1, 0\leq j\leq N-1$) を棒 $i$ から切り出す注文 $j$ のピース数とします.
以下の制約を満たす必要があります.
### 注文制約：
各注文 $j$ について,すべての棒に割り当てられたピースの合計は $c_j$ に等しくなければなりません：
$$
\begin{aligned}
\sum_{i=0}^{M-1}x_{i,j} &= c_j & &(0\leq j\leq N-1)
\end{aligned}
$$
### 棒制約
各棒 $i$ について,割り当てられたピースの合計長は $L$ を超えてはなりません：
$$
\begin{aligned}
\sum_{j=0}^{N-1}l_jx_{i,j} &\leq L & &(0\leq i\leq M-1)
\end{aligned}
$$
## PyQBPPプログラム
以下のPyQBPPプログラムは,長さ $L=60$ の $M=6$ 本の棒と以下の $N=4$ 件の注文に対する実行可能な切断計画を求めます：
| 注文 $j$ | 0 | 1 | 2 | 3 |
|:---:|:---:|:---:|:---:|:---:|
| 長さ $l_j$ | 13 | 23 | 8 | 11 |
| 数量 $c_j$ | 10 | 4 | 8 | 6 |
この切出し問題のPyQBPPプログラムは以下のとおりです：
```{literalinclude} /../programFiles/pythonPrograms/example/real/cutting-stock-program1.py
:language: python
:caption: cutting-stock-program1.py
```
このプログラムは整数変数の `M`$\times$`N` 行列 `x` を作成します.各エントリ `x[i][j]` は `qbpp.var(between=(0, c[j]))` により生成され,`c[j]` 以下の非負整数値をとります.
制約は以下のように定義されます：
- `order_fulfilled_count`: $N$ 個の式のリストで,`order_fulfilled_count[j]` は注文 $j$ について生産されたピースの合計数を表します.
- `order_constraint`: `(col_sum == c[j])` で構築された $N$ 個の制約式の和で,すべての $j$ に対して `col_sum == c[j]` を強制します.
- `bar_length_used`: $M$ 個の式のリストで,`bar_length_used[i]` は棒 $i$ で使用された合計長を表します.
- `bar_constraint`: `(0 <= used) & (qbpp.same <= L)` で構築された $M$ 個の制約式の和で,すべての $i$ に対して `0 <= bar_length_used[i] <= L` を強制します.
- `f`: すべての制約式の和です.`f.simplify_as_binary()` を呼び出した後,Easy Solverはターゲットエネルギー0（すなわちすべての制約が満たされた状態）の解を探索します.
以下の出力は実行可能解の例です：
```{include} /../programFiles/markDown/example/real/cutting-stock.md
:start-after:
:end-before:
```
$N=4$ 件のすべての注文が $M=6$ 本の棒で満たされていることがわかります.
$M=5$ に設定すると,ソルバーは以下の実行不可能な解を返し,すべての注文が満たされていません：
```{include} /../programFiles/markDown/example/real/cutting-stock.md
:start-after:
:end-before:
```
## `qbpp.cons()` で制約を表す
注文制約と長さ制約は,`qbpp.cons()` で囲むことで制約として印を付けられます.
変更は,蓄積する各制約を `qbpp.cons()` で囲むことだけです.
`sol(bar_length_used[i])` や `sol(order_fulfilled_count[j])` による報告を含む
残りの部分はそのままです:
```{literalinclude} /../programFiles/pythonPrograms/example/real/cutting-stock-program2.py
:language: python
:caption: cutting-stock-program2.py
```
このプログラムは,例えば次のような実行可能な切り出し計画を見つけます:
```{include} /../programFiles/markDown/example/real/cutting-stock.md
:start-after:
:end-before:
```
2つの定式化は等価です.制約を `qbpp.cons()` で囲むことで,バンドルされた
ソルバーがそれらを制約として扱います.`f.cons(sol)` は違反した制約の本数を
返します（実行可能な計画では `0`）.
:::