Balanço hídrico
Calcula o balanço hídrico climatológico pelo método de Thornthwaite e Mather
(1955) e entrega a tabela, os gráficos e o relatório em PDF:
- Ano normal, por mês: quanto chove, quanto a atmosfera pede (ETP),
quanto o solo guarda, e em que meses há deficiência ou excedente.
- Sequencial, por decêndio ou por mês: o mesmo, para uma safra ou para uma
sequência de anos de verdade.
Para que serve
- Descrever a disponibilidade de água de um lugar no ano normal.
- Acompanhar o que aconteceu numa safra: quando faltou e quando sobrou água,
para a CAD informada.
Para que NÃO serve
- Não escolhe a CAD, o método de ETP, a chuva normal nem o armazenamento
inicial. Mostra as opções e pergunta.
- Não recomenda irrigação, lâmina, época de plantio, cultura nem cultivar.
Deficiência é um número do balanço; o que fazer com ele é do responsável
técnico.
- Não é balanço de cultura: não usa Kc, fase da lavoura nem profundidade
de raiz que muda no ciclo. Não é o ZARC e não o substitui.
- Não prevê: usa o que já choveu. Não diga como será a próxima safra.
- Balanço do ano normal por decêndio não sai dos dados mensais: repartir a
chuva do mês em três partes iguais esconderia a distribuição dentro do mês.
Por decêndio, só o sequencial, que usa a chuva de cada dia.
O que precisa estar disponível
- Um ambiente que rode Python com
matplotlib. Sem ele, não faça a conta
de cabeça: explique o método e diga que a skill precisa de um ambiente com
código.
- Os dados, de um destes jeitos:
- conector ClaudIA Clima, com a ferramenta
clima_historico; ou
- tabela do usuário (estação própria): CSV, TXT ou XLSX com data, chuva
e temperatura (mínima e máxima, ou a média), ou as 12 normais do lugar.
- A latitude do lugar, em graus decimais (sul é negativo). Com ponto, é a
do ponto consultado. Com fazenda salva ou perímetro, pergunte o município ou
use a do centro da área: 1 grau de erro muda a ETP do ano em até 1% (e a
de um mês em até 3,5%, com Hargreaves no sul do país).
Antes de buscar os dados: as perguntas (numa mensagem só)
- O lugar: fazenda salva (
listar_fazendas mostra os nomes), perímetro,
ponto por latitude e longitude, ou a tabela da estação dele.
- Qual balanço: o do ano normal, o de uma safra, ou os dois.
- Para a safra: as datas de início e fim (até 400 dias por consulta).
Vale começar dois ou três meses antes do período que interessa: o começo
da série depende do armazenamento inicial (veja o passo 5).
- Para o ano normal: quantos anos entram na temperatura média. A série
da ferramenta começa em 02/01/1998: o primeiro ano inteiro é 1999. Cada
ano são 12 linhas para transcrever: 10 anos, 120 linhas; a série toda,
mais de 300. Se ele disser que tanto faz, use todos os anos completos e
escreva isso no relato.
A CAD, o método de ETP e o resto ficam para depois do diagnóstico, quando há
números para mostrar. O que ele já disse, não pergunte de novo.
O que cada consulta custa (diga antes de chamar)
Cada chamada de clima_historico conta como consulta de clima na conta
do usuário. O ano normal é uma chamada; cada safra, mais uma. Diga quantas
serão antes de chamar, e não repita chamada para "conferir": o resultado é o
mesmo.
Fluxo de trabalho (siga nesta ordem)
- Busque os dados.
- Ano normal:
clima_historico com escala = mes, data_inicio no dia
1º de janeiro do primeiro ano e data_fim em 31 de dezembro do último
ano fechado, no lugar escolhido (fazenda, geometria, ou latitude e
longitude).
- Safra:
clima_historico com escala = dia e as datas da safra.
- Estação do usuário: pule para o passo 2 com o arquivo dele.
- Grave a resposta num arquivo de texto, um para a tabela mensal e outro
para a diária. O formato está na seção "Como transcrever". Não resuma, não
arredonde e não pule linha.
- Rode o diagnóstico (não calcula o balanço):
python scripts/balanco.py --diagnostico --mensal mensal.txt --diario diario.txt --saida saida
Se alguma linha da conferência disser NÃO FECHA, a transcrição tem
erro: corrija o arquivo comparando com a resposta da ferramenta e rode de
novo. O balanço não roda enquanto a conferência não fechar.
- Mostre o diagnóstico ao usuário: a conferência, as normais de cada mês,
a ETP do ano por método, o índice de calor, e, quando as duas tabelas têm
meses em comum, a diferença entre a soma mensal e a soma diária.
- Pergunte o que é dele (seções abaixo): a CAD; o método de ETP;
a chuva do ano normal (
referencia ou periodo), quando a tabela traz
as duas; e, no sequencial, o armazenamento inicial. Se ele pedir
"escolhe você", explique em uma frase o que muda e devolva a pergunta.
Para ver o efeito da CAD no ano normal antes de decidir, repita o
diagnóstico com --etp e --chuva já escolhidos. Sem a resposta dele,
não rode.
- Rode o balanço:
python scripts/balanco.py --normal --mensal mensal.txt --cad <mm> --etp <método> \
--chuva <referencia|periodo> --nome "<lugar>" --fonte conector --saida saida
python scripts/balanco.py --sequencial --diario diario.txt --mensal mensal.txt --cad <mm> \
--etp <método> --arm-inicial <cad|normal|mm> [--chuva <referencia|periodo>] --nome "<lugar>" \
--fonte conector --saida saida
Com dado de estação, --fonte "<nome da estação>". No sequencial, a
tabela mensal só é necessária para Thornthwaite (índice de calor) e para
--arm-inicial normal, que também pede --chuva. Uma sequência de anos
por mês sai direto da tabela mensal, sem a diária: --sequencial --mensal mensal.txt --passo mes.
- Relate o resultado inteiro: as escolhas e a origem de cada número; a
tabela; os totais; a aferição; a frase sobre o armazenamento inicial; e
todos os avisos, com as palavras do script. Mostre
balanco_normal_graficos.png ou balanco_sequencial_graficos.png.
- Entregue os arquivos e diga para que serve cada um. Outra CAD ou outro
método é outra rodada: rode de novo e diga o que mudou. Os dados são os
mesmos, não chame a ferramenta outra vez.
Para ver a skill funcionando sem dado nenhum: python scripts/balanco.py --demo
(dados inventados; o script diz o que foi fixado só no exemplo).
Como transcrever a resposta da ferramenta
Dois jeitos, que o script lê igual:
- Colar o texto como veio, do título
Chuva — ... até a última linha de
dado. O script tira sozinho o período, o total e os avisos.
- Formato compacto, mais curto: uma linha por dia ou por mês, com as
linhas de controle em cima.
local: -17.8, -50.93
periodo: 01/07/2024 a 30/06/2025
total: 1.518,2
temperatura: 10 40
avisos: 15 dia(s): o pluviômetro de referência mais próximo somou bem menos...
2024-07-01 0,0 17 30
2024-07-02 0,0 17 31
| Linha |
De onde vem na resposta da ferramenta |
local: |
o que vem depois de Chuva —: as coordenadas ou "área de N ha" |
periodo: |
as duas datas do título |
total: |
o total em mm da linha RESUMO |
temperatura: |
só na escala de dia: mín e máx da linha TEMPERATURA |
normal: |
só na escala de mês: os 12 valores de média de um ano inteiro, de janeiro a dezembro |
avisos: |
a linha AVISOS, inteira; uma linha avisos: para cada aviso |
| dia |
AAAA-MM-DD chuva mínima máxima (a faixa temp 17–30°C vira 17 30) |
| mês |
AAAA-MM chuva mínima máxima (a faixa temp média 20.5–28.5°C vira 20.5 28.5) |
Copie os números como estão: chuva com vírgula, temperatura com ponto. Dia
com SEM DADO vira sd. Linha com confiança baixa pode levar cb no fim.
Umidade, vento e graus-dia não entram.
O script confere: nenhum dia ou mês faltando ou repetido; o período; a soma
da chuva contra o total da ferramenta; e a menor mínima e a maior máxima.
Erro pequeno, menor que a folga de arredondamento (perto de 2 mm num ano de
dias), ou dois erros que se compensam, passam: transcreva com calma.
As escolhas do usuário
CAD (capacidade de água disponível), em mm. É do solo e da profundidade
das raízes: CAD = (capacidade de campo − ponto de murcha, em %) ÷ 100 ×
densidade do solo × profundidade efetiva das raízes (mm). Como referência,
para ele decidir (Sentelhas e Angelocci, ESALQ/USP; valores gerais de
Doorenbos e Kassam, 1994, e de Alfonsi et al., 1990):
- por textura: solo argiloso 2,0 mm por cm de profundidade; textura média
1,4; arenoso 0,6;
- profundidade efetiva das raízes: hortaliças 10 a 20 cm; arroz, batata e
feijão 20 a 30; trigo 30 a 40; milho e soja 40 a 50; amendoim 50 a 60;
cana, citros e café 70 a 100;
- para caracterizar o clima de uma região, é comum usar de 75 a 125 mm.
Mostre a referência; não escolha o valor.
Método de ETP (--etp). Liste os que rodam com os dados (o diagnóstico
diz) com a linha de cada um. Não indique um.
--etp |
O que é |
thornthwaite |
Thornthwaite (1948): só a temperatura média. Feito para clima úmido e para o mês; em clima seco costuma subestimar a ETP. É o método original do balanço climatológico. |
thornthwaite-tef |
O mesmo, com a temperatura efetiva de Camargo et al. (1999), 0,36 × (3 × máxima − mínima), proposta para valer também em clima seco. |
hargreaves |
Hargreaves e Samani (1985): mínima, máxima e radiação no topo da atmosfera. Feito para clima seco; em clima úmido costuma superestimar a ETP. |
informada |
A ETP da tabela do usuário (estação com Penman-Monteith, tanque). A skill não recalcula. |
Chuva do ano normal (--chuva): referencia é a média histórica de 1991
a 2020 que a ferramenta informa em cada mês; periodo é a média dos anos da
tabela. A temperatura é sempre a dos anos da tabela: com referencia, chuva
e temperatura vêm de períodos diferentes, e o relatório avisa.
Armazenamento inicial do sequencial (--arm-inicial): cad (solo cheio,
quando a série começa depois de um período chuvoso); normal (o do ano
normal no fim do mês anterior ao começo da série); ou o valor em mm. O
relatório diz até que período o resultado depende dessa escolha.
Parâmetros
| Parâmetro |
O que faz |
Padrão |
--mensal, --diario |
as tabelas transcritas ou da estação |
— |
--normais |
tabela de 12 normais do usuário (mês, chuva, temperatura ou ETP), no lugar da mensal |
— |
--cad |
CAD em mm, de 5 a 500 |
sem padrão: o usuário informa |
--etp |
método de ETP |
sem padrão: o usuário escolhe |
--chuva |
referencia ou periodo |
sem padrão quando a tabela traz as duas |
--arm-inicial |
cad, normal ou mm |
sem padrão: o usuário informa |
--anos 2005-2024 |
anos que entram nas médias |
todos os anos completos da tabela |
--passo |
decendio ou mes no sequencial |
decendio com tabela diária |
--de, --ate |
recorta o sequencial |
a tabela inteira |
--sem-dado zero |
conta como zero os dias sem dado de chuva |
recusa |
--latitude |
graus decimais, sul negativo |
a da linha local:, quando é ponto |
--nome, --fonte |
título do relatório e origem dos dados (conector ou o nome da estação) |
— |
Decêndios: dias 1 a 10, 11 a 20 e 21 ao fim do mês. Só entram decêndios
inteiros; os dias que sobram nas pontas ficam de fora, e o script diz quantos.
As fórmulas, as fontes e os limites: references/metodo.md.
Regras de honestidade
- Diagnóstico antes, sempre, e balanço só com a conferência fechada.
- CAD, método, chuva normal e armazenamento inicial vêm do usuário. Não
use "o mais comum" por conta própria.
- Descreva, não recomende. "Em agosto a deficiência do ano normal é de 60
mm, para a CAD de 100 mm", e não "é preciso irrigar" nem "plante em
outubro". Não use bom, ruim, crítico, favorável.
- Diga de onde saiu cada número: qual tabela, quais anos, qual método,
qual CAD. O ano normal usa a tabela mensal; o sequencial por decêndio usa a
diária. As duas séries da ferramenta não precisam fechar entre si no mesmo
período: quando o diagnóstico mostrar a diferença, repita-a.
- ETP é estimativa por temperatura. Os métodos dão valores diferentes
para os mesmos dados; mostre a tabela do diagnóstico em vez de escolher.
- Não esconda aviso: confiança baixa, dia sem dado contado como zero,
temperatura acima de 26,5 °C, períodos diferentes de chuva e temperatura,
dependência do armazenamento inicial.
- Recusa é recusa. Se o script não rodou, repasse o motivo. Não contorne
nem faça a conta por fora.
- Avisos da ferramenta vão com as palavras dela, e o que ela marcou como
provisório ou de confiança baixa continua marcado.
Saídas (na pasta --saida)
balanco_normal.pdf ou balanco_sequencial.pdf — a tabela com as escolhas,
a aferição e os avisos; depois os gráficos. O .png de mesmo nome é a
primeira página.
..._graficos.png — extrato (excedente e deficiência), chuva com ETP e
ETR, e armazenamento.
....csv — a tabela inteira (ponto e vírgula e vírgula decimal). Em série
com mais de 96 períodos, o PDF resume por ano e o CSV traz todos.
....json — todos os números e as escolhas.
- No diagnóstico:
diagnostico.json.
Sigilo das fontes
Com dado do conector, a fonte é "pluviômetros e satélites da comunidade
agrônomo10X (OagronomIA)", como a ferramenta manda (--fonte conector escreve
isso no relatório). Não nomeie produto, instituto ou satélite, e não deduza
como o dado é processado. Com dado de estação, a fonte é a estação do usuário.
Dependências
Python com matplotlib (que traz o numpy). As contas usam só a biblioteca
padrão. Sem internet.
1---2name: balanco-hidrico3description: >-4 Calcula o balanço hídrico climatológico de Thornthwaite e Mather (1955): o5 do ano normal, por mês, e o sequencial de uma safra, por decêndio ou por6 mês, para a CAD que o usuário informar. Entra a chuva e a temperatura da7 ferramenta `clima_historico` (ClaudIA Clima) ou da estação do usuário; sai a8 tabela com ETP, armazenamento, ETR, deficiência e excedente, o gráfico, o9 CSV e o PDF. ETP por Thornthwaite, Thornthwaite com temperatura efetiva ou10 Hargreaves e Samani. Confere a transcrição dos dados contra o total que a11 ferramenta informa. Não escolhe a CAD, o método de ETP nem o armazenamento12 inicial: pergunta. Não recomenda irrigação, época de plantio nem cultura.13 Acione com "balanço hídrico", "deficiência hídrica", "excedente hídrico",14 "Thornthwaite", "armazenamento de água no solo", "BH climatológico", "BH15 sequencial da safra" ou quando o usuário pedir o déficit e o excedente de16 água de um lugar ou de uma safra.17metadata:18 source: https://skillmd.com/skills/guilherme-iaparaagronomos/balanco-hidrico19---2021# Balanço hídrico2223Calcula o balanço hídrico climatológico pelo método de Thornthwaite e Mather24(1955) e entrega a tabela, os gráficos e o relatório em PDF:2526- **Ano normal**, por mês: quanto chove, quanto a atmosfera pede (ETP),27 quanto o solo guarda, e em que meses há deficiência ou excedente.28- **Sequencial**, por decêndio ou por mês: o mesmo, para uma safra ou para uma29 sequência de anos de verdade.3031## Para que serve32- Descrever a disponibilidade de água de um lugar no ano normal.33- Acompanhar o que aconteceu numa safra: quando faltou e quando sobrou água,34 para a CAD informada.3536## Para que NÃO serve37- **Não escolhe** a CAD, o método de ETP, a chuva normal nem o armazenamento38 inicial. Mostra as opções e pergunta.39- **Não recomenda** irrigação, lâmina, época de plantio, cultura nem cultivar.40 Deficiência é um número do balanço; o que fazer com ele é do responsável41 técnico.42- **Não é balanço de cultura**: não usa Kc, fase da lavoura nem profundidade43 de raiz que muda no ciclo. Não é o ZARC e não o substitui.44- **Não prevê**: usa o que já choveu. Não diga como será a próxima safra.45- Balanço do ano normal por decêndio não sai dos dados mensais: repartir a46 chuva do mês em três partes iguais esconderia a distribuição dentro do mês.47 Por decêndio, só o sequencial, que usa a chuva de cada dia.4849## O que precisa estar disponível50- **Um ambiente que rode Python** com `matplotlib`. Sem ele, não faça a conta51 de cabeça: explique o método e diga que a skill precisa de um ambiente com52 código.53- **Os dados**, de um destes jeitos:54 - **conector ClaudIA Clima**, com a ferramenta `clima_historico`; ou55 - **tabela do usuário** (estação própria): CSV, TXT ou XLSX com data, chuva56 e temperatura (mínima e máxima, ou a média), ou as 12 normais do lugar.57- **A latitude** do lugar, em graus decimais (sul é negativo). Com ponto, é a58 do ponto consultado. Com fazenda salva ou perímetro, pergunte o município ou59 use a do centro da área: 1 grau de erro muda a ETP do ano em até 1% (e a60 de um mês em até 3,5%, com Hargreaves no sul do país).6162## Antes de buscar os dados: as perguntas (numa mensagem só)631. **O lugar**: fazenda salva (`listar_fazendas` mostra os nomes), perímetro,64 ponto por latitude e longitude, ou a tabela da estação dele.652. **Qual balanço**: o do ano normal, o de uma safra, ou os dois.663. Para a safra: **as datas de início e fim** (até 400 dias por consulta).67 Vale começar dois ou três meses antes do período que interessa: o começo68 da série depende do armazenamento inicial (veja o passo 5).694. Para o ano normal: **quantos anos entram na temperatura média**. A série70 da ferramenta começa em 02/01/1998: o primeiro ano inteiro é 1999. Cada71 ano são 12 linhas para transcrever: 10 anos, 120 linhas; a série toda,72 mais de 300. Se ele disser que tanto faz, use todos os anos completos e73 escreva isso no relato.7475A CAD, o método de ETP e o resto ficam para depois do diagnóstico, quando há76números para mostrar. O que ele já disse, não pergunte de novo.7778## O que cada consulta custa (diga antes de chamar)79Cada chamada de `clima_historico` conta como **consulta de clima** na conta80do usuário. O ano normal é uma chamada; cada safra, mais uma. Diga quantas81serão antes de chamar, e não repita chamada para "conferir": o resultado é o82mesmo.8384## Fluxo de trabalho (siga nesta ordem)85861. **Busque os dados.**87 - Ano normal: `clima_historico` com `escala` = `mes`, `data_inicio` no dia88 1º de janeiro do primeiro ano e `data_fim` em 31 de dezembro do último89 ano fechado, no lugar escolhido (`fazenda`, `geometria`, ou `latitude` e90 `longitude`).91 - Safra: `clima_historico` com `escala` = `dia` e as datas da safra.92 - Estação do usuário: pule para o passo 2 com o arquivo dele.932. **Grave a resposta num arquivo de texto**, um para a tabela mensal e outro94 para a diária. O formato está na seção "Como transcrever". Não resuma, não95 arredonde e não pule linha.963. **Rode o diagnóstico** (não calcula o balanço):97 ```98 python scripts/balanco.py --diagnostico --mensal mensal.txt --diario diario.txt --saida saida99 ```100 Se alguma linha da conferência disser **NÃO FECHA**, a transcrição tem101 erro: corrija o arquivo comparando com a resposta da ferramenta e rode de102 novo. O balanço não roda enquanto a conferência não fechar.1034. **Mostre o diagnóstico ao usuário**: a conferência, as normais de cada mês,104 a ETP do ano por método, o índice de calor, e, quando as duas tabelas têm105 meses em comum, a diferença entre a soma mensal e a soma diária.1065. **Pergunte o que é dele** (seções abaixo): a **CAD**; o **método de ETP**;107 a **chuva do ano normal** (`referencia` ou `periodo`), quando a tabela traz108 as duas; e, no sequencial, o **armazenamento inicial**. Se ele pedir109 "escolhe você", explique em uma frase o que muda e devolva a pergunta.110 Para ver o efeito da CAD no ano normal antes de decidir, repita o111 diagnóstico com `--etp` e `--chuva` já escolhidos. **Sem a resposta dele,112 não rode.**1136. **Rode o balanço**:114 ```115 python scripts/balanco.py --normal --mensal mensal.txt --cad <mm> --etp <método> \116 --chuva <referencia|periodo> --nome "<lugar>" --fonte conector --saida saida117118 python scripts/balanco.py --sequencial --diario diario.txt --mensal mensal.txt --cad <mm> \119 --etp <método> --arm-inicial <cad|normal|mm> [--chuva <referencia|periodo>] --nome "<lugar>" \120 --fonte conector --saida saida121 ```122 Com dado de estação, `--fonte "<nome da estação>"`. No sequencial, a123 tabela mensal só é necessária para Thornthwaite (índice de calor) e para124 `--arm-inicial normal`, que também pede `--chuva`. Uma sequência de anos125 por mês sai direto da tabela mensal, sem a diária: `--sequencial --mensal126 mensal.txt --passo mes`.1277. **Relate o resultado inteiro**: as escolhas e a origem de cada número; a128 tabela; os totais; a aferição; a frase sobre o armazenamento inicial; e129 **todos os avisos, com as palavras do script**. Mostre130 `balanco_normal_graficos.png` ou `balanco_sequencial_graficos.png`.1318. **Entregue os arquivos** e diga para que serve cada um. Outra CAD ou outro132 método é outra rodada: rode de novo e diga o que mudou. Os dados são os133 mesmos, não chame a ferramenta outra vez.134135Para ver a skill funcionando sem dado nenhum: `python scripts/balanco.py --demo`136(dados inventados; o script diz o que foi fixado só no exemplo).137138## Como transcrever a resposta da ferramenta139140Dois jeitos, que o script lê igual:141142- **Colar o texto como veio**, do título `Chuva — ...` até a última linha de143 dado. O script tira sozinho o período, o total e os avisos.144- **Formato compacto**, mais curto: uma linha por dia ou por mês, com as145 linhas de controle em cima.146147```148local: -17.8, -50.93149periodo: 01/07/2024 a 30/06/2025150total: 1.518,2151temperatura: 10 40152avisos: 15 dia(s): o pluviômetro de referência mais próximo somou bem menos...1532024-07-01 0,0 17 301542024-07-02 0,0 17 31155```156157| Linha | De onde vem na resposta da ferramenta |158|---|---|159| `local:` | o que vem depois de `Chuva —`: as coordenadas ou "área de N ha" |160| `periodo:` | as duas datas do título |161| `total:` | o total em mm da linha `RESUMO` |162| `temperatura:` | só na escala de dia: `mín` e `máx` da linha `TEMPERATURA` |163| `normal:` | só na escala de mês: os 12 valores de `média` de um ano inteiro, de janeiro a dezembro |164| `avisos:` | a linha `AVISOS`, inteira; uma linha `avisos:` para cada aviso |165| dia | `AAAA-MM-DD chuva mínima máxima` (a faixa `temp 17–30°C` vira `17 30`) |166| mês | `AAAA-MM chuva mínima máxima` (a faixa `temp média 20.5–28.5°C` vira `20.5 28.5`) |167168Copie os números como estão: chuva com vírgula, temperatura com ponto. Dia169com `SEM DADO` vira `sd`. Linha com `confiança baixa` pode levar `cb` no fim.170Umidade, vento e graus-dia não entram.171172O script confere: nenhum dia ou mês faltando ou repetido; o período; **a soma173da chuva contra o total da ferramenta**; e a menor mínima e a maior máxima.174Erro pequeno, menor que a folga de arredondamento (perto de 2 mm num ano de175dias), ou dois erros que se compensam, passam: transcreva com calma.176177## As escolhas do usuário178179**CAD (capacidade de água disponível), em mm.** É do solo e da profundidade180das raízes: CAD = (capacidade de campo − ponto de murcha, em %) ÷ 100 ×181densidade do solo × profundidade efetiva das raízes (mm). Como referência,182para ele decidir (Sentelhas e Angelocci, ESALQ/USP; valores gerais de183Doorenbos e Kassam, 1994, e de Alfonsi et al., 1990):184185- por textura: solo argiloso 2,0 mm por cm de profundidade; textura média186 1,4; arenoso 0,6;187- profundidade efetiva das raízes: hortaliças 10 a 20 cm; arroz, batata e188 feijão 20 a 30; trigo 30 a 40; milho e soja 40 a 50; amendoim 50 a 60;189 cana, citros e café 70 a 100;190- para caracterizar o clima de uma região, é comum usar de 75 a 125 mm.191192Mostre a referência; não escolha o valor.193194**Método de ETP** (`--etp`). Liste os que rodam com os dados (o diagnóstico195diz) com a linha de cada um. Não indique um.196197| `--etp` | O que é |198|---|---|199| `thornthwaite` | Thornthwaite (1948): só a temperatura média. Feito para clima úmido e para o mês; em clima seco costuma subestimar a ETP. É o método original do balanço climatológico. |200| `thornthwaite-tef` | O mesmo, com a temperatura efetiva de Camargo et al. (1999), 0,36 × (3 × máxima − mínima), proposta para valer também em clima seco. |201| `hargreaves` | Hargreaves e Samani (1985): mínima, máxima e radiação no topo da atmosfera. Feito para clima seco; em clima úmido costuma superestimar a ETP. |202| `informada` | A ETP da tabela do usuário (estação com Penman-Monteith, tanque). A skill não recalcula. |203204**Chuva do ano normal** (`--chuva`): `referencia` é a média histórica de 1991205a 2020 que a ferramenta informa em cada mês; `periodo` é a média dos anos da206tabela. A temperatura é sempre a dos anos da tabela: com `referencia`, chuva207e temperatura vêm de períodos diferentes, e o relatório avisa.208209**Armazenamento inicial do sequencial** (`--arm-inicial`): `cad` (solo cheio,210quando a série começa depois de um período chuvoso); `normal` (o do ano211normal no fim do mês anterior ao começo da série); ou o valor em mm. O212relatório diz até que período o resultado depende dessa escolha.213214## Parâmetros215216| Parâmetro | O que faz | Padrão |217|---|---|---|218| `--mensal`, `--diario` | as tabelas transcritas ou da estação | — |219| `--normais` | tabela de 12 normais do usuário (mês, chuva, temperatura ou ETP), no lugar da mensal | — |220| `--cad` | CAD em mm, de 5 a 500 | **sem padrão: o usuário informa** |221| `--etp` | método de ETP | **sem padrão: o usuário escolhe** |222| `--chuva` | `referencia` ou `periodo` | **sem padrão quando a tabela traz as duas** |223| `--arm-inicial` | `cad`, `normal` ou mm | **sem padrão: o usuário informa** |224| `--anos 2005-2024` | anos que entram nas médias | todos os anos completos da tabela |225| `--passo` | `decendio` ou `mes` no sequencial | `decendio` com tabela diária |226| `--de`, `--ate` | recorta o sequencial | a tabela inteira |227| `--sem-dado zero` | conta como zero os dias sem dado de chuva | recusa |228| `--latitude` | graus decimais, sul negativo | a da linha `local:`, quando é ponto |229| `--nome`, `--fonte` | título do relatório e origem dos dados (`conector` ou o nome da estação) | — |230231Decêndios: dias 1 a 10, 11 a 20 e 21 ao fim do mês. Só entram decêndios232inteiros; os dias que sobram nas pontas ficam de fora, e o script diz quantos.233As fórmulas, as fontes e os limites: `references/metodo.md`.234235## Regras de honestidade236237- **Diagnóstico antes, sempre**, e balanço só com a conferência fechada.238- **CAD, método, chuva normal e armazenamento inicial vêm do usuário.** Não239 use "o mais comum" por conta própria.240- **Descreva, não recomende.** "Em agosto a deficiência do ano normal é de 60241 mm, para a CAD de 100 mm", e não "é preciso irrigar" nem "plante em242 outubro". Não use bom, ruim, crítico, favorável.243- **Diga de onde saiu cada número**: qual tabela, quais anos, qual método,244 qual CAD. O ano normal usa a tabela mensal; o sequencial por decêndio usa a245 diária. As duas séries da ferramenta não precisam fechar entre si no mesmo246 período: quando o diagnóstico mostrar a diferença, repita-a.247- **ETP é estimativa por temperatura.** Os métodos dão valores diferentes248 para os mesmos dados; mostre a tabela do diagnóstico em vez de escolher.249- **Não esconda aviso**: confiança baixa, dia sem dado contado como zero,250 temperatura acima de 26,5 °C, períodos diferentes de chuva e temperatura,251 dependência do armazenamento inicial.252- **Recusa é recusa.** Se o script não rodou, repasse o motivo. Não contorne253 nem faça a conta por fora.254- **Avisos da ferramenta vão com as palavras dela**, e o que ela marcou como255 provisório ou de confiança baixa continua marcado.256257## Saídas (na pasta `--saida`)258259- `balanco_normal.pdf` ou `balanco_sequencial.pdf` — a tabela com as escolhas,260 a aferição e os avisos; depois os gráficos. O `.png` de mesmo nome é a261 primeira página.262- `..._graficos.png` — extrato (excedente e deficiência), chuva com ETP e263 ETR, e armazenamento.264- `....csv` — a tabela inteira (ponto e vírgula e vírgula decimal). Em série265 com mais de 96 períodos, o PDF resume por ano e o CSV traz todos.266- `....json` — todos os números e as escolhas.267- No diagnóstico: `diagnostico.json`.268269## Sigilo das fontes270271Com dado do conector, a fonte é "pluviômetros e satélites da comunidade272agrônomo10X (OagronomIA)", como a ferramenta manda (`--fonte conector` escreve273isso no relatório). Não nomeie produto, instituto ou satélite, e não deduza274como o dado é processado. Com dado de estação, a fonte é a estação do usuário.275276## Dependências277278Python com `matplotlib` (que traz o `numpy`). As contas usam só a biblioteca279padrão. Sem internet.