# グラフ辺彩色問題
:::{container} prog-cpp
無向グラフ $G=(V,E)$ が与えられたとき,**グラフ辺彩色問題**は,同じ色の2つの辺が共通の端点を持たないように各辺に色を割り当てることを目的とします.
より具体的には,色の集合 $C$ に対して,同じノードに接続する任意の2つの異なる辺 $e$ と $e'$ について $\sigma(e)\neq \sigma(e')$ となるような割り当て $\sigma:E\rightarrow C$ を求めます.
同等に,すべてのノード $u\in V$ と $(u,v)\in E$ かつ $(u,v')\in E$ である任意の2つの異なる隣接ノード $v\neq v'$ について,以下が成り立つ必要があります：
$$
\sigma((u,v))\neq \sigma((u,v')).
$$
グラフ辺彩色問題は QUBO 式として容易に定式化できます.
$V=\lbrace 0,1,\ldots,n−1\rbrace$,$C=\lbrace 0,1,\ldots,m−1\rbrace$ とします.
$s=∣E∣$ 本の辺に一意の ID $0,1,\ldots,s−1$ を割り当て,$(u_i,v_i)$ で第 $i$ 辺を表します.
$s\times m$ のバイナリ変数行列 $X=(x_{i,j})$ を導入し,$x_{i,j}=1$ は辺 $(u_i,v_i)$ に色 $j$ が割り当てられることを表します.
### ワンホット制約
各辺にちょうど1つの色を割り当てる必要があるため,$X$ の各行はワンホットでなければなりません：
$$
\begin{aligned}
\text{onehot}&= \sum_{i=0}^{s-1}\bigr(\sum_{j=0}^{m-1}x_{i,j}==1\bigl)\\
&=\sum_{i=0}^{s-1}\bigr(1-\sum_{j=0}^{m-1}x_{i,j}\bigl)^2
\end{aligned}
$$
### 接続辺は異なる色
各ノードについて,接続する任意の2つの異なる辺は同じ色を割り当ててはなりません.これは以下のようにペナルティ化できます：
$$
\begin{aligned}
\text{different}&= \sum_{u\in V}\sum_{\substack{i
## QUBO 目的関数
これらの式を組み合わせることで,QUBO 目的関数が得られます：
$$
\begin{aligned}
f &= \text{onehot}+\text{different}
\end{aligned}
$$
この目的関数は,有効な辺彩色が存在する場合にのみ最小値 0 を達成します.
## Hi-QUBO による定式化
単純グラフの辺彩色数は $\Delta$ または $\Delta+1$ であることが知られています.ここで $\Delta$ はグラフの最大次数です.以下の Hi-QUBO プログラムは,$n$ ノード,$s$ 辺のグラフに対して $m=\Delta$ 色での辺彩色を求めます：
```{literalinclude} /../programFiles/cppPrograms/example/graph/edge-color-program1.cpp
:language: cpp
:caption: edge-color-program1.cpp
```
このプログラムでは,まず接続リスト `adj` を構築します.`adj[i]` にはノード `i` に接続する辺のインデックスが格納されます.
次に,最大次数 $\Delta$ を計算し,`m=`$\Delta$ と設定します.
そして,`s`$\times$`m` のバイナリ変数行列 `x` を定義します.`x[i][j]=1` は辺 `i` に色 `j` が割り当てられることを意味します.
式 `onehot`,`different`,`f` を以下のように構築します：
- `onehot` は各辺にちょうど1つの色が割り当てられることを強制します.
- `different` は端点を共有し同じ色が割り当てられた辺のペアにペナルティを課します.
- `f = onehot + different` は QUBO 目的関数であり,有効な `m`-辺彩色が見つかった場合にのみ最小値 0 を達成します.
得られた QUBO を目標エネルギー 0 で Easy Solver を用いて解き,解を `sol` に格納します.次に,`sol` における `onehot` と `different` の値を出力します.
また,`sol(x)` に `qbpp::onehot_to_int()` を適用して,各辺に割り当てられた色を格納する `edge_color` を計算します.
最後に,`qbpp::graph::GraphDrawer` を使って辺彩色されたグラフを描画します.辺 `i` は色番号 `edge_color[i] + 1` で彩色されます.
関数 `qbpp::onehot_to_int()` は `[0,m−1]` の範囲の整数ベクトルを返し,各エントリは対応するワンホット行における 1 の位置を示します.行が有効なワンホットベクトルでない場合,その行に対して $−1$ を返します.この場合,辺の色は $−1+1=0$ となり,辺は色 0（黒）で描画されます.
このプログラムの出力は以下の通りです：
```{include} /../programFiles/markDown/example/graph/edge-color.md
:start-after:
:end-before:
```
したがって,`m = 6` 色を使った有効な辺彩色が見つかりました：
:::
:::{container} prog-python
無向グラフ $G=(V,E)$ が与えられたとき,**グラフ辺彩色問題**は,同じ色の2つの辺が共通の端点を持たないように各辺に色を割り当てることを目的とします.
より具体的には,色の集合 $C$ に対して,同じノードに接続する任意の2つの異なる辺 $e$ と $e'$ について $\sigma(e)\neq \sigma(e')$ となるような割り当て $\sigma:E\rightarrow C$ を求めます.
同等に,すべてのノード $u\in V$ と $(u,v)\in E$ かつ $(u,v')\in E$ である任意の2つの異なる隣接ノード $v\neq v'$ について,以下が成り立つ必要があります：
$$
\sigma((u,v))\neq \sigma((u,v')).
$$
グラフ辺彩色問題は QUBO 式として容易に定式化できます.
$V=\lbrace 0,1,\ldots,n−1\rbrace$,$C=\lbrace 0,1,\ldots,m−1\rbrace$ とします.
$s=|E|$ 本の辺に一意の ID $0,1,\ldots,s−1$ を割り当て,$(u_i,v_i)$ で第 $i$ 辺を表します.
$s\times m$ のバイナリ変数行列 $X=(x_{i,j})$ を導入し,$x_{i,j}=1$ は辺 $(u_i,v_i)$ に色 $j$ が割り当てられることを表します.
### ワンホット制約
各辺にちょうど1つの色を割り当てる必要があるため,$X$ の各行はワンホットでなければなりません：
$$
\begin{aligned}
\text{onehot}&= \sum_{i=0}^{s-1}\bigr(\sum_{j=0}^{m-1}x_{i,j}==1\bigl)\\
&=\sum_{i=0}^{s-1}\bigr(1-\sum_{j=0}^{m-1}x_{i,j}\bigl)^2
\end{aligned}
$$
### 接続辺は異なる色
各ノードについて,接続する任意の2つの異なる辺は同じ色を割り当ててはなりません.これは以下のようにペナルティ化できます：
$$
\begin{aligned}
\text{different}&= \sum_{u\in V}\sum_{\substack{i
## QUBO 目的関数
これらの式を組み合わせることで,QUBO 目的関数が得られます：
$$
\begin{aligned}
f &= \text{onehot}+\text{different}
\end{aligned}
$$
この目的関数は,有効な辺彩色が存在する場合にのみ最小値 0 を達成します.
## PyQBPP による定式化
単純グラフの辺彩色数は $\Delta$ または $\Delta+1$ であることが知られています.ここで $\Delta$ はグラフの最大次数です.以下の PyQBPP プログラムは,$n$ ノード,$s$ 辺のグラフに対して $m=\Delta$ 色での辺彩色を求めます：
```{literalinclude} /../programFiles/pythonPrograms/example/graph/edge-color-program1.py
:language: python
:caption: edge-color-program1.py
```
このプログラムでは,まず接続リスト `adj` を構築します.`adj[i]` にはノード `i` に接続する辺のインデックスが格納されます.
次に,最大次数 $\Delta$ を計算し,`m=`$\Delta$ と設定します.
そして,`s`$\times$`m` のバイナリ変数行列 `x` を定義します.`x[i][j]=1` は辺 `i` に色 `j` が割り当てられることを意味します.
式 `onehot`,`different`,`f` を以下のように構築します：
- `onehot` は各辺にちょうど1つの色が割り当てられることを強制します.`qbpp.vector_sum(x)` で各行の総和を取り,`qbpp.vector_sum(x) == 1` で各行に対する制約を作成します.
- `different` は端点を共有し同じ色が割り当てられた辺のペアにペナルティを課します.`x[u] * x[v]` で2つの行の要素積を取り,`qbpp.sum()` で `m` 個の色の列にわたって和を取ります.
- `f = onehot + different` は QUBO 目的関数であり,有効な `m`-辺彩色が見つかった場合にのみ最小値 0 を達成します.
得られた QUBO を `target_energy=0` で Easy Solver を用いて解き,解を `sol` に格納します.次に,`sol` における `onehot` と `different` の値を出力します.
また,`sol(x)` の各行を走査して 1 の位置を記録することで,各辺に割り当てられた色を格納する `edge_color` を計算します.行が有効なワンホットベクトルでない場合,代わりに `-1` を記録します.
このプログラムの出力は以下の通りです：
```{include} /../programFiles/markDown/example/graph/edge-color.md
:start-after:
:end-before:
```
したがって,`m = 6` 色を使った有効な辺彩色が見つかりました.
## matplotlib による可視化
以下のコードは,辺彩色の解を可視化します.各辺はソルバーが割り当てた色で描画され,固定のパレットを循環的に使用します：
```{literalinclude} /../programFiles/pythonPrograms/example/graph/edge-color-program2.py
:language: python
:caption: edge-color-program2.py
```
各辺は割り当てられた色に従って彩色され,端点を共有する2つの辺は異なる色となります.
:::