SAREF extension for environment
type: Ontology
version IRI: saref4envi
creator: mpoveda
preferred namespace uri: https://w3id.org/def/saref4envi#
description: This ontology extends the SAREF ontology for the environment domain, specifically for the light pollution domain, including concepts like photometers, light, etc.
creator: me
preferred namespace prefix: s4envi
license: cc-by4.0
version info: 1.0
publisher: www.oeg-upm.net

location
type: ObjectProperty
comment: The relation between something and the point, or other geometrical thing in space, where it is. For example, the realtionship between a radio tower and a Point with a given lat and long. Or a relationship between a park and its outline as a closed arc of points, or a road and its location as a arc (a sequence of points). Clearly in practice there will be limit to the accuracy of any such statement, but one would expect an accuracy appropriate for the size of the object and uses such as mapping .

affects property
type: ObjectProperty
comment: A relation between an actuator with the property or properties it can act on

contains
type: ObjectProperty
inverse of: is contained in
comment: A relation between a physical object and the physical objects that can be contained in it.

encapsulates
type: ObjectProperty
inverse of: has digital representation
type: FunctionalProperty
comment: A relation between a digital representation and the physical objects it represents.

has color
type: ObjectProperty
comment: A relation between a light emitted and its color.

has component
type: ObjectProperty
inverse of: is component of
type: TransitiveProperty
comment: A relation between a system and the system in which it might be decomposed.

has digital representation
type: ObjectProperty
type: InverseFunctionalProperty
comment: A relation between a physical object and the digital representation in which it is encapsulated.

has frequency measurement
type: ObjectProperty
comment: The relation between a device and the frequency in which it makes measurements.

has geometry
type: ObjectProperty
comment: A relation between a light emitted and the shape it is projected in.

has light point
type: ObjectProperty
comment: A relation between a lamppost and its light points

has transmission period
type: ObjectProperty
comment: The relation between a device and the period in which it transmit information.

is accesible through
type: ObjectProperty
type: FunctionalProperty
comment: The relation between a digital representation and the service which it is accesible through.

is component of
type: ObjectProperty
type: TransitiveProperty
comment: A relation between a system and the system it belongs to as a component.

is connected to
type: ObjectProperty
type: SymmetricProperty
comment: A relation between a system and the system to which it is connected.

is contained in
type: ObjectProperty
comment: A relation between a physical object and the physical object in which it might be contained.

is projected from height
type: ObjectProperty
comment: A relation between a light and the height measurement from which it is projected.

is projected in direction
type: ObjectProperty
comment: A relation between a light and the direction in which it is projected.

projects light
type: ObjectProperty
comment: A relation between a lamppost or a light point and the light (or lights) they might project.

uses communication interface
type: ObjectProperty
comment: A relation between a system and the communication interface it uses.

uses communication protocol
type: ObjectProperty
comment: A relation between a system and the communication protocol it uses.

isMeasuredIn
type: ObjectProperty
comment: A relation between a measurement and the unit of measure in which the measurement value is expressed.
comment: is measured in

makes measurement
type: ObjectProperty
comment: A relation between a sensor and the measurements it makes. Such measurement will link together the valur of the measurement, its unit of measure and the property to which it relates.

measures property
type: ObjectProperty
comment: A relation between a sensor and the property o properties it can take measurement about.

relates to property
type: ObjectProperty
comment: A relation between a measurement and the property such measurement is about.

has creation date
type: DatatypeProperty
type: FunctionalProperty
range: dateTime
comment: A relationship defining the creation date of an entity (e.g., a digital representation).

has flash
type: DatatypeProperty
type: FunctionalProperty
range: boolean
comment: A relationship stating whether a light has flash.

has identifier
type: DatatypeProperty
range: string
comment: A relationship providing the identifier of an entity (e.g., digital representation)

has projection angle
type: DatatypeProperty
type: FunctionalProperty
range: float
comment: A relationship defining the projection angle of an entity (e.g., a light).

has revision number
type: DatatypeProperty
range: string
comment: A relationship defining the revision number of a certain entity (e.g., a device)

has shield
type: DatatypeProperty
type: FunctionalProperty
range: boolean
comment: A relationship stating whether a lamppost has a shield.

has tag
type: DatatypeProperty
range: string
comment: A relationship stating the tags that can be assigned to an entity (e.g., a digital representation).

has version
type: DatatypeProperty
type: FunctionalProperty
range: string
comment: A relationship defining the version of a certain entity (e.g., a device)

has description
type: DatatypeProperty
comment: A relationship providing a description of an entity (e.g., device)

has manufacturer
type: DatatypeProperty
comment: A relationship identifying the manufacturer of an entity (e.g., device)

has name
type: DatatypeProperty
comment: A relationship providing the name of an entity (e.g., device)

has timestamp
type: DatatypeProperty
type: FunctionalProperty
range: dateTime
comment: A relationship stating the timestamp of an entity (e.g. a measurement).

has value
type: DatatypeProperty
comment: A relationship defining the value of a certain property, e.g., energy or power

Point
type: Class
comment: A point, typically described using a coordinate system relative to Earth, such as WGS84. Uniquely identified by lat/long/alt. i.e. spaciallyIntersects(P1, P2) :- lat(P1, LAT), long(P1, LONG), alt(P1, ALT), at(P2, LAT), long(P2, LONG), alt(P2, ALT). sameThing(P1, P2) :- type(P1, Point), type(P2, Point), spaciallyIntersects(P1, P2).

Spatial thing
type: Class
disjoint with: Color
disjoint with: Communication interface
disjoint with: Communication protocol
disjoint with: Compass direction
disjoint with: Digital representation
disjoint with: Geometry
disjoint with: Measurement
disjoint with: Service
comment: Anything with spatial extent, i.e. size, shape, or position. e.g. people, places, bowling balls, as well as abstract areas like cubes.

Temporal unit
type: Class
subclass of: Unit of measure
comment: A temporal unit of measure, which provides a scale factor for a time quantity.

Actuator
type: Class
subclass of: Device
subclass of: Restriction
  on property: affects property
  all values from: Property
comment: Device that can act over at least one property.

Color
type: Class
disjoint with: Communication interface
disjoint with: Communication protocol
disjoint with: Compass direction
disjoint with: Digital representation
disjoint with: Geometry
disjoint with: Light
disjoint with: Service
disjoint with: Unit of measure
comment: Color of the emitted light. It might be indicated by named colors or using other type of color values like hexadecimal for RGB, color temperature, etc.

Communication interface
type: Class
subclass of: Restriction
  on property: has version
  all values from: string
subclass of: Restriction
  on property: has version
  max qualified cardinality: 1
  on data range: string
disjoint with: Communication protocol
disjoint with: Compass direction
disjoint with: Digital representation
disjoint with: Geometry
disjoint with: Light
disjoint with: Measurement
disjoint with: Property
disjoint with: Unit of measure
comment: An interface defines which primitive operations and services the lower layer makes available to the upper one, when referring to network layers. (Definition adapted from "Tanenbaum, A. S. (2003). Computer networks, 4-th edition. ed: Prentice Hall.")

Communication protocol
type: Class
disjoint with: Compass direction
disjoint with: Digital representation
disjoint with: Geometry
disjoint with: Light
disjoint with: Measurement
disjoint with: Property
disjoint with: Service
disjoint with: Unit of measure
comment: A protocol is an agreement between the communicating parties on how communication is to proceed. (Definition taken from "Tanenbaum, A. S. (2003). Computer networks, 4-th edition. ed: Prentice Hall.")

Compass direction
type: Class
disjoint with: Digital representation
disjoint with: Geometry
disjoint with: Light
disjoint with: Measurement
disjoint with: Property
disjoint with: Service
disjoint with: Unit of measure
comment: The four cardinal directions or cardinal points are the directions of north, east, south, and west, commonly denoted by their initials: N, E, S, W. East and west are at right angles to north and south, with east being in the clockwise direction of rotation from north and west being directly opposite east. Intermediate points between the four cardinal directions form the points of the compass. (definition taken from https://en.wikipedia.org/wiki/Cardinal_direction)

Device
type: Class
subclass of: System
subclass of: Device
subclass of: Restriction
  on property: has frequency measurement
  all values from: Frequency measurement
subclass of: Restriction
  on property: has transmission period
  all values from: Period measurement
subclass of: Restriction
  on property: is contained in
  all values from: Physical object
subclass of: Restriction
  on property: has revision number
  all values from: string
subclass of: Restriction
  on property: has version
  all values from: string
subclass of: Restriction
  on property: has manufacturer
  all values from: string
subclass of: Restriction
  on property: has revision number
  max qualified cardinality: 1
  on data range: string
subclass of: Restriction
  on property: has version
  max qualified cardinality: 1
  on data range: string
comment: A thing made or adapted for a particular purpose, especially a piece of mechanical or electronic equipment. For example ‘a measuring device’ (definition taken from https://en.oxforddictionaries.com/definition/device). In this ontology it refers to the devices for environmental purposes.

Digital representation
type: Class
subclass of: Restriction
  on property: encapsulates
  all values from: Physical object
subclass of: Restriction
  on property: is accesible through
  all values from: Service
subclass of: Restriction
  on property: has creation date
  all values from: dateTime
subclass of: Restriction
  on property: has identifier
  all values from: string
subclass of: Restriction
  on property: has tag
  all values from: string
subclass of: Restriction
  on property: has description
  all values from: string
subclass of: Restriction
  on property: has name
  all values from: string
subclass of: Restriction
  on property: has creation date
  max qualified cardinality: 1
  on data range: dateTime
subclass of: Restriction
  on property: has identifier
  max qualified cardinality: 1
  on data range: string
disjoint with: Geometry
disjoint with: Light
disjoint with: Measurement
disjoint with: Unit of measure
comment: A digital representation encapsulates a physical object accessible via Web services

Frequency measurement
type: Class
subclass of: Measurement
subclass of: Restriction
  on property: relates to property
  has value: Frequency
subclass of: Restriction
  on property: isMeasuredIn
  qualified cardinality: 1
  on class: Frequency unit
comment: Represents the measured value made over a frequency property. It is also linked to the frequency unit of measure in which the value is expressed and the timestamp of the measurement.

Frequency unit
type: Class
subclass of: Unit of measure
comment: Unit of measure for the quantity frequency.

Geometry
type: Class
disjoint with: Light
disjoint with: Measurement
disjoint with: Property
disjoint with: Service
disjoint with: Unit of measure
comment: Represents the shape of the light emission. It might be instantiated by individuals like "spherical", "cylindrical", etc. even though it is open to more comples representation of geometries using other vocabularies.

Height measurement
type: Class
subclass of: Measurement
subclass of: Restriction
  on property: relates to property
  has value: Height
subclass of: Restriction
  on property: isMeasuredIn
  qualified cardinality: 1
  on class: Length unit
comment: Represents the measured value made over a height property. It is also linked to the height unit of measure in which the value is expressed and the timestamp of the measurement.

Lamppost
type: Class
subclass of: Device
subclass of: Restriction
  on property: has light point
  all values from: Light point
subclass of: Restriction
  on property: projects light
  all values from: Light
subclass of: Restriction
  on property: has shield
  all values from: boolean
comment: A tall pole with a light at the top.

Length unit
type: Class
subclass of: Unit of measure
comment: Unit of measure for the quantity lenght.

Light
type: Class
subclass of: Restriction
  on property: has color
  all values from: Color
subclass of: Restriction
  on property: has geometry
  all values from: Geometry
subclass of: Restriction
  on property: is projected from height
  all values from: Height measurement
subclass of: Restriction
  on property: is projected in direction
  all values from: Compass direction
subclass of: Restriction
  on property: has flash
  all values from: boolean
subclass of: Restriction
  on property: has projection angle
  all values from: float
disjoint with: Measurement
disjoint with: Property
disjoint with: Service
disjoint with: Unit of measure
comment: A light source, which may be a lantern, a street light, a floodlight, a signal lamp or any other device whose primary purpose is the generation of light. (Definition taken from http://wiki.openstreetmap.org/wiki/Proposed_features/Key:light_source#Description)

Light point
type: Class
subclass of: Point
subclass of: Restriction
  on property: location
  all values from: Spatial thing
subclass of: Restriction
  on property: projects light
  all values from: Light
comment: An spatial point from where a light is projected. It might belong to a lamppost.

Light property
type: Class
subclass of: Property
comment: An aspect of light that can be observable by a sensor.

Period measurement
type: Class
subclass of: Measurement
subclass of: Restriction
  on property: relates to property
  has value: Period
subclass of: Restriction
  on property: isMeasuredIn
  qualified cardinality: 1
  on class: Temporal unit
comment: Represents the measured value over a period property. It is also linked to the period unit of measure in which the value is expressed and the timestamp of the measurement.

Photometer
type: Class
subclass of: Sensor
subclass of: Restriction
  on property: measures property
  some values from: Light property
comment: A photometer, generally, is an instrument that measures light intensity or optical properties of solutions or surfaces.

Physical object
type: Class
subclass of: Spatial thing
subclass of: Restriction
  on property: location
  all values from: Spatial thing
subclass of: Restriction
  on property: contains
  all values from: Physical object
subclass of: Restriction
  on property: has digital representation
  all values from: Digital representation
subclass of: Restriction
  on property: is contained in
  all values from: Physical object
subclass of: Restriction
  on property: has description
  all values from: string
comment: Any Object that has a proper space region. (Definition extracted from DUL ontology)

System
type: Class
subclass of: Physical object
subclass of: Restriction
  on property: has component
  all values from: System
subclass of: Restriction
  on property: is component of
  all values from: System
subclass of: Restriction
  on property: is connected to
  all values from: System
subclass of: Restriction
  on property: uses communication interface
  all values from: Communication interface
subclass of: Restriction
  on property: uses communication protocol
  all values from: Communication protocol
comment: A group of related hardware units or programs or both, especially when dedicated to a single application. (Definition taken from https://en.oxforddictionaries.com/definition/system)

TESS (Telescope Encoder and Sky Sensor)
type: Class
subclass of: Photometer
comment: The Telescope Encoder and Sky Sensor (TESS) is a Sky Brightness and Cloud detector developed as a device for a remote observatory. A TESS can observe the light magnitude and other properties as ambient temperature and sky temperature.

Device
type: Class
comment: A tangible object designed to accomplish a particular task in households, common public buildings or offices. In order to accomplish this task, the device performs one or more functions. For example, a washing machine is designed to wash (task) and to accomplish this task it performs the start and stop function.

Measurement
type: Class
subclass of: Restriction
  on property: isMeasuredIn
  all values from: Unit of measure
subclass of: Restriction
  on property: relates to property
  all values from: Property
subclass of: Restriction
  on property: isMeasuredIn
  qualified cardinality: 1
  on class: Unit of measure
subclass of: Restriction
  on property: relates to property
  qualified cardinality: 1
  on class: Property
subclass of: Restriction
  on property: has timestamp
  all values from: dateTime
subclass of: Restriction
  on property: has value
  all values from: float
subclass of: Restriction
  on property: has value
  qualified cardinality: 1
  on data range: float
disjoint with: Property
disjoint with: Service
disjoint with: Unit of measure
comment: Represents the measured value made over a property. It is also linked to the unit of measure in which the value is expressed and the timestamp of the measurement.

Property
type: Class
disjoint with: Service
disjoint with: Unit of measure
comment: An aspect of an entity that can be observable by a sensor.

Sensor
type: Class
subclass of: Device
subclass of: Restriction
  on property: makes measurement
  all values from: Measurement
subclass of: Restriction
  on property: measures property
  all values from: Property
comment: A device that detects and responds to events or changes in the physical environment such as light, motion, or temperature changes. A device that has category saref:Sensor and performs a saref:SensingFunction.

Service
type: Class
disjoint with: Unit of measure
comment: A service is a representation of a function to a network that makes the function discoverable, registerable, remotely controllable by other devices in the network. A service can represent one or more functions. A Service is offered by a device that wants (a certain set of) its function(s) to be discoverable, registerable, remotely controllable by other devices in the network. A Service must specify the device that is offering the service, the function(s) to be represented, and the (input and output) parameters necessary to operate the service.

Unit of measure
type: Class
comment: The unit of measure is a standard for measurement of a quantity, such as a Property. For example, Power is a property and Watt is a unit of power that represents a definite predetermined power: when we say 10 Watt, we actually mean 10 times the definite predetermined power called "watt". Our definition is based on the definition of unit of measure in the Ontology of units of Measure (OM). We propose here a list of some units of measure that are relevant for the purpose of the Smart Appliances ontology, but this list can be extended.

Centimetre
type: NamedIndividual
type: Length unit

Decametre
type: NamedIndividual
type: Length unit

Decimetre
type: NamedIndividual
type: Length unit

Hectometre
type: NamedIndividual
type: Length unit

Hertz
type: NamedIndividual
type: Frequency unit

Kilometre
type: NamedIndividual
type: Length unit

Metre
type: NamedIndividual
type: Length unit

Milimetre
type: NamedIndividual
type: Length unit

Reciprocal day
type: NamedIndividual
type: Frequency unit

Reciprocal hour
type: NamedIndividual
type: Frequency unit

Reciprocal second
type: NamedIndividual
type: Frequency unit

Reciprocal year
type: NamedIndividual
type: Frequency unit

Fluorescence
type: NamedIndividual
type: Light property
comment: An individual representing the light property fluorescence.

Frequency
type: NamedIndividual
type: Property
comment: An individual representing the property frequency.

Height
type: NamedIndividual
type: Property
comment: An individual representing the property height.

Illuminance
type: NamedIndividual
type: Light property
comment: An individual representing the light property illuminance.

Irradiance
type: NamedIndividual
type: Light property
comment: An individual representing the light property irradiance.

Light absorption
type: NamedIndividual
type: Light property
comment: An individual representing the light property light absorption.

Light magnitude
type: NamedIndividual
type: Light property
comment: An individual representing the light property light magnitude.

Luminiscence
type: NamedIndividual
type: Light property
comment: An individual representing the light property luminiscence.

Period
type: NamedIndividual
type: Property
comment: An individual representing the property period.

Phosphorescence
type: NamedIndividual
type: Light property
comment: An individual representing the light property phosphorescence.

Reflection of light
type: NamedIndividual
type: Light property
comment: An individual representing the light property reflection of light.

Scattering of light
type: NamedIndividual
type: Light property
comment: An individual representing the light property scattering of light.