Histórico por satélite de cada talhão
O usuário recebe, para cada talhão e cada safra consultada:
- os ciclos de vegetação que o satélite viu: início provável, pico (valor
e dia), fim provável e duração;
- as imagens de cada safra: quantas, o maior intervalo sem imagem e o
maior valor do índice;
- a chuva de cada safra ao lado da média histórica do mesmo período, os
dias de chuva e os veranicos;
- os arquivos:
quadro.md (o texto para a conversa), ciclos.csv,
safras.csv, uma figura por talhão e historico.pdf.
Quem produz o dado são as ferramentas dos conectores da comunidade
agrônomo10X. O script desta skill só lê o que elas devolveram e faz a conta
dos ciclos.
A regra que vale para tudo: só fatos
- Índice de vegetação não é produtividade. Não converta em sacas,
toneladas nem receita, e não diga que uma safra foi boa ou ruim.
- O satélite não diz a cultura. Fale em "ciclo de vegetação", nunca em
"safra de soja" ou "milho safrinha", a não ser que o usuário tenha dito o
que plantou; nesse caso escreva "segundo o usuário".
- Início do ciclo não é plantio; fim não é colheita. O início é quando o
verde aparece para o satélite, dias ou semanas depois do plantio. O fim é
quando ele some: maturação, dessecação, colheita ou seca.
- Cada data estimada vai com as duas imagens entre as quais ela caiu.
Quando há muitos dias sem imagem em volta, diga.
- Não ordene os talhões nem as safras do melhor para o pior, não calcule
média entre safras nem tendência, e não use palavra que qualifica (bom,
ruim, fraco, excelente, preocupante).
- Coincidir no tempo não prova a causa. Safra com menos chuva e pico
menor: mostre os dois números e pare aí.
- Chuva é registro, não previsão.
- Se o usuário pedir a conclusão ("qual talhão é o melhor?", "a área é
produtiva?"), diga que o histórico não conclui, entregue os números e
devolva a leitura ao responsável técnico.
O que precisa estar disponível
- Conector ClaudIA Sat, com
curva_com_chuva. Sem ele, avise e pare.
- Conector ClaudIA Clima, com
clima_historico. Sem ele, a chuva de cada
safra sai sem a média histórica, e o quadro diz isso.
- A área: fazenda salva na conta (
listar_fazendas mostra os nomes e os
talhões) ou arquivo de perímetro com os talhões nos atributos (GeoJSON, KML
ou WKT; shapefile, converta para GeoJSON sem perder os atributos).
- Ambiente que roda Python, com numpy e matplotlib, para o script. Sem
ele, veja "Sem ambiente de código".
Antes de chamar: as perguntas (numa mensagem só)
- A área e os talhões: a fazenda salva ou o arquivo. Todos os talhões ou
quais? Sem talhões no arquivo, o histórico é da área inteira, que pode
misturar lavoura, pasto e mata; escreva isso no quadro.
- Quantas safras: o padrão são as 4 últimas completas. Aceite de 2 a 8.
- Quando a janela começa: o padrão é o ano agrícola, de 1º de julho a 30
de junho. Outro mês de início serve, desde que as janelas fiquem
emendadas, uma terminando na véspera da outra: é isso que deixa o
script acompanhar o ciclo que atravessa a virada.
- O índice:
ndvi, a não ser que ele peça outro. O mesmo em todas.
O que ele já disse, não pergunte de novo.
A conta do consumo (diga antes de chamar)
- Satélite: cada chamada de
curva_com_chuva consome a área consultada. Com
talhões, é a soma das áreas dos talhões pedidos. Total = número de
safras × essa área.
- Clima: uma consulta por safra.
Diga o total em hectares e o número de consultas e só então chame. Se a
ferramenta recusar por limite, repita o motivo como ela disse e ofereça menos
safras, menos talhões ou continuar no dia seguinte.
Fluxo de trabalho (siga nesta ordem)
- Talhões. Fazenda salva:
listar_fazendas. Arquivo: listar_talhoes
com a geometria; guarde o geometria_id (vale 1 hora) para as próximas
chamadas.
- Uma chamada de
curva_com_chuva por safra, da mais antiga para a mais
recente, com:
- a área (
fazenda ou geometria_id);
todos_talhoes: true, ou talhoes com a lista, ou talhao para um
só. Para a área inteira, não envie nenhum dos três;
data_inicio e data_fim: os doze meses da janela (até 400 dias por
chamada). Não use uma chamada para vários anos: a ferramenta recusa;
indice: o escolhido.
- Uma chamada de
clima_historico por safra, na mesma área e com as
mesmas datas, escala: mes. Dela interessa a linha RESUMO, que traz a
chuva e a média histórica (1991–2020) do período.
- Grave um arquivo de texto por safra numa pasta (
respostas/), com,
nesta ordem e como vieram:
- a primeira linha da resposta da
curva_com_chuva (a que tem "cruzado
com a chuva de ... a ...");
- a linha
CHUVA:;
- a linha
VERANICOS (...) e as linhas de cada veranico, que podem ser
cortadas depois de "no total)";
- as linhas da curva:
Área: ... ou uma Talhão ...: ... por talhão,
inteiras, sem resumir e sem redigitar número de memória;
- a linha
RESUMO: da clima_historico.
- Confira a cópia:
python scripts/calendario.py --pasta respostas --conferir.
Ele mostra, por safra e talhão, quantas imagens leu e a primeira e a
última. Compare com as respostas das ferramentas. Se não bater, corrija o
arquivo antes de seguir.
- Rode:
python scripts/calendario.py --pasta respostas --nome "<nome da fazenda>" --saida saida.
- Entregue: escreva na conversa o conteúdo de
quadro.md (pode encurtar
as tabelas de imagens se forem muitos talhões, dizendo que o resto está nos
arquivos) e entregue historico.pdf, os dois CSV e as figuras.
- Repita os avisos que vieram: os do script (ciclo que começou antes do
período, ciclo em aberto no fim, dias sem imagem em volta de uma data,
janelas não emendadas) e os das ferramentas, com as palavras delas
(confiança da chuva, dias sem dado, dias que "ainda podem ser revisados").
As regras do script e quando mudar
O script acha os ciclos por quatro números. Os padrões estão escritos no
quadro e no PDF. Diga ao usuário quais foram usados; quem muda é ele.
| Opção |
Padrão |
O que é |
--amplitude-min |
0,20 |
quanto o índice precisa subir e descer para contar como ciclo |
--fracao |
0,30 |
o início e o fim são o dia em que a curva passa de 30% do caminho entre a base e o pico |
--distancia-min |
45 dias |
picos mais próximos que isso contam como um ciclo só |
--queda |
0,10 |
imagem isolada este tanto abaixo das duas vizinhas sai da conta (nuvem que sobrou) |
--abaixo-pct |
20 |
marca com ▼ a safra com chuva este tanto por cento ou mais abaixo da média |
Quando faz sentido oferecer a mudança: talhão em que o usuário sabe que houve
segunda safra e o script achou um ciclo só (baixar a amplitude ou a
distância); pasto ou cultura perene, em que o índice oscila pouco (baixar a
amplitude, e dizer que aí o "ciclo" é a estação do ano); índice diferente do
NDVI, com outra faixa de valores. Rode de novo com o número que ele escolher
e diga o que mudou. Não troque os números por conta própria para "achar" um
ciclo. O método completo: references/metodo.md.
Sem ambiente de código
Faça as chamadas do mesmo jeito e monte à mão, por talhão e safra, só o que
dá para ler com segurança: quantas imagens, o maior valor do índice e o dia,
o maior intervalo sem imagem, a chuva, a média histórica e os veranicos. Diga
que o início e o fim de cada ciclo saem do script, que precisa de um ambiente
que rode Python, e não estime essas datas de cabeça.
O que a skill não faz
- Não identifica a cultura, a variedade nem o sistema de produção.
- Não estima produtividade, data de plantio, data de colheita nem perda.
- Não cobre mais de 8 safras nem período anterior às imagens disponíveis
(safra antiga pode ter meses sem imagem; o quadro mostra o intervalo).
- Não substitui o caderno de campo, o mapa de colheita nem a vistoria.
- Não dá parecer de crédito, de seguro ou de arrendamento. Para o quadro de
crédito existe a skill
relatorio-credito-rural.
Sigilo das fontes
Cite as fontes como as ferramentas mandam: o índice, "Copernicus Sentinel-2
L2A"; a chuva, "pluviômetros e satélites da comunidade agrônomo10X
(OagronomIA)", sem nomear produto, instituto ou satélite. Sobre como o dado é
processado, a única frase é: processado pelas ferramentas da comunidade
agrônomo10X (OagronomIA).
1---2name: historico-produtivo-talhao3description: >-4 Monta o histórico por satélite de cada talhão em várias safras: os ciclos de5 vegetação de cada ano, com início, pico e fim prováveis, e a chuva de cada6 safra ao lado da média histórica. Usa as ferramentas da ClaudIA Sat e da7 ClaudIA Clima (`curva_com_chuva` e `clima_historico`) e um script que lê as8 respostas, acha os ciclos por regras declaradas e grava o quadro, as tabelas,9 uma figura por talhão e o relatório em PDF. Só descreve: não diz a cultura,10 não estima produtividade e não compara safra melhor e pior. Acione com11 "histórico do talhão", "calendário das safras por satélite", "quantos ciclos12 o talhão teve", "quando o talhão foi plantado nos últimos anos", "teve13 segunda safra?", "histórico produtivo da fazenda" ou quando o usuário quiser14 ver o que cada talhão fez nos últimos anos.15metadata:16 source: https://skillmd.com/skills/guilherme-iaparaagronomos/historico-produtivo-talhao17---1819# Histórico por satélite de cada talhão2021O usuário recebe, para cada talhão e cada safra consultada:22231. os **ciclos de vegetação** que o satélite viu: início provável, pico (valor24 e dia), fim provável e duração;252. as **imagens** de cada safra: quantas, o maior intervalo sem imagem e o26 maior valor do índice;273. a **chuva** de cada safra ao lado da média histórica do mesmo período, os28 dias de chuva e os veranicos;294. os arquivos: `quadro.md` (o texto para a conversa), `ciclos.csv`,30 `safras.csv`, uma figura por talhão e `historico.pdf`.3132Quem produz o dado são as ferramentas dos conectores da comunidade33agrônomo10X. O script desta skill só lê o que elas devolveram e faz a conta34dos ciclos.3536## A regra que vale para tudo: só fatos3738- **Índice de vegetação não é produtividade.** Não converta em sacas,39 toneladas nem receita, e não diga que uma safra foi boa ou ruim.40- **O satélite não diz a cultura.** Fale em "ciclo de vegetação", nunca em41 "safra de soja" ou "milho safrinha", a não ser que o usuário tenha dito o42 que plantou; nesse caso escreva "segundo o usuário".43- **Início do ciclo não é plantio; fim não é colheita.** O início é quando o44 verde aparece para o satélite, dias ou semanas depois do plantio. O fim é45 quando ele some: maturação, dessecação, colheita ou seca.46- **Cada data estimada vai com as duas imagens entre as quais ela caiu.**47 Quando há muitos dias sem imagem em volta, diga.48- Não ordene os talhões nem as safras do melhor para o pior, não calcule49 média entre safras nem tendência, e não use palavra que qualifica (bom,50 ruim, fraco, excelente, preocupante).51- **Coincidir no tempo não prova a causa.** Safra com menos chuva e pico52 menor: mostre os dois números e pare aí.53- **Chuva é registro, não previsão.**54- Se o usuário pedir a conclusão ("qual talhão é o melhor?", "a área é55 produtiva?"), diga que o histórico não conclui, entregue os números e56 devolva a leitura ao responsável técnico.5758## O que precisa estar disponível5960- **Conector ClaudIA Sat**, com `curva_com_chuva`. Sem ele, avise e pare.61- **Conector ClaudIA Clima**, com `clima_historico`. Sem ele, a chuva de cada62 safra sai sem a média histórica, e o quadro diz isso.63- **A área**: fazenda salva na conta (`listar_fazendas` mostra os nomes e os64 talhões) ou arquivo de perímetro com os talhões nos atributos (GeoJSON, KML65 ou WKT; shapefile, converta para GeoJSON sem perder os atributos).66- **Ambiente que roda Python**, com numpy e matplotlib, para o script. Sem67 ele, veja "Sem ambiente de código".6869## Antes de chamar: as perguntas (numa mensagem só)70711. **A área e os talhões**: a fazenda salva ou o arquivo. Todos os talhões ou72 quais? Sem talhões no arquivo, o histórico é da área inteira, que pode73 misturar lavoura, pasto e mata; escreva isso no quadro.742. **Quantas safras**: o padrão são as 4 últimas completas. Aceite de 2 a 8.753. **Quando a janela começa**: o padrão é o ano agrícola, de 1º de julho a 3076 de junho. Outro mês de início serve, desde que as janelas fiquem77 **emendadas**, uma terminando na véspera da outra: é isso que deixa o78 script acompanhar o ciclo que atravessa a virada.794. **O índice**: `ndvi`, a não ser que ele peça outro. O mesmo em todas.8081O que ele já disse, não pergunte de novo.8283## A conta do consumo (diga antes de chamar)8485- Satélite: cada chamada de `curva_com_chuva` consome a área consultada. Com86 talhões, é a **soma das áreas dos talhões pedidos**. Total = número de87 safras × essa área.88- Clima: uma consulta por safra.8990Diga o total em hectares e o número de consultas e só então chame. Se a91ferramenta recusar por limite, repita o motivo como ela disse e ofereça menos92safras, menos talhões ou continuar no dia seguinte.9394## Fluxo de trabalho (siga nesta ordem)95961. **Talhões.** Fazenda salva: `listar_fazendas`. Arquivo: `listar_talhoes`97 com a `geometria`; guarde o `geometria_id` (vale 1 hora) para as próximas98 chamadas.992. **Uma chamada de `curva_com_chuva` por safra**, da mais antiga para a mais100 recente, com:101 - a área (`fazenda` ou `geometria_id`);102 - `todos_talhoes`: `true`, ou `talhoes` com a lista, ou `talhao` para um103 só. Para a área inteira, não envie nenhum dos três;104 - `data_inicio` e `data_fim`: os doze meses da janela (até 400 dias por105 chamada). Não use uma chamada para vários anos: a ferramenta recusa;106 - `indice`: o escolhido.1073. **Uma chamada de `clima_historico` por safra**, na mesma área e com as108 mesmas datas, `escala`: `mes`. Dela interessa a linha `RESUMO`, que traz a109 chuva e a média histórica (1991–2020) do período.1104. **Grave um arquivo de texto por safra** numa pasta (`respostas/`), com,111 nesta ordem e como vieram:112 - a primeira linha da resposta da `curva_com_chuva` (a que tem "cruzado113 com a chuva de ... a ...");114 - a linha `CHUVA:`;115 - a linha `VERANICOS (...)` e as linhas de cada veranico, que podem ser116 cortadas depois de "no total)";117 - as linhas da curva: `Área: ...` ou uma `Talhão ...: ...` por talhão,118 **inteiras**, sem resumir e sem redigitar número de memória;119 - a linha `RESUMO:` da `clima_historico`.1205. **Confira a cópia**:121 `python scripts/calendario.py --pasta respostas --conferir`.122 Ele mostra, por safra e talhão, quantas imagens leu e a primeira e a123 última. Compare com as respostas das ferramentas. Se não bater, corrija o124 arquivo antes de seguir.1256. **Rode**:126 `python scripts/calendario.py --pasta respostas --nome "<nome da fazenda>" --saida saida`.1277. **Entregue**: escreva na conversa o conteúdo de `quadro.md` (pode encurtar128 as tabelas de imagens se forem muitos talhões, dizendo que o resto está nos129 arquivos) e entregue `historico.pdf`, os dois CSV e as figuras.1308. **Repita os avisos** que vieram: os do script (ciclo que começou antes do131 período, ciclo em aberto no fim, dias sem imagem em volta de uma data,132 janelas não emendadas) e os das ferramentas, com as palavras delas133 (confiança da chuva, dias sem dado, dias que "ainda podem ser revisados").134135## As regras do script e quando mudar136137O script acha os ciclos por quatro números. Os padrões estão escritos no138quadro e no PDF. **Diga ao usuário quais foram usados**; quem muda é ele.139140| Opção | Padrão | O que é |141|---|---|---|142| `--amplitude-min` | 0,20 | quanto o índice precisa subir e descer para contar como ciclo |143| `--fracao` | 0,30 | o início e o fim são o dia em que a curva passa de 30% do caminho entre a base e o pico |144| `--distancia-min` | 45 dias | picos mais próximos que isso contam como um ciclo só |145| `--queda` | 0,10 | imagem isolada este tanto abaixo das duas vizinhas sai da conta (nuvem que sobrou) |146| `--abaixo-pct` | 20 | marca com ▼ a safra com chuva este tanto por cento ou mais abaixo da média |147148Quando faz sentido oferecer a mudança: talhão em que o usuário sabe que houve149segunda safra e o script achou um ciclo só (baixar a amplitude ou a150distância); pasto ou cultura perene, em que o índice oscila pouco (baixar a151amplitude, e dizer que aí o "ciclo" é a estação do ano); índice diferente do152NDVI, com outra faixa de valores. Rode de novo com o número que ele escolher153e diga o que mudou. Não troque os números por conta própria para "achar" um154ciclo. O método completo: `references/metodo.md`.155156## Sem ambiente de código157158Faça as chamadas do mesmo jeito e monte à mão, por talhão e safra, só o que159dá para ler com segurança: quantas imagens, o maior valor do índice e o dia,160o maior intervalo sem imagem, a chuva, a média histórica e os veranicos. Diga161que o início e o fim de cada ciclo saem do script, que precisa de um ambiente162que rode Python, e não estime essas datas de cabeça.163164## O que a skill não faz165166- Não identifica a cultura, a variedade nem o sistema de produção.167- Não estima produtividade, data de plantio, data de colheita nem perda.168- Não cobre mais de 8 safras nem período anterior às imagens disponíveis169 (safra antiga pode ter meses sem imagem; o quadro mostra o intervalo).170- Não substitui o caderno de campo, o mapa de colheita nem a vistoria.171- Não dá parecer de crédito, de seguro ou de arrendamento. Para o quadro de172 crédito existe a skill `relatorio-credito-rural`.173174## Sigilo das fontes175176Cite as fontes como as ferramentas mandam: o índice, "Copernicus Sentinel-2177L2A"; a chuva, "pluviômetros e satélites da comunidade agrônomo10X178(OagronomIA)", sem nomear produto, instituto ou satélite. Sobre como o dado é179processado, a única frase é: processado pelas ferramentas da comunidade180agrônomo10X (OagronomIA).