Как установить opencv python на Windows

Обновлено: 01.07.2024

Этот документ содержит инструкции по установке и переходу на последнюю версию OpenCV (версия 3) и привязки Python. В дополнение к некоторым изменениям API, есть также изменения в интерфейсе Python (например, удаление cv2.cv ), которые могут потребовать изменений в существующем коде для работы с новой версией модуля cv2. После установки перейдите на следующую страницу «Миграция и изменения» для получения подробной информации об изменениях модуля и помощи в переносе существующего кода Python в новую версию.

На этой странице рассказывается об установке OpenCV 3 в Windows (с использованием предварительно собранных двоичных файлов) и Linux (скомпилированных из исходного кода), включая интерфейс Python (модуль cv2). OpenCV можно скачать с официального сайта OpenCV. Обратите внимание, что это руководство написано на основе OpenCV версии 3.1.0. После установки рекомендуется проверить версию OpenCV, которую использует Python:

Обратите внимание, что хотя OpenCV 3 является последней версией, по соглашению модуль по-прежнему называется cv2 .

Установка в Windows (готовые двоичные файлы)

Использование готовых двоичных файлов — это самый быстрый способ настроить и запустить среду Python OpenCV в Windows. В настоящее время собрана и включена в последнюю версию Windows только версия модуля cv2 для Python 2. Поддержка Python 3 (а также добавление других нестандартных функций/модулей) требует компиляции из исходного кода — подробности см. в официальной документации OpenCV.

Загрузка OpenCV и Python

Для начала загрузите OpenCV для Windows (версия 3.1, opencv-3.1.0.exe) и распакуйте его в каталог по вашему выбору. Сборка Windows включает как 32-разрядный, так и 64-разрядный модуль для Python 2.7.

Прежде чем продолжить, убедитесь, что у вас установлена рабочая версия Python 2.7, которую можно загрузить с веб-сайта Python. Это руководство было протестировано с использованием Python 2.7.9 (установщик x86/x64). При установке рекомендуется разрешить установщику добавить Python в переменную среды PATH, чтобы вы могли запускать python и pip из командной строки.

Установка зависимостей модуля

Для модуля Python OpenCV cv2 требуется стек NumPy и SciPy. Чтобы получить это, сначала убедитесь, что у вас есть рабочая среда Python и установлен pip (если нет, используйте приведенные выше ссылки и убедитесь, что папка Python находится в вашей переменной PATH).

Кристоф Гольке в настоящее время предоставляет некоторые (неофициальные) готовые пакеты Python для Windows, включая NumPy и SciPy. Загрузите последние стабильные версии NumPy и SciPy и установите их, вызвав pip install [module].whl из командной строки. Обратите внимание, что вы должны загрузить версию, соответствующую вашей среде Python (в данном случае 2.7) и размеру слова. Например, в 32-разрядных системах/интерпретаторах:

А для 64-битных систем/интерпретаторов:

После установки вы сможете запустить import numpy и import scipy из интерпретатора Python, чтобы убедиться, что модули установлены правильно. Вы можете проверить, какие версии NumPy и SciPy установлены из numpy.__version__ и scipy.__version__ соответственно.

Установка модуля Python-OpenCV

Наконец, нам нужно скопировать модуль OpenCV в локальные пакеты Python. В файлах, извлеченных из opencv-3.0.0-rc1.exe , перейдите в папку opencv\build\python\2.7\ и откройте папку x86\ (для 32-разрядной версии) или x64\ (для 64-разрядной версии). . В каждом будет файл cv2.pyd.

Скопируйте cv2.pyd непосредственно в каталог Lib\site-packages\ вашей установки Python. Для большинства пользователей это можно найти по адресу:

Наконец, убедитесь, что файлы OpenCV .dll находятся где-то в папке %PATH% вашей системы, особенно файл opencv_ffmpeg310.dll (или opencv_ffmpeg310_64.dll для 64-разрядных систем), необходимый для загрузки видеофайлов.

Перейдите к разделу Проверка установки, чтобы убедиться, что все установлено правильно и используется новая версия OpenCV. Также обязательно ознакомьтесь со следующей страницей «Миграция и изменения» для получения подробной информации об изменениях в модуле и обновлении существующего кода.

Установка в Linux (компиляция из исходников)

Несмотря на то, что это руководство написано для Ubuntu 12.04/14.04 и других версий (например, Xubuntu/Lubuntu/Kubuntu), в других версиях, а также в аналогичных дистрибутивах Linux, подобных Debian, процесс должен быть в основном таким же. Обратите внимание на вывод каждой команды, чтобы убедиться, что все работает правильно, и если в процессе сборки возникнут какие-либо проблемы, см. внизу этого документа возможные решения

Загрузка OpenCV

Для начала загрузите OpenCV для Linux (версия 3.1.0, opencv-3.1.0.zip) и распакуйте его в каталог по вашему выбору (например, ~/opencv-src). Создайте папку сборки внутри папки, в которую был распакован архив (директория, содержащая файл CMakeLists.txt), и откройте там терминальную сессию. Например:

Выполните все следующие команды из самой подпапки сборки, чтобы туда были помещены скомпилированные файлы.

Установка зависимостей сборки

Чтобы скомпилировать OpenCV, мы должны убедиться, что необходимые зависимости доступны, включая сами инструменты сборки. Мы можем получить необходимые пакеты с помощью apt в Ubuntu, но сначала убедитесь, что список пакетов актуален, запустив apt-get update . Затем выполните следующие команды, чтобы получить необходимые пакеты (см. ниже однострочный список всех):

Обратите внимание, что для дополнительных модулей/функций OpenCV (например, поддержки GPU/CUDA или модуля Python 3) вам также потребуется загрузить соответствующие пакеты разработки/SDK для этих библиотек. Перечисленные выше зависимости относятся только к сборке самого OpenCV и модуля Python 2.7 cv2.

Компиляция и установка OpenCV

Теперь, когда у нас есть необходимые зависимости сборки, запустите cmake (опять же, в созданном нами каталоге build/), чтобы сгенерировать Makefile для сборки OpenCV:

Если есть какие-либо ошибки, убедитесь, что вы загрузили все необходимые пакеты. Вывод должен помочь найти недостающие пакеты. Чтобы убедиться, что модуль Python будет собран, вы должны увидеть python2 в списке настроенных модулей после запуска cmake:

Если вы не видите модуль python2 в списке «Требуется сборка», убедитесь, что у вас установлены надлежащие пакеты разработки Python, удалите все файлы из папки build/ и попробуйте снова запустить команду cmake.

Теперь мы можем собрать OpenCV (и модуль Python) с помощью make и установить его в нашу систему:

Убедитесь, что сборка прошла успешно после вызова make , и проверьте выходные данные перед установкой. Если вы столкнулись с проблемами/ошибками сборки, снова убедитесь, что в вашей системе есть все необходимые зависимости и заголовочные файлы. Если есть реальные проблемы со сборкой с самим OpenCV, см. раздел «Проблемы со сборкой Linux» ниже, чтобы узнать о некоторых возможных обходных путях.

Если сборка прошла успешно, но вы не можете импортировать cv2 из оболочки Python после запуска make install , вы можете установить модуль вручную, скопировав только что созданный файл cv2.so из папки build/lib/ в / usr/local/lib/python2.7/dist-packages/ . Из папки build/ это можно сделать следующим образом:

После этого шага модуль cv2 установлен, и теперь его можно импортировать в вашу среду Python. Перейдите к разделу «Проверка установки», чтобы убедиться, что все установлено правильно и, что более важно, Python использует правильную версию OpenCV. Вы также можете перейти на следующую страницу, Миграция и изменения, чтобы узнать об изменениях в модуле cv2 и о том, какие изменения необходимо внести в существующий код для работы с обновленным модулем.

Проверка установки

Как упоминалось ранее, вы можете проверить правильность установки модуля cv2, выполнив в оболочке Python следующее:

Если напечатана правильная строка версии (3.0.0-rc1 или новее, если вы использовали более новую версию), на этом этапе все установлено правильно!

Обратите внимание, что в самой иерархии модулей cv2 произошли серьезные изменения, и программы Python, написанные с учетом OpenCV 2.4.x, могут больше не работать должным образом. Подробнее об изменениях и о том, как модифицировать программы для работы с изменениями, см. в следующем разделе «Миграция и изменения».

Проблемы со сборкой Linux

В некоторых системах вы можете столкнуться с проблемами при компиляции самого OpenCV, в зависимости от того, какие пакеты доступны. Если нужные файлы заголовков доступны, но проблемы со сборкой все еще возникают, попробуйте найти обходные пути для этой проблемы, описанные ниже.

Неопределенный AV_CODEC_ID_. в ffmpeg_codecs.hpp

Если вы столкнулись с проблемой, когда ошибки сборки вызваны тем, что некоторые кодеки не определены, вы можете загрузить более новую версию ffmpeg_codecs.hpp отсюда и заменить ее в исходном коде, который вы скачали/распаковали в модулях/ папка videoio/src/.

Кроме того, вы можете объявить их вручную, отредактировав сам файл ffmpeg_codecs.hpp, добавив отсутствующую запись кодека для H263I и переименовав WNV в WNV1 . Вы можете увидеть, какие изменения необходимо внести, просмотрев эту фиксацию из проекта OpenCV GitHub.

После обновления файла вы можете снова вызвать make из папки build/, и теперь OpenCV должен завершить компиляцию без ошибок.

В этом руководстве

Мы научимся настраивать OpenCV-Python в вашей системе Windows.

Приведенные ниже шаги протестированы на компьютере с 64-разрядной ОС Windows 7 и Visual Studio 2010 и Visual Studio 2012. На снимках экрана показан VS2012.

Установка OpenCV из готовых двоичных файлов

Пакеты Python, указанные ниже, необходимо загрузить и установить в места по умолчанию.
1. Python 3.x (3.4+) или Python 2.7.x отсюда.
2. Пакет Numpy (например, с помощью команды pip install numpy).
3. Matplotlib ( pip install matplotlib ) (Matplotlib является необязательным, но рекомендуется, так как мы часто используем его в наших руководствах).
Если результаты распечатываются без ошибок, поздравляем. Вы успешно установили OpenCV-Python.

Сборка OpenCV из исходного кода
1. Загрузите и установите Visual Studio и CMake.
Загрузите и установите необходимые пакеты Python в папки по умолчанию

Нажмите «Настроить».

Откроется новое окно для выбора компилятора. Выберите подходящий компилятор (здесь Visual Studio 11) и нажмите Готово.

Вы увидите, что все поля отмечены красным. Нажмите на поле WITH, чтобы развернуть его. Он решает, какие дополнительные функции вам нужны. Поэтому отметьте соответствующие поля. См. изображение ниже:

Теперь нажмите на поле BUILD, чтобы развернуть его. Первые несколько полей настраивают метод сборки. См. изображение ниже:

Остальные поля указывают, какие модули должны быть построены. Поскольку модули GPU еще не поддерживаются OpenCV-Python, вы можете полностью избежать этого, чтобы сэкономить время (но если вы работаете с ними, оставьте их там). См. изображение ниже:

Теперь нажмите на поле ENABLE, чтобы развернуть его. Убедитесь, что флажок ENABLE_SOLUTION_FOLDERS не установлен (папки решений не поддерживаются выпуском Visual Studio Express). См. изображение ниже:

Также убедитесь, что в поле PYTHON все заполнено. (Игнорировать PYTHON_DEBUG_LIBRARY). См. изображение ниже:

Снова щелкните правой кнопкой мыши УСТАНОВИТЬ и соберите его. Теперь будет установлен OpenCV-Python.

Дополнительные ресурсы

Упражнения

Если у вас есть компьютер с Windows, скомпилируйте OpenCV из исходного кода. Делайте всевозможные хаки. Если вы столкнулись с какой-либо проблемой, посетите форум OpenCV и объясните свою проблему.

OpenCV — это огромная библиотека с открытым исходным кодом для компьютерного зрения, машинного обучения и обработки изображений, и теперь она играет важную роль в работе в режиме реального времени, что очень важно в современных системах. С его помощью можно обрабатывать изображения и видео для идентификации объектов, лиц или даже почерка человека. Когда он интегрирован с различными библиотеками, такими как Numpuy, python способен обрабатывать структуру массива OpenCV для анализа. Чтобы определить шаблоны изображения и его различные функции, мы используем векторное пространство и выполняем математические операции над этими функциями.

Чтобы установить OpenCV, в системе должны быть предустановлены Python и PIP. Чтобы проверить, содержит ли ваша система Python, выполните следующие инструкции:

< /p>
Если Python уже установлен, появится сообщение с указанием доступной версии Python.

Если Python отсутствует, см. раздел Как установить Python в Windows? и следуйте предоставленным инструкциям.

PIP – это система управления пакетами, используемая для установки и управления программными пакетами/библиотеками, написанными на Python. Эти файлы хранятся в большом «онлайн-репозитории», называемом индексом пакетов Python (PyPI).
Чтобы проверить, установлен ли уже PIP в вашей системе, просто перейдите в командную строку и выполните следующую команду:< /p>

Если PIP отсутствует, см. раздел Как установить PIP в Windows? и следуйте предоставленным инструкциям.

Загрузка и установка OpenCV:

OpenCV можно загрузить и установить напрямую с помощью pip (менеджера пакетов). Чтобы установить OpenCV, просто перейдите в командную строку и введите следующую команду:

Чтобы проверить правильность установки OpenCV, просто выполните следующие команды для проверки версии:

В этом сообщении блога мы будем устанавливать OpenCV в Windows для C++ и Python. Установка C++ выполняется с помощью установочных исполняемых файлов. В то время как установка Python выполняется с помощью Anaconda.

Установка OpenCV из исходного кода занимает много времени. В зависимости от вашего оборудования и конфигурации установки это может занять от 5 минут до 2 часов.

Более того, установка не является легкой прогулкой. Поэтому мы придумали решение для пользователей Windows — установщики OpenCV для Windows. Эти установщики будут работать только для установки OpenCV для C++. Если вы хотите установить OpenCV для Python, вы найдете информацию позже в блоге.

Если вы хотите установить OpenCV 4 в Windows из исходного кода, ознакомьтесь с этой записью в блоге.

Содержание

Установите OpenCV в Windows для CPP

Шаг 1. Предварительные условия

В вашей системе должна быть предварительно установлена Visual Studio. Вы можете загрузить последнюю версию Visual Studio отсюда. В противном случае вы можете найти более старые версии здесь.

Шаг 2. Загрузите программу установки

После того как вы настроили Visual Studio в своей системе, загрузите программу установки в соответствии с установленной версией Visual Studio.

Установщик запускается с экрана приветствия. Нажмите «Далее», чтобы прочитать лицензию.

Если вы принимаете лицензию, нажмите «Я принимаю соглашение» и нажмите «Далее».

Далее вам будет предложено выбрать папку для установки. Вы можете установить OpenCV в любом месте системы. Расположение по умолчанию — C: .

Наконец, программа установки попросит вас подтвердить установку OpenCV в системе. Нажмите «Установить», чтобы продолжить.

После установки OpenCV вы можете выйти из программы установки.

Шаг 4. Выполните пример кода

После завершения установки OpenCV вы можете сразу приступить к написанию кода. Мы предоставили пример кода для тестирования установки. Ниже приведен фрагмент кода.

Загрузить код Чтобы легко следовать этому руководству, загрузите код, нажав кнопку ниже. Это БЕСПЛАТНО!

Если вы планируете выполнять код C++ с помощью Cmake, загрузите и установите отсюда (установщик Windows win64-x64) и следуйте приведенным ниже инструкциям. В третьей строке указана версия Visual Studio в вашей системе.

Приведенный выше код считывает входное изображение в оттенках серого, записывает его на диск и отображает. Ниже приведены ввод и вывод кода.

Чем установщики отличаются от официальных установщиков OpenCV для Windows

Это установщики общего назначения, которые могут установить и удалить OpenCV менее чем за 15 секунд. Это быстрый и чистый подход к установке OpenCV для вашей системы Windows. Вы можете протестировать последнюю версию OpenCV и посмотреть, подходит ли она вам. В противном случае вы можете установить OpenCV без настройки и часами ждать, пока он установится.

Хотя установщики полезны для новых пользователей или пользователей, которым нужна установка в один клик, или просто для тех, у кого проблемы с установкой, они не являются официальными установщиками. Вы можете найти официальные двоичные файлы OpenCV здесь. Существуют различия между предоставляемыми нами установщиками и официальными бинарными файлами OpenCV

Читайте также: