diff --git a/documentation/description.html b/documentation/description.html index 8fb9b972c3601ef0f9a704749fac1390f3546830..73e11ed6525cad0ac5e6ae66d550609892a7fad7 100644 --- a/documentation/description.html +++ b/documentation/description.html @@ -20,9 +20,9 @@

As it can be observed in Figure 3, the modelling of measurements in the SAREF4WATR ontology mostly relies on the measurement model proposed in SAREF.

-

SAREF allows to define the temporal extent of a measurement by defining the timestamp for it (using the saref:hasTimestamp property). However, the SAREF4WATR extension also required to be able to define the temporal interval to which a measurement applies, apart from the temporal instant defined by the timestamp. Therefore, the s4watr:hasPhenomenonTime property has been defined in this extension to define the time for which the measurement applies to a feature of interest. The range of this property time has been defined as a time:TemporalEntity, which allows defining temporal intervals or instants.

+

SAREF allows to define the temporal extent of a measurement by defining the timestamp for it (using the saref:hasTimestamp property). However, the SAREF4WATR extension also required to be able to define the temporal interval to which a measurement applies, apart from the temporal instant defined by the timestamp. Therefore, the s4watr:hasPhenomenonTime property has been defined in this extension to define the time for which the measurement applies to a feature of interest. The range of this property time has been defined as a time:TemporalEntity, which allows defining temporal intervals or instants.

-

Besides, the extension requires to be able to represent those devices that measure a certain feature of interest (and those features of interest that are measured by a device) independently of having measures from which this relationship could be inferred. Because of this, in this extension we have created four new properties to relate saref:Device and saref:FeatureOfInterest: s4watr:featureIsMeasuredByDevice, s4watr:featureIsControlledByDevice, s4watr:measuresFeature, and s4watr:controlsFeature.

+

Besides, the extension requires to be able to represent those devices that measure a certain feature of interest (and those features of interest that are measured by a device) independently of having measures from which this relationship could be inferred. Because of this, in this extension we have created four new properties to relate saref:Device and saref:FeatureOfInterest: s4watr:featureIsMeasuredByDevice, s4watr:featureIsControlledByDevice, s4watr:measuresFeature, and s4watr:controlsFeature.

Measurement model @@ -32,11 +32,11 @@

Water meter

-

Figure 4 provides an overview of how to represent a water meter using the s4watr:WaterMeter class. The representation of water meters and their properties has been extracted from the European M-Bus standard (EN 13757).

+

Figure 4 provides an overview of how to represent a water meter using the s4watr:WaterMeter class. The representation of water meters and their properties has been extracted from the European M-Bus standard (EN 13757).

-

A water meter may be defined by the properties inherited from SAREF (e.g., saref:hasManufacturer or saref:hasModel) and also by a set of properties defined in SAREF4WATR to indicate: its fabrication number (s4watr:hasFabricationNumber), its firmware version (s4watr:hasFirmwareVersion), its hardware version (s4watr:hasHardwareVersion), its version (s4watr:hasVersion), the radio frequency in which it operates (s4watr:operatesAtRadioFrequency), and its required power (s4watr:requiresPower).

+

A water meter may be defined by the properties inherited from SAREF (e.g., saref:hasManufacturer or saref:hasModel) and also by a set of properties defined in SAREF4WATR to indicate: its fabrication number (s4watr:hasFabricationNumber), its firmware version (s4watr:hasFirmwareVersion), its hardware version (s4watr:hasHardwareVersion), its version (s4watr:hasVersion), the radio frequency in which it operates (s4watr:operatesAtRadioFrequency), and its required power (s4watr:requiresPower).

-

Measurements may be taken from the water meter themselves. To enable the representation of such measurements, water meters are defined as features of interest (saref:FeatureOfInterest) and a non-exhaustive list of properties has been defined based on the M-Bus standard to allow measuring: on time (s4watr:MeterOnTime), operating time (s4watr:MeterOperatingTime), battery operating time (s4watr:BatteryOperatingTime), battery last change (s4watr:BatteryLastChange), and battery remaining time (s4watr:BatteryRemainingTime).

+

Measurements may be taken from the water meter themselves. To enable the representation of such measurements, water meters are defined as features of interest (saref:FeatureOfInterest) and a non-exhaustive list of properties has been defined based on the M-Bus standard to allow measuring: on time (s4watr:MeterOnTime), operating time (s4watr:MeterOperatingTime), battery operating time (s4watr:BatteryOperatingTime), battery last change (s4watr:BatteryLastChange), and battery remaining time (s4watr:BatteryRemainingTime).

Water meter model @@ -46,7 +46,7 @@

Water flow

-

Water meters are mainly intended to measure water flows. SAREF4WATR defines the main properties related to the water flow that are defined in the European M-Bus standard (EN 13757): pressure (s4watr:FlowPressure), rate (s4watr:FlowRate), temperature(s4watr:FlowTemperature), and volume(s4watr:FlowVolume). These properties are depicted in Figure 5.

+

Water meters are mainly intended to measure water flows. SAREF4WATR defines the main properties related to the water flow that are defined in the European M-Bus standard (EN 13757): pressure (s4watr:FlowPressure), rate (s4watr:FlowRate), temperature(s4watr:FlowTemperature), and volume(s4watr:FlowVolume). These properties are depicted in Figure 5.

Water flow model @@ -54,7 +54,7 @@
-

There are also other environmental factors that are relevant since they affect water and the infrastructures using it. Therefore, the following environmental properties, depicted in Figure 6, are defined: atmospheric pressure (s4watr:AtmosphericPressure), humidity (s4watr:Humidity), precipitation (s4watr:Precipitation) and temperature (s4watr:ExternalTemperature).

+

There are also other environmental factors that are relevant since they affect water and the infrastructures using it. Therefore, the following environmental properties, depicted in Figure 6, are defined: atmospheric pressure (s4watr:AtmosphericPressure), humidity (s4watr:Humidity), precipitation (s4watr:Precipitation) and temperature (s4watr:ExternalTemperature).

Environmental properties model @@ -64,10 +64,10 @@

Tariff

-

SAREF4WATR allows describing the tariff that is applied to a water meter by means of the s4watr:Tariff class, as presented in Figure 7. The representation of tariffs has been extracted from the CEN/TR 17167 technical report.

+

SAREF4WATR allows describing the tariff that is applied to a water meter by means of the s4watr:Tariff class, as presented in Figure 7. The representation of tariffs has been extracted from the CEN/TR 17167 technical report.

-

A tariff may be described using different properties to describe its: start timestamp (s4watr:hasStartTimestamp), duration (s4watr:hasDuration), period (s4watr:hasPeriod), billing date (s4watr:hasBillingDate), and billing period (s4watr:hasBillingPeriod). Besides, a tariff can be related to a water meter by means of the s4watr:appliesTo property. -There are different types of tariffs, depending on whether they are based on thresholds (s4watr:ThresholdBasedTariff), consumption (s4watr:ConsumptionBasedTariff), or time (s4watr:TimeBasedTariff). Each of these types of tariffs has its own properties: for threshold-based ones their volume flow can be defined (s4watr:forVolumeFlow), for consumption-based ones their volume and financial consumption can be defined (s4watr:forVolumeConsumption and s4watr:forFinancialConsumption, respectively), and for time-based ones their absolute time at day, week day and day in month can be defined (s4watr:forAbsoluteTimeAtDay, s4watr:forWeekDay and s4watr:forDayInMonth, respectively). It is also possible to define a combined tariff by making it an instance of more than one type of tariff.

+

A tariff may be described using different properties to describe its: start timestamp (s4watr:hasStartTimestamp), duration (s4watr:hasDuration), period (s4watr:hasPeriod), billing date (s4watr:hasBillingDate), and billing period (s4watr:hasBillingPeriod). Besides, a tariff can be related to a water meter by means of the s4watr:appliesTo property. +There are different types of tariffs, depending on whether they are based on thresholds (s4watr:ThresholdBasedTariff), consumption (s4watr:ConsumptionBasedTariff), or time (s4watr:TimeBasedTariff). Each of these types of tariffs has its own properties: for threshold-based ones their volume flow can be defined (s4watr:forVolumeFlow), for consumption-based ones their volume and financial consumption can be defined (s4watr:forVolumeConsumption and s4watr:forFinancialConsumption, respectively), and for time-based ones their absolute time at day, week day and day in month can be defined (s4watr:forAbsoluteTimeAtDay, s4watr:forWeekDay and s4watr:forDayInMonth, respectively). It is also possible to define a combined tariff by making it an instance of more than one type of tariff.

Tariff model @@ -77,7 +77,7 @@ There are different types of tariffs, depending on whether they are based on thr

Water types

-

SAREF4WATR defines four types of water as instances of the s4watr:Water class: raw water (s4watr:RawWater), drinking water (s4watr:DrinkingWater), storm water (s4watr:StormWater), and waste water (s4watr:WasteWater). All these types of water, depicted in Figure 8, are defined as features of interest (saref:FeatureOfInterest), so measurements and key performance indicators can be defined over them.

+

SAREF4WATR defines four types of water as instances of the s4watr:Water class: raw water (s4watr:RawWater), drinking water (s4watr:DrinkingWater), storm water (s4watr:StormWater), and waste water (s4watr:WasteWater). All these types of water, depicted in Figure 8, are defined as features of interest (saref:FeatureOfInterest), so measurements and key performance indicators can be defined over them.

Water types model @@ -87,7 +87,7 @@ There are different types of tariffs, depending on whether they are based on thr

Water properties

-

SAREF4WATR includes a classification of the different water properties based on the classification proposed by the World Health Organization, as shown in Figure 9. Water properties (s4watr:WaterProperty) are classified into acceptability (s4watr:AcceptabilityProperty), chemical (s4watr:ChemicalProperty), and microbial (s4watr:MicrobialProperty) ones, being bacterial (s4watr:BacterialProperty) properties a subclass of microbial ones. +

SAREF4WATR includes a classification of the different water properties based on the classification proposed by the World Health Organization, as shown in Figure 9. Water properties (s4watr:WaterProperty) are classified into acceptability (s4watr:AcceptabilityProperty), chemical (s4watr:ChemicalProperty), and microbial (s4watr:MicrobialProperty) ones, being bacterial (s4watr:BacterialProperty) properties a subclass of microbial ones. The extension defines different individuals for each type of water property, based in different EC directives on the quality of drinking water, bathing water, and groundwater. This list of individuals does not aim to be exhaustive but to reflect the potential use of the ontology. Note, for example, that it is out of the scope to categorize chemical compounds according to their intended use (e.g., pesticide, fertilizer, etc.).

@@ -98,7 +98,7 @@ The extension defines different individuals for each type of water property, bas

Water infrastructure

-

In SAREF4WATR water infrastructures can be defined using the s4watr:WaterInfrastructure class. Such infrastructures may be designed for one of the water types described above (through the s4watr:isDesignedFor property), may have an intended use (through the s4watr:isIntendedFor property), and may be classified into five different types, although others may be defined if needed: distribution systems (s4watr:DistributionSystem), storage infrastructures (s4watr:StorageInfrastructure), treatment plants (s4watr:TreatmentPlant), hydroelectric power plants (s4watr:HydroelectricPowerPlant), and monitoring infrastructures (s4watr:MonitoringInfrastructure).

+

In SAREF4WATR water infrastructures can be defined using the s4watr:WaterInfrastructure class. Such infrastructures may be designed for one of the water types described above (through the s4watr:isDesignedFor property), may have an intended use (through the s4watr:isIntendedFor property), and may be classified into five different types, although others may be defined if needed: distribution systems (s4watr:DistributionSystem), storage infrastructures (s4watr:StorageInfrastructure), treatment plants (s4watr:TreatmentPlant), hydroelectric power plants (s4watr:HydroelectricPowerPlant), and monitoring infrastructures (s4watr:MonitoringInfrastructure).

In order to represent the topology of a water infrastructure or its assets, the GeoSPARQL ontology has been reused and connected to the SARE4WATR terms. As shown in Figure 10, for representing spatial objects the geosp:SpatialObject class from GeoSPARQL has been reused along with its subclasses that allow defining spatial features (geosp:Feature) and geometries (geosp:Geometry). Different properties from GeoSPARQL can be reused to define spatial relations among spatial objects (e.g., geosp:sfContains, or geosp:sfWithin)or to define the geometry of a feature (geosp:hasGeometry). Two types of geometries from the GeoSPARQL Simple Features ontology are proposed to be used: points (sf:Point) and polygons (sf:Polygon), although others may also be used from that same ontology or from another one. We refer to the GeoSPARQL standard for further details on how to define the topology of water infrastructures.

@@ -109,11 +109,11 @@ We refer to the GeoSPARQL standard for further details on how to define the topo
-

By reusing the SAREF4SYST ontology, the different subsystems of a water infrastructure may be defined. A water infrastructure is a complex system (s4syst:System) and each of its subsystems may be defined (using the s4syst:hasSubSystem property) as a water asset (s4watr:WaterAsset).

+

By reusing the SAREF4SYST ontology, the different subsystems of a water infrastructure may be defined. A water infrastructure is a complex system (s4syst:System) and each of its subsystems may be defined (using the s4syst:hasSubSystem property) as a water asset (s4watr:WaterAsset).

-

As shown in Figure 11, SAREF4WATR defines the main types of water assets found in the literature in a hierarchy that is not intended to be exhaustive and that may be extended if needed. This hierarchy classifies water assets into source assets (s4watr:SourceAsset), sink assets (s4watr:SinkAsset), storage assets (s4watr:StorageAsset), and transport assets (s4watr:TransportAsset).

+

As shown in Figure 11, SAREF4WATR defines the main types of water assets found in the literature in a hierarchy that is not intended to be exhaustive and that may be extended if needed. This hierarchy classifies water assets into source assets (s4watr:SourceAsset), sink assets (s4watr:SinkAsset), storage assets (s4watr:StorageAsset), and transport assets (s4watr:TransportAsset).

-

A dedicated class has been defined for water devices (s4watr:WaterDevice), which are those water assets that are also devices according to SAREF (saref:Device). A water meter, described above, is one special type of water device, among other possible water-related sensors and actuators.

+

A dedicated class has been defined for water devices (s4watr:WaterDevice), which are those water assets that are also devices according to SAREF (saref:Device). A water meter, described above, is one special type of water device, among other possible water-related sensors and actuators.

Water asset model @@ -123,9 +123,9 @@ We refer to the GeoSPARQL standard for further details on how to define the topo

Key Performance Indicator

-

Figure 12 provides an overview of the modelling of Key Performance Indicators (KPI). The KPI modelling involves two main concepts, namely s4city:KeyPerformanceIndicator and s4city:KeyPerformanceIndicatorAssessment. As can be seen in the figure, the modelling of KPIs in SAREF4WATR totally relies on the KPI model proposed in SAREF4CITY.

+

Figure 12 provides an overview of the modelling of Key Performance Indicators (KPI). The KPI modelling involves two main concepts, namely s4city:KeyPerformanceIndicator and s4city:KeyPerformanceIndicatorAssessment. As can be seen in the figure, the modelling of KPIs in SAREF4WATR totally relies on the KPI model proposed in SAREF4CITY.

-

In SAREF4WATR, KPIs are intended to be defined for water infrastructures (s4watr:WaterInfrastructure). However, KPIs may also be defined for other features of interest.

+

In SAREF4WATR, KPIs are intended to be defined for water infrastructures (s4watr:WaterInfrastructure). However, KPIs may also be defined for other features of interest.

Key Performance Indicator model diff --git a/documentation/examples.html b/documentation/examples.html index 2e04f42dfa84900b44e54230c0eb863b791413d9..9b1d5f92fc808270d944054c0f97fbdff92efb09 100644 --- a/documentation/examples.html +++ b/documentation/examples.html @@ -1,11 +1,11 @@ -

The example presented in Figure 13 depicts a water meter (ex:Meter4837QW123). It can be described by a set of static properties either reused from SAREF (e.g., saref:hasModel) or from SAREF4WATR (e.g., s4watr:hasFirmwareVersion). The spatial extent of the meter is described by its geometry (ex:MeterGeom) that is represented as a point in space following its WKT representation. SAREF4WATR defines different measurable properties of a water meter, among them the battery remaining time (s4watr:BatteryRemainingTime) that is the one used in the example. Measurements of the meter for this property can be represented (ex:WMMeasurement200206) using for example the time instant of the measurement, its value and the unit of measure.

+

The example presented in Figure 13 depicts a water meter (ex:Meter4837QW123). It can be described by a set of static properties either reused from SAREF (e.g., saref:hasModel) or from SAREF4WATR (e.g., s4watr:hasFirmwareVersion). The spatial extent of the meter is described by its geometry (ex:MeterGeom) that is represented as a point in space following its WKT representation. SAREF4WATR defines different measurable properties of a water meter, among them the battery remaining time (s4watr:BatteryRemainingTime) that is the one used in the example. Measurements of the meter for this property can be represented (ex:WMMeasurement200206) using for example the time instant of the measurement, its value and the unit of measure.

Example of water meter
Figure 13: Example of water meter
-

The main function of water meters is to measure water flow. Figure 14 presents two examples of water flow measurements (ex:WFMeasurement170206 and ex:WFMeasurement643234) for two different water flow properties (s4watr:FlowVolume and s4watr:ExternalTemperature, respectively). Notice how the flow volume measurement is described with a time instant while the external temperature one is described with a time interval (ex:PT838452).

+

The main function of water meters is to measure water flow. Figure 14 presents two examples of water flow measurements (ex:WFMeasurement170206 and ex:WFMeasurement643234) for two different water flow properties (s4watr:FlowVolume and s4watr:ExternalTemperature, respectively). Notice how the flow volume measurement is described with a time instant while the external temperature one is described with a time interval (ex:PT838452).

Example of water meter measurements @@ -19,14 +19,14 @@
Figure 15: Example of tariff
-

The measurement of the different properties of the water itself is also of interest. Figure 16 presents two measurements (ex:DTSMeasurement106 and ex:DTSMeasurement107) of one chemical property (s4watr:Cadmium) and of one bacterial property (s4watr:EscherichiaColi), along with their timestamps, values and units. Even if SAREF4WATR includes a set of predefined water properties, other properties could be defined by instantiating the corresponding s4watr:WaterProperty subclass.

+

The measurement of the different properties of the water itself is also of interest. Figure 16 presents two measurements (ex:DTSMeasurement106 and ex:DTSMeasurement107) of one chemical property (s4watr:Cadmium) and of one bacterial property (s4watr:EscherichiaColi), along with their timestamps, values and units. Even if SAREF4WATR includes a set of predefined water properties, other properties could be defined by instantiating the corresponding s4watr:WaterProperty subclass.

Example of water measurements
Figure 16: Example of water measurements
-

Figure 17 depicts a water infrastructure (ex:DowntownDS) that represents a distribution system for drinking water (s4watr:DrinkingWater) intended for domestic use (s4watr:Domestic). The spatial extent of the infrastructure is described by its geometry (ex:DSGeom) that is represented as a polygon in space following its WKT representation. The water distribution system has different subsystems: a water meter (ex:Meter4837QW123), a tank (ex:Tank38472) and a pump (ex:PumpRT73467). These subsystems can be represented through their geometries, as points in the example (ex:MeterGeom, ex:TankGeom, ex:PumpGeom), and different measures could be made of them such as the one depicted (ex:PMeasurement854306) that measures the flow rate (s4watr:FlowRate) of the pump.

+

Figure 17 depicts a water infrastructure (ex:DowntownDS) that represents a distribution system for drinking water (s4watr:DrinkingWater) intended for domestic use (s4watr:Domestic). The spatial extent of the infrastructure is described by its geometry (ex:DSGeom) that is represented as a polygon in space following its WKT representation. The water distribution system has different subsystems: a water meter (ex:Meter4837QW123), a tank (ex:Tank38472) and a pump (ex:PumpRT73467). These subsystems can be represented through their geometries, as points in the example (ex:MeterGeom, ex:TankGeom, ex:PumpGeom), and different measures could be made of them such as the one depicted (ex:PMeasurement854306) that measures the flow rate (s4watr:FlowRate) of the pump.

Example of water infrastructure and water assets