Python

Colabでライブラリをインストールする方法【pip install・importの使い方とよくあるエラー】

酒井 裕麻株式会社Bistro 代表取締役社長

Pythonでデータ分析をするときは、pandasやmatplotlibなどのライブラリを読み込んで使います。Google Colabには多くのライブラリが最初から入っていますが、入っていないものを使うときは、自分でインストールする必要があります。

この記事では、Colabでのライブラリのインストール方法(!pip install)と読み込み方(import)、そしてよくあるエラーの対処法を解説します。

Rでのパッケージのインストール方法は、Rのパッケージのインストール方法と読み込み方で紹介しています。

ライブラリとは

ライブラリとは、よく使う機能をまとめた部品のセットです。Rでいう「パッケージ」と同じものです(Pythonでも「パッケージ」と呼ぶことがあります)。

ライブラリを使うまでの流れは、次の2ステップです。

ステップ やること 頻度
1. インストール ライブラリを実行環境に入れる(pip install) Colabでは実行環境が起動するたびに
2. 読み込み ノートブックで使えるようにする(import) ノートブックを開くたびに

アプリに例えると、インストールは「スマホにアプリを入れる」、読み込みは「アプリを開く」です。

Colabに最初から入っている主なライブラリ

データ分析でよく使うライブラリは、ほとんどがColabに最初から入っています。これらはインストールせずに、すぐ import できます。

ライブラリ 用途
pandas 表形式のデータの読み込み・加工・集計
numpy 数値計算
matplotlib、seaborn グラフの作成
scipy 統計の検定など
statsmodels 回帰分析などの統計モデル
scikit-learn 機械学習(決定木、クラスター分析など)
openpyxl Excelファイルの読み書き

Step 1:importで読み込む

ライブラリは import で読み込みます。よく使うライブラリは、短い別名(as のあとの名前)を付けて読み込むのが一般的です。

import pandas as pd
import numpy as np
import matplotlib.pyplot as plt

この別名は、世界中のPythonのコードでほぼ共通です。ネットで見つけたコードを使うときも、この名前で書かれていることが多いので、合わせておきましょう。

ライブラリの一部の機能だけを読み込む書き方もあります。

from scipy import stats
from sklearn.tree import DecisionTreeClassifier

Step 2:入っていないライブラリをインストールする

Colabに入っていないライブラリは、!pip install ライブラリ名 でインストールします。先頭の ! は、「Pythonのコードではなく、実行環境へのコマンドとして実行する」という意味です。

たとえば、グラフの日本語の文字化けを防ぐ matplotlib-fontja をインストールするには、次のようにします。

!pip install matplotlib-fontja

実行結果(例)

Collecting matplotlib-fontja
  Downloading matplotlib_fontja-1.1.0-py3-none-any.whl
Installing collected packages: matplotlib-fontja
Successfully installed matplotlib-fontja-1.1.0

「Successfully installed」と表示されれば成功です。そのあと、import で読み込みます。

import matplotlib_fontja

注意:インストールするときの名前と、importの名前が違うことがあります。 matplotlib-fontja は、importのときはハイフン(-)ではなくアンダースコア(_)になります。

インストールの名前 importの名前
matplotlib-fontja matplotlib_fontja
scikit-learn sklearn
python-docx docx
beautifulsoup4 bs4

Colabでは毎回インストールが必要

Colabの実行環境は、しばらく使わないとリセットされます。インストールしたライブラリも、リセットされると消えます。

そのため、インストールのコードは、ノートブックの最初のセルにまとめて書いておき、開くたびに実行するようにしましょう。

# 最初のセル:準備
!pip install -q matplotlib-fontja janome

import pandas as pd
import matplotlib.pyplot as plt
import matplotlib_fontja

-q を付けると、インストールのときの細かい表示が省略されます。

インストール済みか・バージョンを確認する

ライブラリのバージョンは、__version__ で確認できます。

import pandas as pd
pd.__version__

実行結果(例)

'2.2.2'

!pip show を使うと、インストールされているかどうかと、詳しい情報がわかります。インストールされていなければ「WARNING: Package(s) not found」と表示されます。

!pip show scikit-learn

入っているライブラリの一覧は、!pip list で確認できます。

バージョンを指定してインストールする

ネットで見つけたコードが、新しいバージョンでは動かないことがあります。そのようなときは、バージョンを指定してインストールできます。

!pip install "ライブラリ名==1.2.3"   # このバージョンを入れる
!pip install -U ライブラリ名          # 最新版に更新する

Colabに最初から入っているライブラリのバージョンを変えた場合は、「ランタイム」→「セッションを再起動」を行ってから import してください。再起動しないと、古いバージョンのまま動くことがあります。

ただし、pandasやnumpyなど、Colabに最初から入っている基本のライブラリのバージョンを変えると、ほかのライブラリが動かなくなることがあります。特別な理由がなければ、最初から入っているバージョンのまま使うのがおすすめです。

よくあるエラーと対処法

ModuleNotFoundError: No module named ‘xxx’

ModuleNotFoundError: No module named 'matplotlib_fontja'

ライブラリがインストールされていません。主な原因は次のとおりです。

  • !pip install をまだ実行していない
  • 実行環境がリセットされて、インストールしたライブラリが消えた
  • importの名前を間違えている(matplotlib-fontja と書いた、など)

最初のセルの !pip install から、順に実行し直しましょう。

NameError: name ‘pd’ is not defined

NameError: name 'pd' is not defined

import pandas as pd のセルを、まだ実行していません。Colabでは、上のセルから順番に実行するのが基本です。迷ったら「ランタイム」→「すべてのセルを実行」で、上からすべて実行し直しましょう。

ImportError: cannot import name ‘xxx’ from ‘yyy’

ライブラリのバージョンによって、機能の名前や場所が変わっていることがあります。ネットのコードが古い可能性があるので、ライブラリの公式ドキュメントで、今のバージョンでの書き方を確認しましょう。エラーの全文をAIに貼り付けて、対処法を聞くのも有効です。

pip install で「ERROR: Could not find a version that satisfies the requirement」

ライブラリの名前を間違えているか、今のPythonのバージョンに対応していないライブラリです。名前のつづりを確認し、ライブラリの公式ページで対応しているPythonのバージョンを確認しましょう。

Rのパッケージとの対応

Rを使ったことがある方向けに、よく使うパッケージとPythonのライブラリの対応をまとめます。

やりたいこと R Python
データの加工・集計 dplyr、tidyr pandas
グラフ ggplot2 matplotlib、seaborn
CSV・Excelの読み込み readr、readxl pandas(+openpyxl)
日付の処理 lubridate pandas
統計モデル(回帰など) 標準のlm・glm statsmodels
機械学習 rpart、randomForest scikit-learn
日本語の形態素解析 RMeCab janome、fugashi

まとめ

  • ライブラリは !pip install でインストールし、import で読み込む
  • データ分析でよく使うライブラリは、Colabに最初から入っている
  • Colabでは実行環境がリセットされるとライブラリが消えるので、最初のセルにまとめて書いておく
  • インストールの名前とimportの名前が違うことがある
  • エラーが出たら、まず上のセルから順に実行し直す

CONTACT

データ活用のお悩み、
直接相談しませんか。

「何から始めればいいかわからない」段階でも大丈夫です。課題の整理からお手伝いします。