pax_global_header 0000666 0000000 0000000 00000000064 13666705607 0014532 g ustar 00root root 0000000 0000000 52 comment=afe004ec5e5f8279c15de5265dd4a10aba5847ea saref4agri-afe004ec5e5f8279c15de5265dd4a10aba5847ea/ 0000775 0000000 0000000 00000000000 13666705607 0020775 5 ustar 00root root 0000000 0000000 saref4agri-afe004ec5e5f8279c15de5265dd4a10aba5847ea/.gitignore 0000664 0000000 0000000 00000000067 13666705607 0022770 0 ustar 00root root 0000000 0000000 *~ .DS_Store catalog-v001.xml saref-pipeline.jar target saref4agri-afe004ec5e5f8279c15de5265dd4a10aba5847ea/.gitlab-ci.yml 0000664 0000000 0000000 00000001540 13666705607 0023431 0 ustar 00root root 0000000 0000000 image: openjdk:8-jdk develop: script: - curl -L -o saref-pipeline.jar "https://gitlab.emse.fr/saref/saref-pipeline/-/jobs/artifacts/master/raw/target/saref-pipeline.jar?job=build" - java -jar saref-pipeline.jar develop -s except: - /^prerelease-v/ - /^release-v/ artifacts: when: always paths: - target/site - target/report_output.xml reports: junit: target/report_output.xml release: script: - curl -L -o saref-pipeline.jar "https://gitlab.emse.fr/saref/saref-pipeline/-/jobs/artifacts/master/raw/target/saref-pipeline.jar?job=build" - java -jar saref-pipeline.jar release only: - /^prerelease-v/ - /^release-v/ artifacts: when: always paths: - target/site - target/report_output.xml reports: junit: target/report_output.xml saref4agri-afe004ec5e5f8279c15de5265dd4a10aba5847ea/.saref-repositories.yml 0000664 0000000 0000000 00000000070 13666705607 0025420 0 ustar 00root root 0000000 0000000 forge.etsi.org/rep/: repos: - saref/saref-core saref4agri-afe004ec5e5f8279c15de5265dd4a10aba5847ea/LICENSE 0000664 0000000 0000000 00000002703 13666705607 0022004 0 ustar 00root root 0000000 0000000 Copyright 2020 ETSI Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. 2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. 3. Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. saref4agri-afe004ec5e5f8279c15de5265dd4a10aba5847ea/README.md 0000664 0000000 0000000 00000000050 13666705607 0022247 0 ustar 00root root 0000000 0000000 Repository for the SAREF4AGRI ontology. saref4agri-afe004ec5e5f8279c15de5265dd4a10aba5847ea/documentation/ 0000775 0000000 0000000 00000000000 13666705607 0023646 5 ustar 00root root 0000000 0000000 saref4agri-afe004ec5e5f8279c15de5265dd4a10aba5847ea/documentation/abstract.md 0000664 0000000 0000000 00000010436 13666705607 0025777 0 ustar 00root root 0000000 0000000 The present document has been developed in the context of the STF 534, an ETSI specialists task force that was established with the goal to extend SAREF [[1]](#[1]) for the domains of Smart Cities, Smart Industry & Manufacturing, and Smart AgriFood ([https://portal.etsi.org/STF/stfs/STFHomePages/STF534](https://portal.etsi.org/STF/stfs/STFHomePages/STF534)). In particular, the present document is a technical specification of SAREF4AGRI, an OWL-DL ontology that extends SAREF for the Smart Agriculture and Food Chain domain. The intention of SAREF4AGRI is to connect SAREF with existing ontologies (such as W3C SSN, W3C SOSA, GeoSPARQL, etc.) and important standardization initiatives and ontologies in the Smart Agriculture and Food Chain domain, including ICAR for livestock data ([https://www.icar.org/](https://www.icar.org/)), AEF for agricultural equipment ([http://www.aef-online.org](http://www.aef-online.org)), Plant Ontology Consortium for plants ([http://archive.plantontology.org](http://archive.plantontology.org)), AgGateway for IT support for arable farming ([http://www.aggateway.org/](http://www.aggateway.org/)), as mentioned in the associated SAREF4AGRI requirements document ETSI TR 103 511 [[i.2]](#[i.2]). To show the potential of SAREF4AGRI, the present document focuses on two examples, which are the "livestock farming" and "smart irrigation" use cases. Various other examples exist in the Smart Agriculture and Food Chain domain, such as arable farming, horticulture, agricultural equipment, greenhouses and food chain, as mentioned in [[i.2]](#[i.2]) (for an exhaustive list of use cases, see also the H2020 Large Scale Pilot "Internet of Food and Farm 2020 (IoF2020)" at [https://iof2020.eu/trials](https://iof2020.eu/trials)). However, it was necessary to make actionable choices within the STF 534 timeframe and the available resources, thus livestock farming and smart irrigation have been chosen as the two initial examples to create SAREF4AGRI. As a next step, it is recommended to further refine the proposed livestock farming and smart irrigation examples to add relevant sensors that are not considered yet, and also consider additional use cases to create new releases of SAREF4AGRI, following and extending the examples provided in the present document. As all the SAREF ontologies, SAREF4AGRI is a dynamic semantic model that is meant to evolve over time. Therefore, the stakeholders in the AgriFood domain (starting from the ICAR, AEF and AgGateway initiatives) are invited to use, validate and provide feedback on SAREF4AGRI, collaborating with the SAREF ontology experts to improve and evolve SAREF4AGRI in an iterative and interactive manner, so that changes and additions can be incorporated in future releases of the present document. The livestock farming and smart irrigation use cases used as basis to create SAREF4AGRI in the present document are concerned with the integration of multiple data sources for the purpose of providing decision support services located on the local "Farm Management System" of the farmers or provided by a service over the network. Multiple data sources of interest include GPS, meteorological data (both historic and current), remote observation (via satellite sources such as Copernicus) and local observation using near or proximal sensors. As an extension of SAREF, which is a semantic model for IoT that describes smart devices and applications in terms of their functions, services, states and measurements [[1]](#[1]), SAREF4AGRI is concerned with the description of proximal sensors that measure a variety of relevant parameters for agriculture, including: (on animal) movement, temperature, etc., (in the soil) moisture/humidity, Ph value, salinity, compaction, (on plant) plant colour (NDVI), etc. The measurements from these sensors need to be integrated by a decision support service to enable the planning of (for example) a treatment plan for animals (in a livestock scenario), or a decision to irrigate or harvest (in an irrigation, horticulture or greenhouse context). The requirements used to create the SAREF4AGRI extension specified in the present document are described in the associated ETSI TR 103 511 [[i.2]](#[i.2]). The prefixes and namespaces used in SAREF4AGRI and in the present document are listed in [the Namespace Declarations section](#namespacedeclarations) saref4agri-afe004ec5e5f8279c15de5265dd4a10aba5847ea/documentation/acknowledgements.md 0000664 0000000 0000000 00000000646 13666705607 0027530 0 ustar 00root root 0000000 0000000 The editors would like to thank the ETSI SmartM2M technical committee for providing guidance and expertise. Also, many thanks to the ETSI staff and all other current and former active Participants of the ETSI SmartM2M group for their support, technical input and suggestions that led to improvements to this ontology. Also, special thanks goes to the ETSI SmartM2M Technical Officer Guillemin Patrick for his help. saref4agri-afe004ec5e5f8279c15de5265dd4a10aba5847ea/documentation/contributors.md 0000664 0000000 0000000 00000000140 13666705607 0026720 0 ustar 00root root 0000000 0000000 - [Jack Verhoosel](https://www.researchgate.net/profile/Jack_Verhoosel) ([TNO](https://tno.nl/)) saref4agri-afe004ec5e5f8279c15de5265dd4a10aba5847ea/documentation/creators.md 0000664 0000000 0000000 00000000650 13666705607 0026013 0 ustar 00root root 0000000 0000000 - [Maria Poveda-Villalon](https://w3id.org/people/mpoveda/) ([Universidad Politécnica de Madrid](http://www.oeg-upm.net/)) - [Raúl Garcia-Castro](http://www.garcia-castro.com/foaf.rdf#me) ([Universidad Politécnica de Madrid](http://www.oeg-upm.net/)) - [Laura Daniele](https://www.linkedin.com/in/lauradaniele) ([TNO](https://tno.nl/)) - [Mike de Roode](https://www.linkedin.com/in/mderoode) ([TNO](https://tno.nl/)) saref4agri-afe004ec5e5f8279c15de5265dd4a10aba5847ea/documentation/description.html 0000664 0000000 0000000 00000042352 13666705607 0027065 0 ustar 00root root 0000000 0000000
An overview of the SAREF4AGRI ontology is provided in Figure 1. For all the entities described in the present document, it is indicated whether they are defined in the SAREF4AGRI extension or elsewhere by the prefix included before their identifier, i.e. if the element is defined in SAREF4AGRI, the prefix is s4agri, while if the element is reused from another ontology it is indicated by a prefix according to Table 1.
Arrows are used to represent properties between classes and to represent some RDF, RDF-S and OWL constructs, more precisely:
Datatype properties are denoted by rectangles attached to the classes, in an UML-oriented way. Dashed boxes represent local restrictions in the class, i.e. datatype properties that can be applied to the class they are attached to.
Individuals are denoted by rectangles in which the identifier is underlined.
Note that Figure 1 aims at showing a global overview of the main classes of SAREF4AGRI and their mutual relations.
The model defined in SAREF4AGRI for representing platforms, systems and deployments is depicted in Figure 2. The main entities in the modelling are represented by the ssn:System and ssn:Deployment classes. Note that the design patterns for modelling these concepts have been taken from the W3C SSN ontology and, as a best practice for reuse, the SAREF4AGRI model refers directly to the URIs of the SSN (http://www.w3.org/ns/ssn/) and SOSA (http://www.w3.org/ns/sosa/) ontologies.
The ssn:System class in the SSN ontology represents a system and is components as specific devices, actuators or sensors. Moreover, the ssn:Deployment class from the SSN ontology describes the deployment of one or more systems on a ssn:Platform for a particular purpose for a given time period. SAREF4AGRI defines a saref:Device as subclass of an ssn:System and extends the ssn:Deployment class by means of the s4agri:Deployment class. In this way, it is possible to represent a specific installation of a certain agricultural system (e.g. a smart irrigation system) in a given space (expressed by means of the property s4agri:hasDeploymentPeriod) and at a given temporal frame (expressed by means of the property s4agri:isDeployedAtSpace) where SAREF4AGRI devices (e.g. a pluviometer, a soil tensiometer, a weather station and a watering gun) can be deployed. The deployment can involve a given ssn:Platform which hosts the system deployed in such deployment. In order to represent temporal information the TIME ontology has been reused. For the geographical information both the GeoSPARQL ontology (http://www.opengis.net/ont/geosparql#) and the WGS84 Geo vocabulary (http://www.w3.org/2003/01/geo/wgs84_pos#) are reused.
As shown in Figure 3, the modelling of measurements in SAREF4AGRI relies on the measurement model proposed in SAREF to express information about a certain property to be measured, its measured value, its measurement unit and the time of the measurement.
This modelling includes the saref:FeatureOfInterest (whose design pattern has been taken from the W3C SSN ontology) that provides the means to refer to the real world phenomena that is being observed in a given measurement (e.g. a cow can be defined in SAREF4AGRI as the feature of interest of a weight measurement made by a weight sensor). The reader is referred to the SAREF specification [1] for details about the modelling of measurements, whereas the present document includes details only for the new concepts created in SAREF4AGRI, such as the classes and instances added to support the livestock farming and smart irrigation use cases. Note that a work item ETSI TS 103 264 [1] has been opened to evolve the current SAREF core specification ETSI TS 103 264 [1] according to the latest developments in various sectors, including the input from the SAREF4AGRI extension in the present document. ETSI TS 103 264 [1] work item will result in an updated SAREF 3.0 core ontology. The following properties (to be included in SAREF 3.0) are reused in SAREF4AGRI to complete the model of measurements:
In order to support the Smart Irrigation use case, a number of units of measure have been added to SAREF4AGRI as instances of the saref:UnitOfMeasure class, namely dbpedia:DBM (decibel-milliwatts), om:millivolt (millivolt), om:millimetre (millimetre), om:millibar (millibar) and om:degree_Celsius (degree Celsius). Additionally, for the livestock farming use case the om:Liter unit has been added. These instances have been reused from DBpedia (https://wiki.dbpedia.org/) and the Ontology of units of Measure (OM) 2.0 (http://www.ontology-of-units-of-measure.org/).
In order to support the livestock farming use case (and potentially other use cases such as arable farming and horticulture in future SAREF4AGRI releases), the s4agri:Animal, s4agri:AnimalGroup and s4agri:Crop classes have been added to SAREF4AGRI as subclasses of saref:FeatureOfInterest (see clause 4.2.4).
In this way, measurements from relevant sensors (such as on animal activity movement, temperature, weight, milking yield, etc.) can be related via the isMeasurementOf relation to specific e.g. (groups of) animals that are instances of the saref:FeatureOfInterest class. This relation is explained in more detail in the following clause.
The main features of interest in SAREF4AGRI currently support (aspects of) the livestock farming and smart irrigation use cases and are represented by the s4agri:Animal, s4agri:AnimalGroup, s4agri:Crop and s4agri:Soil classes that are shown in Figure 4.
The s4agri:Animal class describes an animal that can be classified in SAREF4AGRI reusing the TAXRANK taxonomy vocabulary (http://purl.obolibrary.org/obo/taxrank.owl#). Besides the reuse of the TAXRANK taxonomy vocabulary, an animal is furthermore defined in SAREF4AGRI in order to have a birth and death date. An animal also has a unique identifier and can be part of one or more s4agri:AnimalGroup that are used to conduct experiments and observations on the livestock. Note that animals can be also specialized using subclasses, as is shown in the example in clause 4.3.1 with the ex:LactatingCow class that was created as a subclass of s4agri:Animal. Animals and animal groups are related to measurements via the saref:FeatureOfinterest concept of SAREF (see clause 4.2.3).
The s4agri:Soil class represents the upper layer of the earth in which plants grow. The s4agri:Crop class describes a collection of homogeneous plant species that is grown on a large scale commercially (especially a cereal, fruit, or vegetable) and is planted on a single location. A s4agri:Crop is grown on some s4agri:Parcel, which is an area of land, defined in SAREF4AGRI as subclass of the geosp:Feature (see clause 4.2.6). Moreover, s4agri:Crop is related to measurements via saref:FeatureOfInterest (see clause 4.2.3).
SAREF4AGRI extends the device hierarchy defined in SAREF in order to include devices needed to support the livestock farming and the smart irrigation use cases. These devices are shown in Figure 5. The devices included for the Smart Irrigation use case are: s4agri:Pluviometer, s4agri:SoilTensiometer, s4agri:WeatherStation, and s4agri:WateringGun. The devices included for the Livestock Farming use case are: s4agri:MovementActivitySensor, EatingActivitySensor, s4agri:MilkingSensor, and s4agri:WeightSensor.
SAREF4AGRI extends the property hierarchy defined in SAREF in order to include properties needed to support the livestock farming and the smart irrigation use cases. These devices are shown in Figure 6. The properties included for the smart irrigation use case are: s4agri:SoilMoisture, s4agri:IrrigationWater, s4agri:SoilTemperature, s4agri:AirTemperature, s4agri:AmbientHumidity, s4agri:Precipitation and s4agri:PlantGrowthStage.
The properties included for the livestock farming use case are: s4agri:Yield (which can further be specialized in subclasses, such as MilkYield, CropYield, MeatYield, MilkYield, etc. as needed) and s4agri:Intake (which can further be specialized in subclasses, such as FoodIntake for animals, FertilizerIntake for crops, etc. as needed).
SAREF4AGRI adopts the same topology modelling pattern that is adopted in the SAREF4CITY extension [i.3], where existing standard ontologies have been reused for this purpose. As shown in Figure 7, for representing spatial objects in SAREF4AGRI, the geosp:SpatialObject class from GeoSPARQL has been reused along with its subclasses geosp:Feature, geosp:Geometry and the properties geosp:sfContains, geosp:sfWithin and geosp:hasGeometry. In addition, the class geo:Point and the property geo:location have been reused from the "WGS84 Geo Positioning vocabulary" (which is the W3C de-facto standard for geographical information) in order to be able to indicate that something is located at certain coordinates.
For the purpose of SAREF4AGRI, the geosp:Feature class has been extended with the following subclasses:
A s4agri:Farm can contain one or more s4agri:Building and s4agri:Parcel (via the geosp:sfContains relation). Note that these types of feature are used in the present document as examples, but more feature types (and building types) can be added as needed. Moreover, a s4agri:Building can be further decomposed in one or more s4agri:BuildingSpaces (once again via the geosp:sfContains relation). As subclasses of geosp:Feature, all the classes mentioned above inherit the possibility to have a physical geometric description using geosp:Geometry, if needed (e.g. especially relevant for s4agri:Parcel). As subclasses of geosp:SpatialObject, all the classes mentioned above also inherit the possibility to use the geo:location property to indicate that something is located at certain coordinates (e.g. especially relevant for s4agri:Bulding).
As it is modelled in the SAREF4CITY extension [i.3], also SAREF4AGRI reuses the FOAF vocabulary (http://xmlns.com/foaf/0.1/) and Schema.org vocabulary (https://schema.org/) to represent the concepts of Person and Organization. Figure 8 shows that in SAREF4AGRI the foaf:Person and org:Organization classes are extended with the s4agri:Farmer and s4agri:FarmHolding subclasses to describe farmers and their organizations. Both foaf:Person and org:Organization are subclass of foaf:Agent. Organizations (e.g. s4agri:FarmHolding) have members (e.g. farmers). Both s4agri:Farmer and s4agri:FarmHolding can manage some s4agri:Farm.
saref4agri-afe004ec5e5f8279c15de5265dd4a10aba5847ea/documentation/diagrams/ 0000775 0000000 0000000 00000000000 13666705607 0025435 5 ustar 00root root 0000000 0000000 saref4agri-afe004ec5e5f8279c15de5265dd4a10aba5847ea/documentation/diagrams/Device.png 0000664 0000000 0000000 00000152646 13666705607 0027360 0 ustar 00root root 0000000 0000000 PNG IHDR 9 J Zd sRGB gAMA a pHYs % %IR$ ;IDATx^읅wGe7fFAfffmْ-۲d9f8fffƀp6lv7f{5fFs{o߮%cB%MT^27suUIԡ,/m%|Rw)TXkۢT+").\ a{Ӿ}{3i$crJ3uT3l0S|yӺuk3sL3bӹsgٮ{=YnР3UV5J2u7oޔmA䠯ڼ۞>37x|2