{
  "project": {
    "name": "Water Security Index — South Africa",
    "code": "WSI26",
    "version": "1.0.0",
    "created": "2026-02-20",
    "institution": "Hydrosoft Institute",
    "commission": "Water Research Commission",
    "grid": {
      "resolution_km": 5,
      "nx": 350,
      "ny": 144,
      "total_cells": 50400,
      "sa_cells": 16630,
      "crs": "EPSG:4326",
      "definition_file": "data/grid/wsi_grid_def.json"
    },
    "naming_convention": "WSI26-D{n}-{indicator_code}-{YYYYMMDD}.csv",
    "archive_format": "YYYY-MM-DD_description/"
  },
  "dimensions": [
    {
      "id": "D1",
      "code": "WRH",
      "name": "Water Resources & Hydrology",
      "short": "Water Resources",
      "description": "Quantifies the availability, accessibility, and sustainability of surface and groundwater resources including climatic factors and alternative sources.",
      "color": "#3498db",
      "icon": "💧",
      "weight": 0.125,
      "page": "dimensions/D1_water_resources.html",
      "data_folder": "data/D1_water_resources",
      "indicators": [
        {
          "id": "D1-I01",
          "code": "SWR",
          "name": "Surface Water",
          "directionality": "benefit",
          "weight": 0.15,
          "parameters": [
            {
              "id": "D1-P01",
              "code": "SWF",
              "name": "Surface Water Flow",
              "unit": "m³/s",
              "min": 0,
              "max": 5000,
              "directionality": "benefit",
              "status": "available",
              "file": "WSI26-D1-SWF-20260224.csv",
              "value_field": "SWF",
              "tier": "raw",
              "preferred_renderer": "terrain"
            },
            {
              "id": "D1-P02",
              "code": "RFA",
              "name": "Rainfall Availability",
              "unit": "mm/year",
              "min": 0,
              "max": 3000,
              "directionality": "benefit",
              "status": "available",
              "file": "WSI26-D1-RFA-MAP-2022-2025.csv",
              "value_field": "p_MAP_2022_2025_mm",
              "tier": "raw",
              "preferred_renderer": "terrain"
            },
            {
              "id": "D1-P03",
              "code": "ACC",
              "name": "Accessibility",
              "unit": "index 0-10",
              "min": 0,
              "max": 10,
              "directionality": "benefit",
              "status": "available",
              "file": "WSI26-D1-ACC-20260224.csv",
              "value_field": "ACC",
              "tier": "derived",
              "preferred_renderer": "heatmap"
            },
            {
              "id": "D1-P04",
              "code": "CLF",
              "name": "Climatic Factors",
              "unit": "index 0-10",
              "min": 0,
              "max": 10,
              "directionality": "benefit",
              "status": "available",
              "file": "WSI26-D1-CLF-20260224.csv",
              "value_field": "CLF",
              "tier": "derived",
              "preferred_renderer": "heatmap"
            }
          ]
        },
        {
          "id": "D1-I02",
          "code": "GWR",
          "name": "Groundwater",
          "directionality": "benefit",
          "weight": 0.15,
          "parameters": [
            {
              "id": "D1-P05",
              "code": "GWA",
              "name": "Groundwater Availability",
              "unit": "m³/day",
              "min": 0,
              "max": 50000,
              "directionality": "benefit",
              "status": "available",
              "file": "WSI26-D1-GWA-20260224.csv",
              "value_field": "GWA",
              "tier": "derived",
              "preferred_renderer": "heatmap"
            },
            {
              "id": "D1-P06",
              "code": "GWC",
              "name": "Groundwater Accessibility",
              "unit": "index 0-10",
              "min": 0,
              "max": 10,
              "directionality": "benefit",
              "status": "pending"
            },
            {
              "id": "D1-P07",
              "code": "GRR",
              "name": "Recharge Rates",
              "unit": "mm/year",
              "min": 0,
              "max": 500,
              "directionality": "benefit",
              "status": "available",
              "file": "WSI26-D1-GRR-20260224.csv",
              "value_field": "GRR",
              "tier": "raw",
              "preferred_renderer": "terrain"
            },
            {
              "id": "D1-P08",
              "code": "GWQ",
              "name": "Quality",
              "unit": "index 0-10",
              "min": 0,
              "max": 10,
              "directionality": "benefit",
              "status": "pending"
            }
          ]
        },
        {
          "id": "D1-I03",
          "code": "HEX",
          "name": "Hydrological Extremes",
          "directionality": "cost",
          "weight": 0.12,
          "parameters": [
            {
              "id": "D1-P09",
              "code": "FLD",
              "name": "Floods",
              "unit": "events/year",
              "min": 0,
              "max": 20,
              "directionality": "cost",
              "status": "available",
              "file": "WSI26-D1-FLD-20260224.csv",
              "value_field": "FLD",
              "tier": "derived",
              "preferred_renderer": "categorical"
            },
            {
              "id": "D1-P10",
              "code": "DRT",
              "name": "Droughts",
              "unit": "events/year",
              "min": 0,
              "max": 20,
              "directionality": "cost",
              "status": "available",
              "file": "WSI26-D1-DRT-20260224.csv",
              "value_field": "DRT",
              "tier": "derived",
              "preferred_renderer": "categorical"
            },
            {
              "id": "D1-P11",
              "code": "TFD",
              "name": "Trends of Floods and Droughts",
              "unit": "trend index",
              "min": -1,
              "max": 1,
              "directionality": "cost",
              "status": "pending"
            }
          ]
        },
        {
          "id": "D1-I04",
          "code": "HSU",
          "name": "Hydrological Sustainability",
          "directionality": "benefit",
          "weight": 0.12,
          "parameters": [
            {
              "id": "D1-P12",
              "code": "LTR",
              "name": "Long-term Reliability",
              "unit": "index 0-10",
              "min": 0,
              "max": 10,
              "directionality": "benefit",
              "status": "available",
              "file": "WSI26-D1-LTR-20260224.csv",
              "value_field": "LTR",
              "tier": "derived",
              "preferred_renderer": "heatmap"
            },
            {
              "id": "D1-P13",
              "code": "CCI",
              "name": "Climate Change Implications",
              "unit": "index 0-10",
              "min": 0,
              "max": 10,
              "directionality": "cost",
              "status": "available",
              "file": "WSI26-D1-CCI-20260224.csv",
              "value_field": "CCI",
              "tier": "derived",
              "preferred_renderer": "heatmap"
            }
          ]
        },
        {
          "id": "D1-I05",
          "code": "EVP",
          "name": "Evaporation and Evapotranspiration",
          "directionality": "cost",
          "weight": 0.1,
          "parameters": [
            {
              "id": "D1-P14",
              "code": "EVR",
              "name": "Evaporation Rates",
              "unit": "mm/year",
              "min": 0,
              "max": 3000,
              "directionality": "cost",
              "status": "pending"
            },
            {
              "id": "D1-P15",
              "code": "ETR",
              "name": "Evapotranspiration Rates",
              "unit": "mm/year",
              "min": 0,
              "max": 2500,
              "directionality": "cost",
              "status": "pending"
            },
            {
              "id": "D1-P16",
              "code": "INF",
              "name": "Infiltration",
              "unit": "mm/year",
              "min": 0,
              "max": 500,
              "directionality": "benefit",
              "status": "pending"
            },
            {
              "id": "D1-P17",
              "code": "LCV",
              "name": "Land Cover",
              "unit": "classification",
              "min": 0,
              "max": 10,
              "directionality": "benefit",
              "status": "pending"
            },
            {
              "id": "D1-P18",
              "code": "SWR2",
              "name": "Soils and Soil Water Retention",
              "unit": "mm",
              "min": 0,
              "max": 500,
              "directionality": "benefit",
              "status": "pending"
            }
          ]
        },
        {
          "id": "D1-I06",
          "code": "ALT",
          "name": "Alternative Water Sources",
          "directionality": "benefit",
          "weight": 0.08,
          "parameters": [
            {
              "id": "D1-P19",
              "code": "GRY",
              "name": "Greywater",
              "unit": "m³/day",
              "min": 0,
              "max": 10000,
              "directionality": "benefit",
              "status": "pending"
            },
            {
              "id": "D1-P20",
              "code": "MST",
              "name": "Mist",
              "unit": "mm/year",
              "min": 0,
              "max": 200,
              "directionality": "benefit",
              "status": "pending"
            },
            {
              "id": "D1-P21",
              "code": "SNW",
              "name": "Snow",
              "unit": "mm/year",
              "min": 0,
              "max": 100,
              "directionality": "benefit",
              "status": "pending"
            }
          ]
        },
        {
          "id": "D1-I07",
          "code": "WBL",
          "name": "Water Balance",
          "directionality": "benefit",
          "weight": 0.14,
          "parameters": [
            {
              "id": "D1-P22",
              "code": "WBU",
              "name": "Urban Area Water Balance",
              "unit": "m³/year",
              "min": -500000000,
              "max": 500000000,
              "directionality": "benefit",
              "status": "pending"
            },
            {
              "id": "D1-P23",
              "code": "WBR",
              "name": "Rural Area Water Balance",
              "unit": "m³/year",
              "min": -500000000,
              "max": 500000000,
              "directionality": "benefit",
              "status": "pending"
            }
          ]
        }
      ]
    },
    {
      "id": "D2",
      "code": "WQL",
      "name": "Water Quality",
      "short": "Water Quality",
      "description": "Assesses the chemical, biological, and physical quality of water resources including nutrient levels, contaminants, and microbial safety.",
      "color": "#2ecc71",
      "icon": "🧪",
      "weight": 0.125,
      "page": "dimensions/D2_water_quality.html",
      "data_folder": "data/D2_water_quality",
      "indicators": [
        {
          "id": "D2-I01",
          "code": "NUT",
          "name": "Nutrient Levels",
          "directionality": "cost",
          "weight": 0.15,
          "parameters": [
            {
              "id": "D2-P01",
              "code": "NPC",
              "name": "Nitrate/Phosphate Concentrations",
              "unit": "mg/L",
              "min": 0,
              "max": 50,
              "directionality": "cost",
              "status": "available",
              "file": "WSI26-D2-NPC-20260224.csv",
              "value_field": "NPC",
              "tier": "raw",
              "preferred_renderer": "heatmap"
            }
          ]
        },
        {
          "id": "D2-I02",
          "code": "HMC",
          "name": "Heavy Metal Concentration",
          "directionality": "cost",
          "weight": 0.15,
          "parameters": [
            {
              "id": "D2-P02",
              "code": "MET",
              "name": "Metals Concentration",
              "unit": "mg/L",
              "min": 0,
              "max": 5,
              "directionality": "cost",
              "status": "pending"
            }
          ]
        },
        {
          "id": "D2-I03",
          "code": "CHQ",
          "name": "Chemical Quality",
          "directionality": "cost",
          "weight": 0.15,
          "parameters": [
            {
              "id": "D2-P03",
              "code": "PHS",
              "name": "pH Levels, Salinity, Dissolved Solids",
              "unit": "mg/L",
              "min": 0,
              "max": 500,
              "directionality": "cost",
              "status": "available",
              "file": "WSI26-D2-PHS-20260224.csv",
              "value_field": "PHS",
              "tier": "raw",
              "preferred_renderer": "heatmap"
            },
            {
              "id": "D2-P04",
              "code": "CHC",
              "name": "Chemical Contaminants",
              "unit": "mg/L",
              "min": 0,
              "max": 100,
              "directionality": "cost",
              "status": "pending"
            }
          ]
        },
        {
          "id": "D2-I04",
          "code": "BQL",
          "name": "Biological Quality",
          "directionality": "cost",
          "weight": 0.12,
          "parameters": [
            {
              "id": "D2-P05",
              "code": "ECL",
              "name": "E. coli Counts",
              "unit": "CFU/100mL",
              "min": 0,
              "max": 100000,
              "directionality": "cost",
              "status": "pending"
            },
            {
              "id": "D2-P06",
              "code": "BOD",
              "name": "Biological Oxygen Demand",
              "unit": "mg/L",
              "min": 0,
              "max": 100,
              "directionality": "cost",
              "status": "available",
              "file": "WSI26-D2-BOD-20260224.csv",
              "value_field": "BOD",
              "tier": "raw",
              "preferred_renderer": "heatmap"
            }
          ]
        },
        {
          "id": "D2-I05",
          "code": "WHY",
          "name": "Water Hyacinth Coverage",
          "directionality": "cost",
          "weight": 0.08,
          "parameters": [
            {
              "id": "D2-P07",
              "code": "WHC",
              "name": "Coverage Area of Water Hyacinth",
              "unit": "hectares",
              "min": 0,
              "max": 10000,
              "directionality": "cost",
              "status": "pending"
            }
          ]
        },
        {
          "id": "D2-I06",
          "code": "PWQ",
          "name": "Physical Water Quality",
          "directionality": "benefit",
          "weight": 0.1,
          "parameters": [
            {
              "id": "D2-P08",
              "code": "VQS",
              "name": "Visual Quality Score",
              "unit": "index 0-10",
              "min": 0,
              "max": 10,
              "directionality": "benefit",
              "status": "pending"
            }
          ]
        },
        {
          "id": "D2-I07",
          "code": "TRB",
          "name": "Turbidity",
          "directionality": "cost",
          "weight": 0.1,
          "parameters": [
            {
              "id": "D2-P09",
              "code": "TLV",
              "name": "Turbidity Level",
              "unit": "NTU",
              "min": 0,
              "max": 1000,
              "directionality": "cost",
              "status": "available",
              "file": "WSI26-D2-TLV-20260224.csv",
              "value_field": "TLV",
              "tier": "raw",
              "preferred_renderer": "heatmap"
            }
          ]
        },
        {
          "id": "D2-I08",
          "code": "SAL",
          "name": "Salinity",
          "directionality": "cost",
          "weight": 0.08,
          "parameters": [
            {
              "id": "D2-P10",
              "code": "ECN",
              "name": "Electrical Conductivity",
              "unit": "µS/cm",
              "min": 0,
              "max": 5000,
              "directionality": "cost",
              "status": "available",
              "file": "WSI26-D2-ECN-20260224.csv",
              "value_field": "ECN",
              "tier": "raw",
              "preferred_renderer": "heatmap"
            }
          ]
        },
        {
          "id": "D2-I09",
          "code": "MSF",
          "name": "Microbial Safety",
          "directionality": "cost",
          "weight": 0.07,
          "parameters": [
            {
              "id": "D2-P11",
              "code": "MSE",
              "name": "E. coli Counts (Safety)",
              "unit": "CFU/100mL",
              "min": 0,
              "max": 100000,
              "directionality": "cost",
              "status": "pending"
            }
          ]
        }
      ]
    },
    {
      "id": "D3",
      "code": "WEC",
      "name": "Water Ecosystem",
      "short": "Ecosystem",
      "description": "Evaluates the health and functionality of aquatic ecosystems including biodiversity, environmental flows, and land use impacts.",
      "color": "#27ae60",
      "icon": "🌿",
      "weight": 0.125,
      "page": "dimensions/D3_water_ecosystem.html",
      "data_folder": "data/D3_water_ecosystem",
      "indicators": [
        {
          "id": "D3-I01",
          "code": "ABD",
          "name": "State of Aquatic Biodiversity",
          "directionality": "benefit",
          "weight": 0.18,
          "parameters": [
            {
              "id": "D3-P01",
              "code": "SPR",
              "name": "Species Richness",
              "unit": "number of species",
              "min": 0,
              "max": 500,
              "directionality": "benefit",
              "status": "available",
              "file": "WSI26-D3-SPR-20260224.csv",
              "value_field": "SPR",
              "tier": "raw",
              "preferred_renderer": "heatmap"
            }
          ]
        },
        {
          "id": "D3-I02",
          "code": "ESP",
          "name": "Ecosystem Services Provision",
          "directionality": "benefit",
          "weight": 0.17,
          "parameters": [
            {
              "id": "D3-P02",
              "code": "AHI",
              "name": "Aquatic Health Index (SASS5)",
              "unit": "SASS5 score",
              "min": 0,
              "max": 300,
              "directionality": "benefit",
              "status": "available",
              "file": "WSI26-D3-AHI-20260224.csv",
              "value_field": "AHI",
              "tier": "raw",
              "preferred_renderer": "heatmap"
            }
          ]
        },
        {
          "id": "D3-I03",
          "code": "EFL",
          "name": "Environmental Flows",
          "directionality": "benefit",
          "weight": 0.17,
          "parameters": [
            {
              "id": "D3-P03",
              "code": "EFR",
              "name": "Environmental Flow Requirements Met",
              "unit": "%",
              "min": 0,
              "max": 100,
              "directionality": "benefit",
              "status": "pending"
            }
          ]
        },
        {
          "id": "D3-I04",
          "code": "AHY",
          "name": "Alterations to the Hydrology",
          "directionality": "cost",
          "weight": 0.13,
          "parameters": [
            {
              "id": "D3-P04",
              "code": "HAI",
              "name": "Hydrological Alteration Index",
              "unit": "score 0-1",
              "min": 0,
              "max": 1,
              "directionality": "cost",
              "status": "pending"
            }
          ]
        },
        {
          "id": "D3-I05",
          "code": "MIH",
          "name": "Macroinvertebrates Health",
          "directionality": "benefit",
          "weight": 0.15,
          "parameters": [
            {
              "id": "D3-P05",
              "code": "MIS",
              "name": "Average SASS5 Score",
              "unit": "score",
              "min": 0,
              "max": 300,
              "directionality": "benefit",
              "status": "pending"
            },
            {
              "id": "D3-P06",
              "code": "MHI",
              "name": "Macroinvertebrate Health Index",
              "unit": "score",
              "min": 0,
              "max": 300,
              "directionality": "benefit",
              "status": "pending"
            }
          ]
        },
        {
          "id": "D3-I06",
          "code": "EFC",
          "name": "Environmental Flows Compliance",
          "directionality": "benefit",
          "weight": 0.1,
          "parameters": [
            {
              "id": "D3-P07",
              "code": "CRT",
              "name": "Compliance Rate",
              "unit": "%",
              "min": 0,
              "max": 100,
              "directionality": "benefit",
              "status": "pending"
            }
          ]
        },
        {
          "id": "D3-I07",
          "code": "LUD",
          "name": "Land Use and Degradation",
          "directionality": "cost",
          "weight": 0.1,
          "parameters": [
            {
              "id": "D3-P08",
              "code": "LCC",
              "name": "Annual Land Cover Change",
              "unit": "%",
              "min": 0,
              "max": 100,
              "directionality": "cost",
              "status": "pending"
            }
          ]
        }
      ]
    },
    {
      "id": "D4",
      "code": "INF",
      "name": "Infrastructure and Land",
      "short": "Infrastructure",
      "description": "Assesses the condition, capacity, and resilience of water infrastructure including storage, treatment, and conveyance systems.",
      "color": "#e67e22",
      "icon": "🏗️",
      "weight": 0.125,
      "page": "dimensions/D4_infrastructure.html",
      "data_folder": "data/D4_infrastructure",
      "indicators": [
        {
          "id": "D4-I01",
          "code": "ICN",
          "name": "Infrastructure Condition",
          "directionality": "benefit",
          "weight": 0.12,
          "parameters": [
            {
              "id": "D4-P01",
              "code": "MRI",
              "name": "Maintenance Records",
              "unit": "index 0-10",
              "min": 0,
              "max": 10,
              "directionality": "benefit",
              "status": "pending"
            }
          ]
        },
        {
          "id": "D4-I02",
          "code": "UAW",
          "name": "Unaccounted for Water",
          "directionality": "cost",
          "weight": 0.14,
          "parameters": [
            {
              "id": "D4-P02",
              "code": "NRW",
              "name": "Non-revenue Water",
              "unit": "%",
              "min": 0,
              "max": 100,
              "directionality": "cost",
              "status": "available",
              "file": "WSI26-D4-NRW-20260224.csv",
              "value_field": "NRW",
              "tier": "derived",
              "preferred_renderer": "heatmap"
            }
          ]
        },
        {
          "id": "D4-I03",
          "code": "WEU",
          "name": "Water for Economic Use",
          "directionality": "benefit",
          "weight": 0.1,
          "parameters": [
            {
              "id": "D4-P03",
              "code": "WPS",
              "name": "Water Supplied for Productive Sectors",
              "unit": "million m³/year",
              "min": 0,
              "max": 1000,
              "directionality": "benefit",
              "status": "pending"
            }
          ]
        },
        {
          "id": "D4-I04",
          "code": "WCS",
          "name": "Water Conveyance Systems",
          "directionality": "benefit",
          "weight": 0.1,
          "parameters": [
            {
              "id": "D4-P04",
              "code": "DLV",
              "name": "Latest Dam Levels",
              "unit": "%",
              "min": 0,
              "max": 100,
              "directionality": "benefit",
              "status": "pending"
            }
          ]
        },
        {
          "id": "D4-I05",
          "code": "WST",
          "name": "Water Storage",
          "directionality": "benefit",
          "weight": 0.1,
          "parameters": [
            {
              "id": "D4-P05",
              "code": "STV",
              "name": "Storage Volume",
              "unit": "million m³",
              "min": 0,
              "max": 10000,
              "directionality": "benefit",
              "status": "available",
              "file": "WSI26-D4-STV-20260224.csv",
              "value_field": "STV",
              "tier": "raw",
              "preferred_renderer": "heatmap"
            }
          ]
        },
        {
          "id": "D4-I06",
          "code": "WTE",
          "name": "Wastewater Treatment Efficiency",
          "directionality": "benefit",
          "weight": 0.12,
          "parameters": [
            {
              "id": "D4-P06",
              "code": "TWS",
              "name": "Treated Wastewater Meeting Standards",
              "unit": "%",
              "min": 0,
              "max": 100,
              "directionality": "benefit",
              "status": "pending"
            }
          ]
        },
        {
          "id": "D4-I07",
          "code": "IVN",
          "name": "Infrastructure Vandalism",
          "directionality": "cost",
          "weight": 0.08,
          "parameters": [
            {
              "id": "D4-P07",
              "code": "VIN",
              "name": "Reported Vandalism Incidents",
              "unit": "number/year",
              "min": 0,
              "max": 500,
              "directionality": "cost",
              "status": "pending"
            }
          ]
        },
        {
          "id": "D4-I08",
          "code": "IDV",
          "name": "Infrastructure Development",
          "directionality": "benefit",
          "weight": 0.08,
          "parameters": [
            {
              "id": "D4-P08",
              "code": "NIA",
              "name": "New Infrastructure Added",
              "unit": "km/year",
              "min": 0,
              "max": 500,
              "directionality": "benefit",
              "status": "pending"
            }
          ]
        },
        {
          "id": "D4-I09",
          "code": "SOF",
          "name": "Sewer Overflow Frequency",
          "directionality": "cost",
          "weight": 0.08,
          "parameters": [
            {
              "id": "D4-P09",
              "code": "OVF",
              "name": "Overflow Events",
              "unit": "events/year",
              "min": 0,
              "max": 100,
              "directionality": "cost",
              "status": "pending"
            }
          ]
        },
        {
          "id": "D4-I10",
          "code": "FIR",
          "name": "Flood Infrastructure Rating",
          "directionality": "benefit",
          "weight": 0.08,
          "parameters": [
            {
              "id": "D4-P10",
              "code": "FRT",
              "name": "Inspection Ratings",
              "unit": "index 0-10",
              "min": 0,
              "max": 10,
              "directionality": "benefit",
              "status": "pending"
            }
          ]
        },
        {
          "id": "D4-I11",
          "code": "BSX",
          "name": "Built Settlement Extent",
          "directionality": "benefit",
          "weight": 0.08,
          "parameters": [
            {
              "id": "D4-P11",
              "code": "BSE",
              "name": "Built Settlement Fraction",
              "unit": "fraction 0-1",
              "min": 0,
              "max": 1,
              "directionality": "benefit",
              "status": "available",
              "file": "WSI26-D4-BSE-20260226.csv",
              "value_field": "BSE",
              "tier": "raw",
              "preferred_renderer": "heatmap"
            }
          ]
        }
      ]
    },
    {
      "id": "D5",
      "code": "SEC",
      "name": "Socio-Economics, Culture & Financial Factors",
      "short": "Socio-Economics",
      "description": "Measures the socio-economic impacts and financial dimensions of water security including affordability, access, and economic dependencies.",
      "color": "#9b59b6",
      "icon": "📊",
      "weight": 0.125,
      "page": "dimensions/D5_socio_economics.html",
      "data_folder": "data/D5_socio_economics",
      "indicators": [
        {
          "id": "D5-I01",
          "code": "RWA",
          "name": "Reliable Water Access",
          "directionality": "benefit",
          "weight": 0.2,
          "parameters": [
            {
              "id": "D5-P01",
              "code": "PWA",
              "name": "Population with Access",
              "unit": "%",
              "min": 0,
              "max": 100,
              "directionality": "benefit",
              "status": "available",
              "file": "WSI26-D5-PWA-20260224.csv",
              "value_field": "PWA",
              "tier": "derived",
              "preferred_renderer": "heatmap"
            }
          ]
        },
        {
          "id": "D5-I02",
          "code": "AFF",
          "name": "Affordability",
          "directionality": "cost",
          "weight": 0.2,
          "parameters": [
            {
              "id": "D5-P02",
              "code": "WEI",
              "name": "Water Expenditure",
              "unit": "% household income",
              "min": 0,
              "max": 100,
              "directionality": "cost",
              "status": "pending"
            }
          ]
        },
        {
          "id": "D5-I03",
          "code": "ECL",
          "name": "Economic Losses",
          "directionality": "cost",
          "weight": 0.18,
          "parameters": [
            {
              "id": "D5-P03",
              "code": "ELW",
              "name": "Economic Loss Due to Water Insecurity",
              "unit": "Rand/year",
              "min": 0,
              "max": 1000000000,
              "directionality": "cost",
              "status": "pending"
            }
          ]
        },
        {
          "id": "D5-I04",
          "code": "GDP",
          "name": "GDP Dependency",
          "directionality": "benefit",
          "weight": 0.15,
          "parameters": [
            {
              "id": "D5-P04",
              "code": "GDW",
              "name": "GDP Linked to Water Sectors",
              "unit": "%",
              "min": 0,
              "max": 100,
              "directionality": "benefit",
              "status": "pending"
            }
          ]
        },
        {
          "id": "D5-I05",
          "code": "VPA",
          "name": "Vulnerable Populations Affected",
          "directionality": "cost",
          "weight": 0.15,
          "parameters": [
            {
              "id": "D5-P05",
              "code": "VPP",
              "name": "Percent Population Affected",
              "unit": "%",
              "min": 0,
              "max": 100,
              "directionality": "cost",
              "status": "pending"
            }
          ]
        },
        {
          "id": "D5-I06",
          "code": "WRD",
          "name": "Water-related Diseases",
          "directionality": "cost",
          "weight": 0.12,
          "parameters": [
            {
              "id": "D5-P06",
              "code": "DIN",
              "name": "Disease Incidence",
              "unit": "cases/year",
              "min": 0,
              "max": 100000,
              "directionality": "cost",
              "status": "pending"
            }
          ]
        },
        {
          "id": "D5-I07",
          "code": "PDP",
          "name": "Population Density Pressure",
          "directionality": "cost",
          "weight": 0.1,
          "parameters": [
            {
              "id": "D5-P07",
              "code": "PDN",
              "name": "Population Density",
              "unit": "people/km²",
              "min": 0,
              "max": 10000,
              "directionality": "cost",
              "status": "available",
              "file": "WSI26-D5-PDN-20260226.csv",
              "value_field": "PDN",
              "tier": "raw",
              "preferred_renderer": "terrain"
            }
          ]
        }
      ]
    },
    {
      "id": "D6",
      "code": "ICG",
      "name": "Institutional Capacity & Governance",
      "short": "Governance",
      "description": "Evaluates institutional readiness, financial health, policy frameworks, and governance quality for water service delivery.",
      "color": "#e74c3c",
      "icon": "🏛️",
      "weight": 0.125,
      "page": "dimensions/D6_institutional.html",
      "data_folder": "data/D6_institutional",
      "indicators": [
        {
          "id": "D6-I01",
          "code": "PCA",
          "name": "Personnel Capacity",
          "directionality": "benefit",
          "weight": 0.14,
          "parameters": [
            {
              "id": "D6-P01",
              "code": "TSP",
              "name": "Trained Staff Proportion",
              "unit": "%",
              "min": 0,
              "max": 100,
              "directionality": "benefit",
              "status": "pending"
            }
          ]
        },
        {
          "id": "D6-I02",
          "code": "RTD",
          "name": "Response Time to Disruptions",
          "directionality": "cost",
          "weight": 0.12,
          "parameters": [
            {
              "id": "D6-P02",
              "code": "RST",
              "name": "Response Times",
              "unit": "hours/event",
              "min": 0,
              "max": 720,
              "directionality": "cost",
              "status": "pending"
            }
          ]
        },
        {
          "id": "D6-I03",
          "code": "IFS",
          "name": "Institutional Financial State",
          "directionality": "benefit",
          "weight": 0.14,
          "parameters": [
            {
              "id": "D6-P03",
              "code": "RCR",
              "name": "Revenue-to-cost Recovery Ratio",
              "unit": "%",
              "min": 0,
              "max": 200,
              "directionality": "benefit",
              "status": "pending"
            }
          ]
        },
        {
          "id": "D6-I04",
          "code": "SWG",
          "name": "State of Water Governance",
          "directionality": "benefit",
          "weight": 0.15,
          "parameters": [
            {
              "id": "D6-P04",
              "code": "GVI",
              "name": "Governance Index",
              "unit": "score 0-10",
              "min": 0,
              "max": 10,
              "directionality": "benefit",
              "status": "available",
              "file": "WSI26-D6-GVI-20260224.csv",
              "value_field": "GVI",
              "tier": "derived",
              "preferred_renderer": "heatmap"
            }
          ]
        },
        {
          "id": "D6-I05",
          "code": "LEI",
          "name": "Level of Expertise",
          "directionality": "benefit",
          "weight": 0.1,
          "parameters": [
            {
              "id": "D6-P05",
              "code": "CWP",
              "name": "Certified Water Professionals",
              "unit": "%",
              "min": 0,
              "max": 100,
              "directionality": "benefit",
              "status": "pending"
            }
          ]
        },
        {
          "id": "D6-I06",
          "code": "FRR",
          "name": "Financial Recovery Rates",
          "directionality": "benefit",
          "weight": 0.12,
          "parameters": [
            {
              "id": "D6-P06",
              "code": "BRR",
              "name": "Billing Recovery Rate",
              "unit": "%",
              "min": 0,
              "max": 100,
              "directionality": "benefit",
              "status": "pending"
            }
          ]
        },
        {
          "id": "D6-I07",
          "code": "AWP",
          "name": "Active Water Policies",
          "directionality": "benefit",
          "weight": 0.08,
          "parameters": [
            {
              "id": "D6-P07",
              "code": "NOP",
              "name": "Number of Policies",
              "unit": "count",
              "min": 0,
              "max": 100,
              "directionality": "benefit",
              "status": "pending"
            }
          ]
        },
        {
          "id": "D6-I08",
          "code": "PEF",
          "name": "Policy Effectiveness",
          "directionality": "benefit",
          "weight": 0.08,
          "parameters": [
            {
              "id": "D6-P08",
              "code": "PIR",
              "name": "Implementation Rating",
              "unit": "index 0-10",
              "min": 0,
              "max": 10,
              "directionality": "benefit",
              "status": "pending"
            }
          ]
        },
        {
          "id": "D6-I09",
          "code": "STC",
          "name": "Stakeholder Consultations",
          "directionality": "benefit",
          "weight": 0.07,
          "parameters": [
            {
              "id": "D6-P09",
              "code": "CEY",
              "name": "Consultation Events per Year",
              "unit": "events/year",
              "min": 0,
              "max": 365,
              "directionality": "benefit",
              "status": "pending"
            }
          ]
        }
      ]
    },
    {
      "id": "D7",
      "code": "WUD",
      "name": "Water Use & Demand Management",
      "short": "Water Use & Demand",
      "description": "Quantifies water abstraction, use efficiency, demand management, conservation effectiveness, and service coverage.",
      "color": "#f39c12",
      "icon": "🚰",
      "weight": 0.125,
      "page": "dimensions/D7_water_use_demand.html",
      "data_folder": "data/D7_water_use_demand",
      "indicators": [
        {
          "id": "D7-I01",
          "code": "RWB",
          "name": "Raw Water Abstraction",
          "directionality": "cost",
          "weight": 0.1,
          "parameters": [
            {
              "id": "D7-P01",
              "code": "ABV",
              "name": "Abstraction Volume",
              "unit": "million m³/year",
              "min": 0,
              "max": 5000,
              "directionality": "cost",
              "status": "available",
              "file": "WSI26-D7-ABV-20260224.csv",
              "value_field": "ABV",
              "tier": "raw",
              "preferred_renderer": "heatmap"
            }
          ]
        },
        {
          "id": "D7-I02",
          "code": "ALC",
          "name": "Abstraction Licensing Compliance",
          "directionality": "benefit",
          "weight": 0.09,
          "parameters": [
            {
              "id": "D7-P02",
              "code": "ACP",
              "name": "Compliance Rate",
              "unit": "%",
              "min": 0,
              "max": 100,
              "directionality": "benefit",
              "status": "available",
              "file": "WSI26-D7-ACP-20260228.csv",
              "value_field": "ACP",
              "tier": "derived",
              "preferred_renderer": "heatmap"
            }
          ]
        },
        {
          "id": "D7-I03",
          "code": "PCD",
          "name": "Per Capita Daily Potable Use",
          "directionality": "cost",
          "weight": 0.1,
          "parameters": [
            {
              "id": "D7-P03",
              "code": "LPD",
              "name": "Average Litres/Person/Day",
              "unit": "L/person/day",
              "min": 0,
              "max": 1000,
              "directionality": "cost",
              "status": "available",
              "file": "WSI26-D7-LPD-20260228.csv",
              "value_field": "LPD",
              "tier": "derived",
              "preferred_renderer": "heatmap"
            }
          ]
        },
        {
          "id": "D7-I04",
          "code": "CWS",
          "name": "Coverage of Water Services",
          "directionality": "benefit",
          "weight": 0.12,
          "parameters": [
            {
              "id": "D7-P04",
              "code": "PPC",
              "name": "Percentage of Population Covered",
              "unit": "%",
              "min": 0,
              "max": 100,
              "directionality": "benefit",
              "status": "available",
              "file": "WSI26-D7-PPC-20260224.csv",
              "value_field": "PPC",
              "tier": "derived",
              "preferred_renderer": "heatmap"
            }
          ]
        },
        {
          "id": "D7-I05",
          "code": "WDU",
          "name": "Water Demand and Use",
          "directionality": "cost",
          "weight": 0.1,
          "parameters": [
            {
              "id": "D7-P05",
              "code": "CNS",
              "name": "Consumption",
              "unit": "L/person/day",
              "min": 0,
              "max": 1000,
              "directionality": "cost",
              "status": "available",
              "file": "WSI26-D7-CNS-20260228.csv",
              "value_field": "CNS",
              "tier": "derived",
              "preferred_renderer": "heatmap"
            }
          ]
        },
        {
          "id": "D7-I06",
          "code": "SCV",
          "name": "Sanitation Coverage",
          "directionality": "benefit",
          "weight": 0.1,
          "parameters": [
            {
              "id": "D7-P06",
              "code": "SPC",
              "name": "Population Coverage",
              "unit": "%",
              "min": 0,
              "max": 100,
              "directionality": "benefit",
              "status": "available",
              "file": "WSI26-D7-SPC-20260228.csv",
              "value_field": "SPC",
              "tier": "derived",
              "preferred_renderer": "heatmap"
            }
          ]
        },
        {
          "id": "D7-I07",
          "code": "WWR",
          "name": "Wastewater Reuse",
          "directionality": "benefit",
          "weight": 0.09,
          "parameters": [
            {
              "id": "D7-P07",
              "code": "RCW",
              "name": "Recycled Water",
              "unit": "%",
              "min": 0,
              "max": 100,
              "directionality": "benefit",
              "status": "available",
              "file": "WSI26-D7-RCW-20260228.csv",
              "value_field": "RCW",
              "tier": "derived",
              "preferred_renderer": "heatmap"
            }
          ]
        },
        {
          "id": "D7-I08",
          "code": "EWA",
          "name": "Ecosystem Water Allocations",
          "directionality": "benefit",
          "weight": 0.09,
          "parameters": [
            {
              "id": "D7-P08",
              "code": "ALV",
              "name": "Allocated Volume",
              "unit": "% MAR compliance",
              "min": 0,
              "max": 100,
              "directionality": "benefit",
              "status": "available",
              "file": "WSI26-D7-ALV-20260228.csv",
              "value_field": "ALV",
              "tier": "derived",
              "preferred_renderer": "heatmap"
            }
          ]
        },
        {
          "id": "D7-I09",
          "code": "WCE",
          "name": "Water Conservation Effectiveness",
          "directionality": "benefit",
          "weight": 0.09,
          "parameters": [
            {
              "id": "D7-P09",
              "code": "RUS",
              "name": "Reduction in Usage",
              "unit": "%",
              "min": 0,
              "max": 100,
              "directionality": "benefit",
              "status": "available",
              "file": "WSI26-D7-RUS-20260228.csv",
              "value_field": "RUS",
              "tier": "derived",
              "preferred_renderer": "heatmap"
            }
          ]
        },
        {
          "id": "D7-I10",
          "code": "AIE",
          "name": "Agricultural/Industrial Efficiency",
          "directionality": "benefit",
          "weight": 0.07,
          "parameters": [
            {
              "id": "D7-P10",
              "code": "WUE",
              "name": "Water Use Efficiency",
              "unit": "m³/output",
              "min": 0,
              "max": 100,
              "directionality": "benefit",
              "status": "available",
              "file": "WSI26-D7-WUE-20260228.csv",
              "value_field": "WUE",
              "tier": "derived",
              "preferred_renderer": "heatmap"
            }
          ]
        },
        {
          "id": "D7-I11",
          "code": "WDM",
          "name": "Water Demand Management",
          "directionality": "benefit",
          "weight": 0.05,
          "parameters": [
            {
              "id": "D7-P11",
              "code": "PRD",
              "name": "Percentage Reduction of Demand",
              "unit": "%",
              "min": 0,
              "max": 100,
              "directionality": "benefit",
              "status": "available",
              "file": "WSI26-D7-PRD-20260228.csv",
              "value_field": "PRD",
              "tier": "derived",
              "preferred_renderer": "heatmap"
            }
          ]
        }
      ]
    },
    {
      "id": "D8",
      "code": "WSH",
      "name": "Water Stakeholders",
      "short": "Stakeholders",
      "description": "Assesses stakeholder representation, knowledge, collaboration, adaptability, equity, and participation in water governance.",
      "color": "#1abc9c",
      "icon": "👥",
      "weight": 0.125,
      "page": "dimensions/D8_stakeholders.html",
      "data_folder": "data/D8_stakeholders",
      "indicators": [
        {
          "id": "D8-I01",
          "code": "SRD",
          "name": "Stakeholder Representation & Diversity",
          "directionality": "benefit",
          "weight": 0.17,
          "parameters": [
            {
              "id": "D8-P01",
              "code": "RVG",
              "name": "Representation of Vulnerable Groups",
              "unit": "%",
              "min": 0,
              "max": 100,
              "directionality": "benefit",
              "status": "available",
              "file": "WSI26-D8-RVG-20260228.csv",
              "value_field": "RVG",
              "tier": "derived",
              "preferred_renderer": "heatmap"
            },
            {
              "id": "D8-P02",
              "code": "GBR",
              "name": "Gender Balance Ratio",
              "unit": "ratio",
              "min": 0,
              "max": 1,
              "directionality": "benefit",
              "status": "available",
              "file": "WSI26-D8-GBR-20260228.csv",
              "value_field": "GBR",
              "tier": "derived",
              "preferred_renderer": "heatmap"
            },
            {
              "id": "D8-P03",
              "code": "SRC",
              "name": "Sectoral Representation Completeness",
              "unit": "index 0-10",
              "min": 0,
              "max": 10,
              "directionality": "benefit",
              "status": "available",
              "file": "WSI26-D8-SRC-20260228_v2.csv",
              "value_field": "SRC",
              "tier": "derived",
              "preferred_renderer": "heatmap"
            }
          ]
        },
        {
          "id": "D8-I02",
          "code": "SKC",
          "name": "Stakeholder Knowledge & Capacity",
          "directionality": "benefit",
          "weight": 0.17,
          "parameters": [
            {
              "id": "D8-P04",
              "code": "WLA",
              "name": "Water Literacy Assessment Scores",
              "unit": "score",
              "min": 0,
              "max": 100,
              "directionality": "benefit",
              "status": "available",
              "file": "WSI26-D8-WLA-20260224.csv",
              "value_field": "WLA",
              "tier": "derived",
              "preferred_renderer": "heatmap"
            },
            {
              "id": "D8-P05",
              "code": "TPR",
              "name": "Training Participation Rates",
              "unit": "%",
              "min": 0,
              "max": 100,
              "directionality": "benefit",
              "status": "available",
              "file": "WSI26-D8-TPR-20260228.csv",
              "value_field": "TPR",
              "tier": "derived",
              "preferred_renderer": "heatmap"
            },
            {
              "id": "D8-P06",
              "code": "SPW",
              "name": "Stakeholder Perception of Water Risks",
              "unit": "survey index",
              "min": 0,
              "max": 100,
              "directionality": "benefit",
              "status": "available",
              "file": "WSI26-D8-SPW-20260228.csv",
              "value_field": "SPW",
              "tier": "derived",
              "preferred_renderer": "heatmap"
            }
          ]
        },
        {
          "id": "D8-I03",
          "code": "SCS",
          "name": "Stakeholder Collaboration & Support",
          "directionality": "benefit",
          "weight": 0.17,
          "parameters": [
            {
              "id": "D8-P07",
              "code": "JIN",
              "name": "Joint Initiatives",
              "unit": "number/year",
              "min": 0,
              "max": 500,
              "directionality": "benefit",
              "status": "available",
              "file": "WSI26-D8-JIN-20260228.csv",
              "value_field": "JIN",
              "tier": "derived",
              "preferred_renderer": "heatmap"
            },
            {
              "id": "D8-P08",
              "code": "RSA",
              "name": "Resource-sharing Agreements",
              "unit": "number",
              "min": 0,
              "max": 500,
              "directionality": "benefit",
              "status": "available",
              "file": "WSI26-D8-RSA-20260228.csv",
              "value_field": "RSA",
              "tier": "derived",
              "preferred_renderer": "heatmap"
            },
            {
              "id": "D8-P09",
              "code": "CRS",
              "name": "Conflict Resolution Success Rate",
              "unit": "%",
              "min": 0,
              "max": 100,
              "directionality": "benefit",
              "status": "available",
              "file": "WSI26-D8-CRS-20260228.csv",
              "value_field": "CRS",
              "tier": "derived",
              "preferred_renderer": "heatmap"
            }
          ]
        },
        {
          "id": "D8-I04",
          "code": "SAI",
          "name": "Stakeholder Adaptability & Innovation",
          "directionality": "benefit",
          "weight": 0.17,
          "parameters": [
            {
              "id": "D8-P10",
              "code": "SRT",
              "name": "Response Time to New Policies",
              "unit": "months",
              "min": 0,
              "max": 120,
              "directionality": "cost",
              "status": "available",
              "file": "WSI26-D8-SRT-20260228.csv",
              "value_field": "SRT",
              "tier": "derived",
              "preferred_renderer": "heatmap"
            },
            {
              "id": "D8-P11",
              "code": "IAR",
              "name": "Innovation Adoption Rates",
              "unit": "%",
              "min": 0,
              "max": 100,
              "directionality": "benefit",
              "status": "available",
              "file": "WSI26-D8-IAR-20260228.csv",
              "value_field": "IAR",
              "tier": "derived",
              "preferred_renderer": "heatmap"
            },
            {
              "id": "D8-P12",
              "code": "FAS",
              "name": "Flexibility Assessment Score",
              "unit": "index 0-10",
              "min": 0,
              "max": 10,
              "directionality": "benefit",
              "status": "available",
              "file": "WSI26-D8-FAS-20260228.csv",
              "value_field": "FAS",
              "tier": "derived",
              "preferred_renderer": "heatmap"
            }
          ]
        },
        {
          "id": "D8-I05",
          "code": "SEI",
          "name": "Stakeholder Equity & Inequalities",
          "directionality": "benefit",
          "weight": 0.16,
          "parameters": [
            {
              "id": "D8-P13",
              "code": "DGP",
              "name": "Disadvantaged Group Participation Rate",
              "unit": "%",
              "min": 0,
              "max": 100,
              "directionality": "benefit",
              "status": "available",
              "file": "WSI26-D8-DGP-20260228.csv",
              "value_field": "DGP",
              "tier": "derived",
              "preferred_renderer": "heatmap"
            },
            {
              "id": "D8-P14",
              "code": "RAF",
              "name": "Resource Allocation Fairness Index",
              "unit": "index",
              "min": 0,
              "max": 10,
              "directionality": "benefit",
              "status": "available",
              "file": "WSI26-D8-RAF-20260228.csv",
              "value_field": "RAF",
              "tier": "derived",
              "preferred_renderer": "heatmap"
            },
            {
              "id": "D8-P15",
              "code": "BSA",
              "name": "Benefit-sharing Assessment",
              "unit": "score",
              "min": 0,
              "max": 100,
              "directionality": "benefit",
              "status": "available",
              "file": "WSI26-D8-BSA-20260228_v2.csv",
              "value_field": "BSA",
              "tier": "derived",
              "preferred_renderer": "heatmap"
            }
          ]
        },
        {
          "id": "D8-I06",
          "code": "SPD",
          "name": "Stakeholder Participation & Decision Influence",
          "directionality": "benefit",
          "weight": 0.16,
          "parameters": [
            {
              "id": "D8-P16",
              "code": "PPP",
              "name": "Participation in Planning Processes",
              "unit": "attendance %",
              "min": 0,
              "max": 100,
              "directionality": "benefit",
              "status": "available",
              "file": "WSI26-D8-PPP-20260228.csv",
              "value_field": "PPP",
              "tier": "derived",
              "preferred_renderer": "heatmap"
            },
            {
              "id": "D8-P17",
              "code": "ISI",
              "name": "Impact of Stakeholder Input on Decisions",
              "unit": "index",
              "min": 0,
              "max": 10,
              "directionality": "benefit",
              "status": "available",
              "file": "WSI26-D8-ISI-20260228.csv",
              "value_field": "ISI",
              "tier": "derived",
              "preferred_renderer": "heatmap"
            },
            {
              "id": "D8-P18",
              "code": "EQA",
              "name": "Engagement Quality Assessment",
              "unit": "score",
              "min": 0,
              "max": 100,
              "directionality": "benefit",
              "status": "available",
              "file": "WSI26-D8-EQA-20260228.csv",
              "value_field": "EQA",
              "tier": "derived",
              "preferred_renderer": "heatmap"
            }
          ]
        }
      ]
    }
  ],
  "supplementary_files": [
    {
      "file": "WSI26-D2-SAL-20260224.csv",
      "maps_to": "ECN",
      "value_field": "SAL",
      "note": "Salinity data mapped to ECN parameter"
    },
    {
      "file": "WSI26-D2-pH-20260224.csv",
      "maps_to": "PHS",
      "value_field": "pH_level",
      "note": "pH data mapped to PHS parameter"
    },
    {
      "file": "WSI26-D3-SPR_BIO-20260224.csv",
      "maps_to": "MHI",
      "value_field": "SPR_bio",
      "note": "Biodiversity index mapped to MHI parameter"
    }
  ]
}