SAREF for Energy Flexibility
type: Ontology
contributor: Anais Walle
contributor: George Hallak
contributor: Georg Jung
contributor: Josef Baumeister
contributor: mente-konsman-b0a1711
contributor: Wilco Wijbrandi
creator: bouterca
creator: giulia-biagioni
creator: lauradaniele
description: The flexibility ontology module (ic-flex) is by design tightly integrated with SAREF, SAREF4ENER and the following InterConnect modules: power limit (ic-pwlm), incentive table (ic-inc), S2 (ic-s2), data-point (ic-data) and forecast (ic-fc) The main concept of the ic-flex module is the s4ener:FlexOffer, which allows to represent a flexibility offer (or schedule) as a combination of multiple time-series, data-points and forecasts. It also allows to specify a creation time (s4ener:hasCreationTime), validity period (s4ener:hasEffectivePeriod) and provenance (s4ener:producedBy) for the offer, on top of the creation time, validity period and provenance already specified for the time-series and data-points included in the offer. The additional key aspect captured in the ic-flex module is that a flex offer can also include various categories of flexibility, which are modelled as subclasses of the s4ener:FlexibilityProfile class, as follows: - Power Profile flexibilty is modelled as s4ener:PowerProfile based on the EEBUS spec - Tariff based flexibility (s4ener:TariffBased) is implemented using the incentive table (ic-inc) ontology based on the EEBUS spec (note that tariif-based felxibility does note exist in S2) - Power limit flexibility (ic-pwlm:PowerLimit) is implemented using thepower limit (ic-pwlm) ontology based on the EEBUS spec (and compliant also with S2) - Power Envelope flexibility (s4ener:PowerEnvelope) is implemented using theS2 (ic-s2) that follows the S2 specification (and compliant also with EEBUS) - Demand driven flexibility (s4ener:DemandDriven) flexibility (s4ener:PowerEnvelope) is implemented using theS2 (ic-s2) that follows the S2 specification (and compliant also with EEBUS) - Operation mode flexibility (s4ener:OperationMode) is implemented using theS2 (ic-s2) that follows the S2 specification (and compliant also with S2) - Fill rate based flexibility (s4ener:FillRateBased is implemented using theS2 (ic-s2) that follows the S2 specification (and complia…
license: etsi-software-license
modified: 2025-06-05
issued: 2025-06-05
publisher: www.etsi.org
source: saref4ener
preferred namespace prefix: s4ener
imports: v4.1.1
version IRI: v2.1.1
version info: v2.1.1
prior version: v1.2.1

Aborted
type: NamedIndividual
type: Instruction Status
type: Power sequence status
comment: Instruction was aborted.
comment: The selected PPBC.PowerSequence was aborted by the device and will not continue

Absolute cost
type: NamedIndividual
type: Incentive Type
comment: The incentive type ''absolute cost'' defined in the incentive table.

Accepted
type: NamedIndividual
type: Instruction Status
comment: Instruction has been accepted

Actuator level
type: Class
comment: Independent from the ActuatorSwitch class, the ActuatorLevel class enables a user or application to model LEVEL commands (start, up, percentageAbsolute, relative, etc.). This can be used to dim a light, set the speed of an electric motor, etc.
subclass of: Actuator

Actuator switch
type: Class
comment: Basic on/off operations on a simple actuator can be modelled with the ActuatorSwitch class. Whether the function turns a device itself ON or OFF, or whether it switches a specific feature, depends on the implementation. For example, one could model the super freeze program of a freezer using ActuatorSwitch class. An ON command would then activate the super freeze program and an OFF command would deactivate it. This example shall just give an idea how ActuatorSwitch can be used for more purposes than only turning devices on and off.
subclass of: Actuator

Allowed limit range
type: Class
comment: The actual constraints of an Power Envelope Based Profile.
subclass of: Thing

Alternatives group
type: Class
comment: A collection of power sequences for a certain profile
subclass of: Restriction
  all values from: Power profile control
  on property: belongs to
subclass of: Restriction
  all values from: Power sequence
  on property: consistsOf
subclass of: Restriction
  some values from: Power sequence
  on property: consistsOf
subclass of: Restriction
  on class: Power profile control
  on property: belongs to
  qualified cardinality: 1
subclass of: Restriction
  on data range: unsignedInt
  on property: hasIdentifier
  qualified cardinality: 1

Average
type: NamedIndividual
type: Usage
comment: The datapoint indicates an average value aggregated over a number of values.

Baseline
type: NamedIndividual
type: Usage
comment: This datapoint indicates the baseline.

Battery power source
type: Power source
comment: This Power Source codelist element indicates that a battery is the power source of this device.

CO2 Emission
type: NamedIndividual
type: Incentive Type
comment: The incentive type ''CO2 Emission'' defined in the incentive table.

Calculated
type: Value source
comment: This value source codelist element indicates that this observation has been calculated instead of measured or empirical.

Committed
type: NamedIndividual
type: Scope Type
comment: The committed version of this concept, usually an incentive table or power plan

Completed
type: NamedIndividual
type: Power sequence state
comment: Power sequence state with value 'completed'

Consumption
type: NamedIndividual
type: Usage
comment: This datapoint indicates the consumption.

Contractual Power Limit
type: Class
comment: The contractual power limit of a device
subclass of: Power Limit

DC Power source
type: Power source
comment: This Power Source codelist element indicates that the type of power source is DC.

Demand Driven Based Control Instruction
type: Class
comment: An Instruction as specified for an Demand Driven Based Control Profile.
subclass of: Flexibility Instruction

Data point
type: Class
comment: A data point is a quantity that is extended with various pieces of process information, namely - A creation time (instant). This is the point in time when the data point was created, which is not necessarily the time for which it is valid. In the case of soft-sensors or forecasters, a data point might have been created ahead of time, in the case of a direct observation a data point might created at its time of validity (or at the end of its validity time interval) and in the case of an archived value the data point might have been created after the fact. - A validity time (temporal entity) which will be named "time stamp". The validity time is the instant or interval in time in which a specific quantity is in effect. For example a room temperature might be measured at 12:00, which means it is in effect at this very instant. A specific amount of energy might me expended within the time-slot between 12:30 and 12:45, which means that the energy observation is in effect during this time interval. - A location or topological association. For example, an observation might be taken in a specific room, a power avarage might have been measured by a specific meter, a forecast might be valid for a specific region or grid segment. This association is therefore not always a location.
subclass of: Observation
subclass of: Restriction
  all values from: Usage
  on property: has usage
subclass of: Restriction
  max cardinality: 1
  on property: has creation time
subclass of: Restriction
  max cardinality: 1
  on property: has quantile
subclass of: Restriction
  max cardinality: 1
  on property: has update rate
subclass of: Restriction
  on class: Interval
  on property: has effective period
  qualified cardinality: 1

Defer
type: NamedIndividual
type: Power Envelope Consequence Type
comment: Indicating that the limited load or generation will be postponed to a later moment

Demand driven control
type: Class
comment: The Flexibility Profile following the Demand Driven strategy.
subclass of: Flexibility Profile

Device
type: Class
comment: A specialization of a saref:Device that exposes a power profile with power sequences to the CEM. Most of the existing devices can expose at most one power profile, but there are special cases in which more than one power profiles can be exposed by the same device. For example, consider the case of a combined fridge-freezer in which there are 2 logical devices (fridge and freezer) combined in 1 physical device. This combined device can expose 2 power profiles, one for the fridge and one for the freezer. A s4ee:Device (e.g. a household appliance or a smart meter) can also receive events about overload warning severity level and related load control commands (LoadControlEventData)
subclass of: Device
subclass of: Restriction
  all values from: Load control event data
  on property: receives
subclass of: Restriction
  max cardinality: 1
  on property: brand name
subclass of: Restriction
  max cardinality: 1
  on property: device code
subclass of: Restriction
  max cardinality: 1
  on property: device name
subclass of: Restriction
  max cardinality: 1
  on property: hardware revision
subclass of: Restriction
  max cardinality: 1
  on property: hasManufacturer
subclass of: Restriction
  max cardinality: 1
  on property: serial number
subclass of: Restriction
  max cardinality: 1
  on property: software revision
subclass of: Restriction
  max cardinality: 1
  on property: vendor code
subclass of: Restriction
  max cardinality: 1
  on property: vendor name
subclass of: Restriction
  min cardinality: 0
  on property: Power source
subclass of: Restriction
  min qualified cardinality: 0
  on class: Load control event data
  on property: receives

Downflex
type: NamedIndividual
type: Usage
comment: This datapoint indicates the down flexibility.

has elapsed slot time
type: ObjectProperty
comment: If state is set to 'running' or 'paused' AND the slot is determined, this property CAN contain the time the slot has already been in 'running' state (this also means the value remains constant during a 'paused' state). Otherwise it SHALL be omitted.
range: TemporalEntity

Electric Power 3 Phase Symmetric
type: Commodity
comment: Electric power described in Watt on when power is equally shared among the three phases. Only applicable for 3 phase devices.

Electric Power L1
type: Commodity
comment: Electric power described in Watt on phase 1. If a device utilizes only one phase it should always use L1.

Electric Power L2
type: Commodity
comment: Electric power described in Watt on phase 2. Only applicable for 3 phase devices.

Electric Power L3
type: Commodity
comment: Electric power described in Watt on phase 3. Only applicable for 3 phase devices.

Electricity
type: Commodity
comment: Identifier for Commodity ELECTRICITY

Emergency
type: NamedIndividual
type: Event action consume
type: Event action produce
comment: Load control event action with value 'emergency'

Empirical
type: Value source
comment: This value source codelist element indicates this value is an empirical value instead of a calculated or measured value.

End Interruption Instruction
type: Class
comment: An Instruction message indicating when an interruption can end.
subclass of: Interruption Instruction

End time duration Description
type: Class
comment: The duration description for the end time duration temporal entities
subclass of: DurationDescription

Energy Constraint
type: Class
comment: The energy constraint described in the Allowed Limit Range or Power Limit.

Energy Consumer
type: NamedIndividual
type: Role Type
comment: Identifier for RoleType Consumer

Energy Producer
type: NamedIndividual
type: Role Type
comment: Identifier for RoleType Producer

Energy Storage
type: NamedIndividual
type: Role Type
comment: Identifier for RoleType Storage

Euro per kilo watt hour
type: UnitOfMeasure
comment: Unit of Measure to represent euro's per kilowatt per hour

Event accepted
type: NamedIndividual
type: Event state consume
type: Event state produce
comment: Load control state with value 'event accepted'

Event action consume
type: Class
comment: An action type used to express a consume action to be performed as a consequence of an event used to send overload warning severity level and related load control commands to a device (e.g. a household appliance or a smart meter).
subclass of: Load Control event action
one of: Pause
one of: Resume
one of: Reduce
one of: Increase
one of: Emergency
one of: Normal

Event action produce
type: Class
comment: An action type used to express a produce action to be performed as a consequence of an event used to send overload warning severity level and related load control commands to a device (e.g. a household appliance or a smart meter).
subclass of: Load Control event action
one of: Pause
one of: Resume
one of: Reduce
one of: Increase
one of: Emergency
one of: Normal

Event cancelled
type: NamedIndividual
type: Event state consume
type: Event state produce
comment: Load control state with value 'event cancelled'

Event error
type: NamedIndividual
type: Event state consume
type: Event state produce
comment: Load control state with value 'event error'

Event rejected
type: NamedIndividual
type: Event state consume
type: Event state produce
comment: Load control state with value 'event rejected'

Event started
type: NamedIndividual
type: Event state consume
type: Event state produce
comment: Load control state with value 'event started'

Event state consume
type: Class
comment: In the load control, it expresses a consume state of an event used to send overload warning severity level and related load control commands to a device (e.g. a household appliance or a smart meter).
subclass of: Load control event state
one of: Event accepted
one of: Event started
one of: Event stopped
one of: Event rejected
one of: Event cancelled
one of: Event error

Event state produce
type: Class
comment: In the load control, it expresses a produce state of an event an event used to send overload warning severity level and related load control commands to a device (e.g. a household appliance or a smart meter).
subclass of: Load control event state
one of: Event accepted
one of: Event started
one of: Event stopped
one of: Event rejected
one of: Event cancelled
one of: Event error

Event stopped
type: NamedIndividual
type: Event state consume
type: Event state produce
comment: Load control state with value 'event stopped'

EXECUTING
type: Power sequence status
comment: The selected PPBC.PowerSequence is currently being executed

Fill Rate Based Control Instruction
type: Class
comment: A Fill Rate Based Instruction message.
subclass of: Flexibility Instruction

Failsafe Power Limit
type: Class
comment: In case the communication between a device and the energy manager is interrupted, fail-safe values apply and the device enters fail-safe state until the communication is re-established.
subclass of: Power Limit

Fail-safe state
type: Class
comment: State that indicates that the device currently is in its Fail-safe state. This means that it has lost its connection to a central energy manager. This may result in the device following stricter power limits.

Falling
type: Value tendency
comment: This value tendency codelist element indicates that the tendency of this observation indicates that the value is decreasing (i.e., falling).

Fill level target profile
type: Class
comment: The target profile that a fill rate based control flexibility profile tries to follow.
subclass of: Thing

Fill level target profile element
type: Class
comment: A description of the various Elements detailing the Fill Level Target Profile consists.
subclass of: Thing

Fill rate control
type: Class
comment: A flexibility profile specified through a Fill Rate Based Profile.
subclass of: Flexibility Profile

Finished
type: Power sequence status
comment: The selected PPBC.PowerSequence was executed and finished successfully

Flex offer
type: Class
comment: It allows to represent a flexibility offer (or schedule) as a combination of multiple time-series, data-points and forecasts. For example, we can create a flexibility offer that includes a time-series ex:T-power of power values, combined with a time-series ex:T-costs of associated costs.
subclass of: Restriction
  all values from: Class
    union of: Agent
    union of: Device
  on property: has recipient
subclass of: Restriction
  all values from: Class
    union of: Agent
    union of: Device
  on property: produced by
subclass of: Restriction
  all values from: Class
    union of: Data point
    union of: Time Series
    union of: Flexibility Profile
  on property: includes
subclass of: Restriction
  max cardinality: 1
  on property: has creation time
subclass of: Restriction
  max qualified cardinality: 1
  on class: Interval
  on property: has effective period

Flex request
type: Class
comment: The flexibility request
subclass of: Thing
subclass of: Restriction
  all values from: dateTime
  on property: has creation time
subclass of: Restriction
  all values from: Interval
  on property: has effective period
subclass of: Restriction
  all values from: Class
    union of: Agent
    union of: Device
  on property: has recipient
subclass of: Restriction
  all values from: Class
    union of: Agent
    union of: Device
  on property: produced by
subclass of: Restriction
  all values from: Class
    union of: Data point
    union of: Time Series
    union of: Flexibility Profile
    union of: Incentive table based profile
  on property: includes

Flexibility Instruction
type: Class
comment: The various types of instructions Flexibility Sources can send and/or receive.

Flexibility Profile
type: Class
comment: Different control types to describe the energy flexibility that a device has to offer. Charging of an EV for instance, may be controlled by power profile-based control or fill-rate -based control. It is not allowed to mix different control types at the same time, but different control types may be used sequentially. Control Types dictates flexibility instructions. Control Type provides Flexibility options.
subclass of: Profile

Gas
type: Commodity
comment: Identifier for Commodity GAS

Gaussian data point
type: Class
comment: A data point whose quantity is a standard deviation.
subclass of: Data point
subclass of: Restriction
  on property: has standard deviation
  some values from: decimal

Heat
type: Commodity
comment: Identifier for Commodity Heat

Heat Flow Rate
type: Commodity
comment: Flow rate of heat carrying gas or liquid in liters per second

Heat Temperature
type: Commodity
comment: Heat described in degrees Celsius

Heat Thermal Power
type: Commodity
comment: Thermal power in Watt

Hydrogen Flow Rate
type: Commodity
comment: Gas flow rate described in grams per second

Inactive
type: NamedIndividual
type: Power sequence state
comment: Power sequence state with value 'inactive'

Incentive
type: Class
comment: An Incentive indicates the intersection of a tier with a slot. In this particular combination of slot and tier there are a particular costs to draw this type of energy. For example, drawing power from the grid costs 0.30 euro per kilowatthour during the afternoon, but will only be activated from a lower boundary of 3000W.
subclass of: Data point

Incentive table based profile
type: Class
comment: This flexibility profile describes the usage of an incentive table to describe an incentive type in the form of costs (relative or absolute), CO2 emissions or renewable energy percentage that can be associated to power values (expressed as a time-series of power data-points).
subclass of: Flexibility Profile
subclass of: Restriction
  all values from: boolean
  on property: is changeable
subclass of: Restriction
  all values from: boolean
  on property: requiresUpdate
subclass of: Restriction
  all values from: Scope Type
  on property: has scope type

Incentive table slot
type: Class
comment: This concept describes a slot that belongs to a Incentive Table. Each slot of the Incentive Table consists of a series of (lower) boundaries, each indicating the power at which a change to another incentive takes place. Additionally, each boundary is associated with a IncentiveTableTier.
subclass of: Slot

Incentive table tier
type: Class
comment: This concept specifies a Tier that an Incentive Table consists of. Each Tier indicates through a series of Boundaries the price per kilowatthour this incentive costs. For example, a tier may describe grid power, solar panel power, or surplus power.
subclass of: Time Series

Incentive Type
type: Class
comment: In the incentive table, an incentive type is defined in the form of costs (relative or absolute), CO2 emissions or renewable energy percentage.

Increase
type: NamedIndividual
type: Event action consume
type: Event action produce
comment: Load control event action with value 'increase'

Instruction Status
type: Class
comment: The status an instruction has at a specific moment.
subclass of: Thing

Interrupted
type: Power sequence status
comment: The selected PPBC.PowerSequence is being executed, but is currently interrupted and will continue afterwards

Interruption Instruction
type: Class
comment: An instruction indicating an interruption to the process.
subclass of: Power Profile Based Control Instruction

Invalid
type: NamedIndividual
type: Power sequence state
comment: Power sequence state with value 'invalid'

Leakage behaviour
type: Class
comment: A description of the Leakage Behaviour associated with this Fill Rate Flexibility Profile.
subclass of: Thing

Leakage behaviour element
type: Class
comment: An element detailing the leakage behaviour of a storage.
subclass of: Thing

Load Control event action
type: Class
comment: An action type used to express the action to be performed as a consequence of an event used to send overload warning severity level and related load control commands to a device (e.g. a household appliance or a smart meter).

Load control event data
type: Class
comment: An event used to send overload warning severity level and related load control commands to a device (e.g. a household appliance or a smart meter).
subclass of: Restriction
  all values from: dateTime
  on property: hasTimestamp
subclass of: Restriction
  all values from: Device
  on property: has device
subclass of: Restriction
  all values from: Event action consume
  on property: triggers event action consume
subclass of: Restriction
  all values from: Event action produce
  on property: triggers event action produce
subclass of: Restriction
  min cardinality: 0
  on property: hasIdentifier
subclass of: Restriction
  min qualified cardinality: 0
  on class: Event action consume
  on property: triggers event action consume
subclass of: Restriction
  min qualified cardinality: 0
  on class: Event action produce
  on property: triggers event action produce
subclass of: Restriction
  min qualified cardinality: 1
  on class: Device
  on property: has device
subclass of: Restriction
  min qualified cardinality: 1
  on data range: dateTime
  on property: hasTimestamp

Load control event state
type: Class
subclass of: State
comment: In the load control, it expresses the possible states of an event used to send overload warning severity level and related load control commands to a device (e.g. a household appliance or a smart meter).

Load control state data
type: Class
comment: The representation of the state of an event used to send overload warning severity level and related load control commands to a device (e.g. a household appliance or a smart meter).
subclass of: Restriction
  all values from: dateTime
  on property: hasTimestamp
subclass of: Restriction
  all values from: Event action consume
  on property: has applied event action consume
subclass of: Restriction
  all values from: Event action produce
  on property: has applied event action produce
subclass of: Restriction
  all values from: Event state consume
  on property: has event state consume
subclass of: Restriction
  all values from: Event state produce
  on property: has event state produce
subclass of: Restriction
  min qualified cardinality: 0
  on class: Event action consume
  on property: has applied event action consume
subclass of: Restriction
  min qualified cardinality: 0
  on class: Event action produce
  on property: has applied event action produce
subclass of: Restriction
  min qualified cardinality: 0
  on class: Event state consume
  on property: has event state consume
subclass of: Restriction
  min qualified cardinality: 0
  on class: Event state produce
  on property: has event state produce
subclass of: Restriction
  min qualified cardinality: 0
  on data range: unsignedInt
  on property: hasIdentifier
subclass of: Restriction
  min qualified cardinality: 1
  on data range: dateTime
  on property: hasTimestamp

Lower Limit
type: NamedIndividual
type: Power Envelope Limit Type
type: Usage
comment: The PowerEnvelopeLimitType codelist element indicating the lower limit.
comment: This data point indicates the lower limit, for example of a PowerEnvelopeLimitType.

Mains3Phase
type: Power source
comment: This Power Source codelist element indicates that the power source of this device is Mains 3 Phase.

Mains single phase
type: Power source
comment: This codelist element of power source indicates that the power source is the mains single phase.

Maximum
type: NamedIndividual
type: Usage
comment: The usage of this datapoint is the Maximum value.

Skewness
type: NamedIndividual
type: Usage
comment: The usage of this datapoint is the power skewness (assymetry of the distribution).

Measured
type: Value source
comment: The value source type indicates that this data point has been measured by a device.

Minimum
type: NamedIndividual
type: Usage
comment: The usage of this datapoint is the Minimum value.

Natural Gas Flow Rate
type: Commodity
comment: Gas flow rate described in liters per second

New
type: NamedIndividual
type: Instruction Status
comment: Instruction was newly created

Nominal Power Limit
type: Class
comment: A device may have nominal power consumption and/or production values that are defined by the manufacturer and must not be exceeded, so that the power limit must stay within these constraints.
subclass of: Power Limit

Normal
type: NamedIndividual
type: Event action consume
type: Event action produce
comment: The value NORMAL used to instantiate the Load Control Event Action class and MeasurandState class

NotScheduled
type: Power sequence status
comment: No PPBC.PowerSequence within the PPBC.PowerSequenceContainer is scheduled

Number range
type: Class
comment: This class describes a range via a datatype property indicating the start of the range and another datatype property indicating the end of the range.
subclass of: Thing

Operation Mode Based Control Instruction
type: Class
comment: An instruction following the Operation Mode Based Profile.
subclass of: Flexibility Instruction

Oil
type: Commodity
comment: Identifier for Commodity OIL

Oil Flow Rate
type: Commodity
comment: Oil flow rate described in liters per hour

Operation Mode
type: Class
subclass of: State
comment: A resource manager can declare multiple operation modes for a device. An operation mode is a mode/state that a device can find itself in, that is associated with a specific power value.

Operation Mode Element
type: Class
comment: Operation Mode Elements of a Fill Rate Based Control
subclass of: Thing

Operation mode control
type: Class
comment: A resource manager can declare multiple operation modes for a device. An operation mode is a mode/state that a device can find itself in, that is associated with a specific power value.
subclass of: Flexibility Profile

Power Envelop Based Control Instruction
type: Class
comment: An instruction for the Power Envelope Based Profile.
subclass of: Flexibility Instruction

Power Profile Based Control Instruction
type: Class
comment: An instruction for a Power Profile Based Flexibility Profile.
subclass of: Flexibility Instruction

Pause
type: NamedIndividual
type: Event action consume
type: Event action produce
comment: Load control event action with value 'pause'

Paused
type: NamedIndividual
type: Power sequence state
comment: Power sequence state or sensor state with value 'paused'

Pending
type: NamedIndividual
type: Power sequence state
comment: Power sequence state with value 'pending'

Power constraint
type: Class
comment: The actual power constraint contained in the Allowed Limit Range or Power limit.
subclass of: Thing

Power Envelope
type: Class
comment: A specific Power Envelope to be followed by an energy manager
subclass of: Thing

Power Envelope Consequence Type
type: Class
comment: The type of consequence of limiting power, which can be Defer or Vanish.
subclass of: Thing

Power Envelope Limit Type
type: Class
comment: An enumeration containing the codelist for Power Envelope Limit Types, which may be Lower limit or Upper limit.
subclass of: Thing

Power envelope control
type: Class
comment: A Flexibility Profile described through a Power Envelope Profile.
subclass of: Flexibility Profile

Power Limit
type: Class
comment: A power limit is defined as the maximum value for power consumption and/or production that must not be exceeded by e.g. a (group of) device(s), a building, or also a district.
subclass of: Allowed limit range
subclass of: Restriction
  all values from: boolean
  on property: is changeable
subclass of: Restriction
  all values from: boolean
  on property: is obligatory

Power limit profile
type: Class
comment: This profile describes the energy flexibility of a device via a set of power limits, following the SPINE documentation
subclass of: Flexibility Profile

Power plan
type: Class
comment: The Power Plan that an energy manager creates for a device. It contains three timeseries indicating the minimum, average, and maximum respectively.
subclass of: Time Series
subclass of: Restriction
  on property: consistsOf
  some values from: Time Series

Power profile control
type: Class
comment: A way to model curves of power and energy over time, which also provides definitions for the modelling of power scheduling including alternative plans. With a PowerProfile, a device (or power sequences server) exposes the power sequences that are potentially relevant for the CEM (or power sequences client).
comment: PPBC.PowerProfileDefinition
subclass of: Profile
subclass of: Restriction
  all values from: Alternatives group
  on property: consistsOf
subclass of: Restriction
  all values from: Device
  on property: belongs to
subclass of: Restriction
  cardinality: 1
  on property: node remote controllable
subclass of: Restriction
  cardinality: 1
  on property: supports reselection
subclass of: Restriction
  cardinality: 1
  on property: supports single slot scheduling only
subclass of: Restriction
  cardinality: 1
  on property: total sequences count max
subclass of: Restriction
  some values from: Alternatives group
  on property: consistsOf
subclass of: Restriction
  on class: Device
  on property: belongs to
  qualified cardinality: 1

Power range
type: Class
comment: A class describing a power range, containing a start of range, an end of range, and a saref:Property indicating the type of power involved.
subclass of: Thing

Power sequence
type: Class
comment: A Power Sequence following S2 is a container containing one or more PowerSequenceElements among which the EMS can choose the Element with the best fit to the current energy demands.
comment: The specification of a task, such as wash or tumble dry, according to user preferences and/or manufacturer's settings for a certain device. It is the most 'coarse' view, a power sequence can represent all single steps of a whole task,where the single steps are represented by slots. If the power sequence is pausable by the bound power sequences client, the property 'saref:isInterrupteble' SHALL be present and set to true. Otherwise it SHALL be omitted. If the power sequence is stoppable by the bound power sequences client, the property 'saref:isFlexible' SHALL be present and set to true. Otherwise it SHALL be omitted.
subclass of: Thing
subclass of: Restriction
  all values from: Alternatives group
  on property: belongs to
subclass of: Restriction
  all values from: Power sequence state
  on property: hasState
subclass of: Restriction
  all values from: PropertyValue
  on property: Resume cost estimated
subclass of: Restriction
  all values from: PropertyValue
  on property: Resume energy estimated
subclass of: Restriction
  all values from: Slot
  on property: consistsOf
subclass of: Restriction
  cardinality: 1
  on property: hasIdentifier
subclass of: Restriction
  cardinality: 1
  on property: sequence remote controllable
subclass of: Restriction
  max cardinality: 1
  on property: active repetition number
subclass of: Restriction
  max cardinality: 1
  on property: active slot number
subclass of: Restriction
  max cardinality: 1
  on property: cheapest
subclass of: Restriction
  max cardinality: 1
  on property: greenest
subclass of: Restriction
  max cardinality: 1
  on property: is pausable
subclass of: Restriction
  max cardinality: 1
  on property: is stoppable
subclass of: Restriction
  max cardinality: 1
  on property: max cycles per day
subclass of: Restriction
  max cardinality: 1
  on property: repetition total
subclass of: Restriction
  min cardinality: 1
  on property: has active duration max
subclass of: Restriction
  min cardinality: 1
  on property: has active duration min
subclass of: Restriction
  max cardinality: 1
  on property: has active duration sum max
subclass of: Restriction
  max cardinality: 1
  on property: has active duration sum min
subclass of: Restriction
  max cardinality: 1
  on property: has earliest start time
subclass of: Restriction
  max cardinality: 1
  on property: has elapsed slot time
subclass of: Restriction
  max cardinality: 1
  on property: end time
subclass of: Restriction
  max cardinality: 1
  on property: has latest end time
subclass of: Restriction
  max cardinality: 1
  on property: has pause duration max
subclass of: Restriction
  max cardinality: 1
  on property: has pause duration min
subclass of: Restriction
  max cardinality: 1
  on property: has remaining slot time
subclass of: Restriction
  max qualified cardinality: 1
  on class: PropertyValue
  on property: Resume cost estimated
subclass of: Restriction
  max qualified cardinality: 1
  on class: PropertyValue
  on property: Resume energy estimated
subclass of: Restriction
  min cardinality: 0
  on property: has value source
subclass of: Restriction
  some values from: Slot
  on property: consistsOf
subclass of: Restriction
  min cardinality: 1
  on property: has start time
subclass of: Restriction
  on class: Alternatives group
  on property: belongs to
  qualified cardinality: 1

Power profile container
type: Class
comment: A container containing the various Power Sequences among which the EMS may choose for the appropriate Power Sequence at a given time.
subclass of: Thing

Power sequence element
type: Class
comment: An element of a power sequence, roughly equivalent to slots in the existing S4ener.
subclass of: Thing

Power sequence state
type: Class
subclass of: State
comment: The current state of the power sequence. It can assume one of the values 'running', 'paused', 'scheduled', 'scheduled paused', 'pending', 'inactive', 'completed', or 'invalid'.

Power sequence status
type: Class
comment: A codelist for the various Power Sequence statuses.
subclass of: Thing

Power
type: Property
comment: The Property of Power that a Value Property may be about. This concept can be related to observation or property values that are characterized by a certain value that is measured in a power unit (such as watt or kilowatt).

Energy
type: Property
comment: The Property of Energy that a Value Property may be about. This concept can be related to observations and property values that are characterized by a certain value measured in an energy unit (such as Kilowatt_Hour or Watt_hour).

Power source
type: Class
comment: Indicates the power source of a device. Possible values are e.g. mainsSinglePhase or battery
subclass of: Thing

Preliminary
type: NamedIndividual
type: Scope Type
comment: The preliminary version of this concept, usually an incentive table or power plan

Production
type: NamedIndividual
type: Usage
comment: This datapoint indicates the energy production.

Reduce
type: NamedIndividual
type: Event action consume
type: Event action produce
comment: Load control event action with value 'reduce'

Rejected
type: NamedIndividual
type: Instruction Status
comment: Instruction was rejected

Relative cost
type: NamedIndividual
type: Incentive Type
comment: The incentive type ''relative cost'' defined in the incentive table.

Renewable energy percentage
type: NamedIndividual
type: Incentive Type
comment: The incentive type ''renewable energy percentage'' defined in the incentive table.

Resume
type: NamedIndividual
type: Event action consume
type: Event action produce
comment: Load control event action with value 'resume'

Resume cost estimated
type: ObjectProperty
comment: In a power sequence the additional costs for the resumption of a device to its normal operation (after a pause).
sub property of: hasPropertyValue

Resume energy estimated
type: ObjectProperty
comment: In a power sequence the additional energy for the resumption of a device to its normal operation (after a pause).
sub property of: hasPropertyValue

Revoked
type: NamedIndividual
type: Instruction Status
comment: Instruction was revoked

Rising
type: Value tendency
comment: This value tendency codelist element indicates that the tendency of this observation indicates that the value is increasing (i.e., rising).

Role
type: Class
comment: A codelist containing the various roles a device can take: producer, consumer, and storage.
subclass of: Thing

Role Type
type: Class
comment: An enumeration containing the various roles a device can take up: consumer, producer, or storage.

Running
type: NamedIndividual
type: Power sequence state
comment: Power sequence state with value 'running'

Schedule Instruction
type: Class
comment: Schedule instruction for a power profile flexibility profile.
subclass of: Power Profile Based Control Instruction

Scheduled
type: NamedIndividual
type: Power sequence state
comment: Power sequence state with value 'scheduled'

Scheduled paused
type: NamedIndividual
type: Power sequence state
comment: Power sequence state with value 'scheduled paused'

Scope Type
type: Class
comment: An incentive table may additionally define a scope type to indicate whether it is a preliminary or committed version.

Setpoint
type: NamedIndividual
type: Usage
comment: This datapoint indicates a setpoint.

Slot
type: Class
comment: The single steps of a power sequence are represented by slots. A slot is associated with a slot number (while a power sequence is associated with a power sequence identifier). The slot numbers of two power sequences should be considered independent from each other, i.e., slot number 7 of sequence 1 describes a different slot than slot number 7 of sequence 2. Therefore a slot is only uniquely identified in combination with a sequence ID.
subclass of: Restriction
  all values from: Usage
  on property: has usage
subclass of: Restriction
  all values from: Power sequence
  on property: belongs to
subclass of: Restriction
  cardinality: 1
  on property: slot number
subclass of: Restriction
  max cardinality: 1
  on property: optional slot
subclass of: Restriction
  max cardinality: 1
  on property: slot activated
subclass of: Restriction
  max cardinality: 1
  on property: has default duration
subclass of: Restriction
  max cardinality: 1
  on property: Duration uncertainty
subclass of: Restriction
  max cardinality: 1
  on property: has earliest start time
subclass of: Restriction
  max cardinality: 1
  on property: end time
subclass of: Restriction
  max cardinality: 1
  on property: has latest end time
subclass of: Restriction
  max cardinality: 1
  on property: has max duration
subclass of: Restriction
  max cardinality: 1
  on property: has min duration
subclass of: Restriction
  max cardinality: 1
  on property: has remaining pause time
subclass of: Restriction
  max cardinality: 1
  on property: has start time
subclass of: Restriction
  min qualified cardinality: 1
  on class: Usage
  on property: has usage
subclass of: Restriction
  on class: Power sequence
  on property: belongs to
  qualified cardinality: 1

Stable
type: Value tendency
comment: This value tendency codelist element indicates that the tendency this observation has is to stay stable, instead of rising or falling.

Start Interruption Instruction
type: Class
comment: An instruction or message indicating the start of an interruption.
subclass of: Interruption Instruction

Started
type: NamedIndividual
type: Instruction Status
comment: Instruction was executed

Storage
type: Class
comment: storage device which is the main component of Fill Rate Based Control type.). In the context of flexibility control and instructuons, a device shall be able to inform the CEM about its fill level, a measure of how full the storage is, and the lower and upper boundaries that the fill level should remain within.
subclass of: Thing
subclass of: Device

Succeeded
type: NamedIndividual
type: Instruction Status
comment: Instruction finished successfully

Time Series
type: Class
comment: An ordered sequence of data points of a quantity observed at spaced time intervals is referred to as a time series. Time series can be a result of prediction algorithm.
subclass of: Restriction
  all values from: Interval
  on property: has effective period
subclass of: Restriction
  all values from: Usage
  on property: has usage
subclass of: Restriction
  max cardinality: 1
  on property: has creation time
subclass of: Restriction
  max cardinality: 1
  on property: has temporal resolution
subclass of: Restriction
  max cardinality: 1
  on property: has update rate
subclass of: Restriction
  min qualified cardinality: 0
  on class: Data point
  on property: has data point

Timer
type: Class
comment: A timer for time-based operation mode and transition constraints.
subclass of: Thing

Transition
type: Class
comment: Possible transitions to switch from one Operation Mode to another or to set new parameters.
subclass of: Thing

Upflex
type: NamedIndividual
type: Usage
comment: This datapoint indicates the upper flexibility.

Upper Limit
type: NamedIndividual
type: Power Envelope Limit Type
type: Usage
comment: The PowerEnvelopeLimitType enumeration for the upper limit.
comment: This datapoint indicates the upperlimit.
label: Upper limit

Usage
type: Class
comment: The usage of a datapoint, time series or message.

Value source
type: Class
comment: Indicates the source (origin/foundation) of the observation forecasted values for a power sequence. If absent, the source is undefined. Remark: This element shall express the reliability of the forecast.
subclass of: Thing

Value tendency
type: Class
comment: This type indicates a codelist for the s4ener:valueTendency property about whether the tendency of an observation is rising, stable or falling.
subclass of: Thing

Vanish
type: NamedIndividual
type: Power Envelope Consequence Type
comment: The load or generation that is limited will vanish. This is for example the case with curtailing production from solar panels; the potentially generated energy is lost and will never reappear.

abnormal condition
type: DatatypeProperty
comment: Indicates if this is an instruction during an abnormal condition
domain: Flexibility Instruction
range: boolean

Abnormal Condition Only
type: DatatypeProperty
comment: Indicates if this element can only be used during an abnormal condition. In SAREF4ENER this property is intended to be used on the following properties: - s4ener:OperationMode - s4ener:Transition - s4ener:AllowedLimitRange - s4ener:PowerSequence
range: boolean

activate slot
type: DatatypeProperty
comment: Indicates whether a slot is used (activateSlot = true) or not (activateSlot = false). SHALL be present if a slot is optional (i.e., the property s4ee:optionalSlot is TRUE), otherwise SHALL be absent (i.e. in case the slot is mandatory).
range: boolean

active repetition number
type: DatatypeProperty
comment: Indicates the current repetition of the sequence of slots. SHALL be present if a power sequence can repeat its sequence of slots (i.e., if s4ee:repetitionTotal is present and has a value > 1). Otherwise, it SHALL be absent.
range: unsignedInt

active slot number
type: DatatypeProperty
comment: Indicates the currently active slot number, if the power sequence state is set to 'running' or 'paused'. Otherwise it SHALL be omitted.
range: unsignedInt

allowed limit range
type: ObjectProperty
comment: This property indicates the various AllowedLimitRanges or PowerLimits that this PowerConstraint object consists of.
domain: Class
  union of: Power constraint
  union of: Energy Constraint
range: Allowed limit range

belongs to
type: ObjectProperty
comment: A relationship identifying the ownership of an entity. In particular, a slot belongs to a power sequence, a power sequence belongs to an alternative, an alternative belongs to a power profile, a power profile belongs to a device.

belongs to time series
type: ObjectProperty
comment: The relationship that connects a data point to a time series.
domain: Data point
range: Time Series
inverse of: has data point

brand name
type: DatatypeProperty
comment: Provides the name of the brand of a device. Useful where the name of the brand and the vendor differs.
range: string

cheapest
type: DatatypeProperty
comment: Indicates whether a power sequence applies a configuration that minimises the user's energy bill (if set to TRUE). MAY be present. Absence of this element is equal to the presence with value FALSE.
range: boolean

device code
type: DatatypeProperty
comment: Provides a device code for the device as defined by the manufacturer.
range: string

device name
type: DatatypeProperty
comment: Provides the name of the device as defined by the manufacturer.
range: string

end of range
type: ObjectProperty
comment: This property indicates the end of a number range.
domain: Number range
range: PropertyValue

Fill Rate Level
type: ObjectProperty
comment: Indicates the change in fill_level per second. The lower_boundary of the NumberRange is associated with an operation_mode_factor of 0, the upper_boundary is associated with an operation_mode_factor of 1.
domain: Class
  union of: Storage
  union of: Operation Mode Element
range: Number range

has firmware version
type: DatatypeProperty
comment: Version identifier of the firmware used in the device (provided by the manufacturer)
domain: Device
range: string

from operation mode
type: ObjectProperty
comment: ID of the OperationMode (exact type differs per ControlType) that should be switched from.
domain: Transition
range: Operation Mode

greenest
type: DatatypeProperty
comment: Indicates whether a power sequence optimises the configuration towards the maximum availability of renewable energy (if set to TRUE). MAY be present. Absence of this element is equal to the presence with value FALSE.
range: boolean

hardware revision
type: DatatypeProperty
comment: Indicates the hardware revision of the device as defined by the manufacturer.
range: string

has active duration max
type: DatatypeProperty
comment: The active maximum duration a power sequence can run without interruption. This property is suggested to be added to SAREF4Ener_v2 to replace the time:TemporalEntity and/or time:DurationDescription.
range: duration
sub property of: duration in xsd

has active duration min
type: DatatypeProperty
comment: The active mininum duration a power sequence can run without interruption. This property is suggested to be added to SAREF4Ener_v2 to replace the time:TemporalEntity and/or time:DurationDescription.
range: duration
sub property of: duration in xsd

has active duration sum max
type: DatatypeProperty
comment: The active maximum duration a power sequence can run in total (summation of all active times). This property is suggested to be added to SAREF4Ener_v2 to replace the time:TemporalEntity and/or time:DurationDescription.
range: duration
sub property of: duration in xsd

has active duration sum min
type: DatatypeProperty
comment: The active minimum duration a power sequence must run in total (summation of all active times). This property is suggested to be added to SAREF4Ener_v2 to replace the time:TemporalEntity and/or time:DurationDescription.
range: duration
sub property of: duration in xsd

has active operation mode
type: ObjectProperty
comment: A reference to the OperationMode that is presently active
domain: Class
  union of: Operation Mode
  union of: Actuator
range: Operation Mode

has applied event action consume
type: ObjectProperty
comment: A relationship between the state of a load control event consume and the action to be performed as a consequence of this event.

has applied event action produce
type: ObjectProperty
comment: A relationship between the state of a load control event produce and the action to be performed as a consequence of this event.

Uses commodity
type: ObjectProperty
comment: An indication of which commodity this Role is a consumer, producer, or storer of.
domain: Role
range: Commodity

Has Consequence Type
type: ObjectProperty
comment: The consequence type associated with this Power Constraint, which can be Defer or Vanish.
domain: Power constraint
range: Power Envelope Consequence Type

has constraints
type: ObjectProperty
comment: This property relates a Power Envelop Instruction or Profile to the constraints it needs to follow. There are two types of constraints modelled: Power constraints and energy constraints.
domain: Class
  union of: Power Envelop Based Control Instruction
  union of: Power envelope control
range: Class
  union of: Power constraint
  union of: Energy Constraint

has contractual consumption Max
type: ObjectProperty
comment: The relationship between the contractual power limit and the value indicating the max limit consumption.
domain: Contractual Power Limit
range: PropertyValue
sub property of: has power limit consumption Max

has contractual production Max
type: ObjectProperty
comment: The relationship between the contractual power limit and the value indicating the max limit production.
domain: Contractual Power Limit
range: PropertyValue
sub property of: has power limit production Max

has cost
type: ObjectProperty
comment: Additional costs per second (e.g. wear, services) associated with this operation mode in the currency defined by the ResourceManagerDetails , excluding the commodity cost. The range is expressing uncertainty and is not linked to the operation_mode_factor.
comment: The relationship between the s4ener:FlexibilityInstruction and s4ener:DataPoint
domain: Flexibility Instruction
domain: Operation Mode
label: hasCost
range: Data point

has creation time
type: DatatypeProperty
comment: The time instant that defines the creation time of a data point or quantity or forecast or similar entities. This is not the same as the time at which the quantity is in effect. For example, if a temperature is forecasted today at 12:30 (creation time of the forecast) for the following day at 14:45 (time when the temperature is expected to be in effect), the this instant should be 12:30 of today. A creation time (instant). This is the point in time when the data point was created, which is not necessarily the time for which it is valid. In the case of soft-sensors or forecasters, a data point might have been created ahead of time, in the case of a direct observation a data point might created at its time of validity (or at the end of its validity time interval) and in the case of an archived value the data point might have been created after the fact.
range: dateTimeStamp

has data point
type: ObjectProperty
comment: This relationship connects a time series to data point.
domain: Time Series
range: Data point

has demand rate
type: ObjectProperty
comment: The present demand rate that needs to be satisfied by the system
domain: Demand driven control
range: Number range

has average demand rate forecast
type: ObjectProperty
comment: This property relates a Demand Driven Profile to a TimeSeries object that indicates a forecast of the average demand rate.
domain: Demand driven control
range: Time Series

has device
type: ObjectProperty
comment: A relationship between a load control event (used to send overload warning severity level and related load control commands) and the device interested by this event.

duration in xsd
type: DatatypeProperty
comment: This property is added to the time:DurationDescription class to allow to express time duration also as xsd:duration. This is necessary because in the EEBus/E@h model time is always expressed as xsd:duration. We use this property to express the following time information in the EEBus/E@h model: - the startTime of the power sequence (in the PowerSequence class). SHALL be present - the endTime of the power sequence (in the PowerSequence class). If the value is available, it SHALL be denoted here. Otherwise the element SHALL be omitted. - the startTime of observation as absolute or relative value (in the Observation class). - the endTime of observation as absolute or relative value (in the Observation class). The duration is expected to be described as in xsd:duration
comment: This property specifies that the componenrt has a duration attribute further specified in the subproperty This property is suggested to be added to SAREF4Ener_v2 to replace the time:TemporalEntity and/or time:DurationDescription.
range: duration

has default duration
type: DatatypeProperty
comment: The duration of a slot (SHALL be present in case of 'determined slot'). If a slot has a configurable lenght, this element SHALL reflect the currently configured lenght This property is suggested to be added to SAREF4Ener_v2 to replace the time:TemporalEntity and/or time:DurationDescription.
range: duration
sub property of: duration in xsd

duration minimum
type: DatatypeProperty
comment: The minimum duration for some component This property is suggested to be added in SAREF4ENER_V2
range: duration
sub property of: duration in xsd

Duration uncertainty
type: DatatypeProperty
comment: The uncertainty of the duration given in the s4ener:defaultDuration property.
range: duration
sub property of: duration in xsd

has manufacturer node identification
type: DatatypeProperty
comment: A node identification for the device as defined by the manufacturer. This could be used for the identification of a device, even if it was removed from the network and re-joined later with changed node address.
sub property of: hasIdentifier
domain: Device

has task identifier
type: DatatypeProperty
comment: Used by a device that wants to uniquely identify reoccurring types of power sequences. For example, specific types of washing cycles with specific parameters SHOULD have the same s4ener:taskIdentifier value every time they are offered using power sequences.
sub property of: hasIdentifier
domain: Power sequence

has earliest start time
type: DatatypeProperty
comment: The earliest possible start time for a power sequence or a slot. Only 'xs:duration' value types SHALL be used to denote a relative time which relates to 'now' as time 0. Note: This element applies to the first repetition of the slot number only. This property is suggested to be added to SAREF4Ener_v2 to replace the time:TemporalEntity and/or time:DurationDescription.
range: dateTimeStamp
sub property of: hasTimestamp

has effective period
type: ObjectProperty
comment: This connects to the temporal entity which describes when (time interval) the quantity of this data point was, is, or will be in effect. This is the time interval which is covered by the forecast. This should be equivalent to the time interval covered by the time-series that express the forecast.
range: Interval

end time
type: DatatypeProperty
comment: The endTime of a power sequence. If the value is available, it SHALL be denoted here. Otherwise the element SHALL be omitted. The end time of a slot MAY be stated in this element. The following equation SHALL apply: endTime - startTime = defaultDuration.
range: duration
sub property of: hasTimestamp

has energy
type: ObjectProperty
comment: A relationship between a power sequence and its energy (in terms of value and unit of measure)
range: PropertyValue

has envelope
type: ObjectProperty
comment: This property relates a Power Envelope to the Timeseries object that describes the envelope
domain: Power Envelope
range: Time Series

has event state consume
type: ObjectProperty
comment: A relationship between the specification of the state of a load control event consume and the value that this state can assume.
sub property of: hasState

has event state produce
type: ObjectProperty
comment: A relationship between the specification of the state of a load control event produce and the value that this state can assume.
sub property of: hasState

has execution time
type: DatatypeProperty
comment: Start time of the instruction
domain: Flexibility Instruction
range: dateTimeStamp
sub property of: hasTimestamp

has failsafe consumption max
type: ObjectProperty
comment: The relationship between the failsafe power limit and the value indicating its consumption.
domain: Failsafe Power Limit
range: PropertyValue
sub property of: has power limit consumption Max

has failsafe duration
type: DatatypeProperty
comment: The relationship between the failsafe power limit and its duration. This property indicates the minimum duration the fail safe state will take once a device has entered that state.
domain: Fail-safe state
range: duration
sub property of: duration in xsd

has failsafe production max
type: ObjectProperty
comment: The relationship between the failsafe power limit and the value indicating its production.
domain: Failsafe Power Limit
range: PropertyValue
sub property of: has power limit production Max

Fill Level Range
type: ObjectProperty
comment: The range of the fill level for which this FRBC.OperationModeElement applies. If this concept is applied on a Storage it indicated the range in which a storage should remain.
domain: Class
  union of: Storage
  union of: Operation Mode Element
  union of: Leakage behaviour element
  union of: Fill level target profile element
range: Number range

has fill level target profile
type: ObjectProperty
comment: The Fill Level Target Profile of the storage that the current Fill Rate Profile tries to accomodate for. NB. This cannot be modelled as a TimeSeries, since the x-axis is not time.
domain: Storage
range: Fill level target profile

has fill level target profile element
type: ObjectProperty
comment: The various Fill Level Target Profile Elements detailing the Fill Level Target Profile that the current Fill Level Based Profile tries to accomodate for.
domain: Fill level target profile
range: Fill level target profile element

has incentive
type: ObjectProperty
comment: This property relates an IncentiveTable element, such as an IncentiveTableSlot or an IncentiveTableTier to the boundaries that it consists of.
domain: Class
  union of: Incentive table slot
  union of: Incentive table tier
range: Incentive

has incentive type
type: ObjectProperty
comment: The relationship between the tier and its incentive type
domain: Incentive table tier
range: Incentive Type

has index
type: DatatypeProperty
comment: Gives the index for elements that are an array in the S2 specification. Can be used regularly as well as in RDF* manner on properties.
range: integer

has Instruction Status
type: ObjectProperty
comment: Present status of this instruction.
range: Instruction Status

has end time Interruption
type: DatatypeProperty
comment: The end time included in an Interruption Instruction message indicating when the interruption should end.
domain: Interruption Instruction
range: dateTimeStamp
sub property of: hasTimestamp

Has Interruption Start Time
type: DatatypeProperty
comment: The start time included in an Interruption Instruction message indicating when the interruption should start.
domain: Interruption Instruction
range: dateTimeStamp
sub property of: hasTimestamp

has latest end time
type: DatatypeProperty
comment: The latest possible end time for a power sequence or a slot. Only 'xs:duration' value types SHALL be used to denote a relative time which relates to 'now' as time 0. Note: This element applies to the first repetition of the slot number only. This property is suggested to be added to SAREF4Ener_v2 to replace the time:TemporalEntity and/or time:DurationDescription.
sub property of: hasTimestamp

has leakage behaviour
type: ObjectProperty
comment: The Leakage Behaviour associated with this storage.
domain: Storage
range: Leakage behaviour

has leakage behaviour element
type: ObjectProperty
comment: This property relates the LeakageBehaviour description to the LeakageBehaviourElements indicating the detailed description.
domain: Leakage behaviour
range: Leakage behaviour element

has lower average power
type: DatatypeProperty
comment: The lower average power associated with this Energy constraint.
domain: Energy Constraint
range: integer

has lower boundary
type: ObjectProperty
comment: This property relates an IncentiveTableBoundary to the datapoint describing its lower boundary or starting point at which this boundary becomes active.
domain: Incentive
range: Data point

has max duration
type: DatatypeProperty
comment: If a slot has a configurable duration, it SHALL be present and denote the maximum supported configuration. Note: This element applies to the first repetition of the slot number only
domain: Power sequence
range: duration
sub property of: duration in xsd

has min duration
type: DatatypeProperty
comment: If a slot has a configurable duration, it SHALL be present and denote the minimum supported configuration. Note: This element applies to the first repetition of the slot number only.
domain: Power sequence
range: duration
sub property of: duration in xsd

max pause before
type: DatatypeProperty
comment: The maximum duration for which a device can be paused between the end of the previous running sequence and the start of this one
domain: Power sequence
range: duration
sub property of: duration in xsd

has nominal consumption Max
type: ObjectProperty
comment: The relationship between the nominal power limit and the value indicating the max limit consumption.
domain: Nominal Power Limit
range: PropertyValue
sub property of: has power limit consumption Max

has nominal production Max
type: ObjectProperty
comment: The relationship between the nominal power limit and the value indicating the max limit production.
domain: Nominal Power Limit
range: PropertyValue
sub property of: has power limit production Max

has activation delay
type: DatatypeProperty
comment: The scheduled activation delay for a slot.
range: duration

has number range
type: ObjectProperty
comment: This property provides the association between a power range and its number range.
domain: Power range
range: Number range

has Operation Modes
type: ObjectProperty
comment: This property indicates the s4ener:OperationMode inidicated by this Actuator, Instruction, or OperationModeProfile. The SAREF4ENER extension expects the following classes to be used as domain: - saref:Actuator - s4ener:FRBCInstruction - s4ener:DDBCInstruction - s4ener:OMBCInstruction - s4ener:OperationModeProfile
range: Operation Mode

Has Operation Mode Element
type: ObjectProperty
comment: List of OperationModeElements, which describe the properties of this FRBC.OperationMode depending on the fill_level. The fill_level_ranges of the items in the Array must be contiguous.
domain: Operation Mode
range: Operation Mode Element

Has Operation Mode Factor
type: DatatypeProperty
comment: The number indicates the factor with which the FRBC.OperationMode or OMBC.OperationMode is usedconfigured. The factor should be greater than or equal than 0 and less or equal to 1. Within the SAREF4ENER extension, this property is to be used on the following classes: - s4ener:OMBCInstruction - s4ener:OperationMode - saref:Actuator - s4ener:FRBCInstruction - s4ener:DDBCInstruction
range: decimal

has pause duration max
type: DatatypeProperty
comment: The maximum duration a power sequence can pause after the end of an activity.
domain: Power sequence
sub property of: duration in xsd
range: duration

has pause duration min
type: DatatypeProperty
comment: The minimum duration a power sequence can pause after the end of an activity.
domain: Power sequence
sub property of: duration in xsd
range: duration

has power envelope
type: ObjectProperty
comment: The PEBC.PowerEnvelope(s) that should be followed by the Resource Manager. There shall be at least one PEBC.PowerEnvelope, but at most one PEBC.PowerEnvelope for each Commodity.
domain: Class
  union of: Power Envelop Based Control Instruction
  union of: Power envelope control
range: Power Envelope

has power envelope element
type: ObjectProperty
comment: This property relates a PowerEnvelopeProfile to the various specific PowerEnvelops contained in the profile.
domain: Power envelope control
range: Power Envelope

has power limit consumption Max
type: ObjectProperty
comment: The relationship between the power limit and the value indicating the max limit consumption.
domain: Power Limit
range: PropertyValue

has power limit duration
type: DatatypeProperty
comment: The relationship between the power limit and its duration. Power limit may come with a time period of validity based on duration
domain: Power Limit
range: duration
sub property of: duration in xsd

has power limit production Max
type: ObjectProperty
comment: The relationship between the power limit and the value indicating the max limit production.
domain: Power Limit
range: PropertyValue

has power limit state
type: ObjectProperty
comment: The relationship between the power limit state and its state (active/ inactive).
domain: Power Limit

has power plan
type: ObjectProperty
comment: A reference to a power plan indicating the preliminary or committed usage of the energy smart device for a specific period.
domain: Incentive table based profile
range: Power plan

has power ranges
type: ObjectProperty
comment: The power produced or consumed by this operation mode. The start of each PowerRange is associated with an operation_mode_factor of 0, the end is associated with an operation_mode_factor of 1. In the array there must be at least one PowerRange, and at most one PowerRange per Commodity.
domain: Class
  union of: Operation Mode
  union of: Operation Mode Element
range: Power range

has power sequence
type: ObjectProperty
comment: The various Sequences contained in a Power Sequence Container among which the EMS can choose the proper PowerSequence for the current energy demands.
domain: Power profile container
range: Power sequence

has power sequence container
type: ObjectProperty
comment: The various power sequence containers contained within an S2 Power Profile. The containers have to executed one after the other. Each container contains various Power Sequence anong which the EMS can choose the appropriate Power Sequence for the current energy demands.
domain: Power profile control
range: Power profile container

has power sequence element
type: ObjectProperty
comment: A connection between the Power Sequence and the elements (or Slots) describing the exact contents.
domain: Power sequence
range: Power sequence element

has power sequence status
type: ObjectProperty
comment: This property indicates the current status of this Power Sequence.
domain: Power profile container
range: Power sequence status

Power source
type: ObjectProperty
comment: Indicates the power source of a device. Possible values are e.g. mainsSinglePhase or battery
range: Power source

has previous operation mode
type: ObjectProperty
comment: The previous operation mode this device was in
domain: Class
  union of: Actuator
  union of: Operation Mode
range: Operation Mode

has quantile
type: DatatypeProperty
comment: Used to define a quantile for example on a data point of a quantile time series. The quantile must be a ratio, usually a percentage. In a quantile forecast the hasQuantile property cannot be empty. his property assigns to the data point the percentage of values that are below this value. In other words, a data point with quantile 90 indicates that 90 % of other measurements are (estimated to be) lower.
domain: Data point
range: decimal

has recipient
type: ObjectProperty
comment: This property can be used to connect a flexibility offer or/and flexibility request to a foaf:agent or saref:Device.

has remaining pause time
type: DatatypeProperty
comment: The duration that the current slot (s4ee:activeSlotNumber) permits being paused. This element SHALL ONLY be present if the power sequence is interruptible. Otherwise, it SHALL be omitted. In case the power sequence is interruptible the following rules apply: If the element is absent this means there is no explicit pause duration restriction for the current slot; a value of 0s denoted the slot does not permit being paused.
range: duration

has remaining slot time
type: DatatypeProperty
comment: If state is set to 'running' or 'paused' AND the slot is determined, this element SHALL contain the time the slot still needs to be in 'running' state (this also means the value remains constant during a 'paused' state). Otherwise it SHALL be omitted.
range: duration

performs role
type: ObjectProperty
comment: Each Resource Manager provides one or more energy Roles
domain: Device
range: Role

role type
type: ObjectProperty
comment: The type of this specific role
domain: Role
range: Role Type

has running costs
type: ObjectProperty
comment: Additional costs per second (e.g. wear, services) associated with this operation mode in the currency defined by the ResourceManagerDetails , excluding the commodity cost. The range is expressing uncertainty and is not linked to the operation_mode_factor.
domain: Operation Mode Element
range: Number range

has scope type
type: ObjectProperty
comment: The relationship between the incentive table and the scope type
domain: Incentive table based profile
range: Scope Type

has slot value
type: ObjectProperty
comment: This property is intended to specify the power or energy value of a slot in a power sequence as part of a power profile.
domain: Slot
range: PropertyValue

has standard deviation
type: DatatypeProperty
comment: The standard deviation (i.e. the square root of the average of the squared deviations of the values subtracted from their average value) can be described with this property.
domain: Gaussian data point
range: decimal

has start time
type: DatatypeProperty
comment: The startTime of a power sequence or slot. SHALL be present
range: dateTimeStamp
sub property of: hasTimestamp

has storage
type: ObjectProperty
comment: The storage regulated by the related Fill Rate Profile.
domain: Fill rate control
range: Storage

Has Supply Range
type: ObjectProperty
comment: The SupplyRange this OperationMode of a Demand Driven Profile can deliver for the CEM to match the DemandRate. The start of the NumberRange is associated with an operation_mode_factor of 0, the end is associated with an operation_mode_factor of 1.
domain: Operation Mode
range: Number range

has temporal resolution
type: DatatypeProperty
comment: The resolution is the distance between two observation timestamps. This only makes sense if the observations are equidistant.
range: duration

has tier incentive
type: ObjectProperty
comment: The relationship between the incentive table and the tiers it consists of
domain: Incentive table based profile

Has Timer
type: ObjectProperty
comment: The set of timers that are available in this Actuator or OperationModeProfile
domain: Class
  union of: Actuator
  union of: Operation mode control
range: Timer

has transition
type: ObjectProperty
comment: The transitions between various saref:States or s4ener:OperationModes that either the Actuator or the OperationModeProfile can support.
domain: Class
  union of: Actuator
  union of: Operation mode control
range: Transition

has transition costs
type: DatatypeProperty
comment: Absolute costs for going through this Transition in the currency as described in the ResourceManagerDetails.
domain: Transition
range: decimal

Transition Duration
type: DatatypeProperty
comment: Indicates the time between the initiation of this Transition, and the time at which the device behaves according to the Operation Mode which is defined in the appropriate data element. When no value is provided it is assumed the transition duration is negligible.
domain: Transition
range: duration
sub property of: duration in xsd

transition Timestamp
type: DatatypeProperty
comment: Time at which the transition from the previous Operation Mode was initiated. This value shall always be provided, unless the active OperationMode is the first OperationMode the Resource Manager is aware of.
domain: Class
  union of: Operation Mode
  union of: Actuator
range: dateTimeStamp
sub property of: hasTimestamp

has update rate
type: DatatypeProperty
comment: The rate at which a data point or time-series or forecast or other data entity is being updated. If the time series gets regularly updated, then the time between two updates can be recorded here.
range: duration

has upper average power
type: DatatypeProperty
comment: The upper average power of an Energy constraint of a Power Envelope profile.
domain: Energy Constraint
range: integer

is writable
type: DatatypeProperty
comment: This Boolean value indicates whether this power plan is writable or fixed.
domain: Power plan
range: boolean

has upper boundary
type: ObjectProperty
comment: This property relates a boundary to its upper boundary or the value at which this incentive becomes inactive. This value is optional, because the upper boundary can be inferred from the lower boundary of the next boundary.
domain: Incentive
range: Data point

has usage
type: ObjectProperty
comment: This property provides the possibility to add some additional information about the usage of a data-point or time-series. For example, a data point or time series can be used as an upper limit, a lower limit, a baseline, a maximum versus minimum value, or a consumption versus a production value.
range: Usage

Has Usage Forecast
type: ObjectProperty
comment: Indicates the usage forecast that may be relevant to decide the energy flexibility strategy following a specific flexibility profile, specifically a fill rate based profile or incentive table. In SAREF4ENER this property is intended to be applied on an s4ener:FlexibilityProfile.
range: Time Series

has value
type: DatatypeProperty
comment: Power value expressed in the unit associated with the Commodity of the Power Value.
range: decimal

has value source
type: ObjectProperty
comment: Indicates the source (origin/foundation) of the observation forecasted values for a power sequence. If absent, the source is undefined. Remark: This element shall express the reliability of the forecast.
range: Value source

includes
type: ObjectProperty
comment: This property can be used to connect the flexibility offer and/or flexibility request to the flexibility profile. Additionally, it can be used to specify the s4ener:datapoint, s4ener:timeseries and ic-fc:forecast included in the flexibility offer and/or flexibility request.

is active
type: DatatypeProperty
comment: Indicates whether the power limit is currently active
domain: Power Limit
range: boolean

is actuated by
type: ObjectProperty
comment: A reference to an (external) actuator that can potentially activate this profile or where the instruction originates from.
domain: Class
  union of: Demand driven control
  union of: Fill rate control
  union of: Fill Rate Based Control Instruction
  union of: Demand Driven Based Control Instruction
range: Actuator

is blocked by
type: ObjectProperty
comment: The Timers that block this Transition from initiating while at least one of these Timers is not yet finished
domain: Transition
range: Timer

is bound to
type: ObjectProperty
comment: The relationship between a device and its contractual power limit
domain: Power limit profile
range: Contractual Power Limit

is changeable
type: DatatypeProperty
comment: A relationship indicating that this element can be changed by its operator. The boolean value indicates whether it is indeed changeable. In the SAREF4ENER extension this property is intended for PowerLimits and IncentiveTable elements, such as the IncentiveTableProfile, IncentiveTableSlot, and the IncentiveTableTier.
range: boolean

is finished at
type: DatatypeProperty
comment: Indicates when the Timer will be finished. If the DateTimeStamp is in the future, the timer is not yet finished. If the DateTimeStamp is in the past, the timer is finished. When the timer was never started, the value can be an arbitrary DateTimeStamp in the past.
domain: Timer
range: dateTimeStamp
sub property of: hasTimestamp

is interruptible
type: DatatypeProperty
comment: This property indicates whether the PowerSequence is interruptible.
domain: Power sequence
range: boolean

is limited with
type: ObjectProperty
comment: The relationship between device and failsafe power limit
domain: Power limit profile
range: Failsafe Power Limit

is obligatory
type: DatatypeProperty
comment: A relationship between the power limit and the boolean value indicating whether the power limit is obligatory
domain: Power Limit
range: boolean

is pausable
type: DatatypeProperty
comment: Specifies if the power sequence is pausable.
range: boolean

is protected by
type: ObjectProperty
comment: The relationship between the device and the nominal power limit
domain: Power limit profile
range: Nominal Power Limit

is stoppable
type: DatatypeProperty
comment: Specifies if the power sequence is stoppable.
range: boolean

Leakage Rate
type: ObjectProperty
comment: Indicates how fast the momentary fill level will decrease per second due to leakage within the given range of the fill level.
domain: Leakage behaviour element
range: PropertyValue

Limit Type
type: ObjectProperty
comment: Indicates if this ranges applies to the upper limit or the lower limit.
domain: Allowed limit range
range: Power Envelope Limit Type

max cycles per day
type: DatatypeProperty
comment: States the maximum amount of starts a power sequence (of a device) allows per day.
range: unsignedInt

node remote controllable
type: DatatypeProperty
comment: Indicates whether the power profile of a device is configured for remote control (e.g., by an energy management system).This refers to the selection chosen by the user on the remote control feature of the device. If nodeRemoteControllable is equal to FALSE, all the supported power sequences shall set the sequenceRemoteControllable property to FALSE. If nodeRemoteControllable is equal to TRUE, at least one power sequence shall be remotely controllable by setting the sequenceRemoteControllable property to TRUE.
range: boolean

optional slot
type: DatatypeProperty
comment: Indicates whether a slot is optional (if set to TRUE). Otherwise, if a slot is mandatory, SHALL be omitted or set to FALSE. Note: This element applies to every repetition of the slot number.
range: boolean

present fill level
type: ObjectProperty
comment: A saref:PropertyValue with a percentage value indicating the fill level of the storage.
domain: Storage
range: PropertyValue

produced by
type: ObjectProperty
comment: A relation between an entity (datapoint, message, timeseries, instruction) that has been produced by a device or other agent. In the context of SAREF4ENER this property is intended for s4ener:DataPoint, s4ener:TimeSeries, and the various types of flexibility instructions, FlexOffers and FlexRequests.
range: Class
  union of: Agent
  union of: Device

progress
type: DatatypeProperty
comment: Time that has passed since the selected sequence has started. A value must be provided, unless no sequence has been selected or the selected sequence hasn't started yet.
domain: Power profile container
range: duration

range boundary
type: ObjectProperty
comment: Boundaries of the power range of this PEBC.AllowedLimitRange. The CEM is allowed to choose values within this range for the power envelope for the limit as described in limit_type. The start of the range shall be smaller or equal than the end of the range.
domain: Class
  union of: Allowed limit range
  union of: Energy Constraint
range: Number range

receives
type: ObjectProperty
comment: A relationship between a device (e.g., an appliance or a smart meter) and a load control event

receives power limit
type: ObjectProperty
comment: The relationship between a power limit profile and the power limit it has received for its device to follow
domain: Power limit profile
range: Power Limit

relates to commodity quantity
type: ObjectProperty
comment: Relates the classes to the various commodities introduced by the S2 standard. In the SAREF4ENER extension this property is intended for the following: - s4ener:PowerRange - s4ener:AllowedLimitRange - s4ener:EnergyConstraint - s4ener:PowerEnvelope
range: Commodity

relates to offer
type: ObjectProperty
comment: The relationship between the s4ener:FlexibilityInstruction and the flexibility offer.
domain: Flexibility Instruction
range: Flex offer

Relates to power profile
type: ObjectProperty
comment: ID of the PPBC.PowerProfileDefinition of which the PPBC.PowerSequence is being selected and scheduled by the CEM.
domain: Power Profile Based Control Instruction
range: Power profile control

Relates to power profile sequence
type: ObjectProperty
comment: ID of the PPBC.PowerSequence that is being selected and scheduled by the CEM.
domain: Power Profile Based Control Instruction
range: Power sequence

Relates to power profile sequence container
type: ObjectProperty
comment: ID of the PPBC.PowerSequnceContainer of which the PPBC.PowerSequence is being selected and scheduled by the CEM.
domain: Power Profile Based Control Instruction
range: Power profile container

relates to request
type: ObjectProperty
comment: The relationship between the flexibility offer and flexibility request
domain: Flex offer
range: Flex request

repetition total
type: DatatypeProperty
comment: Contains the total number of repetitions, if a power sequence repeats its sequence of slots. Absence of the element is equal to a presence with a value of 0 (zero). SHALL be absent if the value is 1.
range: unsignedInt

requiresUpdate
type: DatatypeProperty
comment: The relationship between the incentive table element and the boolean data indicating whether the incentive table requires an update. In the SAREF4ENER extension this property is intended for the following classes: - IncentiveTableProfile - IncentiveTableTier - IncentiveTableSlot
range: boolean

sequence remote controllable
type: DatatypeProperty
comment: Denotes whether a power sequence is modifiable (if value is TRUE) or not (if value is FALSE). Modifiability is required to configure power sequences and slots. It is also required to change a power sequence state.
range: boolean

serial number
type: DatatypeProperty
comment: Indicates the serial number of a device as defined by the manufacturer. Usually the same as printed on the case.
range: string

slot activated
type: DatatypeProperty
comment: If a slot is optional, represents the current status of the slot (true = the slot will be executed, false = the slot will not be executed). If the slot is not optional, this element SHALL be absent.
range: boolean

slot number
type: DatatypeProperty
comment: Provides a unique slot identifier for a certain power sequence
range: unsignedInt

software revision
type: DatatypeProperty
comment: Indicates the software revision of a device as defined by the manufacturer.
range: string

start of range
type: ObjectProperty
comment: This property indicates the start of a number range.
domain: Number range
range: PropertyValue

Starts Timer
type: ObjectProperty
comment: List of IDs of Timers that will be (re)started when this transition is initiated
domain: Transition
range: Timer

supports reselection
type: DatatypeProperty
comment: If set toTRUE, the power profile of a device does not restrict the number of power sequence re-selections by the CEM, i.e. within a given alternative the CEM may first choose one power sequence, alter the selection by configuring another sequence later on, then alter the selection again, etc. (provided the process rules and data still permit configuration). If supportsReselection is set to FALSE, the device permits the CEM to select a power sequence of an alternative only once.
range: boolean

supports single slot scheduling only
type: DatatypeProperty
comment: If set toTRUE, the power profile of a device does NOT permit the modification of more than one slot per configuration command.
range: boolean

to state operation mode
type: ObjectProperty
comment: ID of the OperationMode (exact type differs per ControlType) that will be switched to.
domain: Transition
range: Operation Mode

total sequences count max
type: DatatypeProperty
comment: Represents the total number of power sequences supported by the power profile of a device
range: unsignedInt

triggers event action consume
type: ObjectProperty
comment: A relationship between a load control event and the consume action triggered by this event

triggers event action produce
type: ObjectProperty
comment: A relationship between a load control event and the produce action triggered by this event

value tendency
type: ObjectProperty
comment: Indicates whether the tendency of an observation is rising, stable, or falling.
range: Value tendency

vendor code
type: DatatypeProperty
comment: Provides a code for the vendor of the device as defined by the manufacturer.
range: string

vendor name
type: DatatypeProperty
comment: Provides the name of the vendor of the device as defined by the manufacturer.
range: string

Anais Walle
type: NamedIndividual

George Hallak
type: NamedIndividual

Georg Jung
type: NamedIndividual

Josef Baumeister
type: NamedIndividual

Wilco Wijbrandi
type: NamedIndividual