未知のpandas.DataFrameの中身をサクッと確認したいときに使える関数をつくったので記事にします｡
この関数を使えばデータに含まれる要素を登場回数が多い順に表示することができます｡

コード全文は記事末尾にまとめて掲載しています｡(コピペ用)

※2022-03-29時点追記

コメント欄でdf['登場人物'].value_counts()を使うとよいのでは？ というコメントをいただきました。
たしかに…！ となったのであとで記事編集いたします。

以下の記事の内容でやっていることはdf['登場人物'].value_counts()でほぼカバーできます。
メリットを挙げるなら順位表示と件数表示を同時にできることかなと思います。

せっかくなので割合・積み上げ割合とかを表示できるようにすると新規性があるかも…？
時間があれば追記したいと思います。

本記事の想定読者

• Pythonユーザー
• pandasのDataFrameを使う
• 読み込んだデータの中身をサクッと確認したい

関数の使用例

ランダムに生成された架空のデータを使って実際の使用例を示します｡
今回紹介するicount()関数の詳細はのちほど説明します｡

なお､結果はランダムに生成されたものであり出典の作品とは一切関係しません｡¹

import pandas as pd

df = pd.read_csv('original_sin.csv')

icount(df['登場人物'])

全5件中5件表示
1. タコピー 27件
2. じゅんや 24件
3. まりな 20件
4. しずか 19件
5. なおき 10件

これでデータにどのような要素が含まれるか(あるいは含まれないか)がわかりました｡

icount()の中身

例で用いたicount()の中身は以下のとおりです｡²

from collections import Counter

def icount(iterable, topK=10):
    """iterableな要素を受け取って要素の多い順に表示する"""
    c = Counter(iterable)
    mc = c.most_common()
    topK = len(mc) if topK > len(mc) else topK
    print(f'全{len(mc)}件中{topK}件表示')
    for i in range(topK):
        print(f'{i+1}. {mc[i][0]} {mc[i][1]}件')

関数内部でCounter.most_common()を利用しています｡

icount()の役割はCounter.most_common()の利用の簡易化です｡
加えてtopKを引数にとって上位何件まで表示するかを指定することができます｡

実際の使用イメージ

未知のデータを読み込んだ際にその中身をおおまかに把握したいケースを考えます｡

• データにどんな要素が含まれるのかを知りたい
• データに想定外の要素が含まれていないかを確認したい

今回はoriginal_sin.csvというCSVファイルを読み込みます｡³

import pandas as pd

df = pd.read_csv('original_sin.csv')

この時点ではこのCSVデータにどのような要素が含まれているかまだわかりません｡

まずdf.info()でデータの概要を把握します｡

df.info()

<class 'pandas.core.frame.DataFrame'>
RangeIndex: 100 entries, 0 to 99
Data columns (total 3 columns):
 #   Column  Non-Null Count  Dtype 
---  ------  --------------  ----- 
 0   日付      100 non-null    object
 1   時刻      100 non-null    object
 2   登場人物    100 non-null    object
dtypes: object(3)
memory usage: 2.5+ KB

[日付],[時刻],[登場人物]という列があることがわかりました｡

次にdf.head()でデータの雰囲気をつかみます｡

df.head()

	日付	時刻	登場人物
0	2022-07-17	15:53:56	なおき
1	2022-01-21	11:21:24	じゅんや
2	2022-09-06	12:41:08	まりな
3	2022-09-02	12:15:32	じゅんや
4	2022-04-22	13:35:37	しずか

データのざっくりとした雰囲気はつかめました｡

しかし[登場人物]にどのキャラが含まれているか(あるいは含まれないか)､
どのキャラの登場頻度が高いかなどについてはまだ情報がありません｡

この[登場人物]の列にどういう要素が含まれているかを調べるために
icount()を使います｡

from collections import Counter

def icount(iterable, topK=10):
    """iterableな要素を受け取って要素の多い順に表示する"""
    c = Counter(iterable)
    mc = c.most_common()
    topK = len(mc) if topK > len(mc) else topK
    print(f'全{len(mc)}件中{topK}件表示')
    for i in range(topK):
        print(f'{i+1}. {mc[i][0]} {mc[i][1]}件')

icount(df['登場人物'])

全5件中5件表示
1. タコピー 27件
2. じゅんや 24件
3. まりな 20件
4. しずか 19件
5. なおき 10件

これで[登場人物]には5人(？)のキャラクターがいて､
それぞれが何回ずつ登場するかがわかりました｡

同時に､この5人以外のキャラが含まれていないこともわかりました｡⁴
もしデータに想定外のデータが混ざっていた場合でも､この段階で気付くことができます｡

留意事項

icount()だけでは登場頻度が低い要素について見落とす可能性があります｡

一方で､無効な値が大量に含まれている場合にすぐに察知できるなどの利点もあるので､
標題のとおりデータをサクッと確認する用途に向いてると思います｡

まとめ

• 未知のデータを扱う際に､データの中身をサクッと確認できるようになった！

関連記事

今回の例で使用したランダムな架空のデータは以下の記事の関数を使って作成しました｡
データ分析でテスト用データをサクッとつくりたいときにご利用ください｡

コード全文

from collections import Counter

import pandas as pd

def icount(iterable, topK=10):
    """iterableな要素を受け取って要素の多い順に表示する"""
    c = Counter(iterable)
    mc = c.most_common()
    topK = len(mc) if topK > len(mc) else topK
    print(f'全{len(mc)}件中{topK}件表示')
    for i in range(topK):
        print(f'{i+1}. {mc[i][0]} {mc[i][1]}件')