Guia de Instalação e Uso: Detecção de Mosquito da Dengue por Som

Pré-requisitos

• Python 3.10+
• Git

Instalação

Guia de Instalação para o uso do algoritmo de som - Linux (Ubuntu/Debian)

1. Instale o Python (se necessário):

bash sudo apt update sudo apt install python3 python3-pip -y

1. Crie um ambiente virtual (opcional, mas recomendado):

bash python3 -m venv venv source venv/bin/activate

1. Instale as dependências:

bash pip install -r requirements.txt

1. Instale dependências do sistema para sounddevice:

bash sudo apt install libportaudio2 libsndfile1

---

Guia de Instalação - Windows

1. Instale o Python:

2. Baixe em: https://www.python.org/downloads/

3. Marque a opção “Add Python to PATH” na instalação.

4. Abra o terminal (CMD ou PowerShell) e vá até a pasta do projeto:

cmd cd caminho\para\sua\pasta

1. (Opcional) Crie um ambiente virtual:

cmd python -m venv venv venv\Scripts\activate

1. Instale as dependências:

cmd pip install -r requirements.txt

1. (Se necessário) instale o driver do sounddevice (PortAudio):

2. Baixe o instalador PortAudio se houver erro.

3. Ou use o comando:

   cmd pip install pipwin pipwin install sounddevice

Após instalação

1. Clone o repositório

git clone https://gitlab.com/unb-esw/fga-pi2/semestre-2025-1/dengue/software/algorithm.git
cd algorithm-main/DENGUE_modelo_imagens

2. Execução dos algoritmos

Executar o algoritmo criarBaseDados.py com os áudios dos mosquitos no mesmo diretório para criar a base de dados:

python criarBaseDados.py

Após a criação da base de dados executar o arquivo matching.py para executar o algoritmo que verifica se o mosquito é ou não o Aedes Aegypt:

python matching.py

Histórico de Versão

Versão	Descrição	Data	Responsável
1.0	Criação do documento	30/05/2025	Vinícius de Oliveira