CELINE Core Ontology
type: Ontology
version IRI: v0.4
imports: peco-core
imports: bigg4kpi.ttl
imports: ontology.ttl
imports: sosa.ttl
imports: saref.ttl
imports: saref4ener.ttl
created: 2026-03-24
description: The CELINE Core Ontology is a lightweight orchestration profile for Renewable Energy Communities (RECs) and Digital Twin workflows. It connects established standards — PECO, SAREF, SAREF4ENER, SOSA/SSN and BIGG — without redefining their domain semantics, providing a minimal coordination layer for simulation scenarios, dataset references, KPI evaluation, and REC flexibility commitment and settlement.
license: https://creativecommons.org/licenses/by/4.0/
preferred namespace prefix: celine
preferred namespace uri: https://w3id.org/celine-eu#
prior version: v0.3
version info: 0.4

committed by
type: ObjectProperty
domain: Flexibility Commitment
range: Energy community member

credit for
type: ObjectProperty
inverse of: generates credit
domain: Flexibility Credit
range: Flexibility Commitment

earned by
type: ObjectProperty
domain: Flexibility Credit
range: Energy community member

envelope for
type: ObjectProperty
domain: Flexibility Envelope
range: Electric POD
comment: The POD whose physical and operational flexibility is described by this envelope.

evaluates KPI
type: ObjectProperty
domain: KPI Evaluation
range: KPI

evidenced by
type: ObjectProperty
domain: Flexibility Credit
range: Observation
comment: SOSA observation(s) that meter the actual flexibility delivered, grounding the credit in measured data.

generates credit
type: ObjectProperty
domain: Flexibility Commitment
range: Flexibility Credit

has availability window
type: ObjectProperty
domain: Flexibility Envelope
range: Interval
comment: Time window(s) during which the flexibility declared in this envelope is available for activation.

has flexibility commitment
type: ObjectProperty
domain: Community Context
range: Flexibility Commitment

has commitment mode
type: ObjectProperty
domain: Flexibility Commitment
range: Concept
comment: Expected values: celine:Automated or celine:Voluntary.

has energy community
type: ObjectProperty
domain: Community Context
range: EnergyCommunity

has constraint
type: ObjectProperty
domain: Flexibility Envelope
range: Flexibility Constraint
comment: One or more operational constraints bounding how flexibility in this envelope may be activated.

has constraint type
type: ObjectProperty
domain: Flexibility Constraint
range: Concept
comment: Expected values: celine:DurationConstraint, celine:NoticeConstraint, celine:RecoveryConstraint, celine:FrequencyConstraint.

has cost item
type: ObjectProperty
domain: Settlement Run
range: Cost Item

has cost type
type: ObjectProperty
domain: Cost Item
range: Concept
comment: Expected values: celine:AdminCost, celine:Fee, or celine:Debt.

has flexibility envelope
type: ObjectProperty
domain: Community Context
range: Flexibility Envelope
comment: Links a CommunityContext to the declared flexibility capability envelopes of its PODs.

has flexibility direction
type: ObjectProperty
domain: Flexibility Commitment
range: Concept
comment: Expected values: celine:FlexDown or celine:FlexUp.

has KPI evaluation
type: ObjectProperty
domain: Simulation Run
range: KPI Evaluation

has redistribution result
type: ObjectProperty
domain: Settlement Run
range: Redistribution Result

has scenario
type: ObjectProperty
domain: Simulation
range: Scenario

has settlement run
type: ObjectProperty
domain: Community Context
range: Settlement Run

has simulation
type: ObjectProperty
domain: Community Context
range: Simulation

has simulation run
type: ObjectProperty
domain: Simulation
range: Simulation Run

has time interval
type: ObjectProperty
range: Interval

on POD
type: ObjectProperty
domain: Flexibility Commitment
range: Electric POD
comment: One or more delivery points through which the committed flexibility is provided.

produces dataset
type: ObjectProperty
domain: Simulation Run
range: Dataset Reference

result for
type: ObjectProperty
domain: Redistribution Result
range: Energy community member

settles context
type: ObjectProperty
inverse of: has settlement run
domain: Settlement Run
range: Community Context

uses asset
type: ObjectProperty
domain: Community Context
range: Device
comment: References SAREF or SAREF4ENER devices.

uses dataset
type: ObjectProperty
domain: Simulation Run
range: Dataset Reference

uses observation
type: ObjectProperty
domain: Simulation Run
range: Observation
comment: References SOSA observations (e.g. weather, sensors).

within envelope
type: ObjectProperty
domain: Flexibility Commitment
range: Flexibility Envelope
comment: The FlexibilityEnvelope from which this commitment draws; commitment amounts must not exceed envelope bounds.

available energy
type: DatatypeProperty
domain: Flexibility Envelope
range: decimal
comment: Total energy available for flexibility delivery within the availability window (kWh).

conversion rate
type: DatatypeProperty
domain: Settlement Run
range: decimal
comment: Monetary value per kWh of flexibility credit (e.g., EUR/kWh). Applied uniformly to all members in this settlement period.

cost amount
type: DatatypeProperty
domain: Cost Item
range: decimal
comment: Monetary amount of this cost voice, in the currency of the enclosing SettlementRun.

cost deduction
type: DatatypeProperty
domain: Redistribution Result
range: decimal
comment: Member's allocated share of the total SettlementRun CostItems.

credit amount
type: DatatypeProperty
domain: Flexibility Credit
range: decimal
comment: Flexibility actually delivered, in kWh. May be less than or equal to the commitment's targetFlexibility.

credit balance
type: DatatypeProperty
domain: Redistribution Result
range: decimal
comment: Total flexibility credits (kWh) accumulated by this member in the settlement period.

currency
type: DatatypeProperty
domain: Settlement Run
range: string
comment: ISO 4217 currency code for all monetary amounts in this settlement (e.g., 'EUR').

gross amount
type: DatatypeProperty
domain: Redistribution Result
range: decimal
comment: Monetary value of the member's credit balance before cost deductions (creditBalance × conversionRate).

max activation duration
type: DatatypeProperty
domain: Flexibility Constraint
range: duration
comment: Maximum duration for which a flexibility activation may be maintained (ISO 8601 duration, e.g. PT4H).

max activations per day
type: DatatypeProperty
domain: Flexibility Constraint
range: integer
comment: Maximum number of flexibility activation events permitted within a 24-hour period.

max flex down
type: DatatypeProperty
domain: Flexibility Envelope
range: decimal
comment: Maximum downward flexibility available from this envelope (kW). Positive value; represents decrease in net load or increase in local generation.

max flex up
type: DatatypeProperty
domain: Flexibility Envelope
range: decimal
comment: Maximum upward flexibility available from this envelope (kW). Positive value; represents increase in net load or decrease in local generation.

min activation duration
type: DatatypeProperty
domain: Flexibility Constraint
range: duration
comment: Minimum duration for which a flexibility activation must be sustained once started (ISO 8601 duration, e.g. PT30M).

min notification time
type: DatatypeProperty
domain: Flexibility Constraint
range: duration
comment: Minimum lead time required before a flexibility activation can start (ISO 8601 duration, e.g. PT15M).

min recovery time
type: DatatypeProperty
domain: Flexibility Constraint
range: duration
comment: Minimum rest period required between two consecutive flexibility activations (ISO 8601 duration, e.g. PT1H).

net amount
type: DatatypeProperty
domain: Redistribution Result
range: decimal
comment: Final redistribution amount for this member (grossAmount − costDeduction).

target flexibility
type: DatatypeProperty
domain: Flexibility Commitment
range: decimal
comment: Committed flexibility amount in kWh. Positive value; direction is expressed by hasFlexibilityDirection.

Community Context
type: Class
comment: Operational context binding a PECO Energy Community with assets, datasets, simulations and flexibility commitments.
example: ex:ctx1 a celine:CommunityContext ; celine:hasCommunity ex:rec_valdarno ; celine:usesAsset ex:pv_panel_01 ; celine:hasSimulation ex:sim_baseline ; celine:hasCommitment ex:fc_001 ; celine:hasSettlementRun ex:sr_2025_q3 .

Cost Item
type: Class
comment: A named cost voice within a SettlementRun (e.g., administrative fee, platform fee, outstanding debt). Enables transparent cost breakdown before redistribution amounts are finalised.
example: ex:cost_admin a celine:CostItem ; celine:hasCostType celine:AdminCost ; dct:description "Community administration fee Q3 2025" ; celine:costAmount "120.00"^^xsd:decimal . ex:cost_platform_fee a celine:CostItem ; celine:hasCostType celine:Fee ; dct:description "CELINE platform usage fee Q3 2025" ; celine:costAmount "45.00"^^xsd:decimal .

Dataset Reference
type: Class
comment: Reference to an external dataset used as input or produced as output. CELINE does not define dataset schemas.
example: ex:ds_irradiance a celine:DatasetReference ; dct:identifier "irradiance-2025-07" ; dct:source <https://data.example.org/weather/irradiance> .

Flexibility Commitment
type: Class
comment: A member's pledge to provide a specific amount of flexibility on one or more of their PODs during a given time window. The commitment can be automated (device-driven) or voluntary (manually activated by the member).
example: ex:fc_001 a celine:FlexibilityCommitment ; celine:committedBy ex:member_rossi ; celine:onPOD ex:pod_rossi_heatpump ; celine:hasCommitmentMode celine:Automated ; celine:hasFlexibilityDirection celine:FlexDown ; celine:targetFlexibility "2.5"^^xsd:decimal ; celine:hasTimeInterval ex:interval_2025_07_01 ; celine:generatesCredit ex:cr_001 .

Flexibility Constraint
type: Class
comment: Operational constraint governing when and how flexibility declared in a FlexibilityEnvelope may be activated. Encodes timing rules (minimum notice period, minimum and maximum activation duration, recovery time between activations) and frequency limits.
example: ex:constraint_hp a celine:FlexibilityConstraint ; celine:hasConstraintType celine:DurationConstraint ; celine:minNotificationTime "PT15M"^^xsd:duration ; celine:minActivationDuration "PT30M"^^xsd:duration ; celine:maxActivationDuration "PT4H"^^xsd:duration ; celine:minRecoveryTime "PT1H"^^xsd:duration ; celine:maxActivationsPerDay "3"^^xsd:integer .

Flexibility Credit
type: Class
comment: Credit awarded to a member for fulfilling (fully or partially) a FlexibilityCommitment. Denominated in kWh and backed by metered SOSA observations. Credits accumulate until reconciled in a SettlementRun.
example: ex:cr_001 a celine:FlexibilityCredit ; celine:earnedBy ex:member_rossi ; celine:creditFor ex:fc_001 ; celine:creditAmount "2.1"^^xsd:decimal ; celine:evidencedBy ex:obs_pod_rossi_20250701T10 .

Flexibility Envelope
type: Class
comment: Declared capability of a Point of Delivery (POD) to provide flexibility within a given availability window. Captures the physical bounds — maximum upward and downward power and available energy — that constrain any FlexibilityCommitment drawn from it. Aligned with saref4ener:PowerProfile for device-level scheduling semantics.
example: ex:env_hp a celine:FlexibilityEnvelope ; celine:envelopeFor ex:pod_rossi_heatpump ; celine:maxFlexUp "2.0"^^xsd:decimal ; celine:maxFlexDown "3.0"^^xsd:decimal ; celine:availableEnergy "6.0"^^xsd:decimal ; celine:hasAvailabilityWindow ex:window_morning ; celine:hasConstraint ex:constraint_hp .

KPI Evaluation
type: Class
comment: Evaluation of a BIGG KPI in a specific Scenario or SimulationRun.
example: ex:kpi_self_sufficiency a celine:KPIEvaluation ; celine:evaluatesKPI bigg:SelfSufficiencyRate ; rdf:value "0.72"^^xsd:decimal .

Redistribution Result
type: Class
comment: The calculated redistribution outcome for a single member within a SettlementRun. Records credit balance (kWh), gross monetary value before deductions, the member's allocated share of community costs, and the final net amount.
example: ex:result_rossi a celine:RedistributionResult ; celine:resultFor ex:member_rossi ; celine:creditBalance "2.1"^^xsd:decimal ; celine:grossAmount "0.252"^^xsd:decimal ; celine:costDeduction "0.048"^^xsd:decimal ; celine:netAmount "0.204"^^xsd:decimal .

Scenario
type: Class
comment: Definition of assumptions, temporal scope and configuration for one or more simulations.
example: ex:sc_summer a celine:Scenario ; rdfs:label "Summer 2025 baseline" ; dct:description "24-hour simulation with historical irradiance data." ; celine:hasTimeInterval ex:interval_2025_summer .

Settlement Run
type: Class
comment: Execution of the redistribution calculation for a settlement period. Aggregates FlexibilityCredits across all members, applies a linear conversion rate (kWh → monetary), deducts shared cost voices (CostItems), and produces one RedistributionResult per member.
example: ex:sr_2025_q3 a celine:SettlementRun ; celine:settlesContext ex:ctx1 ; celine:hasTimeInterval ex:interval_q3_2025 ; celine:conversionRate "0.12"^^xsd:decimal ; celine:currency "EUR" ; celine:hasCostItem ex:cost_admin, ex:cost_platform_fee ; celine:hasRedistributionResult ex:result_rossi, ex:result_bianchi .

Simulation
type: Class
comment: Abstract simulation definition independent from execution.
example: ex:sim1 a celine:Simulation ; celine:hasScenario ex:sc_summer ; celine:hasSimulationRun ex:run_001 .

Simulation Run
type: Class
comment: Concrete execution of a Simulation under a specific Scenario.
example: ex:run_001 a celine:SimulationRun ; celine:usesDataset ex:ds_irradiance ; celine:producesDataset ex:ds_energy_forecast ; celine:hasKPIEvaluation ex:kpi_self_sufficiency .

Administrative Cost
type: NamedIndividual
type: Concept
in scheme: Cost Type
comment: Overhead and management costs for operating the REC.
top concept of: Cost Type

Cost Type
type: NamedIndividual
type: ConceptScheme
description: Classification of cost voices within a SettlementRun.

Automated
type: NamedIndividual
type: Concept
in scheme: Commitment Mode
comment: Commitment fulfilled automatically by a smart device or control system, without manual intervention from the member.
top concept of: Commitment Mode

Commitment Mode
type: NamedIndividual
type: ConceptScheme
description: Classification of how a flexibility commitment is activated.

Constraint Type
type: NamedIndividual
type: ConceptScheme
description: Classification of operational constraints on flexibility activation.

Debt
type: NamedIndividual
type: Concept
in scheme: Cost Type
comment: Outstanding obligation carried forward from a previous settlement period.
top concept of: Cost Type

Duration Constraint
type: NamedIndividual
type: Concept
in scheme: Constraint Type
comment: Constraint on the minimum or maximum duration of a single flexibility activation event.
top concept of: Constraint Type

Fee
type: NamedIndividual
type: Concept
in scheme: Cost Type
comment: Platform, service or regulatory fee charged to the community.
top concept of: Cost Type

Flex Down
type: NamedIndividual
type: Concept
in scheme: Flexibility Direction
comment: Decrease community net consumption: reduce load or increase local generation.
top concept of: Flexibility Direction

Flexibility Direction
type: NamedIndividual
type: ConceptScheme
description: Direction of the flexibility commitment relative to the community baseline.

Flex Up
type: NamedIndividual
type: Concept
in scheme: Flexibility Direction
comment: Increase community net consumption: increase load or reduce local generation.
top concept of: Flexibility Direction

Frequency Constraint
type: NamedIndividual
type: Concept
in scheme: Constraint Type
comment: Constraint on the maximum number of flexibility activations permitted within a given period.
top concept of: Constraint Type

Notice Constraint
type: NamedIndividual
type: Concept
in scheme: Constraint Type
comment: Constraint on the minimum lead time required before activating flexibility.
top concept of: Constraint Type

Recovery Constraint
type: NamedIndividual
type: Concept
in scheme: Constraint Type
comment: Constraint on the minimum rest period required between consecutive flexibility activations.
top concept of: Constraint Type

Voluntary
type: NamedIndividual
type: Concept
in scheme: Commitment Mode
comment: Commitment activated manually by the member at their discretion.
top concept of: Commitment Mode