Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International (CC BY-NC-ND 4.0) Copyright (c) 2026 Nick Hedley You are free to: Share — copy and redistribute the material in any medium or format, for non-commercial purposes, with attribution. Under the following terms: Attribution — You must give appropriate credit, provide a link to the licence, and indicate if changes were made. NonCommercial — You may not use the material for commercial purposes without explicit written permission from the copyright holder. NoDerivatives — If you remix, transform, or build upon the material, you may not distribute the modified material without explicit written permission from the copyright holder. The model logic, calibration, cost assumptions, code and presentation are (c) 2026 Nick Hedley and licensed under CC BY-NC-ND 4.0: you may share them with attribution for non-commercial purposes; commercial use or distributing modified versions needs written permission. Our compilations of public facts (project names, capacities, technologies, locations and dates) are licensed under CC BY 4.0. Files derived from other people's data carry the most restrictive terms among their inputs, stated in each file and listed below: Eskom's website terms for Eskom-derived data (non-commercial; publication needs Eskom's consent, which has been requested); NTCSA's website terms for GCCA-derived data (non-commercial; publication needs NTCSA's consent); CC BY-NC 4.0 for Renewables.ninja-derived profiles; and PyPSA-RSA's AGPL-3.0-or-later, whose terms for our use are being confirmed with Meridian. Analysis derived from Eskom data is ours, not Eskom's. (Wording approved by Nick Hedley, 20 Oct 2026, message 261 (2).) Files in public_data/ and in the repository's root that carry no licence field of their own are CC BY-NC-ND 4.0, except any derived from the sources listed below, which carry that source's terms (message 267 (2)). Full licence text: https://creativecommons.org/licenses/by-nc-nd/4.0/legalcode For commercial licensing enquiries about the original work described above, contact the author via the repository. Such a licence covers only that work: it cannot cover third-party data, including NTCSA's GCCA data (see below), which stays under its own terms. --- Data sources incorporated in this repository carry their own licences: - Eskom hourly data (ESK19679 and ESK19243, obtained from the Eskom Data Portal on request; and Eskom's 2021 CSP profile, via PyPSA-RSA): no licence of their own, so Eskom's website terms and the Data Portal disclaimer apply: personal, educational or non-commercial use only; no reproduction, distribution or publication without Eskom's written consent, which has been requested. The raw files are not in this repository; profiles.json and nodal/coal_availability_trace.json hold series derived from them, to be replaced with open versions. - UCT ESRG Single Node Hourly Demand Model (Bruno Merven, ZivaHub): https://doi.org/10.25375/uct.24137877 – CC BY 4.0 - PyPSA-RSA network topology and fleet data (Meridian Economics): https://github.com/MeridianEconomics/pypsa-rsa; AGPL-3.0-or-later. Its own data-licence table puts its supply-region boundaries under the GCCA's terms (BY-NC-SA). The terms for our use are being confirmed with Meridian. The PyPSA library used in validation/ is MIT. The unit fleet tables inside index.html (UC_FLEET and MIP_FLEET) are derived from PyPSA-RSA's fleet data and come under these terms. - PVGIS-SARAH2 and SARAH3 solar data: European Commission JRC – open access - Renewables.ninja wind profiles: Pfenninger & Staffell – CC BY-NC 4.0 - REIPPPP project data (IPP Office, DMRE): no open licence. The IPP Office website terms (May 2016) reserve copyright in the site's contents (clause 7.1) and prohibit their unauthorised use (clause 7.2). Used here: project facts (name, capacity, technology, location, dates) and figures cited from IPP Office reports, credited. - GCCA 2025 connection capacity data and supply-area boundaries (NTCSA): NTCSA website terms (June 2024, clauses 2.1, 2.2 and 3.1): non-commercial use only; publication needs NTCSA's written consent. --- Data files and their licences (generated by harness/licence_list.js from each file's own metadata; do not edit by hand) --- - profiles.json: Eskom Holdings SOC Ltd, hourly dataset ESK19679 (obtained on request): terms under review; not CC BY. - nodal/bq_queue.json: NTCSA website terms (June 2024, clauses 2.1, 2.2 and 3.1): non-commercial use only; publication needs NTCSA's written consent. - nodal/coal_availability_trace.json: Eskom Holdings SOC Ltd, hourly dataset ESK19679 (obtained on request): terms under review; not CC BY. - nodal/corridor_electrical.json: NTCSA website terms (June 2024, clauses 2.1, 2.2 and 3.1): non-commercial use only; publication needs NTCSA's written consent (to be requested). Derived from NTCSA's transmission lines (nodal/transmission_lines.geojson). Changed from CC BY-NC-ND 4.0 on 20 Oct 2026 (D3, message 261 (2)). - nodal/demand_2025_regional.csv: under that source's terms (MIT for the repository; the split rests on Eskom provincial transformer data, terms to be confirmed); no licence of our own - nodal/eskom_tariff_components.json: CC BY 4.0 - https://creativecommons.org/licenses/by/4.0/ - nodal/firm_headroom_lookup.json: NTCSA website terms (June 2024, clauses 2.1, 2.2 and 3.1): non-commercial use only; publication needs NTCSA's written consent. - nodal/fleet_units.csv: under the source's terms (PyPSA-RSA); no licence of our own - nodal/headroom_summary.json: NTCSA website terms (June 2024, clauses 2.1, 2.2 and 3.1): non-commercial use only; publication needs NTCSA's written consent. - nodal/ipp_pipeline.json: CC BY 4.0 - https://creativecommons.org/licenses/by/4.0/ . Changed from CC BY-NC-ND on 6 Sep 2026: this file is a compilation of uncopyrightable facts (project name, MW, technology, location, COD), so nothing upstream constrains the licence, and NC-ND blocked both reuse by researchers and ingestion of BY-SA sources such as PowerTracker. - nodal/nersa_registrations.json: CC BY 4.0 - https://creativecommons.org/licenses/by/4.0/ . Changed from CC BY-NC-ND on 6 Sep 2026: this file is a compilation of uncopyrightable facts (project name, MW, technology, location, COD), so nothing upstream constrains the licence, and NC-ND blocked both reuse by researchers and ingestion of BY-SA sources such as PowerTracker. - nodal/pfl_cod_h1_2026.json: CC BY 4.0 - https://creativecommons.org/licenses/by/4.0/ . Attribution required; reuse, modification and commercial use permitted. Cite as GridTwin ZA, gridtwinza.org. Added 6 Sep 2026: this file had no licence field, which meant anyone downloading it had to guess, and the safe guess is "all rights reserved". - nodal/pfl_private_h1_2026.json: CC BY 4.0 - https://creativecommons.org/licenses/by/4.0/ . Attribution required; reuse, modification and commercial use permitted. Cite as GridTwin ZA, gridtwinza.org. Added 6 Sep 2026: this file had no licence field, which meant anyone downloading it had to guess, and the safe guess is "all rights reserved". - nodal/phes_sites_region.json: CC BY 4.0. Derived from the ANU RE100 Group Global Pumped Hydro Atlas, South Africa shortlist (public_data/anu_phes_shortlist_za.csv); attribution required. - nodal/private_grid_candidates.json: CC BY 4.0 - https://creativecommons.org/licenses/by/4.0/ . A compilation of public facts from DFFE's environmental authorisation register (project name, capacity, technology, location, dates), as public_data/environmental_authorisations.csv. Changed from CC BY-NC-ND 4.0 on 20 Oct 2026 (D3, message 261 (2)). - nodal/private_pending_h2_2026.json: CC BY 4.0 - https://creativecommons.org/licenses/by/4.0/ - nodal/profiles.json: Eskom Holdings SOC Ltd, hourly dataset ESK19679 (obtained on request): terms under review; not CC BY. - nodal/profiles_multiyear_OLD_backup.json: CC BY-NC-ND 4.0 - https://creativecommons.org/licenses/by-nc-nd/4.0/ - nodal/profiles_offshore_regional.json: CC BY-NC-ND 4.0 - https://creativecommons.org/licenses/by-nc-nd/4.0/ - nodal/profiles_regional.json: CC BY-NC 4.0 - https://creativecommons.org/licenses/by-nc/4.0/ . Derived from Renewables.ninja (CC BY-NC 4.0), whose terms it carries: attribution required, non-commercial use only. Cite as GridTwin ZA, gridtwinza.org, and Renewables.ninja (Pfenninger and Staffell). Changed from CC BY 4.0 on 20 Oct 2026 (D3, message 261 (2)). - nodal/profiles_regional_SINGLECENTROID_backup.json: CC BY 4.0 - https://creativecommons.org/licenses/by/4.0/ - nodal/profiles_regional_multiyear.json: CC BY-NC-ND 4.0 - https://creativecommons.org/licenses/by-nc-nd/4.0/ - nodal/profiles_solar_tracking.json: CC BY-NC-ND 4.0 - https://creativecommons.org/licenses/by-nc-nd/4.0/ - nodal/profiles_solar_tracking_map.json: CC BY-NC-ND 4.0 - https://creativecommons.org/licenses/by-nc-nd/4.0/ - nodal/profiles_wind_modern.json: CC BY-NC-ND 4.0 - https://creativecommons.org/licenses/by-nc-nd/4.0/ - nodal/profiles_wind_modern_map.json: CC BY-NC-ND 4.0 - https://creativecommons.org/licenses/by-nc-nd/4.0/ - nodal/project_register.json: DERIVED DATA UNDER MIXED TERMS - not the CC BY-NC-ND 4.0 that covers GridTwin's own files, and the difference matters. - nodal/provincial_mix.json: CC BY-NC-ND 4.0 - nodal/pvc_metered.json: CC BY-NC-ND 4.0 - https://creativecommons.org/licenses/by-nc-nd/4.0/ - nodal/redz.json: CC BY 4.0 - https://creativecommons.org/licenses/by/4.0/ . Changed from CC BY-NC-ND on 6 Sep 2026: this file is a compilation of uncopyrightable facts (project name, MW, technology, location, COD), so nothing upstream constrains the licence, and NC-ND blocked both reuse by researchers and ingestion of BY-SA sources such as PowerTracker. - nodal/reea_projects.json: CC BY 4.0 - https://creativecommons.org/licenses/by/4.0/ . Changed from CC BY-NC-ND on 6 Sep 2026: this file is a compilation of uncopyrightable facts (project name, MW, technology, location, COD), so nothing upstream constrains the licence, and NC-ND blocked both reuse by researchers and ingestion of BY-SA sources such as PowerTracker. - nodal/region_headroom_lookup.json: NTCSA website terms (June 2024, clauses 2.1, 2.2 and 3.1): non-commercial use only; publication needs NTCSA's written consent. - nodal/regional_renewable_capacity.json: CC BY 4.0 - https://creativecommons.org/licenses/by/4.0/ . Changed from CC BY-NC-ND on 6 Sep 2026: this file is a compilation of uncopyrightable facts (project name, MW, technology, location, COD), so nothing upstream constrains the licence, and NC-ND blocked both reuse by researchers and ingestion of BY-SA sources such as PowerTracker. - nodal/residential_profile.json: Derived from Eskom's Distribution Pre-Electrification Tool (DPET) output. Eskom's website terms apply: personal, educational or non-commercial use only; Eskom's written consent to publish has been requested (October 2026). Shape only; the analysis is ours, not Eskom's. To be replaced with an open household shape after the note. - nodal/rooftop_mw_by_region.json: CC BY 4.0 - https://creativecommons.org/licenses/by/4.0/ . Changed from CC BY-NC-ND on 6 Sep 2026: this file is a compilation of uncopyrightable facts (project name, MW, technology, location, COD), so nothing upstream constrains the licence, and NC-ND blocked both reuse by researchers and ingestion of BY-SA sources such as PowerTracker. - nodal/rooftop_ntcsa_2026.json: CC BY 4.0 - https://creativecommons.org/licenses/by/4.0/ ; attribution GridTwin ZA; NTCSA figures as published by Eskom/NTCSA - nodal/sa_solar_grid.json: CC BY 4.0 - https://creativecommons.org/licenses/by/4.0/ . Attribution required; reuse, modification and commercial use permitted. Cite as GridTwin ZA, gridtwinza.org. Added 6 Sep 2026: this file had no licence field, which meant anyone downloading it had to guess, and the safe guess is "all rights reserved". - nodal/substation_bands.json: NTCSA website terms (June 2024, clauses 2.1, 2.2 and 3.1): non-commercial use only; publication needs NTCSA's written consent. - nodal/substations_compact.json: GCCA-derived content (NTCSA GCCA 2025 GIS): NTCSA website terms (June 2024, clauses 2.1, 2.2 and 3.1): non-commercial use only; publication needs NTCSA's written consent. Other sources: as in the source field, on their own terms. - nodal/supply_area_split_draft.json: CC BY-NC-ND 4.0 - https://creativecommons.org/licenses/by-nc-nd/4.0/ - nodal/tdp_projects.json: NTCSA website terms (June 2024, clauses 2.1, 2.2 and 3.1): non-commercial use only; publication needs NTCSA's written consent. - nodal/transmission_lines.geojson: TDP-derived content (Eskom, now NTCSA, Transmission Development Plan): NTCSA website terms (June 2024, clauses 2.1, 2.2 and 3.1): non-commercial use only; publication needs NTCSA's written consent. SAPP planning data stays under SAPP's own terms. - nodal/wind_corr_table.json: Calibration constants fitted to Eskom Holdings SOC Ltd, hourly dataset ESK19679 (obtained on request): terms under review; not CC BY. Published as derived calibration constants with Eskom credited; no Eskom hourly series is in this file. --- End of the generated list --- Users are responsible for complying with the terms of each upstream data source.