Esquema JSON do QUAL2K: referência do formato de importação e exportação

O assistente web do QUAL2K usa JSON como formato nativo de dados para salvar e carregar as configurações dos projetos. Esta página documenta o esquema completo, com exemplos comentados. Para o significado e as unidades de cada campo, veja a Referência dos campos do assistente.

Estrutura de nível superior do esquema JSON

jsonEstrutura da raiz do esquema
{
  "project": { ... },
  "reaches": { "items": [ ... ] },
  "headwater": { ... },
  "pointSources": { "items": [ ... ] },
  "diffuseSources": { "items": [ ... ] },
  "kinetics": { ... },
  "lightHeat": { ... },
  "metData": { ... },
  "observedData": { ... }
}

Seção: project

jsonConfiguração do projeto
{
  "project": {
    "riverName": "Rio de exemplo",
    "simDate": "2026-02-24",
    "timezone": -5,
    "calcStep": 11.25,
    "integration": "Euler",
    "simType": "Steady"
  }
}

Seção: reaches

jsonLista de definição dos trechos
{
  "reaches": {
    "items": [
      {
        "name": "Trecho 1",
        "downstreamDist": 2.64,
        "upstreamElev": 45.0,
        "downstreamElev": 42.0,
        "manningN": 0.035,
        "bottomWidth": 3.0,
        "sideSlope1": 2.0,
        "sideSlope2": 2.0
      },
      {
        "name": "Trecho 2",
        "downstreamDist": 3.87,
        "upstreamElev": 42.0,
        "downstreamElev": 40.5,
        "manningN": 0.035,
        "bottomWidth": 3.5,
        "sideSlope1": 2.0,
        "sideSlope2": 2.0
      }
    ]
  }
}

Seção: headwater

jsonCondições de contorno da cabeceira
{
  "headwater": {
    "flow": 0.06,
    "temperature": 22.0,
    "do": 7.5,
    "cbodFast": 4.0,
    "cbodSlow": 2.0,
    "orgN": 200,
    "nh4": 150,
    "no3": 600,
    "orgP": 50,
    "inorgP": 100,
    "iss": 10,
    "cond": 350,
    "pathogens": 5000,
    "alk": 100
  }
}

Seção: pointSources

jsonLista de fontes pontuais
{
  "pointSources": {
    "items": [
      {
        "name": "Efluente da ETE",
        "location": 3.5,
        "flow": 0.02,
        "abstraction": 0,
        "temperature": 25.0,
        "do": 2.0,
        "cbodFast": 15.0,
        "nh4": 8000,
        "no3": 2000,
        "pathogens": 50000
      }
    ]
  }
}

Seção: kinetics

jsonConstantes das taxas cinéticas
{
  "kinetics": {
    "kdc": 0.20,
    "kdcs": 0.01,
    "khc": 0.02,
    "kn": 0.20,
    "ki": 0.00,
    "khn": 0.02,
    "khp": 0.01,
    "kb": 1.00,
    "vss": 0.00,
    "ron": 4.57,
    "SOD": 0.00
  }
}

Tipos de dados do esquema JSON

Tipo de campoTipo JSONExemploObservações
Nomesstring"PR1"Identificador de texto livre
Distânciasnumber2.64Quilômetros, sempre positivos
Cotasnumber45.0Metros acima do nível do mar
Vazõesnumber0.06Metros cúbicos por segundo (m³/s)
Concentraçõesnumber150mg/L ou μg/L, conforme indicado
Taxasnumber0.20Por dia (dia⁻¹)
Listasarray de objetos[{...}, {...}]Vários trechos ou fontes
Datasstring"2026-02-24"Formato ISO 8601

Modele o rio inteiro no motor de previsão

Importe sua planilha QUAL2Kw ou abra o projeto de exemplo. Os resultados reproduzem 15 modelos QUAL2Kw calibrados dentro de 5% ou de uma pequena faixa absoluta.

Ver o motor de previsão