{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://solaranalytica.com/network-headroom/schema.json","title":"Northern Powergrid headroom snapshot","type":"object","additionalProperties":false,"required":["schemaVersion","version","source","records"],"properties":{"schemaVersion":{"const":1},"version":{"const":"northern-powergrid-headroom-v1"},"source":{"type":"object","required":["publisher","datasetUrl","metadataUrl","dataProcessedAt","retrievedAt","rawSha256","metadataSha256","licence","licenceUrl","attribution","intendedCadence","knownLimits"],"properties":{"publisher":{"type":"string"},"datasetUrl":{"type":"string","format":"uri"},"metadataUrl":{"type":"string","format":"uri"},"dataProcessedAt":{"type":"string","format":"date-time","description":"Publisher processing timestamp, not an observation or release date."},"retrievedAt":{"type":"string","format":"date-time"},"rawSha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"metadataSha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"licence":{"type":"string"},"licenceUrl":{"type":"string","format":"uri"},"attribution":{"type":"string"},"intendedCadence":{"type":"string"},"knownLimits":{"type":"array","items":{"type":"string"}}}},"records":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["key","name","level","voltageKv","generationHeadroomMw","demandHeadroomMva","firmCapacityMva","acceptedGenerationMw","localGenerationFlag","upstreamGenerationFlag","transmissionFlag","worstCaseGenerationFlag","upstreamSubstation","gspName","latitude","longitude","rawSource"],"properties":{"key":{"type":"string","description":"Local snapshot identity from source name, level and voltage; not a stable publisher ID."},"name":{"type":"string"},"level":{"enum":["Primary","Supply Point","GSP"]},"voltageKv":{"type":["number","null"],"description":"Downstream voltage, kV."},"generationHeadroomMw":{"type":["number","null"],"description":"Publisher genhr, indicative thermal generation headroom, MW. Not usable connection capacity."},"demandHeadroomMva":{"type":["number","null"],"description":"Publisher demhr, thermal demand headroom, MVA."},"firmCapacityMva":{"type":["number","null"],"description":"Publisher firm_cap, MVA."},"acceptedGenerationMw":{"type":["number","null"],"description":"Publisher gentot, MW."},"localGenerationFlag":{"type":["string","null"]},"upstreamGenerationFlag":{"type":["string","null"]},"transmissionFlag":{"type":["string","null"],"description":"Literal publisher gsp_hm_constraint_manual; no connection date inferred."},"worstCaseGenerationFlag":{"type":["string","null"],"description":"Literal publisher worst-case flag, full scope unverified."},"upstreamSubstation":{"type":["string","null"]},"gspName":{"type":["string","null"]},"latitude":{"type":["number","null"],"minimum":-90,"maximum":90},"longitude":{"type":["number","null"],"minimum":-180,"maximum":180},"rawSource":{"type":"object","required":["psp_name","grid_easting","grid_northing","typetable","pvoltage","firm_cap","mindemand","maxdemand","rpf","gentot","demtot","genhr","demhr","fl_break_d","fl_break_r","fl_make_d","fl_make_r","fl","worst_tap","gen_voltage_constraint","upgenconst","dem_voltage_constraint","gsp_hm_constraint_manual","odp_primary_name","updemconst","upstreamname","gsp_name","genconstraint","demconstraint","worst_case_constraint_gen_colour","worst_case_constraint_dem_colour","substation_location","fault_level_"],"minProperties":33,"maxProperties":33,"description":"All 33 original publisher fields, without value conversion. Definitions are supplied by the linked publisher metadata."}}}}},"x-solar-analytica-geography":"Northern Powergrid EHV/HV region only. No feeder, postcode or customer coverage inferred.","x-solar-analytica-analysis-rule":"Keep MW and MVA separate. Never sum nested network capacity. Exact name links are not verified topology. Observation window and revisions unknown."}