# 加算器シミュレーション
:::{container} prog-cpp
## 全加算器とリプルキャリー加算器
全加算器は3つの入力ビット $a$,$b$,$i$（キャリー入力）と,
$o$（キャリー出力）および $s$（和）を持ちます.
3つの入力ビットの和は,これら2つの出力ビットを使って表されます.
リプルキャリー加算器は,以下に示すように複数の全加算器をカスケード接続することで,2つの多ビット整数の和を計算します:
このリプルキャリー加算器は,4つの全加算器を使って2つの4ビット整数 $x_3x_2x_1x_0$ と $y_3y_2y_1y_0$ の和を計算し,4ビットの和 $z_3z_2z_1z_0$ を出力します.
対応する5ビットのキャリー信号 $c_4c_3c_2c_1c_0$ も示されています.
## 全加算器のQUBO定式化
全加算器は以下の式を用いて定式化できます:
$$
\begin{aligned}
fa(a,b,i,o,s) &=((a+b+i)-(2o+s))^2
\end{aligned}
$$
この式は,5つの変数が有効な全加算器の動作と整合する値を取るとき,かつそのときに限り,最小値0を達成します.
以下のHi-QUBOプログラムは,Exhaustive Solverを使ってこの定式化を検証します:
```{literalinclude} /../programFiles/cppPrograms/example/math/adder-program1.cpp
:language: cpp
:caption: adder-program1.cpp
```
このQUBOプログラムでは,制約 $fa(a,b,i,o,s)$ は等号演算子 `==` を使って実装されており,直感的に制約 $a+b+i=2o+s$ を表しています.
プログラムは以下の出力を生成し,式が全加算器を正しくモデル化していることを確認します:
```{include} /../programFiles/markDown/example/math/adder.md
:start-after:
:end-before:
```
一部のビットを固定すると,残りのビットの有効な値を導出できます.
例えば,`qbpp::replace()` 関数で3つの入力ビットを固定します（グローバル関数を使うことで制約式のメタデータが保たれます）:
```{include} /../programFiles/markDown/example/math/adder.md
:start-after:
:end-before:
```
この場合,`qbpp::ExhaustiveSolver(fa2)` で解を探索します.
プログラムは以下の出力を生成します:
```{include} /../programFiles/markDown/example/math/adder.md
:start-after:
:end-before:
```
逆に,2つの出力ビットを固定した場合:
```{include} /../programFiles/markDown/example/math/adder.md
:start-after:
:end-before:
```
プログラムは入力ビットのすべての有効な組み合わせを出力します:
```{include} /../programFiles/markDown/example/math/adder.md
:start-after:
:end-before:
```
## 複数の全加算器を用いたリプルキャリー加算器のシミュレーション
全加算器のQUBO式を使って,リプルキャリー加算器をシミュレートするQUBO式を構築できます.
以下のHi-QUBOプログラムは,4つの全加算器を組み合わせて4ビット加算器をシミュレートするQUBO式を作成します:
```{literalinclude} /../programFiles/cppPrograms/example/math/adder-program2.cpp
:language: cpp
:caption: adder-program2.cpp
```
このHi-QUBOプログラムでは,全加算器を表す4つの `qbpp::Expr` オブジェクトが `replace()` 関数を使って作成され,単一の式 `adder` にまとめられます.
次にExhaustive Solverがすべての最適解を列挙します.
このプログラムは512個の有効な解を生成し,4ビット加算器のすべての可能な入力の組み合わせに対応します:
```{include} /../programFiles/markDown/example/math/adder.md
:start-after:
:end-before:
```
あるいは,C++関数 `fa` を定義して,全加算器の制約をより簡潔で読みやすい形式で構築することもできます:
```{literalinclude} /../programFiles/cppPrograms/example/math/adder-program3.cpp
:language: cpp
:caption: adder-program3.cpp
```
このプログラムは前の実装と同じ512個の最適解を生成します.
一部のバイナリ変数を固定すると,残りの変数の有効な値をExhaustive Solverで導出できます.
例えば,以下の `qbpp::MapList` オブジェクト `ml` はキャリー入力,キャリー出力,および和のビットを固定します:
```{include} /../programFiles/markDown/example/math/adder.md
:start-after:
:end-before:
```
結果のプログラムは以下の出力を生成します:
```{include} /../programFiles/markDown/example/math/adder.md
:start-after:
:end-before:
```
:::
:::{container} prog-python
## 全加算器とリプルキャリー加算器
全加算器は3つの入力ビット $a$,$b$,$i$（キャリー入力）と,
$o$（キャリー出力）および $s$（和）を持ちます.
3つの入力ビットの和は,これら2つの出力ビットを使って表されます.
リプルキャリー加算器は,以下に示すように複数の全加算器をカスケード接続することで,2つの多ビット整数の和を計算します:
このリプルキャリー加算器は,4つの全加算器を使って2つの4ビット整数 $x_3x_2x_1x_0$ と $y_3y_2y_1y_0$ の和を計算し,4ビットの和 $z_3z_2z_1z_0$ を出力します.
対応する5ビットのキャリー信号 $c_4c_3c_2c_1c_0$ も示されています.
## 全加算器の QUBO 定式化
全加算器は以下の式を用いて定式化できます:
$$
\begin{aligned}
fa(a,b,i,o,s) &=((a+b+i)-(2o+s))^2
\end{aligned}
$$
この式は,5つの変数が有効な全加算器の動作と整合する値を取るとき,かつそのときに限り,最小値 0 を達成します.
以下の PyQBPP プログラムは,Exhaustive Solver を使ってこの定式化を検証します:
```{literalinclude} /../programFiles/pythonPrograms/example/math/adder-program1.py
:language: python
:caption: adder-program1.py
```
この PyQBPP プログラムでは,制約 $fa(a,b,i,o,s)$ は `... == 0` を使って実装されており,直感的に制約 $a+b+i=2o+s$ を表しています.
`best_energy_sols=0` を指定することで,最小（最良）エネルギーを達成するすべての解を個数制限なしで収集します.
プログラムは以下の出力を生成し,式が全加算器を正しくモデル化していることを確認します:
```{include} /../programFiles/markDown/example/math/adder.md
:start-after:
:end-before:
```
各行は,インデックス,エネルギー（有効な割り当てでは 0）,およびすべての変数の値を示します.全加算器の真理値表の8行すべてが最適解として現れます.
一部のビットを固定すると,残りのビットの有効な値を導出できます.
例えば,`qbpp.replace()` 関数で3つの入力ビットを固定します:
```{include} /../programFiles/markDown/example/math/adder.md
:start-after:
:end-before:
```
`qbpp.replace(expr, mapping)` は,辞書内の各キーを対応する値（定数または別の変数や式）で置換した新しい式を返します.元の `fa` は変更されません.この場合,`qbpp.ExhaustiveSolver(fa2)` で解を探索します.
プログラムは以下の出力を生成します:
```{include} /../programFiles/markDown/example/math/adder.md
:start-after:
:end-before:
```
これは $1 + 1 + 0$ に対する期待されるキャリー出力と和です.
逆に,2つの出力ビットを固定した場合:
```{include} /../programFiles/markDown/example/math/adder.md
:start-after:
:end-before:
```
プログラムは入力ビットのすべての有効な組み合わせを出力します:
```{include} /../programFiles/markDown/example/math/adder.md
:start-after:
:end-before:
```
## 複数の全加算器を用いたリプルキャリー加算器のシミュレーション
全加算器の QUBO 式を使って,リプルキャリー加算器をシミュレートする QUBO 式を構築できます.
以下の PyQBPP プログラムは,4つの全加算器を組み合わせて4ビット加算器をシミュレートする QUBO 式を作成します:
```{literalinclude} /../programFiles/pythonPrograms/example/math/adder-program2.py
:language: python
:caption: adder-program2.py
```
この PyQBPP プログラムでは,全加算器を表す4つの式が `replace()` 関数を使って作成され,単一の式 `adder` にまとめられます.
ここで `qbpp.var("x", shape=4)` は4つのバイナリ変数 `x[0], x[1], x[2], x[3]` の array を返し,`qbpp.replace()` に渡す辞書で各スカラのプレースホルダ（`a`,`b`,`i`,`o`,`s`）を対応する配列要素に置換します.
次に Exhaustive Solver がすべての最適解を列挙します.`sol(x)`,`sol(y)`,`sol(c)`,`sol(z)` は配列に割り当てられた値を Python のリストとして返します.
このプログラムは512個の有効な解を生成し,4ビット加算器のすべての可能な入力の組み合わせに対応します:
```{include} /../programFiles/markDown/example/math/adder.md
:start-after:
:end-before:
```
これら512個の解は,4ビット入力 `x`,`y`,および初期キャリー入力 `c[0]` のすべての組み合わせ（24 x 24 x 2 = 512）に対応します.
あるいは,Python 関数 `fa` を定義して,全加算器の制約をより簡潔で読みやすい形式で構築することもできます:
```{literalinclude} /../programFiles/pythonPrograms/example/math/adder-program3.py
:language: python
:caption: adder-program3.py
```
このプログラムは前の実装と同じ512個の最適解を生成します.
一部のバイナリ変数を固定すると,残りの変数の有効な値を Exhaustive Solver で導出できます.
例えば,以下の辞書 `ml` はキャリー入力,キャリー出力,および和のビットを固定します:
```{include} /../programFiles/markDown/example/math/adder.md
:start-after:
:end-before:
```
これは4ビットの和 `z = 1101`（2進数,最下位ビットから: `z[0]=1, z[1]=0, z[2]=1, z[3]=1`）と,キャリー入力 `c[0]=0`,キャリー出力 `c[4]=1` を割り当てます.すなわち,初期キャリーなしで和 $x + y = 11101_{2} = 29$ を表します.
結果のプログラムは以下の出力を生成します:
```{include} /../programFiles/markDown/example/math/adder.md
:start-after:
:end-before:
```
どちらの解も $14 + 15 = 29$ と $15 + 14 = 29$ に対応しており,指定されたキャリーパターンで4ビットの和 `1101` を得る2通りの方法です.
出力で `z` と固定したキャリービットが `0` と表示される点に注意してください.`replace()` は固定した変数をモデルから消去するため,`sol(z)` / `sol(c[4])` は割り当てた `1101` / `1` ではなくデフォルト値を返します.実際に解かれている変数は `x` と `y` です.
:::