Check if OpenCV is Installed: Complete Guide

by

Verifying whether OpenCV is installed on your system is a crucial step when working on computer vision tasks. OpenCV is one of the most widely used libraries for image processing, object detection, and machine learning in Python and C++. In this guide, we will walk through different methods to check if OpenCV is installed in Python, C++, and across various operating systems. You will also learn how to troubleshoot issues and confirm that OpenCV is functioning properly.

How to Check if OpenCV is Installed in Python

Python is one of the most popular programming languages for OpenCV. Verifying OpenCV installation in Python is straightforward and can be done in multiple ways.

Method 1: Using the cv2 Module

Open a Python interpreter or create a script and run the following code:

import cv2
print("OpenCV version:", cv2.__version__)

If OpenCV is installed correctly, you will see output similar to this:

OpenCV version: 4.5.2

If you encounter an error like ModuleNotFoundError: No module named 'cv2', OpenCV is not installed. You can install OpenCV using the following command:

pip install opencv-python

Method 2: Checking Installation with pip

You can use pip to check if OpenCV is installed and which version you have:

pip show opencv-python

If OpenCV is installed, you will see information about the installed package, such as its version and location. If nothing is displayed, OpenCV is not installed.

Method 3: Verify Installation with a Simple Program

To test OpenCV in a Python program, write a script to read and display an image:

import cv2

# Read an image
image = cv2.imread('image.jpg')

# Display the image
cv2.imshow('Test Image', image)
cv2.waitKey(0)
cv2.destroyAllWindows()

If the program runs without errors and displays the image, OpenCV is installed correctly.

How to Check if OpenCV is Installed in C++

Verifying OpenCV installation in C++ involves writing and compiling a simple program.

Step 1: Write a Test Program

Create a file named check_opencv.cpp with the following content:

#include <opencv2/opencv.hpp>
#include <iostream>

int main() {
    std::cout << "OpenCV version: " << CV_VERSION << std::endl;
    return 0;
}

Step 2: Compile the Program

To compile the program, ensure that OpenCV is correctly configured on your system. Use the following command:

g++ check_opencv.cpp -o check_opencv `pkg-config --cflags --libs opencv4`

If OpenCV is installed, the compilation will complete successfully.

Step 3: Run the Program

Execute the compiled program:

./check_opencv

If OpenCV is installed, the output will display the version number:

OpenCV version: 4.5.2

If you encounter errors during compilation, ensure that OpenCV’s include paths and libraries are correctly set up in your environment.

How to Check OpenCV Installation on Linux

Linux users can use system commands to check if OpenCV is installed.

Method 1: Using dpkg (Debian-based Systems)

Run the following command to search for OpenCV packages:

dpkg -l | grep opencv

If OpenCV is installed, you will see a list of installed packages with their versions.

Method 2: Using pkg-config

To check OpenCV libraries installed on your system, run:

pkg-config --modversion opencv4

This will display the version of OpenCV installed, such as 4.5.2.

Method 3: Verifying with Python

On Linux systems, use the same Python script as shown earlier to verify OpenCV installation.

How to Check OpenCV Installation on Windows

On Windows systems, checking OpenCV installation can be done in a few ways.

Method 1: Verify Using Python

Use the Python verification script:

import cv2
print("OpenCV version:", cv2.__version__)

Method 2: Check Installed Files

If you installed OpenCV using a pre-built package, check the installation directory (e.g., C:\opencv). Verify that the bin, include, and lib directories are present.

Method 3: Check Environment Variables

Ensure that the OpenCV library paths are added to the system’s PATH variable:

  • Go to System Properties > Environment Variables.
  • Look for PATH and confirm the OpenCV library directories are included.

How to Check OpenCV Installation on macOS

On macOS, OpenCV installation can be verified using Homebrew or Python.

Method 1: Using Homebrew

If you installed OpenCV using Homebrew, verify the installation with:

brew list | grep opencv

If OpenCV is installed, the command will return the installed version.

Method 2: Using Python

Run the Python script:

import cv2
print("OpenCV version:", cv2.__version__)

Troubleshooting OpenCV Installation Issues

If OpenCV is not detected or you encounter errors during verification, consider the following steps:

  1. Reinstall OpenCV: Use the appropriate installation command for your environment:pip install --upgrade opencv-python
  2. Check Python Path: Ensure that the Python environment you are using has OpenCV installed. Use pip list to check the installed libraries.
  3. Verify Compiler and Libraries (C++): Ensure that OpenCV libraries and include paths are correctly set when compiling in C++.
  4. Rebuild OpenCV from Source: For advanced users, rebuilding OpenCV from source can resolve compatibility issues.

Conclusion

Checking if OpenCV is installed is essential before working on computer vision projects. Whether you use Python, C++, or operate on Linux, Windows, or macOS, the methods outlined in this guide will help you confirm your OpenCV installation. By following these steps, you can ensure a smooth start to your OpenCV development journey and avoid common pitfalls. If issues arise, troubleshooting tips are provided to help you quickly resolve them and get back on track.

Leave a Comment