Skip to content
Back to skills

Zonas De Manejo

ASecurity

Divide o talhão em zonas de manejo a partir das camadas que o usuário tiver (solo, produtividade, relevo, índice de vegetação), em pontos ou rasters, e entrega os polígonos, a tabela por zona e o relatório. Primeiro mostra o diagnóstico (camadas, repetição entre elas e o que cada número de zonas daria); depois agrupa por componentes principais e K-Means, limpa os fragmentos, funde as partes pequenas e desenha as divisas suavizadas, com a borda no perímetro do talhão. Saídas: GeoJSON, KML, sha...

  • 2 stars
  • 0 votes
  • 0 copies
  • 0 views
  • Added November 14, 2026
ai-agentspythongo

Works with

  • cli

Security analysis

A100/100

Pro scans all 15 files and shows the line behind each finding

Scanned November 14, 2026

npx -y skills add guilherme-iaparaagronomos/skills-agro --skill zonas-de-manejo --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Zonas De Manejo?

Add the live security badge to your README. It updates with every re-scan.

Security grade badge for Zonas De Manejo
[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/guilherme-iaparaagronomos-zonas-de-manejo/badge)](https://www.skillsdirectory.com/skills/guilherme-iaparaagronomos-zonas-de-manejo)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro
SKILL.md
---
name: zonas-de-manejo
description: >-
  Divide o talhão em zonas de manejo a partir das camadas que o usuário tiver
  (solo, produtividade, relevo, índice de vegetação), em pontos ou rasters, e
  entrega os polígonos, a tabela por zona e o relatório. Primeiro mostra o
  diagnóstico (camadas, repetição entre elas e o que cada número de zonas
  daria); depois agrupa por componentes principais e K-Means, limpa os
  fragmentos, funde as partes pequenas e desenha as divisas suavizadas, com a
  borda no perímetro do talhão. Saídas: GeoJSON, KML, shapefile, raster,
  tabelas e PDF. Acione com "zonas de manejo", "dividir o talhão em zonas",
  "unidades de gestão diferenciada", "ambientes de produção a partir dos
  mapas", "juntar os mapas em zonas" ou quando o usuário tiver várias camadas
  do mesmo talhão e quiser uma divisão para manejar.
---

# Zonas de manejo

Junta as camadas de um talhão (o que o usuário tiver: argila, matéria
orgânica, produtividade de várias safras, altitude, declive, índice de
vegetação, condutividade elétrica) e separa os lugares parecidos em **zonas**,
com polígonos prontos para o QGIS e para a máquina.

## Para que serve
- Transformar vários mapas do mesmo talhão numa divisão só.
- Mostrar o que cada zona tem de diferente: a média de cada camada por zona.
- Dizer **quanto** as zonas explicam de cada camada, para o usuário saber se a
  divisão é firme ou fraca.

## Para que NÃO serve
- **Não recomenda manejo.** Não diz dose, população, cultivar nem o que fazer
  em cada zona. Informa o agrupamento; a decisão é do responsável técnico.
- **Não cria dado.** As camadas já têm de existir. Para gerar mapas de solo,
  use `interpolacao-idw` ou `interpolacao-krigagem`; para limpar dado de
  colheita, `limpeza-monitor-produtividade`.
- **Não dá nota às zonas.** O número da zona é só a ordem da média de uma
  camada. "Zona 3" não quer dizer "melhor".
- Não substitui a conferência no campo: o método agrupa o que recebe.

## O que pedir ao usuário
1. O **perímetro** do talhão (GeoJSON, KML ou shapefile). Um talhão por vez
   dá o melhor resultado.
2. As **camadas**, de um destes jeitos (ou dos dois juntos):
   - um arquivo de **pontos** com as camadas em colunas (CSV/TXT com
     coordenadas, ou shapefile de pontos): grade amostral com o laudo, pontos
     de colheita já limpos, grade com valores amostrados de vários mapas;
   - **rasters GeoTIFF**, um por camada: mapas interpolados, índice de
     vegetação, altitude. Em UTM (SIRGAS 2000 ou WGS 84) ou em graus.
3. O que é cada camada, e se alguma deve **pesar mais**.

## Fluxo de trabalho (siga nesta ordem)

1. **Diagnóstico** (não gera zonas):
   ```
   python scripts/zonas.py --perimetro <perímetro> --pontos <pontos> --raster nome=<arquivo.tif> --diagnostico --saida saida
   ```
   Use só o que houver: `--pontos`, um ou mais `--raster nome=arquivo.tif`, ou
   os dois. O nome do raster é o nome da camada no relatório.
2. **Mostre ao usuário o que o diagnóstico disse** e **confirme com ele**:
   - **quais camadas entram.** O script lista as colunas numéricas e marca as
     que parecem identificador. Coluna de id, de data ou de número de amostra
     não é camada.
   - **camadas que andam juntas.** Se duas têm correlação acima de 0,9, a
     mesma informação entra duas vezes: pergunte se tira uma ou reduz o peso.
   - **o número de zonas.** Mostre a tabela inteira: para cada número, a
     silhueta, quantas zonas sobram depois do refino e quanto elas explicam.
     Diga a sugestão do script e que ela é um critério estatístico. Quem
     decide quantas zonas dá para manejar é ele.
   - **a área mínima.** O padrão é 10% da área: o diagnóstico diz quantos
     hectares isso dá. Zona ou parte menor que isso é absorvida pela vizinha.
   - **a camada que ordena os números** das zonas (padrão: a primeira).
3. **Gere as zonas** com o que ele confirmou:
   ```
   python scripts/zonas.py --perimetro <perímetro> --pontos <pontos> --colunas "a,b,c" \
       --raster nome=<arquivo.tif> --k <número> --nome "<talhão · safra>" --saida saida
   ```
   `--k auto` só se ele disser para ficar com o critério estatístico.
4. **Relate o resultado inteiro**: quantas zonas ficaram; hectares, % e
   número de partes de cada uma; a média de cada camada por zona; quanto as
   zonas explicam de cada camada; o que aconteceu no refino (classes
   absorvidas, fragmentos reatribuídos, partes fundidas); e **todos os
   avisos**, com as palavras do script. Mostre `relatorio-zonas.png`.
5. **Pare e converse antes de entregar** se houver aviso de silhueta abaixo
   de 0,25, de camada que as zonas quase não separam, de camadas repetidas ou
   de zona única. Nesses casos o mapa é uma divisão possível, não um limite
   firme: diga isso.
6. **Entregue** os arquivos e diga para que serve cada um. Se ele pedir outro
   número de zonas, outra área mínima ou outro peso, rode de novo e diga o
   que mudou.

Para ver a skill funcionando sem arquivo: `python scripts/zonas.py --demo`
(talhão inventado, com zonas plantadas; o script diz que é exemplo).

## Parâmetros

| Parâmetro | O que faz | Padrão |
|---|---|---|
| `--colunas a,b,c` | colunas do arquivo de pontos que entram como camadas | obrigatório com `--pontos` |
| `--raster nome=arquivo.tif[:banda]` | camada em GeoTIFF (repetível) | — |
| `--pesos a=2,b=0.5` | peso de cada camada | 1 para todas |
| `--k N` ou `--k auto` | número de zonas | obrigatório |
| `--k-min`, `--k-max` | faixa testada no diagnóstico e no `auto` | 2 a 8 |
| `--area-minima P` | menor zona e menor parte, em % da área | 10 |
| `--vizinhos N` | vizinhos usados no refino | 8 |
| `--frag-total P`, `--frag-classe P` | pedaço solto menor que P% do total E P% da classe é reatribuído | 3 e 20 |
| `--variancia-pca P` | % da variação guardada nas componentes | 90 |
| `--suavizar M` | tolerância das divisas entre zonas, em metros (0 = sem suavizar) | o espaçamento dos pontos |
| `--ordenar-por camada` | camada que dá a ordem dos números | a primeira |
| `--espacamento M` | grade de pontos usada para ler os rasters | automático |
| `--agregar M` | média por célula, para dado denso (`nenhum` desliga) | automático acima de 20 mil pontos |
| `--separar-partes` | no shapefile, uma feição por parte de zona | uma por zona |
| `--zona 22S` | zona UTM, para coordenadas em metros sem `.prj` | — |

O que cada etapa faz, quando mexer no padrão e os limites:
`references/metodo.md`.

## Regras de honestidade

- **Diagnóstico antes, sempre.** Não gere zonas sem o usuário confirmar as
  camadas e o número de zonas.
- **Nenhum parâmetro escolhido em silêncio.** Diga quais vai usar, inclusive
  os padrões.
- **Fale das zonas pelo que elas têm**: "a zona 1 tem a menor média de
  argila, 190 g/kg". Não chame de "zona boa", "zona ruim", "alto potencial"
  ou "baixo potencial": isso é interpretação do responsável técnico.
- **Diga quanto a divisão explica.** Zonas que explicam 80% de uma camada
  separam bem aquela camada; 10%, quase nada.
- **O resultado depende das camadas.** Camada de um ano atípico, mapa
  interpolado com poucos pontos ou dado sujo entram do jeito que estão. Se o
  usuário não souber a origem de uma camada, diga que isso limita o resultado.
- **Não esconda aviso** e não troque as palavras dele por outras mais leves.
- A skill foi medida em **talhão inventado com zonas plantadas** e rodada
  numa fazenda real; em talhão de verdade não existe gabarito, e a
  conferência é no campo.

## Saídas (na pasta `--saida`)

- `zonas.geojson`, `zonas.kml`, `zonas-shapefile.zip` — os polígonos, com a
  área e a média de cada camada por zona. A borda de fora segue o perímetro do
  talhão; a divisa entre duas zonas é a mesma linha nas duas.
- `zonas.tif` — raster com o número da zona, em UTM.
- `zonas-resumo.csv` — por zona: área, %, partes e média, desvio, mínimo e
  máximo de cada camada.
- `pontos-com-zona.csv` — os pontos usados, com a zona de cada um.
- `relatorio-zonas.pdf` — o mapa e a tabela; como foi feito; as camadas com
  o contorno das zonas. `relatorio-zonas.png` é a primeira página.
- `zonas.json` — todos os números e os parâmetros usados.
- No diagnóstico: `diagnostico.json`.

## Para onde vão as zonas

- `amostragem-georreferenciada` desenha a coleta por zona com o
  `zonas.geojson`: `--perimetro <perímetro> --modo zona --zonas zonas.geojson`.
- `layout-mapa-qgis` monta o mapa final no QGIS a partir do shapefile.

## Dependências

Python com `numpy`, `scipy` e `matplotlib`. Sem internet.

Files in this skill

  • README.md2.6 KB
  • SKILL.md8.5 KB
  • references/metodo.md7.2 KB
  • scripts/agrupamento.py11.9 KB
  • scripts/areas.py12.1 KB
  • scripts/geometria.py12.1 KB
  • scripts/geotiff.py16.6 KB
  • scripts/grade.py7.1 KB
  • scripts/leitura.py10.8 KB
  • scripts/saidas.py25.3 KB
  • scripts/shapefile_min.py5 KB
  • scripts/sintetico.py5.3 KB
  • scripts/vetor.py16 KB
  • scripts/zonas.py20.2 KB
  • scripts/zoneamento.py15.7 KB

Attribution

Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.

View all in ai-agents →

Comments

Loading comments…

Newsletter

Get the weekly list of safe new skills, and the ones we pulled.