Commit c95c6253 authored by Raul Garcia-Castro's avatar Raul Garcia-Castro
Browse files

Merge branch 'issue-4' into 'develop-v2.1.1' 

Deprecated terms have been replaced.

Closes #4

See merge request !7
parents c9b74275 4539200d

documentation/description.html

+14 −14
Original line number Diff line number Diff line
@@ -17,8 +17,8 @@ 
	</figure>



	<figure>

	  <a href="diagrams/SAREF4GRID_Overview_2.png"><img src="diagrams/SAREF4GRID_Overview_2.png" alt="SAREF4GRID overview: Measurements and profiles"/></a>

	  <figcaption id="Figure_2">Figure 2: SAREF4GRID overview: Measurements and profiles</figcaption>

	  <a href="diagrams/SAREF4GRID_Overview_2.png"><img src="diagrams/SAREF4GRID_Overview_2.png" alt="SAREF4GRID overview: Observations and profiles"/></a>

	  <figcaption id="Figure_2">Figure 2: SAREF4GRID overview: Observations and profiles</figcaption>

	</figure>



	<figure>
@@ -39,11 +39,11 @@ 


	<p>Unlike in other SAREF extensions, meter-specific information is not defined using properties from SAREF. This is because the DLMS/COSEM standard defines the data 

	  structures to model meters from simple up to very complex functionality (IEC 62056-6-2:2017). Moreover, each piece of information within the metering equipment 

	  has a unique identifier called OBIS (OBject Identification System) which identifies the instance of a COSEM object (IEC 62056-6-1:2017). This data includes not only measurement values, 

	  has a unique identifier called OBIS (OBject Identification System) which identifies the instance of a COSEM object (IEC 62056-6-1:2017). This data includes not only observation values, 

	  but also abstract values used for configuration or for obtaining information about the behaviour of the metering equipment.</p>



	<p>For this reason, the characteristics of the meter are represented as properties that are not observable by the meter (<a href="#s4grid:MeterProperty">s4grid:MeterProperty</a>, 

	fully represented in <a href="#Figure_6">Figure 6</a>), i.e., they are not measurements (<a href="https://saref.etsi.org/core/Measurement">saref:Measurement</a>).

	fully represented in <a href="#Figure_6">Figure 6</a>), i.e., they are not observations (<a href="https://saref.etsi.org/core/Observation">saref:Observation</a>).

		The properties of a meter are defined by a value (<a href="https://saref.etsi.org/core/PropertyValue">saref:PropertyValue</a>) and some are complemented with a unit of measurement 

		(<a href="https://saref.etsi.org/core/UnitOfMeasure">saref:UnitOfMeasure</a>).</p>
@@ -204,26 +204,26 @@ 


	<h3>Power Line Properties</h3>



	<p>As it can be observed in <a href="#Figure_14">Figure 14</a> and <a href="#Figure_15">Figure 15</a>, the modelling of measurements in the SAREF4GRID ontology mostly relies on the measurement model proposed in SAREF. 

	In order to reduce duplication with SAREF documentation, the reader is referred to the SAREF specification for details about measurement modelling including here details only for the new concepts.</p>

	<p>As it can be observed in <a href="#Figure_14">Figure 14</a> and <a href="#Figure_15">Figure 15</a>, the modelling of observations in the SAREF4GRID ontology mostly relies on the observation model proposed in SAREF. 

	In order to reduce duplication with SAREF documentation, the reader is referred to the SAREF specification for details about observation modelling including here details only for the new concepts.</p>



	<p>The DLMS/COSEM standard (IEC 62056) defines the measurements that a meter must take from a power line. It should be noted that in SAREF4GRID 

	<p>The DLMS/COSEM standard (IEC 62056) defines the observations that a meter must take from a power line. It should be noted that in SAREF4GRID 

	only the general properties are being defined. In order to use a more specific property it is neccesary to indicate the general property from which it 

	comes from. The properties that are defined in SAREF4GRID, which are measured from a power line (<a href="#s4grid:PowerLine">s4grid:PowerLine</a>), are depicted in 

	<a href="#Figure_14">Figure 14</a> and <a href="#Figure_15">Figure 15</a>.</p>

	

	<p>SAREF4GRID categorises the main properties related to the enregy an power measurements of a power line (<a href="#s4grid:EnergyPowerProperty">s4grid:EnergyPowerProperty</a>): active energy measurements 

	  (<a href="#s4grid:ActiveEnergy">s4grid:ActiveEnergy</a>), reactive energy measurements (<a href="#s4grid:ReactiveEnergy">s4grid:ReactiveEnergy</a>), apparent power measurements 

	  (<a href="#s4grid:ApparentPower">s4grid:ApparentPower</a>), demand register measurements (<a href="#s4grid:DemandRegister">s4grid:DemandRegister</a>), active power measurements 

	  (<a href="#s4grid:ActivePower">s4grid:ActivePower</a>), reactive power measurements (<a href="#s4grid:ReactivePower">s4grid:ReactivePower</a>), current measurements (<a href="#s4grid:Current">s4grid:Current</a>), voltage measurements 

	  (<a href="#s4grid:Voltage">s4grid:Voltage</a>) and power factor related measurements (<a href="#s4grid:PowerFactor">s4grid:PowerFactor</a>).</p>

	<p>SAREF4GRID categorises the main properties related to the enregy an power observations of a power line (<a href="#s4grid:EnergyPowerProperty">s4grid:EnergyPowerProperty</a>): active energy observations 

	  (<a href="#s4grid:ActiveEnergy">s4grid:ActiveEnergy</a>), reactive energy observations (<a href="#s4grid:ReactiveEnergy">s4grid:ReactiveEnergy</a>), apparent power observations 

	  (<a href="#s4grid:ApparentPower">s4grid:ApparentPower</a>), demand register observations (<a href="#s4grid:DemandRegister">s4grid:DemandRegister</a>), active power observations 

	  (<a href="#s4grid:ActivePower">s4grid:ActivePower</a>), reactive power observations (<a href="#s4grid:ReactivePower">s4grid:ReactivePower</a>), current observations (<a href="#s4grid:Current">s4grid:Current</a>), voltage observations 

	  (<a href="#s4grid:Voltage">s4grid:Voltage</a>) and power factor related observations (<a href="#s4grid:PowerFactor">s4grid:PowerFactor</a>).</p>

	

	<figure>

	  <a href="diagrams/SAREF4GRID_Energy_and_power_properties.png"><img src="diagrams/SAREF4GRID_Energy_and_power_properties.png" alt="Energy and power property model"/></a>

	  <figcaption id="Figure_14">Figure 14: Energy and power property model</figcaption>

	</figure>

	

	<p> SAREF4GRID also categorises the main properties related to quality measurements of a power line (<a href="#s4grid:QualityProperty">s4grid:QualityProperty</a>):duration of voltage sags 

	<p> SAREF4GRID also categorises the main properties related to quality observations of a power line (<a href="#s4grid:QualityProperty">s4grid:QualityProperty</a>):duration of voltage sags 

	  (<a href="#s4grid:DurationVoltageSag">s4grid:DurationVoltageSag</a>), duration of voltage swells (<a href="#s4grid:DurationVoltageSwell">s4grid:DurationVoltageSwell</a>) and duration of long power failures 

	  (<a href="#s4grid:DurationLongPowerFailure">s4grid:DurationLongPowerFailure</a>).</p>
@@ -239,7 +239,7 @@ 
	  The capture objects are collected periodically or occasionally. The representation of the profile generic of a meter has been extracted from the IEC 62056-6-2:2017.</p>



	<p>A profile generic is represented by the objects that it captures (<a href="#s4grid:Clock">s4grid:Clock</a>, <a href="https://saref.etsi.org/core/PropertyValue">saref:PropertyValues</a> and 

	  <a href="https://saref.etsi.org/core/Measurement">saref:Measurements</a>). These capture objects are collected in each period defined in the 

	  <a href="https://saref.etsi.org/core/Observation">saref:Observations</a>). These capture objects are collected in each period defined in the 

	  <a href="#s4grid:hasCapturePeriod">s4grid:hasCapturePeriod</a> property.</p>



	<figure>

documentation/examples.html

+7 −7
Original line number Diff line number Diff line
@@ -97,7 +97,7 @@ 




	<p>One of the main functions of electric grid meters is to take measures from a power line in order to control 

	  what is happening in the electric grid. <a href="#Figure_28">Figure 28</a> presents an example of a power line measurement (ex:TotalIncrementalActiveEnergyImportMeasurement123) 

	  what is happening in the electric grid. <a href="#Figure_28">Figure 28</a> presents an example of a power line observation (ex:TotalIncrementalActiveEnergyImportObservation123) 

	  for a power line property (ex:TotalIncrementalActiveEnergyImport) that is identified by an OBIS code (<a href="#s4grid:hasObis">s4grid:hasObis</a>).</p>

	 

	<p>As with meter properties, SAREF4GRID does not aim to provide an exhaustive definition of all the properties defined in the IEC 62056-6-2:2017. Instead, it defines a set of
@@ -106,24 +106,24 @@ 
	(<a href="http://www.w3.org/2008/05/skos#narrower">skos:narrower</a>), and which properties belong to a general property (<a href="http://www.w3.org/2008/05/skos#broader">skos:broader</a>).</p>



	<figure>

	  <a href="diagrams/SAREF4GRID_Example_measurement_1.png"><img src="diagrams/SAREF4GRID_Example_measurement_1.png" alt="Example of electric grid meter measurements I"/></a>

	  <figcaption id="Figure_28">Figure 28: Example of electric grid meter measurements I</figcaption>

	  <a href="diagrams/SAREF4GRID_Example_measurement_1.png"><img src="diagrams/SAREF4GRID_Example_measurement_1.png" alt="Example of electric grid meter observations I"/></a>

	  <figcaption id="Figure_28">Figure 28: Example of electric grid meter observations I</figcaption>

	</figure>





	<p><a href="#Figure_29">Figure 29</a> presents another example of a power line measurement (ex:MaximumDemandRegisterImportC1TP1Measurement136) for a power line property 

	<p><a href="#Figure_29">Figure 29</a> presents another example of a power line observation (ex:MaximumDemandRegisterImportC1TP1Observation136) for a power line property 

	  (ex:MaximumDemandRegisterImportC1TP1) which are identified by an OBIS code (<a href="#s4grid:hasObis">s4grid:hasObis</a>). The power line properties are broader than the properties 

	  shown in <a href="#Figure_14">Figure 14</a> and <a href="#Figure_15">Figure 15</a> (e.g., <a href="#s4grid:DemandRegister">s4grid:DemandRegister</a>).</p>



	<figure>

	  <a href="diagrams/SAREF4GRID_Example_measurement_2.png"><img src="diagrams/SAREF4GRID_Example_measurement_2.png" alt="Example of electric grid meter measurements II"/></a>

	  <figcaption id="Figure_29">Figure 29: Example of electric grid meter measurements II</figcaption>

	  <a href="diagrams/SAREF4GRID_Example_measurement_2.png"><img src="diagrams/SAREF4GRID_Example_measurement_2.png" alt="Example of electric grid meter observations II"/></a>

	  <figcaption id="Figure_29">Figure 29: Example of electric grid meter observations II</figcaption>

	</figure>





	<p>Different profile generics can be generated in order to access data groups which are stored in an electric grid meter. 

	  <a href="#Figure_30">Figure 30</a> presents an example of a profile generic (ex:IncrementalLoadProfile1234) whose objective is to store the incremental energy 

	  values that a meter measures (ex:Measurement1 to ex:Measurement6) each hour. Additionally, the profile generic stores the clock (ex:Clock1234) to indicate the time at which the profile generic 

	  values that a meter measures (ex:Observation1 to ex:Observation6) each hour. Additionally, the profile generic stores the clock (ex:Clock1234) to indicate the time at which the profile generic 

	  captures elements, and the AMR status (ex:PropertyValue1) that the meter stores. Moreover, the profile generic is represented by an OBIS code 

	  (<a href="#s4grid:hasObis">s4grid:hasObis</a>).</p>

examples/Measurements.ttl

+16 −16
Original line number Diff line number Diff line 
@prefix ex: <https://saref.etsi.org/saref4grid/v1.1.1/example/Measurements/> .

@prefix ex: <https://saref.etsi.org/saref4grid/v1.1.1/example/Observations/> .

@prefix owl: <http://www.w3.org/2002/07/owl#> .

@prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .

@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .
@@ -11,11 +11,11 @@ 
@prefix skos: <http://www.w3.org/2008/05/skos#> .

@prefix om: <http://www.ontology-of-units-of-measure.org/resource/om-2> .



<https://saref.etsi.org/saref4grid/v1.1.1/example/Measurements#> a dctype:Dataset ;

<https://saref.etsi.org/saref4grid/v1.1.1/example/Observations#> a dctype:Dataset ;

  dcterms:license <https://forge.etsi.org/etsi-software-license> ;

  dcterms:conformsTo <https://saref.etsi.org/saref4grid/v1.1.1/> ;

  dcterms:title "Example Measurements"@en ;

  dcterms:description "Example Measurements"@en .

  dcterms:title "Example Observations"@en ;

  dcterms:description "Example Observations"@en .
@@ -23,7 +23,7 @@ 
#    Object Properties

#################################################################



saref:makesMeasurement a owl:ObjectProperty .

saref:madeExecution a owl:ObjectProperty .



saref:hasProperty a owl:ObjectProperty .
@@ -31,9 +31,9 @@ saref:isMeasuredIn a owl:ObjectProperty . 


saref:isPropertyOf a owl:ObjectProperty .



saref:relatesToMeasurement a owl:ObjectProperty .

saref:isObservedBy a owl:ObjectProperty .



saref:relatesToProperty a owl:ObjectProperty .

saref:observes a owl:ObjectProperty .



skos:broader a owl:ObjectProperty .
@@ -61,7 +61,7 @@ s4grid:PowerLine a owl:Class . 


saref:EnergyUnit a owl:Class .



saref:Measurement a owl:Class .

saref:Observation a owl:Class .



s4grid:EnergyAndPowerProperty a owl:Class .
@@ -81,17 +81,17 @@ s4grid:DemandRegister a s4grid:EnergyAndPowerProperty, 
	owl:NamedIndividual ;

    skos:narrower ex:MaximumDemandRegisterImportC1TP1 .



ex:MaximumDemandRegisterImportC1TP1Measurement136 a saref:Measurement,

ex:MaximumDemandRegisterImportC1TP1Observation136 a saref:Observation,

        owl:NamedIndividual ;

    saref:hasTimestamp "2023-10-20T21:01:10"^^xsd:dateTime ;

    saref:hasValue "5"^^xsd:unsignedLong ;

    saref:isMeasuredIn om:watt ;

	saref:relatesToProperty ex:MaximumDemandRegisterImportC1TP1 .

	saref:observes ex:MaximumDemandRegisterImportC1TP1 .



ex:Meter1234 a s4grid:GridMeter,

        owl:NamedIndividual ;

    saref:makesMeasurement ex:TotalIncrementalActiveEnergyImportMeasurement123,

			ex:MaximumDemandRegisterImportC1TP1Measurement136 .

    saref:madeExecution ex:TotalIncrementalActiveEnergyImportObservation123,

			ex:MaximumDemandRegisterImportC1TP1Observation136 .



om:wattHour a saref:EnergyUnit,

        owl:NamedIndividual .
@@ -100,15 +100,15 @@ ex:MaximumDemandRegisterImportC1TP1 a s4grid:EnergyAndPowerProperty, 
        owl:NamedIndividual ;

    s4grid:hasObis "1-0:1.6.11.255"^^xsd:string ;

    saref:isPropertyOf ex:SubstationLine23 ;

	saref:relatesToMeasurement ex:MaximumDemandRegisterImportC1TP1Measurement136 ;

	saref:isObservedBy ex:MaximumDemandRegisterImportC1TP1Observation136 ;

	skos:broader s4grid:DemandRegister .



ex:TotalIncrementalActiveEnergyImportMeasurement123 a saref:Measurement,

ex:TotalIncrementalActiveEnergyImportObservation123 a saref:Observation,

        owl:NamedIndividual ;

    saref:hasTimestamp "2023-10-20T21:01:10"^^xsd:dateTime ;

    saref:hasValue "5"^^xsd:unsignedLong ;

    saref:isMeasuredIn om:wattHour ;

	saref:relatesToProperty ex:TotalIncrementalActiveEnergyImport .

	saref:observes ex:TotalIncrementalActiveEnergyImport .



ex:SubstationLine23 a s4grid:PowerLine,

        owl:NamedIndividual ;
@@ -119,5 +119,5 @@ ex:TotalIncrementalActiveEnergyImport a s4grid:EnergyAndPowerProperty, 
        owl:NamedIndividual ;

    s4grid:hasObis "1-0:1.29.0.255"^^xsd:string ;

    saref:isPropertyOf ex:SubstationLine23 ;

	saref:relatesToMeasurement ex:TotalIncrementalActiveEnergyImportMeasurement123 ;

	saref:isObservedBy ex:TotalIncrementalActiveEnergyImportObservation123 ;

	skos:broader s4grid:ActiveEnergy .

examples/ProfileGeneric.ttl

+28 −28
Original line number Diff line number Diff line
@@ -28,13 +28,13 @@ s4grid:hasProfileGeneric a owl:ObjectProperty . 


s4grid:relatedClock a owl:ObjectProperty .



s4grid:relatedMeasurement a owl:ObjectProperty .

s4grid:relatedObservation a owl:ObjectProperty .



s4grid:relatedPropertyValue a owl:ObjectProperty .



saref:relatesToMeasurement a owl:ObjectProperty .

saref:isObservedBy a owl:ObjectProperty .



saref:relatesToProperty a owl:ObjectProperty .

saref:observes a owl:ObjectProperty .



skos:broader a owl:ObjectProperty .
@@ -83,7 +83,7 @@ s4grid:MeterProperty a owl:Class ; 


s4grid:ProfileGeneric a owl:Class .



saref:Measurement a owl:Class .

saref:Observation a owl:Class .



s4grid:EnergyAndPowerProperty a owl:Class .
@@ -97,12 +97,12 @@ ex:IncrementalLoadProfile1234 a s4grid:ProfileGeneric, 
    s4grid:hasCapturePeriod "60"^^xsd:int ;

    s4grid:hasObis "1-0:99.1.0.255"^^xsd:string ;

    s4grid:relatedClock ex:Clock1234 ;

    s4grid:relatedMeasurement ex:Measurement1,

        ex:Measurement2,

        ex:Measurement3,

        ex:Measurement4,

        ex:Measurement5,

        ex:Measurement6 ;

    s4grid:relatedObservation ex:Observation1,

        ex:Observation2,

        ex:Observation3,

        ex:Observation4,

        ex:Observation5,

        ex:Observation6 ;

    s4grid:relatedPropertyValue ex:PropertyValue1 .



ex:Meter1234 a s4grid:GridMeter,
@@ -118,22 +118,22 @@ s4grid:ReactiveEnergy a s4grid:EnergyAndPowerProperty, 


ex:TotalIncrementalReactiveEnergyQI1234 a s4grid:EnergyAndPowerProperty,

        owl:NamedIndividual ;

	saref:relatesToMeasurement ex:Measurement3 ;

	saref:isObservedBy ex:Observation3 ;

    skos:broader s4grid:ReactiveEnergy .



ex:TotalIncrementalReactiveEnergyQII1234 a s4grid:EnergyAndPowerProperty,

        owl:NamedIndividual ;

	saref:relatesToMeasurement ex:Measurement4 ;

	saref:isObservedBy ex:Observation4 ;

    skos:broader s4grid:ReactiveEnergy .



ex:TotalIncrementalReactiveEnergyQIII1234 a s4grid:EnergyAndPowerProperty,

        owl:NamedIndividual ;

	saref:relatesToMeasurement ex:Measurement5 ;

	saref:isObservedBy ex:Observation5 ;

    skos:broader s4grid:ReactiveEnergy .



ex:TotalIncrementalReactiveEnergyQIV1234 a s4grid:EnergyAndPowerProperty,

        owl:NamedIndividual ;

	saref:relatesToMeasurement ex:Measurement6 ;

	saref:isObservedBy ex:Observation6 ;

    skos:broader s4grid:ReactiveEnergy .



s4grid:ActiveEnergy a s4grid:EnergyAndPowerProperty,
@@ -153,29 +153,29 @@ ex:Clock1234 a s4grid:Clock, 
    s4grid:hasTime "2023-05-30T09:00:00"^^xsd:dateTime ;

    s4grid:hasTimeZone "120"^^xsd:long .



ex:Measurement1 a saref:Measurement,

ex:Observation1 a saref:Observation,

        owl:NamedIndividual ;

    saref:relatesToProperty ex:TotalIncrementalActiveEnergyImport1234 .

    saref:observes ex:TotalIncrementalActiveEnergyImport1234 .



ex:Measurement2 a saref:Measurement,

ex:Observation2 a saref:Observation,

        owl:NamedIndividual ;

    saref:relatesToProperty ex:TotalIncrementalActiveEnergyExport1234 .

    saref:observes ex:TotalIncrementalActiveEnergyExport1234 .



ex:Measurement3 a saref:Measurement,

ex:Observation3 a saref:Observation,

        owl:NamedIndividual ;

    saref:relatesToProperty ex:TotalIncrementalReactiveEnergyQI1234 .

    saref:observes ex:TotalIncrementalReactiveEnergyQI1234 .



ex:Measurement4 a saref:Measurement,

ex:Observation4 a saref:Observation,

        owl:NamedIndividual ;

    saref:relatesToProperty ex:TotalIncrementalReactiveEnergyQII1234 .

    saref:observes ex:TotalIncrementalReactiveEnergyQII1234 .



ex:Measurement5 a saref:Measurement,

ex:Observation5 a saref:Observation,

        owl:NamedIndividual ;

    saref:relatesToProperty ex:TotalIncrementalReactiveEnergyQIII1234 .

    saref:observes ex:TotalIncrementalReactiveEnergyQIII1234 .



ex:Measurement6 a saref:Measurement,

ex:Observation6 a saref:Observation,

        owl:NamedIndividual ;

    saref:relatesToProperty ex:TotalIncrementalReactiveEnergyQIV1234 .

    saref:observes ex:TotalIncrementalReactiveEnergyQIV1234 .



s4grid:ProfileStatus a s4grid:MeterProperty,

        owl:NamedIndividual ;
@@ -187,12 +187,12 @@ ex:PropertyValue1 a saref:PropertyValue, 


ex:TotalIncrementalActiveEnergyExport1234 a s4grid:EnergyAndPowerProperty,

        owl:NamedIndividual ;

	saref:relatesToMeasurement ex:Measurement2 ;

	saref:isObservedBy ex:Observation2 ;

    skos:broader s4grid:ActiveEnergy .



ex:TotalIncrementalActiveEnergyImport1234 a s4grid:EnergyAndPowerProperty,

        owl:NamedIndividual ;

    saref:relatesToMeasurement ex:Measurement1 ;

    saref:isObservedBy ex:Observation1 ;

	skos:broader s4grid:ActiveEnergy .



ex:AMRStatusLoadProfilePeriod1-1234 a s4grid:MeterProperty,

ontology/saref4grid.ttl

+4 −4
Original line number Diff line number Diff line
@@ -243,11 +243,11 @@ s4grid:relatedClock a owl:ObjectProperty ; 
    rdfs:domain s4grid:ProfileGeneric ;

    rdfs:range s4grid:Clock .



s4grid:relatedMeasurement a owl:ObjectProperty ;

	rdfs:comment "The measurement that is captured by a profile generic"@en ;

    rdfs:label "related measurement"@en ;

s4grid:relatedObservation a owl:ObjectProperty ;

	rdfs:comment "The observation that is captured by a profile generic"@en ;

    rdfs:label "related observation"@en ;

    rdfs:domain s4grid:ProfileGeneric ;

    rdfs:range saref:Measurement .

    rdfs:range saref:Observation .



s4grid:relatedPropertyValue a owl:ObjectProperty ;

	rdfs:comment "The property value that is captured by a profile generic"@en ;