Nesse post vamos demostrar como preparar um ambiente para desenvolver aplicação com OpenCV e Python.

Primeiro veremos em mais detalhe cada ferramenta. Depois, como gerenciar tudo ambiente a partir do PyCharm sem precisar digitar linhas de códigos.

Você ira aprender como configurar um ambiente para utilizar o OpenCV no Windows e no Ubuntu.

• Escolhendo a versão do OpenCV
• instalando Python
• instalando gerenciador de pacotes pip
• instalando pacote com pip
• Testando instalação

Ha pouco tempo, para usar o OpenCV com Python era necessário compilar tudo manualmente. Mais hoje temos várias versões do OpenCV disponível para o instalador pip.

Sendo mais preciso, existem quatro principais compilações do OpenCV. Mais porque quatro?

Pacotes pip do OpenCV

O OpenCV tem um pacote adicional denominado contrib. Quando um novo algoritimo é submetido ele fica um tempo nesse pacote e só depois e adicionado no repositório principal, então já tempos duas versões.

• opencv-python: módulo principal
• opencv-contrib-python: módulo completo

Uma boa prática de programação é evitar depenicas desnecessárias. Se seu programa não usa algorítimo de contrib não tem porque carregar em sua aplicação final.

No entanto, quando estamos em fase testes ou aprendizado, não precisamos ser tão rigoroso. Em recomendo o pacote opencv-contrib-python.

Às vezes você precisa integrar o OpenCV com outras bibliotecas. Para esse caso existem duas variantes dos pacotes anteriores.

• opencv-python-headless: módulo principal sem suporte para interface gráfica.
• opencv-contrib-python-headless: módulo completo sem suporte para interface gráfica.

Se sua aplicação depende de QT (Pyqt5) os pacotes anterior quebraram. Por essa razão existem essas versões sem recurso de interface gráfica.

Instalando o Python

Instalação no Windows

Para instalar o Python no windows basta baixar o instalador no site oficial aqui (link direto para python 3.9.4 64bits). Vale lembrar que o link principal do site aponta para uma versão 32 bits, não existe muita diferença mais não vejo porque usar 32 bits.

Ao executar você deve ver uma tela parecida com isso.

As únicas alterações que vamos realizar é mudar a pasta de instalação (opção Cuatomize installation) e marcar a caixa para adicionar o Python no PATH.

Instalação no Ubuntu

A maioria das distribuições Linux vem com duas versões do Python instalado: python 2 (para manter operacional aplicações antigas) e o python 3

O Python 2 responde pelo comando python e a versão 3 responde ao comando python3. Por exemplo, execute o seguinte comando no terminal.

• python -V
• python3 -V

O nome python3 é um link que aponta para a versão padrão instalada. Falamos mais disso na proxima seção.

Hoje a versão do Ubuntu 20.04 a versão padrão é 3.8.5. Caso queira usar a 3.9 basta instalar com comando.

• sudo apt install python3.9
• python3.9 -V

Instalando pacotes com pip

Windows

O pip é o gerenciador padrão de pacote Python, ele já vem com instalador. Para instalar um pacote basta digitar pip install nome_do_pacote. Por exemplo, o comando abaixo executado no Prompt de comando instala o OpenCV

pip install opencv-contrib-python

Cada versão do Python terá um pip equivalente, a versão executada pelo prompt é a primeira da lista nas variáveis de ambiente.

Linux

Existe uma convenção que facilita a utilizam de várias versões do Python do Linux. Para o Python3 o gerenciador é denominado de pip3. O comando a baixo instala o pip3

sudo apt install python3-pip

O comando a baixo instala o OpenCV para o Python3 no linux

pip3 install opencv-contrib-python

Os pacotes instalados não são compartilhados, cada versão Python tem um local específico para instalar pacote (usr/local/lib).

Na verdade, são dois locais. usr/loca/lib quando pip3 é chamado pelo root e ./local/lib quando executado pelo usuário.

O comando pip3 instala para o Python3 padrão

Caso tenha instalado o pyhton3.9 você deve ter os seguintes aquivo na pasta /usr/bin

O python3 que chamamos no ternimal, na verdade é um link, originalmente apontando para versão padrão python3.8.

Eu posso especificar qual versão usar de duas formas: alterando o link python3 (sudo ln -sf /usr/bin/python3.9 /usr/bin/python3) ou fazendo uma chamada direta python3.9.

Como o pip3 lida com isso? Ele chama diretamente o link . Mas podemos especificar da seguinte forma.

• python3.9 -m pip install <pacote>
• python3.8 -m pip install <pacote>

Testando

O comando python3.9 incia o interpretador python.

Conclusão

Com várias versões de python e pacote para OpenCV pode ser bastante confuso de incio.

Nesse post tentamos esclarecer um pouco dessa confusão. Porém, se ainda tenha dúvidas deixe nos comentários que eu reponderei em breve.

Para construir aplicações com OpenCV normalmente utilizamos uma IDE. No video abaixo mostro como preparar esse ambiente instalando o pycharm e estalando pacotes usando interface gráfica.