Resources¶

A Resource is a physical electrical asset registered in the platform — a generator, battery, EV charger, water heater, or general consumption/production installation. Resources:

Are always associated with a meter (CPE or internal)
Are owned by one or more members (fractional ownership supported)
Can receive setpoints from the energy management system (OSTEC)
Are the unit of granularity for settlement results

Resource Types¶

Type	Direction	Description
`IU`	Consume + Generate	Utilization Installation — generic prosumer unit (e.g. household with PV panels). Most common type for aggregated entities
`IC`	Consume only	Consumption Installation — consumer-only unit (e.g. household without generation)
`SCPU`	Generate only	Self-Consumption Production Unit — dedicated generation asset (PV plant)
`STORAGE`	Consume + Generate	Battery Storage — supports charge/discharge (Li-ion, VRFB, etc.)
`EV`	Consume (+ Generate if V2G)	Electric Vehicle — EV charger, with optional Vehicle-to-Grid capability
`EWH`	Consume only	Electric Water Heater — controllable thermal storage

Resource-Specific Fields¶

IU / IC (Utilization & Consumption Installations)SCPU (Solar PV)STORAGE (Battery)EV (Electric Vehicle)EWH (Electric Water Heater)

Field	Unit	Required	Description
`sum_certified_power`	kW	✅	Sum of all installed power across the assets that make up the unit
`ic_voltage_level`	—	✅	Voltage level of the resource (`MAT`, `AT`, `MT`, `BT`)

Field	Unit	Required	Description
`generation_capacity`	kW	✅	Nominal installed generation capacity

Field	Unit	Required	Description
`nominal_capacity`	kWh	—	Total energy the battery can store
`max_power`	kW	✅	Maximum instantaneous charge/discharge power
`charging_efficiency`	%	—	Charging efficiency (battery + inverter)
`discharging_efficiency`	%	✅	Discharging efficiency (battery + inverter)
`min_SOC`	%	—	Minimum admissible state-of-charge
`max_SOC`	%	—	Maximum admissible state-of-charge
`deg_cost`	€/kWh	—	Degradation cost per kWh discharged (relevant for Li-ion)

Field	Unit	Required	Description
`nominal_capacity`	kWh	—	Total EV battery capacity
`max_power`	kW	✅	Maximum charge/discharge power
`charging_efficiency`	%	—	Charging efficiency
`discharging_efficiency`	%	—	Discharging efficiency (V2G)
`min_SOC`	%	—	Minimum state-of-charge
`max_SOC`	%	—	Maximum state-of-charge
`desired_min_SOC`	%	—	Minimum SOC the EV must retain at end of charging session
`deg_cost`	€/kWh	—	Degradation cost per kWh discharged

Field	Unit	Required	Description
`power`	kW	✅	Rated heater power
`capacity`	kWh	—	Total thermal energy storage capacity
`max_temp`	°C	—	Maximum water storage temperature
`default_start_temp`	°C	—	Temperature at which the thermostat activates heating
`target_temp`	°C	—	Temperature at which the thermostat deactivates

Ownerships¶

A resource can be owned by multiple members (fractional ownership). The Ownership model records the percentage each member owns of a resource for settlement purposes.

graph LR
    R[Resource: Solar PV] -->|70%| M1[Member A]
    R -->|30%| M2[Member B]

Any compensation—whether paid or received—resulting from a transaction is allocated to the members who own the resource, in proportion to their ownership shares.

RESP (Public Grid) Configuration¶

By default, the platform assumes every pair of CPEs is interconnected through the public grid (RESP). Some pairs — such as those within an industrial park — may also be connected through a private grid.

When two CPEs are connected only through RESP, any energy exchanged between them is subject to the self-consumption grid access tariff. It is important to correctly identify which pairs rely solely on the public grid.