Phreatica

Plugin QGIS de hidroquímica: Piper, Stiff e Schoeller

Faça balanço iônico, diagrama de Piper, Schoeller e diagramas de Stiff no mapa sem sair do QGIS. Grátis, de código aberto e em português, com leitura direta dos valores do laudo (vírgula decimal e “<LQ”).

Como instalar

  1. No QGIS, abra Complementos → Gerenciar e instalar complementos.
  2. Busque Hidroquímica e clique em Instalar.
  3. As ferramentas aparecem no menu Complementos → Hidroquímica (Phreatica) e na Caixa de ferramentas de processamento.

Se o plugin ainda não aparecer na busca (a primeira versão passa por revisão da equipe do QGIS), baixe o arquivo ZIP em github.com/phreatica/qgis-hidroquimica/releases e use Instalar a partir do ZIP na mesma janela.

O que o plugin faz

FerramentaO que fazResultado
Balanço iônico, fácies e durezaAcrescenta à camada cada íon em meq/L, as somas de cátions e ânions, o erro do balanço (%), o limite do critério escolhido (APHA 1030 E, ±5% ou ±10%) e se o erro ficou dentro dele, a fácies pelo íon dominante e a dureza total em mg/L de CaCO₃.Nova camada com os campos hq_*
Diagrama de Piper (SVG)Triângulos de cátions e ânions e o losango central, com porcentagens em meq/L. Cores por grupo (aquífero, campanha) ou por amostra.Arquivo SVG (abre no navegador, Inkscape, Word)
Diagrama de Schoeller (SVG)Gráfico semilogarítmico em meq/L na ordem Ca, Mg, Na+K, Cl, SO₄, HCO₃+CO₃.Arquivo SVG
Diagramas de Stiff no mapaUm polígono de Stiff centrado em cada poço, com escala automática ou fixa em unidades do mapa por meq/L, para comparar mapas.Camada de polígonos no mesmo SRC da entrada

Como preparar a camada

Uma linha por amostra, com uma coluna por íon: Ca²⁺, Mg²⁺, Na⁺, K⁺, HCO₃⁻, CO₃²⁻, SO₄²⁻ e Cl⁻. Pode ser uma camada de pontos (os poços) ou uma tabela sem geometria; para os diagramas de Stiff no mapa, é preciso ponto. Os valores podem estar em mg/L, meq/L ou mmol/L. Uma coluna de grupo (aquífero, campanha, data) colore os diagramas.

Fórmulas e critérios

A conversão usa meq/L = mg/L × carga / massa molar; o balanço, erro = 100 × (Σcátions − Σânions) / (Σcátions + Σânions). Os critérios, a geometria do Piper e a regra de fácies estão descritos na metodologia, e o código está aberto em GitHub.

Prefere sem instalar nada?

As mesmas contas rodam no navegador: diagrama de Piper, balanço iônico, diagrama de Stiff e diagrama de Schoeller.

Perguntas frequentes

Quais nomes de coluna o plugin reconhece?

Ca, Ca (mg/L), calcio, Ca2+, Mg, magnesio, Na, sodio, K, potassio, HCO3, bicarbonato, CO3, carbonato, SO4, sulfato, Cl e cloreto, com ou sem unidade e carga no nome. Se o seu campo tiver outro nome, é só escolhê-lo na janela do algoritmo.

Posso usar valores com vírgula e “<LQ” direto do laudo?

Sim. Campos de texto com 12,5, 1.234,5, <0,5 ou ND são lidos. Para os valores abaixo do limite de quantificação, você escolhe: zero, metade do LQ ou o próprio LQ. O registro do processamento informa quantos valores foram tratados assim.

O plugin diz se a amostra é boa ou ruim?

Não. Ele calcula e mostra o critério usado (por exemplo, ±2% para soma de ânions entre 3 e 10 meq/L no APHA 1030 E). A decisão sobre aceitar, refazer ou interpretar a análise é do profissional responsável.

Funciona em qual versão do QGIS?

QGIS 3.22 ou mais recente, inclusive a versão LTR 3.40, e já está preparado para o QGIS 4. É Python puro, sem instalar bibliotecas extras.

Preciso do QGIS para fazer um diagrama de Piper?

Não. Se você só quer o gráfico, use a versão online grátis: cole a tabela do Excel e baixe o SVG ou PNG. O plugin é para quem já trabalha com os poços no QGIS e quer os resultados ligados ao mapa.