NumPy ブロードキャスト(Broadcast)

ブロードキャスト(Broadcast)は、numpy が異なる形状(shape)の配列に対して数値計算を行う方法です。配列の算術演算は通常、対応する要素に対して行われます。

2つの配列 a と b の形状が同じ場合、すなわち次を満たします:a.shape == b.shapeその場合、a*b の結果は a と b の配列の対応する要素同士の乗算になります。これには次元数が同じで、各次元の長さも同じであることが必要です。

例

import numpy as np a = np.array([1,2,3,4]) b = np.array([10,20,30,40]) c = a * b print (c)

出力結果は次のとおりです:

[ 10  40  90 160]

演算中の2つの配列の形状が異なる場合、numpy は自動的にブロードキャスト機構を起動します。例:

例

import numpy as np a = np.array([[ 0, 0, 0], [10,10,10], [20,20,20], [30,30,30]]) b = np.array([0,1,2]) print(a + b)

出力結果は次のとおりです:

[[ 0  1  2]
 [10 11 12]
 [20 21 22]
 [30 31 32]]
下の画像は、配列 b がブロードキャストによって配列 a とどのように互換性を持つかを示しています。

4x3 の2次元配列と長さ3の1次元配列の加算は、配列 b を2次元方向に4回繰り返してから演算するのと同等です:

例

import numpy as np a = np.array([[ 0, 0, 0], [10,10,10], [20,20,20], [30,30,30]]) b = np.array([1,2,3]) bb = np.tile(b, (4, 1)) # b の各次元を繰り返す print(a + bb)

出力結果は次のとおりです:

[[ 1  2  3]
 [11 12 13]
 [21 22 23]
 [31 32 33]]

ブロードキャストの規則:

  • すべての入力配列を、その中で最も形状が長い配列に合わせます。形状の不足している部分は、先頭に 1 を追加して補います。
  • 出力配列の形状は、入力配列の形状の各次元における最大値です。
  • 入力配列のある次元が出力配列の対応する次元と同じ長さであるか、またはその長さが 1 である場合、この配列は計算に使用できます。それ以外の場合はエラーになります。
  • 入力配列のある次元の長さが 1 の場合、この次元に沿った演算では、この次元の最初の値を使用します。

簡単に理解すると:2つの配列について、それぞれの各次元を比較します(一方の配列に現在の次元がない場合は無視します)。次の条件を満たすこと:

  • 配列が同じ形状を持つこと。
  • 現在の次元の値が等しいこと。
  • 現在の次元の値のいずれかが 1 であること。

条件を満たさない場合は、"ValueError: frames are not aligned"例外がスローされます。

その他の拡張