Re-translate the Japanese version (#1871)

* Retranslate Japanese docs with GPT-5.4

* Retranslate Japanese code with GPT-5.4

ja/codes/python/chapter_graph/graph_adjacency_list.py

@@ -16,7 +16,7 @@ class GraphAdjList:
 
     def __init__(self, edges: list[list[Vertex]]):
         """コンストラクタ"""
-        # 隣接リスト、キー: 頂点、値: その頂点の隣接する全頂点
+        # 隣接リスト。key は頂点、value はその頂点に隣接する全頂点
         self.adj_list = dict[Vertex, list[Vertex]]()
         # すべての頂点と辺を追加
         for edge in edges:
@@ -48,16 +48,16 @@ class GraphAdjList:
         """頂点を追加"""
         if vet in self.adj_list:
             return
-        # 隣接リストに新しい連結リストを追加
+        # 隣接リストに新しいリストを追加
         self.adj_list[vet] = []
 
     def remove_vertex(self, vet: Vertex):
         """頂点を削除"""
         if vet not in self.adj_list:
             raise ValueError()
-        # 隣接リストから頂点vetに対応する連結リストを削除
+        # 隣接リストから頂点 vet に対応するリストを削除
         self.adj_list.pop(vet)
-        # 他の頂点の連結リストを走査し、vetを含むすべての辺を削除
+        # 他の頂点のリストを走査し、vet を含むすべての辺を削除
         for vertex in self.adj_list:
             if vet in self.adj_list[vertex]:
                 self.adj_list[vertex].remove(vet)
@@ -70,7 +70,7 @@ class GraphAdjList:
             print(f"{vertex.val}: {tmp},")
 
 
-"""ドライバコード"""
+"""Driver Code"""
 if __name__ == "__main__":
     # 無向グラフを初期化
     v = vals_to_vets([1, 3, 2, 5, 4])
@@ -86,26 +86,26 @@ if __name__ == "__main__":
     print("\n初期化後、グラフは")
     graph.print()
 
-    # 辺を追加
-    # 頂点1、2 つまり v[0], v[2]
+    # 辺を追加する
+    # 頂点 1, 2 は `v[0]`, `v[2]`
     graph.add_edge(v[0], v[2])
-    print("\n辺1-2を追加後、グラフは")
+    print("\n辺 1-2 を追加した後、グラフは")
     graph.print()
 
-    # 辺を削除
-    # 頂点1、3 つまり v[0], v[1]
+    # 辺を削除する
+    # 頂点 1, 3 はそれぞれ v[0], v[1]
     graph.remove_edge(v[0], v[1])
-    print("\n辺1-3を削除後、グラフは")
+    print("\n辺 1-3 を削除した後、グラフは")
     graph.print()
 
     # 頂点を追加
     v5 = Vertex(6)
     graph.add_vertex(v5)
-    print("\n頂点6を追加後、グラフは")
+    print("\n頂点 6 を追加した後、グラフは")
     graph.print()
 
-    # 頂点を削除
-    # 頂点3 つまり v[1]
+    # 頂点を削除する
+    # 頂点 3 は v[1]
     graph.remove_vertex(v[1])
-    print("\n頂点3を削除後、グラフは")
-    graph.print()
+    print("\n頂点 3 を削除した後、グラフは")
+    graph.print()

ja/codes/python/chapter_graph/graph_adjacency_matrix.py

@@ -16,15 +16,15 @@ class GraphAdjMat:
 
     def __init__(self, vertices: list[int], edges: list[list[int]]):
         """コンストラクタ"""
-        # 頂点リスト、要素は「頂点値」を表し、インデックスは「頂点インデックス」を表す
+        # 頂点リスト。要素は「頂点値」、インデックスは「頂点インデックス」を表す
         self.vertices: list[int] = []
-        # 隣接行列、行と列のインデックスは「頂点インデックス」に対応
+        # 隣接行列。行・列のインデックスは「頂点インデックス」に対応
         self.adj_mat: list[list[int]] = []
         # 頂点を追加
         for val in vertices:
             self.add_vertex(val)
         # 辺を追加
-        # edges要素は頂点インデックスを表す
+        # 注意：edges の各要素は頂点インデックスを表し、vertices の要素インデックスに対応する
         for e in edges:
             self.add_edge(e[0], e[1])
 
@@ -35,12 +35,12 @@ class GraphAdjMat:
     def add_vertex(self, val: int):
         """頂点を追加"""
         n = self.size()
-        # 頂点リストに新しい頂点値を追加
+        # 頂点リストに新しい頂点の値を追加
         self.vertices.append(val)
-        # 隣接行列に行を追加
+        # 隣接行列に 1 行追加
         new_row = [0] * n
         self.adj_mat.append(new_row)
-        # 隣接行列に列を追加
+        # 隣接行列に 1 列追加
         for row in self.adj_mat:
             row.append(0)
 
@@ -48,28 +48,28 @@ class GraphAdjMat:
         """頂点を削除"""
         if index >= self.size():
             raise IndexError()
-        # 頂点リストから`index`の頂点を削除
+        # 頂点リストから index の頂点を削除する
         self.vertices.pop(index)
-        # 隣接行列から`index`の行を削除
+        # 隣接行列で index 行を削除する
         self.adj_mat.pop(index)
-        # 隣接行列から`index`の列を削除
+        # 隣接行列で index 列を削除する
         for row in self.adj_mat:
             row.pop(index)
 
     def add_edge(self, i: int, j: int):
         """辺を追加"""
-        # パラメータi、jは頂点要素のインデックスに対応
-        # インデックスの範囲外と等価性を処理
+        # パラメータ i, j は vertices の要素インデックスに対応する
+        # 範囲外と同値の場合の処理
         if i < 0 or j < 0 or i >= self.size() or j >= self.size() or i == j:
             raise IndexError()
-        # 無向グラフでは、隣接行列は主対角線について対称、すなわち (i, j) == (j, i) を満たす
+        # 無向グラフでは、隣接行列は主対角線に関して対称、すなわち (i, j) == (j, i) を満たす
         self.adj_mat[i][j] = 1
         self.adj_mat[j][i] = 1
 
     def remove_edge(self, i: int, j: int):
         """辺を削除"""
-        # パラメータi、jは頂点要素のインデックスに対応
-        # インデックスの範囲外と等価性を処理
+        # パラメータ i, j は vertices の要素インデックスに対応する
+        # 範囲外と同値の場合の処理
         if i < 0 or j < 0 or i >= self.size() or j >= self.size() or i == j:
             raise IndexError()
         self.adj_mat[i][j] = 0
@@ -82,35 +82,35 @@ class GraphAdjMat:
         print_matrix(self.adj_mat)
 
 
-"""ドライバコード"""
+"""Driver Code"""
 if __name__ == "__main__":
-    # 無向グラフを初期化
-    # edges要素は頂点インデックスを表す
+    # 無向グラフを初期化する
+    # 注意: edges の要素は頂点インデックスであり、vertices の要素インデックスに対応する
     vertices = [1, 3, 2, 5, 4]
     edges = [[0, 1], [0, 3], [1, 2], [2, 3], [2, 4], [3, 4]]
     graph = GraphAdjMat(vertices, edges)
     print("\n初期化後、グラフは")
     graph.print()
 
-    # 辺を追加
-    # 頂点1、2のインデックスはそれぞれ0、2
+    # 辺を追加する
+    # 頂点 1, 2 のインデックスはそれぞれ 0, 2
     graph.add_edge(0, 2)
-    print("\n辺1-2を追加後、グラフは")
+    print("\n辺 1-2 を追加した後、グラフは")
     graph.print()
 
-    # 辺を削除
-    # 頂点1、3のインデックスはそれぞれ0、1
+    # 辺を削除する
+    # 頂点 1, 3 のインデックスはそれぞれ 0, 1
     graph.remove_edge(0, 1)
-    print("\n辺1-3を削除後、グラフは")
+    print("\n辺 1-3 を削除した後、グラフは")
     graph.print()
 
     # 頂点を追加
     graph.add_vertex(6)
-    print("\n頂点6を追加後、グラフは")
+    print("\n頂点 6 を追加した後、グラフは")
     graph.print()
 
-    # 頂点を削除
-    # 頂点3のインデックスは1
+    # 頂点を削除する
+    # 頂点 3 のインデックスは 1
     graph.remove_vertex(1)
-    print("\n頂点3を削除後、グラフは")
-    graph.print()
+    print("\n頂点 3 を削除した後、グラフは")
+    graph.print()

ja/codes/python/chapter_graph/graph_bfs.py

@@ -14,29 +14,29 @@ from graph_adjacency_list import GraphAdjList
 
 
 def graph_bfs(graph: GraphAdjList, start_vet: Vertex) -> list[Vertex]:
-    """幅優先走査"""
-    # 隣接リストを使用してグラフを表現し、指定された頂点のすべての隣接頂点を取得
-    # 頂点走査シーケンス
+    """幅優先探索"""
+    # 指定した頂点の隣接頂点をすべて取得できるよう、隣接リストでグラフを表現する
+    # 頂点の走査順序
     res = []
-    # ハッシュセット、訪問済み頂点を記録するために使用
+    # 訪問済み頂点を記録するためのハッシュ集合
     visited = set[Vertex]([start_vet])
-    # BFSを実装するために使用されるキュー
+    # BFS の実装にキューを用いる
     que = deque[Vertex]([start_vet])
-    # 頂点vetから開始し、すべての頂点が訪問されるまでループ
+    # 頂点 vet を起点に、すべての頂点を訪問し終えるまで繰り返す
     while len(que) > 0:
-        vet = que.popleft()  # キューの先頭の頂点をデキュー
-        res.append(vet)  # 訪問済み頂点を記録
-        # その頂点のすべての隣接頂点を走査
+        vet = que.popleft()  # 先頭の頂点をデキュー
+        res.append(vet)  # 訪問した頂点を記録
+        # この頂点のすべての隣接頂点を走査
         for adj_vet in graph.adj_list[vet]:
             if adj_vet in visited:
-                continue  # 既に訪問済みの頂点をスキップ
-            que.append(adj_vet)  # 未訪問の頂点のみをエンキュー
-            visited.add(adj_vet)  # 頂点を訪問済みとしてマーク
-    # 頂点走査シーケンスを返す
+                continue  # 訪問済みの頂点をスキップ
+            que.append(adj_vet)  # 未訪問の頂点のみをキューに追加
+            visited.add(adj_vet)  # この頂点を訪問済みにする
+    # 頂点の走査順を返す
     return res
 
 
-"""ドライバコード"""
+"""Driver Code"""
 if __name__ == "__main__":
     # 無向グラフを初期化
     v = vals_to_vets([0, 1, 2, 3, 4, 5, 6, 7, 8, 9])
@@ -58,7 +58,7 @@ if __name__ == "__main__":
     print("\n初期化後、グラフは")
     graph.print()
 
-    # 幅優先走査
+    # 幅優先探索
     res = graph_bfs(graph, v[0])
-    print("\n幅優先走査（BFS）の頂点シーケンスは")
-    print(vets_to_vals(res))
+    print("\n幅優先探索（BFS）の頂点順序は")
+    print(vets_to_vals(res))

ja/codes/python/chapter_graph/graph_dfs.py

@@ -13,29 +13,29 @@ from graph_adjacency_list import GraphAdjList
 
 
 def dfs(graph: GraphAdjList, visited: set[Vertex], res: list[Vertex], vet: Vertex):
-    """深さ優先走査のヘルパー関数"""
-    res.append(vet)  # 訪問済み頂点を記録
-    visited.add(vet)  # 頂点を訪問済みとしてマーク
-    # その頂点のすべての隣接頂点を走査
+    """深さ優先走査の補助関数"""
+    res.append(vet)  # 訪問した頂点を記録
+    visited.add(vet)  # この頂点を訪問済みにする
+    # この頂点のすべての隣接頂点を走査
     for adjVet in graph.adj_list[vet]:
         if adjVet in visited:
-            continue  # 既に訪問済みの頂点をスキップ
+            continue  # 訪問済みの頂点をスキップ
         # 隣接頂点を再帰的に訪問
         dfs(graph, visited, res, adjVet)
 
 
 def graph_dfs(graph: GraphAdjList, start_vet: Vertex) -> list[Vertex]:
-    """深さ優先走査"""
-    # 隣接リストを使用してグラフを表現し、指定された頂点のすべての隣接頂点を取得
-    # 頂点走査シーケンス
+    """深さ優先探索"""
+    # 指定した頂点の隣接頂点をすべて取得できるよう、隣接リストでグラフを表現する
+    # 頂点の走査順序
     res = []
-    # ハッシュセット、訪問済み頂点を記録するために使用
+    # 訪問済み頂点を記録するためのハッシュ集合
     visited = set[Vertex]()
     dfs(graph, visited, res, start_vet)
     return res
 
 
-"""ドライバコード"""
+"""Driver Code"""
 if __name__ == "__main__":
     # 無向グラフを初期化
     v = vals_to_vets([0, 1, 2, 3, 4, 5, 6])
@@ -51,7 +51,7 @@ if __name__ == "__main__":
     print("\n初期化後、グラフは")
     graph.print()
 
-    # 深さ優先走査
+    # 深さ優先探索
     res = graph_dfs(graph, v[0])
-    print("\n深さ優先走査（DFS）の頂点シーケンスは")
-    print(vets_to_vals(res))
+    print("\n深さ優先探索（DFS）の頂点順序は")
+    print(vets_to_vals(res))