Pandas Series API マニュアル

Series は 1 次元配列で、任意のデータ型(整数、文字列、浮動小数点数、Python オブジェクトなど)を格納できます。また、各要素にはインデックスと呼ばれるラベルがあります。

以下は Pandas Series のよく使われる API マニュアルです:

Series コンストラクタ

メソッド 説明
pd.Series(data, index, dtype, name, copy) Series オブジェクトを作成し、データ、インデックス、データ型、名前をカスタマイズできます。

Series の属性

属性 説明
Series.values Series のデータ部分(numpy 配列)を返します。
Series.index Series のインデックスを返します。
Series.dtype Series のデータ型を返します。
Series.shape Series の形状(タプル形式)を返します。
Series.size Series 内の要素の数を返します。
Series.name Series の名前を返すか設定します。
Series.empty Series が空かどうかを確認します。
Series.nbytes Series が使用するバイト数を返します。
Series.ndim Series の次元数を返します(常に 1)。
Series.hasnans Series に欠損値(NaN)が含まれているかどうかを確認します。
Series.array Series の基盤データ(Pandas 配列)を返します。

Series のメソッド

データの表示

メソッド 説明
Series.head(n=5) 先頭 n 行のデータを返します。
Series.tail(n=5) 末尾 n 行のデータを返します。
Series.describe() Series の統計サマリー(カウント、平均、標準偏差など)を返します。

欠損値の処理

メソッド 説明
Series.isnull() 各要素が欠損値(NaN)かどうかを確認します。
Series.notnull() 各要素が欠損値でないかどうかを確認します。
Series.dropna() すべての欠損値を削除します。
Series.fillna(value) 指定した値で欠損値を埋めます。

一意の値の処理

メソッド 説明
Series.unique() Series 内の一意の値を返します。
Series.nunique() Series 内の一意の値の数を返します。
Series.value_counts() Series 内の各値の頻度を返します。

並べ替え

メソッド 説明
Series.sort_values(ascending=True) 値で並べ替えます。
Series.sort_index(ascending=True) インデックスで並べ替えます。

インデックス操作

メソッド 説明
Series.reset_index(drop=False) インデックスをリセットします。
Series.drop(labels) 指定したインデックスの要素を削除します。
Series.get(key, default=None) 指定したインデックスの値を取得し、存在しない場合はデフォルト値を返します。
Series.set_axis(labels) 新しいインデックスを設定します。

データ変換

メソッド 説明
Series.map(arg) 渡された関数または辞書に基づいて、Series 内の値をマッピングします。
Series.apply(func) Series 内の各要素に関数を適用します。
Series.astype(dtype) Series を指定したデータ型に変換します。
Series.to_dict() Series を辞書に変換します。
Series.to_frame() Series を DataFrame に変換します。
Series.to_numpy() Series を numpy 配列に変換します。

データ操作

メソッド 説明
Series.copy() Series をコピーします。
Series.append(to_append, ignore_index) 別の Series を追加します。
Series.replace(to_replace, value) Series 内の値を置換します。
Series.update(other) 別の Series の値で現在の Series を更新します。
Series.clip(lower, upper) Series 内の値を指定した範囲内に制限します。
Series.isin(values) Series 内の値が指定したリスト内にあるかどうかを確認します。
Series.between(left, right) Series 内の値が指定した範囲内にあるかどうかを確認します。

統計計算

メソッド 説明
Series.sum() Series 内のすべての値の合計を返します。
Series.mean() Series 内のすべての値の平均を返します。
Series.median() Series 内のすべての値の中央値を返します。
Series.min() Series 内の最小値を返します。
Series.max() Series 内の最大値を返します。
Series.std() Series 内のすべての値の標準偏差を返します。
Series.var() Series 内のすべての値の分散を返します。
Series.count() Series 内の非欠損値の数を返します。
Series.mode() Series 内の最頻値を返します。
Series.quantile(q) Series 内の指定した分位数の値を返します。

時系列操作

メソッド 説明
Series.dt 日時属性にアクセスします(datetime 型の Series にのみ適用)。
Series.dt.year 年を返します。
Series.dt.month 月を返します。
Series.dt.day 日付を返します。

文字列操作

メソッド 説明
Series.str 文字列メソッドにアクセスします(文字列型の Series にのみ適用)。
Series.str.lower() 文字列を小文字に変換します。
Series.str.upper() 文字列を大文字に変換します。
Series.str.contains(pattern) 文字列が指定したパターンを含むかどうかを確認します。

例

例

import pandas as pd

# Series を作成
s = pd.Series([10, 20, 30, 40], index=['a', 'b', 'c', 'd'], name='MySeries')

# データを表示
print(s.head(2))  # 先頭 2 行を出力

# 欠損値の処理
s_with_nan = pd.Series([10, None, 30])
print(s_with_nan.fillna(0))  # 0 で欠損値を埋める

# 一意の値の処理
print(s.nunique())  # 一意の値の数を出力

# 並べ替え
print(s.sort_values(ascending=False))  # 値の降順で並べ替え

# 統計計算
print(s.mean())  # 平均値を出力

より詳細な情報が必要な場合は、以下を参照してください。Pandas 公式ドキュメント。

その他の拡張