K-HELM: Municipal Electricity Demand by Hour and End Use in Korea, 2004–2050

K-HELM (Korean Hourly End-use Load by Municipality) provides electricity-demand data for 229 Korean local units from 2004 to 2050, resolved by municipality, hour of day and end use. The spatial coverage comprises Korea’s 226 autonomous municipalities, Sejong and Jeju’s two administrative cities. Historical files distinguish residential, industrial and commercial-and-other demand; projection files add the post-2025 increase in transport electricity as a separate fourth end use. This is version 2.0 of the record previously published as K-DEMOS. Historical demand is reconstructed by combining four official sources: KEPCO municipal billing statistics determine monthly demand by municipality and end use; KOSIS load-research profiles distribute that demand across hours of the day; KPX system-load metering supplies the observed national hourly chronology for 2024–2025; and KMA station temperatures represent regional weather responses. The reconstruction preserves the source regional-by-end-use accounting with a national mean absolute percentage error of 0.13% and matches the KPX-metered national load in every observed hour. For 2004–2023, K-HELM provides a representative 24-hour demand profile for each municipality, month and end use. Both these monthly profiles and full chronological hourly files are provided for 2024–2025. From 2026 to 2050, chronological hourly projections are available for every year. Future national demand follows GCAM v9.1 end-use growth under a Reference scenario and a net-zero CO₂ scenario in which Korea and the rest of the world each reach net-zero energy and industrial CO₂ emissions by 2050. Separate adjustments allocate the post-2025 increase in transport electricity across municipalities and hours, shift additional electric-heating demand toward colder days, and add the demand response to regional temperature change under SSP2-4.5 and SSP3-7.0. Under the net-zero CO₂ scenario, electrified heating raises the winter peak above the summer peak from 2040 onward. Changes in version 2.0 Version 2.0 accompanies peer review of the companion manuscript and supersedes version 1.0. The principal changes are: - The dataset is renamed from K-DEMOS to K-HELM. - The net-zero CO₂ scenario now uses separate carbon markets for Korea and the rest of the world, requiring both to reach net-zero energy and industrial CO₂ emissions by 2050. Net-zero filenames carry the suffix _NZCO2_KR2050. - An interpolation error affecting projection years between the five-year GCAM anchor years in version 1.0 has been corrected. - The 2024–2025 files now reproduce the KPX national load exactly in every hour. - Projected temperature change is resolved across Korea’s 17 first-level administrative regions. - The dataset license changes from CC BY-NC 4.0 to CC BY 4.0. Files The record contains five data archives and one pipeline archive. Each archive includes its own README and license file, allowing users to download only the scenario branch they need. - K-HELM_v2.0_core.zip (69 MB) — monthly demand profiles for 2004–2025 in CSV format; the incremental EV-charging layer for both energy-system scenarios in Parquet format; and the national accounting ledgers, climate adjustments, regional warming anchors and original five-year model outputs. - K-HELM_v2.0_hourly_reference_ssp245.zip (1.3 GB) — chronological hourly files for observed 2024–2025 demand and the Reference scenario with SSP2-4.5. - K-HELM_v2.0_hourly_reference_ssp370.zip (1.2 GB) — chronological hourly projections for the Reference scenario with SSP3-7.0. - K-HELM_v2.0_hourly_netzero_ssp245.zip (1.2 GB) — chronological hourly projections for the net-zero CO₂ scenario with SSP2-4.5. - K-HELM_v2.0_hourly_netzero_ssp370.zip (1.2 GB) — chronological hourly projections for the net-zero CO₂ scenario with SSP3-7.0. - K-HELM_v2.0_pipeline.zip (0.9 MB) — the complete processing pipeline and figure-generation code under the MIT License. It includes the GCAM v9.1 scenario configurations and exported query results, allowing the dataset to be reproduced from source retrieval through final outputs without a local GCAM installation. The README documents the file schema, English column aliases, day-type and leap-year conventions, and the distinction between the KEPCO sales and KPX metered-load accounting bases. The dataset is released under CC BY 4.0, and the processing pipeline is released under the MIT License. The dataset is described in a companion manuscript currently in revision at GEO DATA.