Visão Geral e Tecnloogias Utilizadas

O labelCloud é uma ferramenta leve e eficiente projetada para a anotação de caixas delimitadoras 3D (bounding boxes) em conjuntos de dados de nuvens de pontos. Desenvolvido em Python, o projeto foca na flexibilidade para suportar diversos formatos de arquivos e rótulos, facilitando tarefas de detecção de objetos em 3D.

As principais bbiliotecas e frameworks que compõem o ecossistema do projeto incluem:

• Python (3.7 a 3.9): Veersões compatíveis do interpretador.
• PyQt5: Interface gráfica multiplataforma.
• Open3D: Motor para processamento e visualização tridimensional.
• NumPy: Operações matemáticas e manipulação de arrays de dados.

Preparação do Ambiente

Antes de iniciar a instalação, certifique-se de que as ferramentas básicas estão configuradas em seu sistema operacional.

1. Validar Versão do Python: Verifique se possui uma versão suportada instalada: ``` python -V

2. Verificar o Git: Necessário para obter o código-fonte: ``` git --version

3. Isolamento do Ambiente (Recomendado): Utilize ambientes virtuais para evitar conflitos entre dependências de diferentes projetos. ```

   Criando o ambiente virtual

   python -m venv venv_labeller

   Ativação no Linux/macOS

   source venv_labeller/bin/activate

   Ativação no Windows

   .\venv_labeller\Scripts\activate

Processo de Instalação e Execução

Siga os comandos abaixo para baixar e configurar as dependências do labelCloud:

1. Obter o código: ``` git clone https://github.com/ch-sa/labelCloud.git cd labelCloud

2. Instalar pacotes necessários: ``` pip install --upgrade pip pip install -r requirements.txt

3. Inicializar a aplicação: ``` python labelCloud.py

Ajustes de Configuração

O comportamento do labelCloud pode ser personalizado através do arquivo config.ini. As principais seções de interesse são:

• Diretório de Dados: Na seção [pointclouds], especifique o caminho local onde seus arquivos de nuvem de pontos estão armazenados.
• Formatos de Saída: Na seção [labels], defina o padrão de exportação dos rótulos gerados durante a anotação.

Guia Rápido de Uso

Para testar a instalação rapidamente, você pode carregar o ambiente com dados de exemplo:

python labelCloud.py --example

Com a interface aberta, a interação básica ocorre da seguinte forma:

• Rotação: Clique e arraste com o botão esquerdo do mouse.
• Translação (Pan): Clique e arraste com o botão direito do mouse.
• Zoom: Utilize o scroll do mouse.
• Atalhos: O teclado é utilizado para criar novas caixas e ajustar as dimensões dos objetos selecionados.