O LabelImg é uma ferramenta de anotação de imagens de código aberto, amplamente utilizada para criar caixas delimitadoras (bounding boxes) e anotações poligonais. Essencial para a preparação de conjuntos de dados em projetos de visão computacional, como detecção de objetos e reconhecimento de imagens, permite rotular objetos em imagens de forma rápida e precisa para o treinamento de modelos de machine learning.
Tecnologias Fundamentais
A base tecnológica do LabelImg reside principalmente na linguagem de programação Python, complementada pela biblioteca Qt para a construção de sua interface gráfica intuitiva. Os principais componentes tecnológicos e frameworks empregados incluem:
- Python: Linguagem central para a lógica da aplicação e manipulação de dados.
- Qt: Biblioteca para o desenvolvimento da interface gráfica do usuário (GUI), garantindo uma experiência interativa.
- lxml: Utilizado para a eficiente manipulação de arquivos XML, fundamental para o formato PASCAL VOC, onde as anotações são salvas.
- PyQt: A ponte que integra Python e o framwork Qt, facilitando a criação de aplicações GUI multiplataforma.
Preparativos para a Instalação
Antes de iniciar o processo de instalação, é crucial garantir que os seguintes componentes estejam presentes em seu sistema operacional:
- Python 3.x: A versão 3 do Python é um requisito fundamental.
- pip: O gerenciador de pacotes padrão do Python, necessário para instalar as dependências.
- Git: Uma ferramenta de controle de versão, utilizada para clonar o repositório do projeto.
Processo de Instalação Detalhado
Siga os passos abaixo para configurar o LabelImg em sua máquina.
1. Obtenção do Código-Fonte
Primeiramente, clone o repositório oficial do LabelImg utilizando o Git. Abra um terminal ou prompt de comando e execute:
git clone https://github.com/heartexlabs/labelImg.git
2. Instalação das Dependências
Navegue até o diretório do projeto recém-clonado e instale as bibliotecas Python necessárias listadas no arquivo de requisitos. Este comando instalará todas as dependências especificadas para sistemas Linux/Python 3:
cd labelImg
pip install -r requirements/requirements-linux-python3.txt
3. Compilação e Execução
As etapas de compilação e inicialização variam ligeiramente dependendo do seu sistema operacional.
Para Linux/Ubuntu/macOS
Execute os comandos a seguir para compilar os recursos da interface e iniciar a aplicação:
make qt5py3
python3 labelImg.py
Para Windows
No ambiente Windows, gere os recursos PyQt e inicie o LabelImg com os seguintes comandos:
pyrcc5 -o libs/resources.py resources.qrc
python labelImg.py
4. Iniciando o LabelImg
Após executar os comandos apropriados para seu sistema, a janela do LabelImg será exibida, pronta para uso.
Utilização Básica do LabelImg
Com o LabelImg em funcionamento, você pode começar a anotar suas imagens de forma eficiente:
- Abrir Diretório: Clique no botão "Open Dir" para selecionar a pasta que contém as imagens que deseja anotar.
- Criar Anotações: Utilize a opção "Create RectBox" para desenhar caixas delimitadoras ao redor dos objetos. Arraste o mouse sobre a imagem para definir a área do objeto e, em seguida, insira o rótulo (classe) do objeto.
- Salvar Anotações: Após criar suas anotações, clique no botão "Save" para armazená-las. Por padrão, os arquivos de anotação são gerados no formato XML PASCAL VOC, na mesma pasta das imagens, com o mesmo nome do arquivo de imagem, mas com a extensão
.xml.