Diagnóstico da variabilidade do talhão
O usuário tem um mapa que varia dentro do talhão (em geral a produtividade) e
outras camadas do mesmo lugar. A skill responde a uma pergunta só: o que
varia junto com ele? Entrega:
- o diagnóstico das camadas: o que cada arquivo cobre, com que
resolução, e quais camadas se repetem;
- as correlações com a variável a explicar, cada uma com o intervalo de
95% calculado com o número de observações independentes do mapa;
- a parte de cada camada: sozinha, por cima das outras e repartida;
- as manchas: o talhão em faixas de valor baixo, médio e alto, e a média
de cada camada em cada faixa;
- os arquivos:
relato.md, quatro CSV, o mapa das manchas em GeoTIFF, as
figuras e relatorio.pdf.
Quem faz a conta é o script scripts/variabilidade.py.
A regra que vale para tudo: descreve, não explica
- Diga "acompanha", "varia junto", "sobe junto", "desce quando ela
sobe". NUNCA diga "causa", "explica", "é por causa de", "o problema é", "o
fator limitante é". Variar junto não é causa: uma terceira coisa pode mexer
nas duas, ou pode ser acaso. Diga isso junto do resultado, sempre.
- NUNCA recomende calagem, adubação, gessagem, subsolagem, troca de variedade,
taxa variável nem outro manejo, e não diga o que "corrigir". O que fazer com
o resultado é decisão do responsável técnico, que conhece a área.
- A variável a explicar e as camadas que entram são do usuário. Mostre o
diagnóstico, pergunte, e só então rode. Não escolha por ele nem use "todas"
sem ele dizer.
- Células de um mapa não são amostras independentes. Dez mil células de um
mapa suave valem algumas dezenas de observações. Por isso a skill não dá
valor de p: dá o intervalo com o número de observações independentes. Não
conserte isso por fora nem diga "altamente significativo" porque há muitas
células.
- Intervalo que inclui o zero: diga "não se distingue do acaso", e não
"tendência" nem "relação fraca".
- Camadas parecidas repartem a importância. Quando duas dizem quase a
mesma coisa, o resultado não diz qual das duas pesa. Repita o aviso.
- Índice de vegetação da mesma safra é quase a própria resposta. Se a
variável a explicar é a produtividade de 2024, o NDVI de 2024 não entra como
camada: ele é outro retrato da mesma lavoura. Índices de outras safras
entram.
- Não use palavra que qualifica: bom, ruim, problema, crítico, limitante,
deficiente.
- Se o usuário pedir a conclusão ("o que eu corrijo?", "é a argila?"), diga
que a análise não conclui, mostre o que acompanha o quê e devolva a decisão
a ele e ao responsável técnico.
O que precisa estar disponível
- Um ambiente que rode Python com
numpy, scipy e matplotlib. Sem
ele, não faça correlação de cabeça nem "de olho" nos mapas: diga que a skill
precisa de um ambiente com código.
- O perímetro do talhão: GeoJSON, KML, shapefile ou WKT.
- As camadas, em arquivo, pelo menos duas (a variável a explicar e mais
uma):
| O que é |
Como chega |
De onde costuma vir |
| mapa de produtividade |
pontos limpos (CSV) ou GeoTIFF |
skill limpeza-monitor-produtividade; exportação do monitor |
| atributos de solo |
um GeoTIFF por atributo |
skills interpolacao-krigagem e interpolacao-idw |
| relevo (altitude, declive) |
GeoTIFF |
ferramenta relevo_fazenda da ClaudIA Sat; QGIS |
| índice de vegetação de outra safra |
GeoTIFF |
ferramentas composto_indice e imagem_satelite da ClaudIA Sat |
| condutividade elétrica, sensor, drone |
pontos densos ou GeoTIFF |
o equipamento; QGIS |
| zonas, variedades, talhões |
polígonos com a classe |
skill zonas-de-manejo; o cadastro da fazenda |
GeoTIFF em SIRGAS 2000 / UTM, WGS 84 / UTM ou em graus. Outro sistema (SAD
69, por exemplo) é recusado: peça para reexportar. As ferramentas da ClaudIA
Sat consomem a franquia de hectares do usuário: só chame se ele pedir, e diga
antes quanto vai consumir.
Laudo de solo em pontos esparsos não entra direto. Com uma amostra por
hectare, quase todas as células ficariam vazias. Interpole antes, com uma das
skills de interpolação, e traga o GeoTIFF.
Antes de rodar: as perguntas (numa mensagem só)
- O perímetro e os arquivos de cada camada, com o nome que cada uma vai
ter.
- De que safra é cada índice de vegetação, e de que safra é a
produtividade.
- De quantas amostras saiu cada mapa de solo (para dizer, no relato, que
mapa de poucas amostras é suave).
- Para os polígonos: qual campo traz a classe.
A variável a explicar, as camadas que entram, a célula e as faixas ficam para
depois do diagnóstico. O que ele já disse, não pergunte de novo.
Fluxo de trabalho (siga nesta ordem)
- Rode o diagnóstico (não analisa nada):
python scripts/variabilidade.py --perimetro talhao.geojson \
--raster argila=argila.tif --raster altitude=altitude.tif \
--pontos colheita_limpa.csv --classes variedade=variedades.geojson:variedade \
--diagnostico --saida saida
--raster nome=arquivo.tif, um por camada (arquivo.tif:2 para a banda 2);
--pontos arquivo.csv: cada coluna numérica vira uma camada com o nome
da coluna (--pontos prefixo=arquivo.csv põe o prefixo no nome);
--classes nome=arquivo.geojson:campo para polígonos com classe.
- Mostre o diagnóstico ao usuário, inteiro: a tabela das camadas, as
notas, os pares parecidos. Preste atenção em:
- camada com cobertura baixa (a análise só usa as células que têm valor em
todas);
- "varia devagar no talhão": poucas observações independentes;
- pares "quase iguais";
- pontos esparsos para a célula.
- Pergunte o que é dele: a variável a explicar; quais camadas entram;
qual fica de fora por ser da mesma safra ou repetida; se a célula
automática serve (
--celula); e como repartir as manchas (três faixas de
mesma área é o padrão; --faixas 2 a 5, ou --cortes com os valores
que ele usa). Se ele disser "escolhe você", explique em uma frase o que
muda e devolva a pergunta. Sem a resposta, não rode.
- Rode a análise com as escolhas:
python scripts/variabilidade.py --perimetro talhao.geojson \
--raster argila=argila.tif --raster altitude=altitude.tif --pontos colheita_limpa.csv \
--classes variedade=variedades.geojson:variedade \
--alvo prod_t_ha --camadas argila,altitude --com-classes variedade \
--nome "Talhão 12" --saida saida
- Relate: escreva na conversa o conteúdo de
relato.md (a leitura, a
tabela camada por camada, as manchas, os avisos e o "como ler") e mostre
manchas.png e importancia.png. Abra o PDF e olhe antes de entregar.
- Repita todos os avisos com as palavras do script. Eles são parte do
resultado.
- Outra escolha é outra rodada: tirar uma camada, mudar a célula ou os
cortes muda os números. Rode de novo e diga o que mudou. Não rode várias
combinações para ficar com a que dá o resultado mais forte.
Para ver funcionando sem dado nenhum: python scripts/variabilidade.py --demo
(talhão inventado, com relações plantadas; o script diz quais escolhas foram
fixadas só no exemplo).
Como ler o que sai
| Coluna |
O que é |
| r (Pearson) |
correlação em linha reta com a variável a explicar, de −1 a +1 |
| Intervalo de 95% |
a faixa do r, contando só as observações independentes. Se inclui o zero, não se distingue do acaso |
| Spearman |
a correlação das posições (ordem). Longe do Pearson: relação que não é reta, ou valores extremos |
| Observações independentes |
quanto o mapa vale em observações soltas, descontada a semelhança entre vizinhas |
| Sozinha |
a parte da variação que a camada acompanha sem as outras (R²) |
| Por cima das outras |
quanto o conjunto perde quando só ela sai |
| Repartida |
a média do que ela acrescenta em todas as ordens de entrada; as partes somam o R² do conjunto |
| Piso de ruído |
o R² que o mesmo número de camadas sem relação nenhuma alcança por acaso |
| Alto − baixo, em desvios |
a diferença da camada entre a faixa mais alta e a mais baixa, em desvios dela |
- Duas camadas altas em "sozinha" e perto de zero em "por cima das outras":
são redundantes.
- "Por cima das outras" maior que "sozinha": as outras camadas escondiam a
relação. Vale para as classes também: a média crua de cada variedade
mistura o efeito das outras camadas.
- R² do conjunto perto do piso de ruído: não há o que ler.
- Nota "relação em curva": há um valor do meio em que a variável a explicar é
maior (ou menor). A conta de reta não vê; o perfil das manchas mostra.
Parâmetros
| Parâmetro |
O que faz |
Padrão |
--alvo |
a variável a explicar |
sem padrão: o usuário escolhe |
--camadas |
as camadas numéricas, separadas por vírgula (todas só se ele disser) |
sem padrão |
--com-classes |
as camadas de classes que entram |
nenhuma |
--celula |
lado da célula da grade, em metros |
automática: a partir de 10 m, até 20 mil células |
--faixas |
número de faixas de mesma área nas manchas (2 a 5) |
3 |
--cortes "3,2;4,0" |
cortes das faixas, com os valores do usuário |
os quantis |
--sem-filtro |
não tira células soltas das manchas |
filtro de maioria ligado |
--mancha-minima |
área mínima, em ha, para contar como mancha |
0,5% da área |
--zona 22S |
zona UTM do perímetro em metros sem .prj |
a do arquivo |
--x, --y |
colunas de coordenada dos pontos |
reconhecidas pelo nome |
--sem-pdf |
não grava figuras nem PDF |
grava |
A célula não deve ser menor que a resolução de verdade das camadas: célula de
10 m com mapa de solo de uma amostra por hectare só multiplica células
repetidas. O diagnóstico mostra o pixel de cada raster e o espaçamento dos
pontos. O método e os limites: references/metodo.md.
O que a skill não faz
- Não diz a causa da variabilidade nem recomenda correção.
- Não interpola laudo de solo, não limpa mapa de colheita e não faz zonas de
manejo: para isso existem as skills
interpolacao-krigagem,
interpolacao-idw, limpeza-monitor-produtividade e zonas-de-manejo.
- Não compara talhões nem safras: uma rodada, um talhão, uma variável.
- Não enxerga relação que depende de outra camada (interação) nem ótimo no
meio, a não ser pela nota de curva e pelo perfil das manchas.
- Não substitui a ida ao talhão: mancha que nenhuma camada acompanha pode ter
motivo que não está em mapa nenhum (praga, falha de plantio, compactação,
histórico).
Recusas
O script para e diz o motivo quando: falta o perímetro ou há só uma camada;
um raster não é GeoTIFF, está noutro sistema de coordenadas ou não cobre o
talhão; nenhum ponto cai dentro do perímetro; duas camadas têm o mesmo nome;
menos de 50 células têm valor em todas as camadas escolhidas; a variável a
explicar ou uma camada é constante; os cortes deixam uma faixa vazia. Repasse
o motivo como veio e não contorne.
1---2name: diagnostico-variabilidade3description: >-4 Mostra o que varia junto com a variabilidade de um talhão: põe o mapa de5 produtividade (ou outra variável) e as camadas disponíveis numa grade comum6 e descreve quem acompanha quem. Entram o perímetro e as camadas em GeoTIFF,7 pontos densos ou polígonos com classe: solo, relevo, índices de vegetação de8 outras safras, condutividade elétrica, drone, zonas. Sai o diagnóstico das9 camadas e, com as escolhas do usuário, as correlações com intervalo que10 respeita a semelhança entre células vizinhas, a parte de cada camada, as11 manchas de valor baixo, médio e alto com o perfil de cada camada, tabelas e12 PDF. Só descreve: variar junto não é causa, e a skill não13 recomenda correção nem manejo. A variável a explicar e as camadas são14 escolha do usuário. Acione com "o que explica a variabilidade do talhão",15 "por que essa mancha produz menos", "cruza a produtividade com o solo",16 "diagnóstico da variabilidade", "correlação entre os mapas" ou quando o17 usuário trouxer um mapa de produtividade e outras camadas do mesmo talhão.18metadata:19 source: https://skillmd.com/skills/guilherme-iaparaagronomos/diagnostico-variabilidade20---2122# Diagnóstico da variabilidade do talhão2324O usuário tem um mapa que varia dentro do talhão (em geral a produtividade) e25outras camadas do mesmo lugar. A skill responde a uma pergunta só: **o que26varia junto com ele?** Entrega:27281. o **diagnóstico das camadas**: o que cada arquivo cobre, com que29 resolução, e quais camadas se repetem;302. as **correlações** com a variável a explicar, cada uma com o intervalo de31 95% calculado com o número de observações independentes do mapa;323. a **parte de cada camada**: sozinha, por cima das outras e repartida;334. as **manchas**: o talhão em faixas de valor baixo, médio e alto, e a média34 de cada camada em cada faixa;355. os arquivos: `relato.md`, quatro CSV, o mapa das manchas em GeoTIFF, as36 figuras e `relatorio.pdf`.3738Quem faz a conta é o script `scripts/variabilidade.py`.3940## A regra que vale para tudo: descreve, não explica4142- Diga **"acompanha"**, **"varia junto"**, "sobe junto", "desce quando ela43 sobe". NUNCA diga "causa", "explica", "é por causa de", "o problema é", "o44 fator limitante é". Variar junto não é causa: uma terceira coisa pode mexer45 nas duas, ou pode ser acaso. Diga isso junto do resultado, sempre.46- NUNCA recomende calagem, adubação, gessagem, subsolagem, troca de variedade,47 taxa variável nem outro manejo, e não diga o que "corrigir". O que fazer com48 o resultado é decisão do responsável técnico, que conhece a área.49- **A variável a explicar e as camadas que entram são do usuário.** Mostre o50 diagnóstico, pergunte, e só então rode. Não escolha por ele nem use "todas"51 sem ele dizer.52- **Células de um mapa não são amostras independentes.** Dez mil células de um53 mapa suave valem algumas dezenas de observações. Por isso a skill não dá54 valor de p: dá o intervalo com o número de observações independentes. Não55 conserte isso por fora nem diga "altamente significativo" porque há muitas56 células.57- Intervalo que inclui o zero: diga "não se distingue do acaso", e não58 "tendência" nem "relação fraca".59- **Camadas parecidas repartem a importância.** Quando duas dizem quase a60 mesma coisa, o resultado não diz qual das duas pesa. Repita o aviso.61- **Índice de vegetação da mesma safra é quase a própria resposta.** Se a62 variável a explicar é a produtividade de 2024, o NDVI de 2024 não entra como63 camada: ele é outro retrato da mesma lavoura. Índices de outras safras64 entram.65- Não use palavra que qualifica: bom, ruim, problema, crítico, limitante,66 deficiente.67- Se o usuário pedir a conclusão ("o que eu corrijo?", "é a argila?"), diga68 que a análise não conclui, mostre o que acompanha o quê e devolva a decisão69 a ele e ao responsável técnico.7071## O que precisa estar disponível7273- **Um ambiente que rode Python** com `numpy`, `scipy` e `matplotlib`. Sem74 ele, não faça correlação de cabeça nem "de olho" nos mapas: diga que a skill75 precisa de um ambiente com código.76- **O perímetro** do talhão: GeoJSON, KML, shapefile ou WKT.77- **As camadas**, em arquivo, pelo menos duas (a variável a explicar e mais78 uma):7980| O que é | Como chega | De onde costuma vir |81|---|---|---|82| mapa de produtividade | pontos limpos (CSV) ou GeoTIFF | skill `limpeza-monitor-produtividade`; exportação do monitor |83| atributos de solo | um GeoTIFF por atributo | skills `interpolacao-krigagem` e `interpolacao-idw` |84| relevo (altitude, declive) | GeoTIFF | ferramenta `relevo_fazenda` da ClaudIA Sat; QGIS |85| índice de vegetação de outra safra | GeoTIFF | ferramentas `composto_indice` e `imagem_satelite` da ClaudIA Sat |86| condutividade elétrica, sensor, drone | pontos densos ou GeoTIFF | o equipamento; QGIS |87| zonas, variedades, talhões | polígonos com a classe | skill `zonas-de-manejo`; o cadastro da fazenda |8889GeoTIFF em SIRGAS 2000 / UTM, WGS 84 / UTM ou em graus. Outro sistema (SAD9069, por exemplo) é recusado: peça para reexportar. As ferramentas da ClaudIA91Sat consomem a franquia de hectares do usuário: só chame se ele pedir, e diga92antes quanto vai consumir.9394**Laudo de solo em pontos esparsos não entra direto.** Com uma amostra por95hectare, quase todas as células ficariam vazias. Interpole antes, com uma das96skills de interpolação, e traga o GeoTIFF.9798## Antes de rodar: as perguntas (numa mensagem só)991001. **O perímetro e os arquivos** de cada camada, com o nome que cada uma vai101 ter.1022. **De que safra é cada índice de vegetação**, e de que safra é a103 produtividade.1043. **De quantas amostras saiu cada mapa de solo** (para dizer, no relato, que105 mapa de poucas amostras é suave).1064. Para os polígonos: **qual campo** traz a classe.107108A variável a explicar, as camadas que entram, a célula e as faixas ficam para109depois do diagnóstico. O que ele já disse, não pergunte de novo.110111## Fluxo de trabalho (siga nesta ordem)1121131. **Rode o diagnóstico** (não analisa nada):114 ```115 python scripts/variabilidade.py --perimetro talhao.geojson \116 --raster argila=argila.tif --raster altitude=altitude.tif \117 --pontos colheita_limpa.csv --classes variedade=variedades.geojson:variedade \118 --diagnostico --saida saida119 ```120 - `--raster nome=arquivo.tif`, um por camada (`arquivo.tif:2` para a banda 2);121 - `--pontos arquivo.csv`: cada coluna numérica vira uma camada com o nome122 da coluna (`--pontos prefixo=arquivo.csv` põe o prefixo no nome);123 - `--classes nome=arquivo.geojson:campo` para polígonos com classe.1242. **Mostre o diagnóstico ao usuário**, inteiro: a tabela das camadas, as125 notas, os pares parecidos. Preste atenção em:126 - camada com cobertura baixa (a análise só usa as células que têm valor em127 todas);128 - "varia devagar no talhão": poucas observações independentes;129 - pares "quase iguais";130 - pontos esparsos para a célula.1313. **Pergunte o que é dele**: a variável a explicar; quais camadas entram;132 qual fica de fora por ser da mesma safra ou repetida; se a célula133 automática serve (`--celula`); e como repartir as manchas (três faixas de134 mesma área é o padrão; `--faixas 2` a `5`, ou `--cortes` com os valores135 que ele usa). Se ele disser "escolhe você", explique em uma frase o que136 muda e devolva a pergunta. **Sem a resposta, não rode.**1374. **Rode a análise** com as escolhas:138 ```139 python scripts/variabilidade.py --perimetro talhao.geojson \140 --raster argila=argila.tif --raster altitude=altitude.tif --pontos colheita_limpa.csv \141 --classes variedade=variedades.geojson:variedade \142 --alvo prod_t_ha --camadas argila,altitude --com-classes variedade \143 --nome "Talhão 12" --saida saida144 ```1455. **Relate**: escreva na conversa o conteúdo de `relato.md` (a leitura, a146 tabela camada por camada, as manchas, os avisos e o "como ler") e mostre147 `manchas.png` e `importancia.png`. Abra o PDF e olhe antes de entregar.1486. **Repita todos os avisos com as palavras do script.** Eles são parte do149 resultado.1507. **Outra escolha é outra rodada**: tirar uma camada, mudar a célula ou os151 cortes muda os números. Rode de novo e diga o que mudou. Não rode várias152 combinações para ficar com a que dá o resultado mais forte.153154Para ver funcionando sem dado nenhum: `python scripts/variabilidade.py --demo`155(talhão inventado, com relações plantadas; o script diz quais escolhas foram156fixadas só no exemplo).157158## Como ler o que sai159160| Coluna | O que é |161|---|---|162| r (Pearson) | correlação em linha reta com a variável a explicar, de −1 a +1 |163| Intervalo de 95% | a faixa do r, contando só as observações independentes. Se inclui o zero, não se distingue do acaso |164| Spearman | a correlação das posições (ordem). Longe do Pearson: relação que não é reta, ou valores extremos |165| Observações independentes | quanto o mapa vale em observações soltas, descontada a semelhança entre vizinhas |166| Sozinha | a parte da variação que a camada acompanha sem as outras (R²) |167| Por cima das outras | quanto o conjunto perde quando só ela sai |168| Repartida | a média do que ela acrescenta em todas as ordens de entrada; as partes somam o R² do conjunto |169| Piso de ruído | o R² que o mesmo número de camadas sem relação nenhuma alcança por acaso |170| Alto − baixo, em desvios | a diferença da camada entre a faixa mais alta e a mais baixa, em desvios dela |171172- Duas camadas altas em "sozinha" e perto de zero em "por cima das outras":173 são redundantes.174- "Por cima das outras" maior que "sozinha": as outras camadas escondiam a175 relação. Vale para as classes também: a média crua de cada variedade176 mistura o efeito das outras camadas.177- R² do conjunto perto do piso de ruído: não há o que ler.178- Nota "relação em curva": há um valor do meio em que a variável a explicar é179 maior (ou menor). A conta de reta não vê; o perfil das manchas mostra.180181## Parâmetros182183| Parâmetro | O que faz | Padrão |184|---|---|---|185| `--alvo` | a variável a explicar | **sem padrão: o usuário escolhe** |186| `--camadas` | as camadas numéricas, separadas por vírgula (`todas` só se ele disser) | **sem padrão** |187| `--com-classes` | as camadas de classes que entram | nenhuma |188| `--celula` | lado da célula da grade, em metros | automática: a partir de 10 m, até 20 mil células |189| `--faixas` | número de faixas de mesma área nas manchas (2 a 5) | 3 |190| `--cortes "3,2;4,0"` | cortes das faixas, com os valores do usuário | os quantis |191| `--sem-filtro` | não tira células soltas das manchas | filtro de maioria ligado |192| `--mancha-minima` | área mínima, em ha, para contar como mancha | 0,5% da área |193| `--zona 22S` | zona UTM do perímetro em metros sem `.prj` | a do arquivo |194| `--x`, `--y` | colunas de coordenada dos pontos | reconhecidas pelo nome |195| `--sem-pdf` | não grava figuras nem PDF | grava |196197A célula não deve ser menor que a resolução de verdade das camadas: célula de19810 m com mapa de solo de uma amostra por hectare só multiplica células199repetidas. O diagnóstico mostra o pixel de cada raster e o espaçamento dos200pontos. O método e os limites: `references/metodo.md`.201202## O que a skill não faz203204- Não diz a causa da variabilidade nem recomenda correção.205- Não interpola laudo de solo, não limpa mapa de colheita e não faz zonas de206 manejo: para isso existem as skills `interpolacao-krigagem`,207 `interpolacao-idw`, `limpeza-monitor-produtividade` e `zonas-de-manejo`.208- Não compara talhões nem safras: uma rodada, um talhão, uma variável.209- Não enxerga relação que depende de outra camada (interação) nem ótimo no210 meio, a não ser pela nota de curva e pelo perfil das manchas.211- Não substitui a ida ao talhão: mancha que nenhuma camada acompanha pode ter212 motivo que não está em mapa nenhum (praga, falha de plantio, compactação,213 histórico).214215## Recusas216217O script para e diz o motivo quando: falta o perímetro ou há só uma camada;218um raster não é GeoTIFF, está noutro sistema de coordenadas ou não cobre o219talhão; nenhum ponto cai dentro do perímetro; duas camadas têm o mesmo nome;220menos de 50 células têm valor em todas as camadas escolhidas; a variável a221explicar ou uma camada é constante; os cortes deixam uma faixa vazia. Repasse222o motivo como veio e não contorne.