When using Python, a common error you may encounter is modulenotfounderror: no module named ‘pandas’. This error occurs when Python cannot detect the Pandas library in your current environment. This tutorial goes through the exact steps to troubleshoot this error for the Windows, Mac and Linux operating systems.
Table of contents
- ModuleNotFoundError: no module named ‘pandas’
- What is ModuleNotFoundError?
- What is Pandas?
- How to Install Pandas on Windows Operating System
- How to Install Pandas on Mac Operating System
- How to Install Pandas on Linux Operating Systems
- Check Pandas Version
- Installing Pandas Using Anaconda
ModuleNotFoundError: no module named ‘pandas’
What is ModuleNotFoundError?
The ModuleNotFoundError occurs when the module you want to use is not present in your Python environment. There are several causes of the modulenotfounderror:
The module’s name is incorrect, in which case you have to check the name of the module you tried to import. Let’s try to import the re module with a double e to see what happens:
--------------------------------------------------------------------------- ModuleNotFoundError Traceback (most recent call last) 1 import ree ModuleNotFoundError: No module named 'ree'
To solve this error, ensure the module name is correct. Let’s look at the revised code:
import re print(re.__version__)
You may want to import a local module file, but the module is not in the same directory. Let’s look at an example package with a script and a local module to import. Let’s look at the following steps to perform from your terminal:
mkdir example_package cd example_package mkdir folder_1 cd folder_1 vi module.py
Note that we are using Vim to create the module.py file in this example. You can use your preferred file editor, such as Emacs or Atom. In module.py, we will import the re module and define a simple function that prints the re version:
import re def print_re_version(): print(re.__version__)
Close the module.py, then complete the following commands from your terminal:
cd ../ vi script.py
Inside script.py, we will try to import the module we created.
import module if __name__ == '__main__': mod.print_re_version()
Let’s run python script.py from the terminal to see what happens:
Traceback (most recent call last): File "script.py", line 1, in <module> import module ModuleNotFoundError: No module named 'module'
To solve this error, we need to point to the correct path to module.py, which is inside folder_1. Let’s look at the revised code:
import folder_1.module as mod if __name__ == '__main__': mod.print_re_version()
When we run python script.py, we will get the following result:
Lastly, you can encounter the modulenotfounderror when you import a module that is not installed in your Python environment.
What is Pandas?
Pandas is the standard data science library for flexible and robust data analysis/manipulation. Pandas provides two data structures called Series and DataFrame; Series is similar to arrays. DataFrame is a collection of Series objects presented in a table, similar to other statistical software like Excel or SPSS. Pandas does not come installed automatically with Python. The easiest way to install Pandas is to use the package manager for Python called pip. The following installation instructions are for the major Python version 3.
How to Install Pandas on Windows Operating System
To install Pandas using pip on Windows, you need to download and install Python on your PC. Ensure you select the install launcher for all users and Add Python to PATH checkboxes. The latter ensures the interpreter is in the execution path. Pip is automatically installed on Windows for Python versions 2.7.9+ and 3.4+.
You can install pip on Windows by downloading the installation package, opening the command line and launching the installer. You can install pip via the CMD prompt by running the following command.
You may need to run the command prompt as administrator. Check whether the installation has been successful by typing.
To install pandas with pip, run the following command from the command prompt.
pip3 install pandas
How to Install Pandas on Mac Operating System
Open a terminal by pressing command (⌘) + Space Bar to open the Spotlight search. Type in terminal and press enter.
To get pip, first ensure you have installed Python3:
Download pip by running the following curl command:
curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py
The curl command allows you to specify a direct download link, and using the -o option sets the name of the downloaded file.
Install pip by running:
From the terminal, use the pip3 command to install pandas:
pip3 install pandas
How to Install Pandas on Linux Operating Systems
All major Linux distributions have Python installed by default. However, you will need to install pip. You can install pip from the terminal, but the installation instructions depend on the Linux distribution you are using. You will need root privileges to install pip. Open a terminal and use the commands relevant to your Linux distribution to install pip.
Installing pip for Ubuntu, Debian, and Linux Mint
sudo apt install python-pip3
Installing pip for CentOS 8 (and newer), Fedora, and Red Hat
sudo dnf install python-pip3
Installing pip for CentOS 6 and 7, and older versions of Red Hat
sudo yum install epel-release sudo yum install python-pip3
Installing pip for Arch Linux and Manjaro
sudo pacman -S python-pip
Installing pip for OpenSUSE
sudo zypper python3-pip
Once you have installed pip, you can install pandas using:
pip3 install pandas
Check Pandas Version
Once you have successfully installed Pandas, you can use two methods to check the version of Pandas. First, you can use pip from your terminal:
pip show pandas
Name: pandas Version: 1.2.4 Summary: Powerful data structures for data analysis, time series, and statistics Home-page: https://pandas.pydata.org Author: None Author-email: None License: BSD Location: /Users/Yusufu.Shehu/opt/anaconda3/lib/python3.8/site-packages Requires: python-dateutil, pytz, numpy Required-by: statsmodels, seaborn, mlxtend Note: you may need to restart the kernel to use updated packages.
Second, within your python program, you can import pandas and reference and then __version__ attribute:
import pandas as pd print(pd.__version__)
Installing Pandas Using Anaconda
Anaconda is a distribution of Python and R for scientific computing and data science. Anaconda comes with pandas, numpy, and other relevant Python libraries for data science and machine learning. You can install Anaconda by going to the installation instructions, and Anaconda provides a complete list of packages available in the distribution across all operating systems.
If you have issues with using pandas in your conda environment, you can install it with the following command:
conda install -c anaconda pandas
Congratulations on reading to the end of this tutorial. The modulenotfounderror occurs if you misspell the module name, incorrectly point to the module path or do not have the module installed in your Python environment. If you do not have the module installed in your Python environment, you can use pip to install the package. However, you must ensure you have pip installed on your system. You can also install Anaconda on your system, which comes with pandas.
For further reading on installing data science and machine learning libraries, you can go to the articles:
- OpenCV: How to Solve Python ModuleNotFoundError: no module named ‘cv2’
- Requests: How to Solve Python ModuleNotFoundError: no module named ‘requests’
- Numpy: How to Solve Python ModuleNotFoundError: no module named ‘numpy’
- TensorFlow: How to Solve Python ModuleNotFoundError: no module named ‘tensorflow’
Go to the online courses page on Python to learn more about Python for data science and machine learning.
Have fun and happy researching!