API · Pandas
Pandas Series.nunique()メソッド
Pandas Series.nunique メソッドは、Python Pandas シリーズの一意の値をカウントします。
このページの内容
Series.nunique() は、pandas の Series に含まれる異なる値の数を整数で返します。「異なる値がいくつあるか」に答えるメソッドであり、それらの値自体を返すものではありません。列のカテゴリ、識別子、測定値などを手短に集計したいときに使えます。
Series.nunique() が一意な値を数える仕組み
欠損していない値は、何度現れても種類ごとに 1 つとして数えられます。既定の設定では、NaN などの欠損値は数に含まれません。そのため、同じ値が繰り返されても 1 回だけ数えられ、NaN が複数あってもすべて除外されます。カテゴリ数を比較するときは、この違いが重要です。既定の動作では、欠損値はカテゴリとして扱われません。
構文と dropna 引数
メソッドのシグネチャは Series.nunique(dropna=True) です。dropna は真偽値を取るオプションで、既定値は True です。Series に含まれる既知の値の種類数を知りたい場合は、既定のままにします。欠損値を追加の 1 種類として数えるには、dropna=False を渡します。欠損値が複数あっても合計に加わるのは 1 だけで、個別に数えられるわけではありません。
このメソッドは、数える値がない場合も整数を返します。欠損値がなければ、dropna を変更しても結果は変わりません。空の Series の一意な値の数は 0 です。欠損値だけを含む Series では、既定の数は 0 ですが、dropna=False にすると 1 になります。これらのケースから、「観測されたカテゴリがない」場合と「欠損値をカテゴリとして扱う」場合の違いが分かります。
Series 内の一意な値を数える
次の例を実行します。コード内の No. という Series 名のラベルは、英語のまま表示されます。
import numpy as np
import pandas as pd
values = pd.Series([1, 2, 3, np.nan, 3, 4, np.nan], name="No.")
print(values.nunique())
4
Series には、欠損していない値が 1、2、3、4 の 4 種類あります。3 は繰り返されていますが 1 回だけ数えられ、既定の dropna=True では NaN の 2 件が除外されるため、結果は 4 です。実際のアプリケーションでは、値の一覧ではなく種類数が必要な場合に、この整数を保存したりレポートに利用したりできます。
dropna=False で欠損値を含める
同じデータを使い、dropna=False に設定すると、欠損値を 1 種類として数えられます。コード内の No. という Series 名のラベルは、英語のまま表示されます。
import numpy as np
import pandas as pd
values = pd.Series([1, 2, 3, np.nan, 3, 4, np.nan], name="No.")
print(values.nunique(dropna=False))
5
結果は 5 です。欠損していない 4 種類の値に、欠損値の 1 種類分が加わります。この Series には NaN が 2 件ありますが、この集計では同じ欠損値の種類として扱われます。何を知りたいかに応じて設定を選びます。既知の値を数えるには既定の設定を使い、欠損データの存在も種類数に 1 を加えるには dropna=False を指定します。この設定で変わるのは欠損値を数に含めるかどうかだけです。通常の値は、どちらの場合も重複分を 1 回だけ数えます。