schema-aggregator

EnergyResourceNetwork

Typed energy resource schema for grid-network infrastructure: distribution transformers (DT), busbars (BUS), feeders (FEEDER), and microgrids (MICROGRID). These resources act as topology anchors in the EnergyResource graph — meters and DERs hang behind them via parentResources[].

EnergyResourceNetwork is one of the seven composable kinds that make up EnergyResource in the ElectricityCredential.

Canonical IRI: https://schema.nfh.global/EnergyResourceNetwork/v1.0

CIM alignment: cim:PowerTransformer (DT), cim:BusbarSection (BUS), cim:Feeder (FEEDER), cim:Substation (MICROGRID) — IEC 61970-301

Tags: energy-resource · network · grid · infrastructure · energy · deg


Versions

Version Status Notes
v1.0 Current Initial typed kind for grid-network infrastructure, extracted from ElectricityCredential/v1.2. Adds nominalVoltageKv, zone, substationId, feederCode fields.

Type discriminators

type value CIM class Description
DT cim:PowerTransformer Distribution transformer
BUS cim:BusbarSection Busbar section
FEEDER cim:Feeder (EquipmentContainer) Distribution feeder
MICROGRID cim:Substation / custom container Microgrid or substation boundary

Properties (v1.0)

Common (EnergyResourceCommonAttributes)

Property Type Description
make string Manufacturer name
model string Model number
ratedPowerKw number ≥0 Nameplate peak power capacity, kW
maxExportKw number ≥0 Maximum grid export capacity, kW
maxImportKw number ≥0 Maximum grid import capacity, kW
telemetryProvider string Vendor API / data-source for telemetry
commissioningDate string (date) ISO 8601 commissioning date
location object Physical location — {geo: GeoJSONGeometry, address: Address}

Network-specific

Property Type CIM alignment Description
nominalVoltageKv number ≥0 BaseVoltage.nominalVoltage Nominal operating voltage, kV
zone string Operating zone / region identifier
substationId string Parent substation identifier per utility records
feederCode string Feeder code per utility records (relevant for FEEDER and DT)

Usage

For full property tables and worked examples, see v1.0/README.md.