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 campo | Tipo JSON | Exemplo | Observações |
|---|---|---|---|
| Nomes | string | "PR1" | Identificador de texto livre |
| Distâncias | number | 2.64 | Quilômetros, sempre positivos |
| Cotas | number | 45.0 | Metros acima do nível do mar |
| Vazões | number | 0.06 | Metros cúbicos por segundo (m³/s) |
| Concentrações | number | 150 | mg/L ou μg/L, conforme indicado |
| Taxas | number | 0.20 | Por dia (dia⁻¹) |
| Listas | array de objetos | [{...}, {...}] | Vários trechos ou fontes |
| Datas | string | "2026-02-24" | Formato ISO 8601 |