HOWTO · Python

IndexError: スカラー変数への無効なインデックスを修正する

NumPy でスカラーを再び添字アクセスしたときの IndexError を診断して修正します。

このページの内容

IndexError: invalid index to scalar variable は、添字アクセスによってすでに1つのスカラー値が得られており、次の [...] がそのスカラーにもう一度添字アクセスしようとしていることを意味します。NumPy では、さらに添字を付ける前に、配列の ndim、shape、選択した値を確認してください。

配列と選択した値を確認する

1次元の NumPy 配列では、要素を選ぶのに位置を1つ指定します。values[0] は1要素の配列ではなく NumPy のスカラーなので、values 自体に複数の要素があっても values[0][1] は失敗します。選択した値の型を調べると、問題が明らかになります。この自己完結した確認例では、配列の次元と、そこから選んだ値を確認します。

このセクションのコードと表示されるラベルや出力は英語のままです。

import numpy as np

values = np.array([1, 2, 3, 4, 5])
selected = values[0]

print(values.ndim, values.shape)
print(type(selected).__name__)
print(values[3])
1 (5,)
int64
4

スカラーの具体的なクラスは、NumPy のビルドやデータ型によって異なる場合があります。重要なのは、selected には添字アクセスできる配列の次元が残っていないことです。values への添字アクセスは、その次元が許す範囲にとどめてください。

エラーを再現して1次元配列を修正する

この例では診断メッセージを捕捉するため、プログラムの残りの処理を続けられます。最初の添字が整数 1 を選ぶため、2つ目の添字は無効です。要素が必要なら余分な添字を削除し、別の配列が必要なら元の配列をスライスしてください。コードと出力は原文どおり保持されるため、出力される診断メッセージなどの表示は英語のままです。

import numpy as np

values = np.array([1, 2, 3, 4, 5])

try:
    print(values[0][1])
except IndexError as error:
    print(error)

print(values[0])
print(values[0:2])
invalid index to scalar variable.
1
[1 2]

values[0] は1つのスカラーを返します。一方、values[0:2] はスライスを使い、1次元配列を返すため、本当に必要であればさらに添字アクセスできます。やみくもに角括弧を追加してこのエラーを直そうとせず、必要なのが1つの値なのか、小さな配列なのかを判断してください。

2次元の NumPy 配列に添字アクセスする

2次元配列には行と列があるため、元の配列を対象にする限り、2つの添字を使えます。タプル形式の grid[row, column] を使うと、2次元配列への操作だと明確になり、スカラーを順に選ぶ式と多次元の添字アクセスを見間違えにくくなります。

このセクションのコードと表示されるラベルや出力は英語のままです。

import numpy as np

grid = np.array([[1, 2, 3], [4, 5, 6]])

print(grid.ndim, grid.shape)
print(grid[1, 2])
print(grid[1][2])
2 (2, 3)
6
6

どちらの添字アクセスも 6 を返しますが、grid[1, 2] は行と列を指定する意図を直接表します。grid[1, 2][0] のように3つ目の添字を付けると、スカラーの 6 に添字アクセスしようとするため、この診断メッセージが発生します。

スカラーへの添字アクセスと範囲外エラーを区別する

このメッセージは範囲外エラーとは異なります。values[9] は存在しない要素を要求し、インデックス 9 が範囲外だと報告します。values[0][1] は、まず有効な要素を取得し、そのスカラーをコンテナーとして誤って扱っています。

デバッグするときは array.ndim と array.shape を出力し、長い式を中間変数に分けてください。選択するたびに、型または shape を確認します。この方法は、2次元の結果を想定していたコードが、実際には1行、1列、または集約後の1つのスカラーを受け取っているという、よくある原因の発見にも役立ちます。

添字アクセスの規則については、NumPy の添字アクセスに関するドキュメントとNumPy のスカラー型リファレンスを参照してください。これらの例では NumPy を使っています。通常の Python リストでは異なるメッセージが発生することがあるため、修正を適用する前に実際のオブジェクトを確認してください。