> For the complete documentation index, see [llms.txt](https://docs.earthindex.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.earthindex.ai/pt/pesquisa-mensal-beta/set-up-monthly-search.md).

# Criar um detetor

Crie um projeto de Pesquisa Mensal (monitoramento), rotule exemplos, treine seu detector e teste-o revisando uma amostra das detecções.

{% hint style="warning" %}
O Monthly Search está em versão beta.
{% endhint %}

Um detetor do Monthly Search (monitorização) é um modelo treinado com exemplos que identifica. Identifique, treine e, em seguida, teste-o, classificando uma amostra das deteções como **Correta** ou **Incorreta**. Depois, pode executá-lo em imagens mensais.

## Antes de começar

* A sua conta tem o Acesso completo e o Monthly Search ativados. Consulte [Quem pode utilizá-lo atualmente](https://docs.earthindex.ai/pt/pesquisa-mensal-beta/overview.md#who-can-use-it-today).
* Consegue encontrar pelo menos 10 exemplos nítidos do elemento que procura e pelo menos 100 quadrados que não o contenham, idealmente incluindo elementos semelhantes.
* O treino conta como uma Deep Search para o limite mensal (consulte [Limites e quotas](https://docs.earthindex.ai/pt/referencia/limits-and-quotas.md)).

## Passos

1. Clique em **Iniciar um novo projeto** e selecione **Monthly Search** em **Tipo de projeto**. Introduza um **Nome**, opcionalmente uma **Descrição**, defina a **Área de interesse** e clique em **Criar projeto**. Consulte [Iniciar um projeto](https://docs.earthindex.ai/pt/comecar/starting-a-new-project.md).
2. **Criar um detetor** tem três passos: **Identificar**, **Treinar** e **Testar**. Mantenha-se em **Identificar**.

   ![Painel lateral do Monthly Search no capítulo Criar um detetor, com as etapas Identificar, Treinar e Testar e o número de identificações.](https://1964083825-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIQB2eToY1Iv2IH6cERjn%2Fuploads%2Fgit-blob-28c68d797836e967d2d763b76ff9c001107eed53%2Flabel-stage.jpg?alt=media)
3. Adicione identificações com a barra de ferramentas do mapa. Consulte [Identificar quadrículas](https://docs.earthindex.ai/pt/pesquisar/label-tiles.md). **Adicionar identificações de treino** mostra as contagens de **Identificações positivas** e **Identificações negativas**, cada uma com uma marca de verificação ou uma cruz em relação ao mínimo: «mínimo de 10» e «mínimo de 100». Escolha identificações negativas semelhantes ao elemento que procura: consulte [Porque é que as identificações negativas são importantes](https://docs.earthindex.ai/pt/melhore-os-seus-resultados/why-negatives-matter.md).
4. Opcional: em **Encontrar rapidamente mais exemplos com IA**, clique em **Executar previsões rápidas**. Precisa de um rótulo positivo e encontra até 50 exemplos semelhantes. Em **Previsões de pesquisa rápida**, passe o cursor sobre um mosaico para confirmá-lo ou rejeitá-lo, ou clique em **Confirmar tudo** ou **Atualizar**.
5. Clique em **Continuar o treinamento**. O treinamento geralmente leva cerca de 20 segundos. Clique em **Cancelar treinamento** para interrompê-lo.
6. Quando **Treinamento concluído** aparecer, a etapa **Teste** será aberta. Em **Definir sensibilidade**, escolha **Ampla**, **Equilibrada** (predefinida) ou **Precisa**, ou **Personalizada** para um **limiar de confiança** controle deslizante. Consulte [os valores](https://docs.earthindex.ai/pt/pesquisa-mensal-beta/overview.md#confidence-and-sensitivity).

   ![A etapa Teste, na qual você executa o teste do detector e analisa uma amostra das detecções.](https://1964083825-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIQB2eToY1Iv2IH6cERjn%2Fuploads%2Fgit-blob-1c59334b2dd098d40091291387709eaad5bd3558%2Ftest-stage.jpg?alt=media)
7. Clique em **Executar teste do detector**. Isso pode levar alguns minutos.
8. Analise até 30 detecções em três grupos de 10: uma "Amostra de alta confiança", uma "Amostra de baixa confiança" e uma "Amostra aleatória". Uma faixa abaixo do mapa mostra sua posição, por exemplo, "Verificação 1–10 de 30".
9. Selecione um mosaico para ver dois painéis. O mosaico anual Sentinel-2 ("Imagens de treinamento") mostra o que o detector viu. O Mapbox Satellite ("Apenas referência") é mais nítido, mas não corresponde às imagens usadas pelo detector.
10. Marque cada detecção como **Correta** ou **Incorreta**. **Progresso da verificação** mostra **Analisadas**, **Marcadas como corretas**, **Marcadas como incorretas** e **Taxa de aprovação até agora**.
11. Quando terminar, o app mostrará a porcentagem de acertos, por exemplo, "70% dos exemplos analisados estavam corretos.", e "Limiar de aprovação: 60%".
    * 60% ou mais: "Seu detector parece pronto". Clique em **Continuar para a etapa mensal**.
    * Menos de 60%: "Talvez seja necessário melhorar seu detector". Clique em **Adicionar mais rótulos** para regressar a **Etiqueta**, ou **Usar dados de validação e voltar a treinar**. Ou clique em **Ignorar melhorias**, depois em **Ignorar e monitorizar**, para continuar como está.

Para ignorar a revisão, clique em **Ignorar validação humana**. A aplicação avisa que o modelo não será verificado. Clique em **Voltar e rever** ou **Ignorar validação**. Não é recomendável ignorar esta etapa.

## O que esperar

* Uma categoria junto à pontuação: **Excelente** (90% ou mais), **Forte** (80–89%), **Pronto** (60–79%), **Limítrofe** (40–59%) ou **Precisa de melhorias** (abaixo de 40%).
* As suas avaliações tornam-se etiquetas: **Correto** é positivo e **Incorreto** é negativo. **Usar dados de validação e voltar a treinar** mantém-nas.
* **Resumo do teste** mostra **Precisão no conjunto de validação**: precisão nos exemplos reservados durante o treino.
* **Resultados completos** (em vez da **Revisão focada**) mostra todas as deteções de teste. Use **Filtrar por confiança** e a lista **Deteções sem etiqueta (120)**. Depois de editar as etiquetas, **Voltar a treinar com as suas edições (3)** substitui **Continuar para o plano mensal**.

## Se algo correr mal

| Sintoma                                                                                                                                                             | Solução                                                                                                                                                                            |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Continuar o treino** está desativado                                                                                                                              | Passe o cursor sobre o elemento: «Adicione pelo menos 10 etiquetas positivas e 100 etiquetas negativas para continuar o treino.» Adicione as etiquetas em falta.                   |
| **Executar previsões rápidas** está desativado                                                                                                                      | «Adicione pelo menos uma etiqueta positiva ao mapa para ativar as previsões rápidas.»                                                                                              |
| «O treino está a demorar mais do que o habitual. Obrigado pela sua paciência.»                                                                                      | Aguarde. Depois de «Não foi possível iniciar o treino. Tente novamente.», clique em **Continuar o treino**.                                                                        |
| É apresentada uma notificação amarela a indicar que foi atingido um limite durante o treino                                                                         | O treino utiliza a sua quota mensal do Deep Search.                                                                                                                                |
| «Esta execução do detetor ainda não tem deteções para testar. Treine novamente o detetor e tente outra vez.»                                                        | Adicione exemplos positivos em **Etiquetar** e treine novamente.                                                                                                                   |
| «Só estavam disponíveis 18 deteções, por isso este teste utiliza menos de 30 exemplos.»                                                                             | Reveja-os. A taxa de aprovação baseia-se neles.                                                                                                                                    |
| **Etiquetar** e **Treinar** estão bloqueados                                                                                                                        | Ficam bloqueados durante um teste e uma revisão. Clique em **Limpar resultados do teste** ou termine a revisão.                                                                    |
| «Não foi possível executar o teste do detetor. Tente novamente.» ou «O detetor terminou, mas não foi possível transferir os ficheiros de deteção. Tente novamente.» | Clique em **Executar teste do detetor** novamente.                                                                                                                                 |
| Quer uma nova amostra mais tarde                                                                                                                                    | Em **Criar um detetor**, clique em **Executar novamente o teste**.                                                                                                                 |
| Quer um novo detetor                                                                                                                                                | Antes de concluir um teste, clique no ícone do caixote do lixo em **Treino concluído** («Eliminar detetor») e, em seguida, em **Eliminar modelo**. Esta ação não pode ser anulada. |

## Relacionados

* [Visão geral da Pesquisa mensal](https://docs.earthindex.ai/pt/pesquisa-mensal-beta/overview.md)
* [Executar e comparar meses](https://docs.earthindex.ai/pt/pesquisa-mensal-beta/monthly-monitor.md)
