Esquema JSON de QUAL2K: Formato de Importación y Exportación

El Asistente Web QUAL2K utiliza JSON como formato nativo de datos para guardar y cargar configuraciones de proyectos. Esta página documenta el esquema completo con ejemplos anotados. Para una descripción del significado y unidades de cada campo, consulte la Referencia de Campos del Asistente.

Figura 1: Estructura del esquema JSON de QUAL2K

Estructura JSON de Nivel Superior

jsonEstructura raíz del esquema

{
  "project": { ... },
  "reaches": { "items": [ ... ] },
  "headwater": { ... },
  "pointSources": { "items": [ ... ] },
  "diffuseSources": { "items": [ ... ] },
  "kinetics": { ... },
  "lightHeat": { ... },
  "metData": { ... },
  "observedData": { ... }
}

Sección: project (Configuración del Proyecto)

jsonConfiguración del proyecto

{
  "project": {
    "riverName": "Río Paraluz",
    "simDate": "2026-02-24",
    "timezone": -5,
    "calcStep": 11.25,
    "integration": "Euler",
    "simType": "Steady"
  }
}

Sección: reaches (Definición de Tramos)

jsonArray de definición de tramos

{
  "reaches": {
    "items": [
      {
        "name": "PR1",
        "downstreamDist": 2.64,
        "upstreamElev": 45.0,
        "downstreamElev": 42.0,
        "manningN": 0.035,
        "bottomWidth": 3.0,
        "sideSlope1": 2.0,
        "sideSlope2": 2.0
      },
      {
        "name": "VPR1",
        "downstreamDist": 3.87,
        "upstreamElev": 42.0,
        "downstreamElev": 40.5,
        "manningN": 0.035,
        "bottomWidth": 3.5,
        "sideSlope1": 2.0,
        "sideSlope2": 2.0
      }
    ]
  }
}

Sección: headwater (Condiciones de Cabecera)

jsonCondiciones de frontera en cabecera

{
  "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
  }
}

Sección: pointSources (Fuentes Puntuales)

jsonArray de fuentes puntuales

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

Sección: kinetics (Tasas Cinéticas)

jsonConstantes de tasas 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 Datos del Esquema JSON

Tipo de campo	Tipo JSON	Ejemplo	Notas
Nombres	string	"PR1"	Identificador de texto libre
Distancias	number	2.64	Kilómetros, siempre positivos
Elevaciones	number	45.0	Metros sobre el nivel del mar
Caudales	number	0.06	Metros cúbicos por segundo (m³/s)
Concentraciones	number	150	mg/L o μg/L según se indique
Tasas	number	0.20	Por día (día⁻¹)
Arrays	array de objetos	[{...}, {...}]	Múltiples tramos o fuentes
Fechas	string	"2026-02-24"	Formato ISO 8601