Data fields & definitions
Working designSample data
Data guide

109 data fields: what is needed, who provides it and why

This list covers electricity production, hydropower project condition, reservoir condition, flood coordination and the EDL and government data needed for useful analysis.

The proposed reporting times are for the pilot. Lao institutions must approve the final requirements, deadlines and warning limits.
Operators have two equal ways to provide readings: send them automatically from SCADA or telemetry, or enter them manually in the web form. Both methods use the same database, data checks, operator review and supervisor confirmation.
Data owner

Every field has an owner

Every value shows who provides it, why it is needed, its unit, when it is updated and who may see it.

Time

Keep four timestamps

Store when the value was observed, received, submitted and confirmed.

Data quality

Zero is not missing

Show if a value was measured, estimated, replaced, missing because of a sensor fault or not needed.

History

Keep every version

A correction creates a new confirmed version. Keep the earlier value, reason, person and time.

Information saved with every value

This helps operators, EDL and government teams see who provided each value, when it applies and whether it is confirmed.

Provider · provider_orgSource system · source_systemRecord type · record_typeHow entered · methodReading time · observation_timeForecast issued · issue_timeTime covered · valid_timeReceived time · received_atQuality · quality_codePossible range · uncertaintyVersion · revisionConfirmed by · certified_byConfirmation time · certified_atWho may see it · classification
Energy · current power and unit statusOperator web form or automatic SCADA / telemetry feed12 fields
Data fieldUnit / typeWhen updatedRequired / ownerWhy it is needed
Generating unit statusstatusAutomatic feed or important changeRequiredOnline, standby, outage, maintenance, condensing
Power made before project use (gross)MWAutomatic feedWhen relevantPower made before the project uses some of it
Power sent to the grid (net)MWAutomatic feedRequiredPower measured at the agreed grid meter
Energy made / energy sent to the gridMWh per interval15–60 minRequiredCompare energy made with energy sent to the grid
Energy used inside the projectMW, MWh15–60 minRequiredShow how much energy the project uses itself
Reactive power / voltage / frequencyMVAr, kV, HzAutomatic feedWhen relevantAutomatic grid-support readings; do not type by hand
Power available nowMWHourly / changeRequiredPower the operator says the project can safely provide
Power that is reduced or unavailableMWEventRequiredHow much power is unavailable and why
Ability to increase or reduce outputMW15–60 minRequiredHow much output can go up or down now
Water through turbines / usable water heightm³/s, mAutomatic feedRequiredConnect water use with electricity production
Start, stop, synchronization, triptimestampEventRequiredProject start, stop and trip history
Energy not produced and the reasonMW, MWh, codeEvent / intervalRequired when usedSeparate grid, water, environment and equipment causes
Energy · available power, next-day plan and fast responseOperator enters and confirms this in the web form12 fields
Data fieldUnit / typeWhen updatedRequired / ownerWhy it is needed
Installed and net maximum capacityMWSet once; update when changedRequiredApproved project and unit capability
Reliable power in wet / dry seasonMWSeasonalRequiredSeason-specific firm contribution
Lowest safe output / safe output rangeMWSet once; update when changedRequiredFeasible dispatch envelope
Lowest / highest available power by timeMWNext-day plan / updateRequiredDay-ahead supply declaration
Planned power by timeMW, MWhNext-day plan / updateRequired24–48 h expected production
Domestic commitment / export commitmentMW, MWhNext-day plan / contractWhen relevantPurpose-limited; contract owner validates
Energy available if EDL changes the planMWhDailyRequiredEDL operational flexibility
How fast output can increase or decreaseMW/minHourly / changeRequiredCurrent feasible ramp
Startup time / minimum up-down timemin, hSet once; update when changedRequired / conditionalCommitment feasibility
Backup power available and for how longMW, min or hNext-day plan / intradayWhen relevantOnly where applicable by arrangement
Black-start / synchronous condenserstatus, MW/MVArDaily / testWhen relevantRestoration and voltage support
Reason for a limit, its effect and confidencecode, MW, levelEach planRequiredReason and quality of declaration
Energy · outages, reliability and maintenanceOperator web form plus system calculations12 fields
Data fieldUnit / typeWhen updatedRequired / ownerWhy it is needed
Outage or reduced-power event IDUnique IDEventRequiredPersistent event identity
Type of eventplanned / maintenance / forced / gridEventRequiredStandard attribution
Start and actual / expected endtimestampEvent / updateRequiredDuration and return forecast
Affected unit and capacity lostID, MWEventRequiredSupply impact
Cause and responsible partycode + textEventRequiredFair responsibility attribution
Expected return time and confidencetimestamp, levelOn changeRequiredFuture supply planning
12-month outage calendarstart, end, MWMonthly / changeRequired12-month coordination
Service / reserve-shutdown / available hourshoursCalculated monthlyRequiredReliability basis
Planned / forced outage hourshoursCalculated monthlyRequiredAvailability metrics
Derating MW-hoursMW-hCalculated monthlyRequiredEquivalent capacity loss
Attempted / successful startscountEvent / monthlyRequiredStart reliability
Trips, MTBF and MTTRcount, hoursCalculated monthlyRequiredReliability trend
Energy · wet/dry supply, efficiency and sustainabilityOperator web form plus water data and system calculations13 fields
Data fieldUnit / typeWhen updatedRequired / ownerWhy it is needed
7-day generation forecastMWh/dayDailyRequiredNear-term supply outlook
1–3 month generation scenariosGWh/week or monthWeekly / monthlyRequiredLow, central and high cases
Dry-season firm energyGWhMonthly / seasonalRequiredEnergy security at agreed confidence
Wet-season expected energyGWhMonthly / seasonalRequiredAbsorption, spill and export planning
Energy that can be made from stored waterMWh / GWhCalculated dailyRequiredReservoir water expressed as energy
Planned reservoir use and filling by seasonlevel, storage, energyWeeklyRequiredWater-energy operating plan
Water or river-flow limit on energyMW, MWhWeekly / changeRequiredForecast impact by cause
Water through turbines and spillwaym³Calculated dailyRequiredWater use and opportunity analysis
Water used for each unit of energym³/MWhCalculated dailyRequiredEfficiency indicator within the project
Share of water energy changed into electricity%Interval / monthlyWhen relevantRequires calibrated head, flow and power
Auxiliary-load ratio / renewable delivery%, MWhDaily / monthlyRequiredNet productivity
Minimum river-flow requirement metstatus / %Daily / eventWhen relevantOperational sustainability
Site GHG intensity / certificationgCO₂e/kWh, statusAnnual / studyOptionalUse recognized site-specific method
Water · reservoir design and safe limitsApproved reference data from the operator or authority13 fields
Data fieldUnit / typeWhen updatedRequired / ownerWhy it is needed
Reservoir type, catchment and cascade ordercode, km², sequenceSet once; update when changedRequiredStorage, pondage or run-of-river logic
Location and water-level referenceGIS, datum/versionSet once; update when changedRequiredSpatial and vertical consistency
Table linking water level, area and storageversioned tablesSet once; update when changedRequiredNever replace with one capacity number
Dead / minimum / normal / maximum levelsm MSL, Mm³Set once; update when changedRequiredApproved operating bounds
Seasonal target water leveldate–level/storageSet once; update when changedRequiredTarget operating trajectory
Flood-control water-level limitsm MSL, Mm³Seasonal / changeWhen relevantRequired for storage reservoirs
Turbine / spillway / outlet capacity curvesm³/s vs head/gateSet once; update after a testRequiredPhysical release envelope
Table linking gate opening and water flowposition–flow tableSet once; update after a testRequiredConvert gate state to flow
Environmental minimum flowm³/s, seasonalSet once; update when changedRequiredEcological operating constraint
Limits on how fast water release may changem³/s/h, m/hSet once; update when changedRequiredSafety and environmental constraint
Downstream river stations and warning levelsIDs, m, m³/sSet once; update when changedRequiredAlert, alarm and danger context
Model of water movement and travel timemodel/versionCalibrate / changeRequired for cascadeFlow-dependent; not one fixed travel time
Operating manual / emergency-plan versiondocument IDsSet once; update when changedRequiredLegal and procedural traceability
Water · current reservoir condition and releasesOperator web form or automatic SCADA / telemetry feed16 fields
Data fieldUnit / typeWhen updatedRequired / ownerWhy it is needed
Reading time and how old the sensor data istimestamp, ageAutomatic feedRequiredSeparate observation from receipt time
Reservoir level / river level below the damm above named datumAutomatic feed or web-form readingRequiredReservoir state and head
Reservoir storage / surface areaMm³, km²Automatic or manual; system calculatedRequired / optionalApproved curve result
Measured or calculated water entering the reservoirm³/sAutomatic feed or web-form readingRequiredMethod must be stated
Local rainfall / tributary inflowsmm, m³/sAutomatic feedWhen relevantOperator-observed contributions
Evaporation / seepage / withdrawalsMm³/day, m³/sDailyWhen relevantWater-balance components
Turbine releasem³/sAutomatic feed or web-form readingRequiredEnergy and release balance
Spillway releasem³/sAutomatic feed or web-form readingRequiredFlood and energy impact
Water through the bottom outlet or bypassm³/sAutomatic feed or web-form readingRequiredComplete outflow
Environmental / fish passage releasem³/sAutomatic feed or web-form readingWhen relevantCompliance
Total releasem³/sAutomatic or manual; system checkedRequiredSum of all release components
Gate status and openingstatus, % or mAutomatic feed or important changeRequired restrictedOperational state, purpose limited
Release equipment and turbine availabilitystatusAutomatic feed or important changeRequiredMaximum feasible release
Current limit or emergency levelcode + textEventRequiredNormal, watch, warning, emergency
Water quality / sediment°C, DO, NTU, mg/LHourly / dailyWhen relevantLicence and sustainability monitoring
Data quality, possible range and reason for a changecodes / ± valueEvery valueRequiredTraceability and confidence
Water · forecast, release plan and coordinationOperator web form, official forecast and system calculations17 fields
Data fieldUnit / typeWhen updatedRequired / ownerWhy it is needed
Forecast provider and model versionIDsEach cycleRequiredOperator and official forecasts stay distinct
When the forecast was made and the time it coverstimestamps, hoursEach cycleRequiredWhich forecast was used
Forecast inflow series / peak / volumem³/s, Mm³Each cycleRequiredP10/P50/P90 or ensemble
Official rainfall forecastmm, probabilityEach cycleRequiredAuthority-owned input
Upstream release plan and expected arrivalm³/s, timestamp rangePlan / eventRequired for cascadeRouted cascade coordination
Target level / storagem MSL, Mm³Plan / eventRequiredOperator end-of-horizon target
Planned turbine / spill / bypass profilem³/s by timePlan / eventRequiredRelease intent
Plan start / end / ramp ratetimestamps, m³/s/hPlan / eventRequiredExecution envelope
Reason for an early releasecode + textEventRequired during eventReason for proposal
Extra water in the early releaseMm³EventRequired during eventPlan above baseline
No-change case and other choicesversioned IDsEventRequired during eventTransparent comparison
Expected storage / space for floodwaterMm³, %Cycle / planCalculatedForward reservoir condition
Downstream flow, water level and arrival timem³/s, m, time rangeEventCalculatedCalibrated routing/hydraulic model
Chance of passing a warning level%EventCalculatedChance of passing a warning level
Energy consequenceMW, MWhEventCalculatedImported from energy module
Plan, decision and notice statusworkflow statesEventRequiredVersioned accountability
Actual release compared with approved planm³/s deviationAutomatic feed during an eventRequiredExecution monitoring
Data from EDL and government agencies · not entered by the operatorEDL and water-authority data14 fields
Data fieldUnit / typeWhen updatedRequired / ownerWhy it is needed
Current and expected electricity demandMW, MWhHourly / Next-day planEDLSupply-demand balance
Peak demand and uncertaintyMW, timestamp, rangeDaily / seasonalEDLAdequacy and scenario analysis
Available power from all energy sourcesMW, MWhHourly / dailyEDLNational system—not hydro alone
EDL generation plans and instructionsMW by intervalNext-day plan / intradayEDLPlan-performance attribution
Backup power needed and availableMWAutomatic feed / hourlyEDLOperational security
Imports, exports and transfer limitsMW, MWhHourly / changeEDLNet balance and deliverability
Power-line outages and limitsequipment, MWEventEDLGrid constraint attribution
Losses, load shedding and unserved energy%, MWhDaily / eventEDLReliability outcome
Power available to EDL under contractsMW / MWhNext-day plan / contractEDL / contract ownerSeparate from technical availability
Official rainfall / river forecastseries + uncertaintyForecast cycleAuthorized authorityNational forecast remains official
National and MRC gauge observationsm, m³/sAutomatic feed / cycleAuthorized authorityBasin and transboundary context
Downstream warning levels and places at riskm, m³/s, GISSet once; update when changedWater authorityImpact assessment
Official event level / coordination rulesstatus / protocolEvent / changeDesignated authorityActions and legal basis
Dry-season allocation / flow objectivem³/s, volumeSeasonalDesignated authorityWater-security target

Recommended first version for operators

Start with the information needed for the pilot. More advanced fields can be added later.

1Operators enter and confirm available power, the next-day plan, outages, limits and expected return dates in the web form.
2Actual MW, MWh, unit status and water readings may also arrive automatically from SCADA or telemetry.
3Collect reservoir level and storage, inflow, turbine water, spillway water, other releases and the planned release.
4Keep the data source, time, quality, confidence, confirmation, version and full change history.

Main calculated indicators

Use the official NERC and IEEE definitions for formal hydropower project availability and reliability reports.

Power left after demandUsable supply − demand − required backup
Share of possible energy producedNet MWh ÷ (maximum MW × hours)
Water used for each unit of energyWater through turbines ÷ net MWh
Total releaseTurbine + spill + bypass + other
Space for floodwaterApproved flood target − current storage
Difference from release planActual release − approved release

Standards and reference sources

International standards guide the design. Lao institutions must approve local definitions, limits and responsibilities.