NumPyのissubdtype()で型階層を判定する方法 – サブタイプかどうかをTrue/Falseで確認

最初の引数が、型階層（type hierarchy）において2番目の引数と同じか、それより下位の型コードである場合に True を返したいときは、Python NumPy の numpy.issubdtype() メソッドを使用します。引数には dtype オブジェクト、または dtype に変換可能なオブジェクトを指定します。

このメソッドは、あるデータ型が別のデータ型のサブクラス（サブタイプ）に相当するかどうかを判定する際に便利です。たとえば、「この整数型は汎用的な整数型に分類されるか」「float64 は浮動小数点型の一種か」といった確認が簡単に行えます。

手順

まず、必要なライブラリをインポートします。

import numpy as np

続いて、NumPy の issubdtype() メソッドを使って、さまざまな型の組み合わせを判定してみましょう。

print("Result...",np.issubdtype(np.float64, np.float32))
print("Result...",np.issubdtype(np.float64, np.floating))
print("Result...",np.issubdtype(np.float32, np.floating))
print("Result...",np.issubdtype('i4', np.signedinteger))
print("Result...",np.issubdtype('i8', np.signedinteger))
print("Result...",np.issubdtype(np.int32, np.integer))

実行例

import numpy as np

# 最初の引数が型階層において下位または同等の型コードである場合に True を返すには、
# Python NumPy の numpy.issubdtype() メソッドを使用します。

# 引数には dtype、または dtype に変換可能なオブジェクトを指定します
print("NumPyのissubdtype()メソッドを使用\n")
print("Result...",np.issubdtype(np.float64, np.float32))
print("Result...",np.issubdtype(np.float64, np.floating))
print("Result...",np.issubdtype(np.float32, np.floating))
print("Result...",np.issubdtype('i4', np.signedinteger))
print("Result...",np.issubdtype('i8', np.signedinteger))
print("Result...",np.issubdtype(np.int32, np.integer))

出力結果

NumPyのissubdtype()メソッドを使用

Result... False
Result... True
Result... True
Result... True
Result... True
Result... True

結果の解説

• np.issubdtype(np.float64, np.float32) → False：float64 と float32 は兄弟関係にあり、float64 は float32 のサブタイプではないためです。
• np.issubdtype(np.float64, np.floating) → True：float64 は汎用の浮動小数点型 np.floating のサブタイプです。
• np.issubdtype(np.float32, np.floating) → True：float32 も同様に np.floating に分類されます。
• np.issubdtype('i4', np.signedinteger) → True：文字列 'i4'（int32 相当）は符号付き整数型のサブタイプです。
• np.issubdtype('i8', np.signedinteger) → True：'i8'（int64 相当）も符号付き整数型に含まれます。
• np.issubdtype(np.int32, np.integer) → True：int32 は汎用の整数型 np.integer のサブタイプです。

このように issubdtype() を使うことで、具体的な dtype がより抽象的な型カテゴリ（np.floating、np.signedinteger、np.integer など）に属しているかどうかを簡潔に判定できます。文字列形式の型コード（'i4'、'i8' など）もそのまま渡せる点が特徴です。