Erik Wallin
Karl Hammar
The REC core module collects the top-level classes and properties that span over or are reused within multiple REC modules.
Note that this module reuses certain classes, properties, and named individuals from other vocabularies, e.g., GeoSPARQL; the copyright conditions on those reused entities are stated in their respective rdfs:comments annotations.
RealEstateCore Consortium
RealEstateCore Core Module
2020-06-23
core
https://w3id.org/rec/core/3.3/
How many rooms are there in Building 1?
What does electricity meter 3 measure? In what units?
Where in Building 1 (i.e., in which rooms) are there devices mounted?
Where is Building 1 located?
Where is the real estate Ulvsnaes 1:7 located?
Which buildings and land make up the real estate Ulvsnaes 1:7?
Which parts of Building 1 (e.g., rooms, wings, etc) are covered by electricity meter 3?
3.3
A GML serialization of a geometry object.
GeoSPARQL is Copyright (c) 2012 Open Geospatial Consortium, Inc. All Rights Reserved. http://www.opengeospatial.org/ogc/document.
GML Literal
A Well-known Text serialization of a geometry object.
GeoSPARQL is Copyright (c) 2012 Open Geospatial Consortium, Inc. All Rights Reserved. http://www.opengeospatial.org/ogc/document.
Well-known Text Literal
The default geometry to be used in spatial calculations. It is Usually the most detailed geometry.
GeoSPARQL is Copyright (c) 2012 Open Geospatial Consortium, Inc. All Rights Reserved. http://www.opengeospatial.org/ogc/document.
default geometry
A spatial representation for a given feature.
GeoSPARQL is Copyright (c) 2012 Open Geospatial Consortium, Inc. All Rights Reserved. http://www.opengeospatial.org/ogc/document.
has geometry
architected by
categorization properties
Links a Building Component to a Space, that the Building Component is either contained in, adjacent to or intersecting with.
component of
Indicates which Building a certain Building Component is part of.
component of building
constructed by
Parthood traversal property linking to mounted Devices.
contains mounted device
true
controlled by
data schema
The measurement unit used by some Device.
Deprecated in favour of qudt:unit
device measurement unit
true
The Quantity Kind that a device measures or affects.
Deprecated in favour of qudt:hasQuantityKind
device quantity kind
true
document topic
A unit used to measure some aspect of some Event.
Deprecated in favour of qudt:unit
event measurement unit
true
The Quantity Kind that an event measures or affects.
Deprecated in favour of qudt:hasQuantityKind
event quantity kind
true
generated observation
Links a Space to a BuildingComponent that is either contained in, adjacent to or intersecting with the Space.
has building component
has capability
has document
Associates a building with a point in some coordinate reference system which can be used to resolve local (building-specific) coordinates against this outer coordinate reference system.
has geo-reference origo
The unit that something (sensor observations, device capabilities, physical measurements, etc) is measured by. This is given as an object property with a corresponding class (rather than a simple datatype property) since one unit may have many serialized representations and may be used for many different types of measurements.
Deprecated in favour of qudt:unit
has measurement unit
true
has member
true
Points to sub-entities that share the same base type (i.e., Spaces only have Spaces as parts, Assets only have Assets as parts, etc.).
has part
Links entities that are measurable to the Quantity Kind that they measure, e.g., Temperature, Pressure, etc.
Deprecated in favour of qudt:hasQuantityKind
quantity kind
true
Parthood traversal property linking a piece of RealEstate to its constituent components (i.e., Buildings and Land).
has real estate component
true
Parthood traversal property linking BuildingComponents to their constituent sub-components.
has sub-BuildingComponent
true
Parthood traversal property linking a Device to any sub-Devices that it contains.
has sub-device
true
Property to model nesting of building components, e.g., rooms within apartments or walls within stairwells, etc.
has super-BuildingComponent
true
A property that allows for nesting of devices within devices.
has super-Device
true
A generic typing relation, holding between individuals and their types (which are also expressed as individuals). This construct allows implementors to add their own types without modifying the ontology and its classes. See the Explicit Typing design pattern in the MODL design library for further discussion.
has type
true
Indicates the physical hardware asset that a given logical device is hosted and executed on.
hosted by
Indicates that a given Asset hosts a logical device; e.g., a Raspberry Pi hosts a Home Assistant installation, or an IoT-connect smart camera unit hosts an IoT Edge runtime.
hosts
Indicates that an entity is included in some Collection, e.g., a Building is included in a RealEstate, or a Room is included in an Apartment.
included in
Member entities of a collection; e.g., a Campus includes some Space, an Apartment includes some Room, etc.
includes
The entity (Asset, Space, LogicalDevice, etc.) that has this Capability.
is capabilty of
is location of
is member of
true
Property describing where a Device is mounted.
is mounted in
true
Property describing in which Building Component (most typically a Room) that a Device is mounted.
is mounted in Building Component
true
Indicates a super-entity of the same base type (i.e., Spaces only have Spaces as parents, Organizations only have Organizations, etc).
is part of
Indicates which Building a certain Building Component is part of.
Deprecated in favour of core:componentOfBuilding
is part of building
true
Indicates that a Building or a piece of Land belongs to / is part of a given Real Estate.
true
located in
observation generated by
Generic property indicating which sensors that are configured or designed to observe some feature, system, phenomenon, etc.
observed by
Indicates the (optional) entity-of-interest of some sensor, i.e., what it is configured to observe or look for. This allows systems to perform graph propagation of sensor values, e.g., letting a temperature sensor that observes a given room set the temperature for that room.
observes
operated by
Property that defines the legal owner(s) of a given entity.
owned by
Indicates that an agent is the legal owner of a given entity, e.g., a Company owns some Real Estate.
owns
true
The entity responsible for generating or producing the event.
produced by
Event(s) generated or produced by an entity.
associated with event
A unit used to specificy some Quantity Kind, such as temperature, pressure, etc.
Deprecated in favour of qudt:unit
quantity kind measurement unit
true
sensor interface
Indicates that a Space or Asset is served by some Sensor/Actuator or other Asset. For example: an entrance room might be served by (e.g., covered by) some camera equipment, or a conference room served by a CO2 sensor. Note that Assets can also service one another, e.g., an air-treatment Asset might serve an air diffuser Asset.
served by
The coverage or impact area of a given Asset or Sensor/Actuator. For example: an air-treatment unit might serve several Rooms or a full Building. Note that Assets can also service one another, e.g., an air-treatment Asset might serve an air diffuser Asset.
serves
Indicates how a Device serves an entire Building.
Deprecated in favour of core:servesSpace
serves building
true
Indicates how a Device serves a particular Building Component (e.g., a Room).
Deprecated in favour of core:servesSpace
serves building component
true
Indicates how a Device serves another Device.
Deprecated in favour of core:servesAsset
serves device
true
The GML serialization of a geometry.
GeoSPARQL is Copyright (c) 2012 Open Geospatial Consortium, Inc. All Rights Reserved. http://www.opengeospatial.org/ogc/document.
asGML
The WKT serialization of a geometry.
GeoSPARQL is Copyright (c) 2012 Open Geospatial Consortium, Inc. All Rights Reserved. http://www.opengeospatial.org/ogc/document.
asWKT
Connects a geometry object with its text-based serialization.
GeoSPARQL is Copyright (c) 2012 Open Geospatial Consortium, Inc. All Rights Reserved. http://www.opengeospatial.org/ogc/document.
has serialization
IP address
MAC address
comment
Was originally intented to map an Id in an external system to an instance (e.g. an UUID).
After discussion in REC technical committee, an approach based on owl:sameAs and/or rdfs:seeAlso (depending on the needed semantics) is recommended instead. This property will therefore be removed in future versions.
has alias ID
true
This parent property groups a number of sub-properties that provide additional richness to building or device model and that are often used in practice in various systems, but which have not yet (REC 3.0) been fully modelled their respecive REC modules.
has auxiliary data
Indicates a city that a certain Geometry is part of.
has city
Extra information about an object that is of a more exceptional character. E.g. "This Device needs to be replaced no later than 2020", "Note: Black color is used to mark warmwater inlet".
Deprecated in favour of core:comment.
has comment
true
Indicates a country that a certain Geometry is part of.
has country
has created time
has deleted time
Measured in ms (milliseconds). Duration is defined as the length of time that something lasts.
has duration
The angle between one of the axis of a local coordinate system within e.g. a building and a north-south meridian. The angle is measured between the meridian and the local coordinate axis and counted as positive to the east side of the meridan (neagtive to the west side).
Bearings are never greater than 90°.
Bearings are based on true north.
has geo reference bearing
Linking to https://www.geonames.org
E.g. for Stockholm (Sweden):
LocationUUID#1 hasGenonames http://www.geonames.org/2673730/stockholm.html
has geonames ID
Designation or enumeration commenly found on blueprints for an object. E.g. text designating a Device or a Room.
has littera
This property is a cognitive clustering for human consumption, grouping sub-properties that assign labels (e.g., place names, addresses, etc.) to Geometry entities. This branch of the property hierarchy may need some further development and cleaning up in future versions.
has location attribute
has observation time
has point in time
Human-readable-friendly name.
has popular name
Address used for postal delivery.
has postal address
Time when an object or result was processed in a system.
has processed time
has read time
Indicates a region that a certain Geometry is part of.
has region
Used for information about a source system or data.
has source
has start time
has stop time
Indicates any sustainability certifications that a Building or piece of Real Estate has achieved. This is a stub for now and will likely be more expressively modelled as classes and properties in future REC releases.
has sustainability certification
Cognitive clustering of time-related properties that can apply to time-indexed objects (i.e., events of various sorts).
Certain time properties are given using xsd:DateTime, i.e., ISO8601 (see below), whereas others are given as ints or floats, depending on use case.
Time format ISO8601:
Complete date, hour, minutes, seconds, and decimal fraction of second
YYYY-MM-DDThh:mm:ss.sTZD (eg 1997-07-16T19:20:30.45+01:00)
Where:
YYYY = 4 numbers for year.
MM = 2 numbers for month (01=January, etc.)
DD = 2 numbers for day of month (01 till 31)
hh = 2 numbers for hour (00 till 23) (am/pm not allowed)
mm = 2 numbers for minutes (00 till 59)
ss = 2 numbers for second (00 till 59)
s = 1 or more numbers represent a decimal fraction of second
TZD = time zone designator (Z or +hh:mm or -hh:mm)
Time is expressed in UTC (Coordinated Universal Time), with designated UTC ("Z") for GMT.
has time
has updated time
REC entities may be associated with values (e.g., Sensors, Setpoints, etc).
Deprecated in favor of core:value.
has value
true
An address for visiting the Geometry. If a Geometry has multiple visiting addresses, then just add as many hasVistingAddress as needed.
has visting address
Indicates a certain Geometry's zip code.
has zip code
Expressed as a string adhering to the notation "(x,y,z)", where x, y, and z ar whole or decimal numbers indicating the position in the local building coordinate system, measured in meters. This relates to the outside world coordinate refence system via the values expressed by GeoReferenceOrigo.
is located at local coordinates
Most recently reported or set value of a core:Capability.
last value
Time when a core:Capability's value was last updated (see core:lastValue).
last value time
A number indicating the ordinal number of this level within the building. Note that the implementation of this numbering scheme and its starting point is implementation-specific; e.g., the fifth floor below ground may be 0 in some systems, and -5 in others.
level number
model number
The number of people who can fit in a Space.
person capacity
The number of people presently occupying a Space.
person occupancy
physical tag number
Reference to the unique identity of the real estate in the property register in the country where the real estate is located.
property register designation
serial number
Indicates a time interval during which something occured, or that something refers to. Intervals are expressed as combinations of some time point and a duration, or as two time points, per ISO 8601; see https://en.wikipedia.org/wiki/ISO_8601.
time interval
type
The syntactical representation of a unit, e.g., m^3 for cubic meter, etc.
unit sign
URL
REC observations (core:Observation) encapsulate observation values that are serialized using this property.
value
The class represents the top-level geometry type. This class is equivalent to the UML class GM_Object defined in ISO 19107, and it is superclass of all geometry types.
GeoSPARQL is Copyright (c) 2012 Open Geospatial Consortium, Inc. All Rights Reserved. http://www.opengeospatial.org/ogc/document.
Geometry
geometry
true
An actuator takes some control input and executes some real-world action based on this input. Examples include setting dampers/valves in heating/cooling systems at certain configurations, opening or closing a smart lock, turning on or off an electric radiator, etc. REC does not provide semantics for every type of actuator you might find in a building; rather we here provide classes and properties that allows users to define their own actuator models, based on the systems they have, adhering to REC.
Actuator
actuator
true
The human, group, or machine that consumes or acts upon an object or data. This higher-level grouping allows properties that are shared among its subclasses (Person, Organization, Company, Department...) to be anchored in one joint place, on the Agent class.
Agent
agent
true
Apartment
Something which is placed inside of a building, but is not an integral part of that building's structure; e.g., furniture, equipment, systems, etc.
Asset
asset
true
Asset collection
A confined building structure.
Building
1
1
A part that constitutes a piece of a building's structural makeup. E.g., Facade, Wall, Slab, RoofInner, etc.
Building component
buildingcomponent
true
A campus represents a collection of location entities. The constituent locations may have differing legal ownership and utilization purposes, but they are generally perceived as a coherent unit or sub-region within a city or other region. E.g., a university campus, a hospital campus, a corporate campus, etc.
Campus
1
1
A Capability indicates the capacity of an entity, be it a Space, an Asset, or a Device, to produce or ingest data. This is roughly equivalent to the established Brick Schema and generic BMS term "point". Specific subclasses specialize this behaviour: Sensor entities harvest data from the real world, Actuator entities accept commands from a digital twin platform, and Parameter entities configure some capability or system.
Capability
An administrative grouping of entities that are adressed and treated as a unit for some purpose. These entities may have some spatial arrangement (e.g., an apartment is typically contiguous) but that is not a requirement (see, e.g., a distributed campus consisting of spatially disjoint plots or buildings).
Collection
collection
true
A data schema for a service, a sensor, an actuator, etc. See the REC dataschemas module for concrete schema semantics.
Data schema
1
1
A thing made or adapted for a particular purpose, specifically a piece of electronic equipment. A Device can contain subdevices or be part of superdevices. It is subclassed into more specific device types, e.g., Sensor, Actuator, etc.
Deprecated in favour of core:Asset (the hardware), core:LogicalDevice (the software), and core:Capability (the measurement or actuation capability).
Device
true
Document
document
true
A spatiotemporally indexed entity with participants (e.g., something which occurs somewhere, and that has or takes some time). We do not on this top level define the particulars of how to model space or time; that is left to the implementing subclasses. Thus, in a sense, this is just a cognitive clustering for human consumers of the ontology, a root class from which all different types of events derive.
Event
event
true
A fixed point for e.g. a building structure. Commonly refered to as "insertion point" in CAD-programs. Used as origo for LocalCoordinates.
Geo-reference origo
HVAC zone
A generic catch-all superclass for all kinds of intangible REC types used in a broad variety of contexts, e.g., configurations, tags, data series, etc.
Information
A piece of land upon which one or more buildings may be situated.
Land
The level of a building, a.k.a. storey, floor, etc.
Level
level
true
Logical controller
1
1
A piece of equipment or software that communicates and interacts with a digital twin platform. Could, e.g., be an integrated circuit inside of a smart HVAC unit, or a virtual server running on a Kubernetes cluster. Logical devices can have Capability instances (through hasCapability) that describe their input/output capabilties. If Logical Devices are embedded within Asset entities (through the locatedIn property) such capabilties typically denote the capabilities of the asset.
Logical device
logicaldevice
true
Logical gateway
Logical server
Deprecated in favour of qudt:Unit
The measurment units that are used in RealEstateCore. Use SI-units in general. Store values without prefixes.
Exceptions to SI:
Express temperature in Celsius,
Energy in Watt hour (Wh),
Angle i degrees (360 degress = 1 revolution)
MillimeterPerHour for Precipation
Measurement unit
https://www.qudt.org/
true
measurementunit
true
A sensor observation.
Observation
Occupancy Zone is a spatial area where devices are monitoring or reporting on the concept of Occupancy (motion sensors, people counters, cameras, etc.)
Occupancy zone
Parameter
parameter
true
A portfolio is a grouping of real estates, spaces, or other portfolios that share some business-relevant commonality, e.g., are managed by the same company, are rented out to the same tenant, share utilization or legal definition (industrial vs commercial), etc.
Portfolio
A premises is an administrative grouping of spaces (buildings, building components, real estates, etc.) that are used for some purpose by a real estate holder or tenant.
Premises
true
Premises type
true
A set of categorization properties associated with a REC entity, complementing the subsumpion hierarchy and allowing orthogonal categorization without the use of multiple inheritance structures. Used for compatibility with legacy point- or tag-based systems.
Property set
component
Deprecated in favour of qudt:QuantityKind
Describes the type of values that can be observed by sensors or set by actuators. Inspired by QUDT.
Quantity kind
true
quantitykind
true
The legal/administrative representation of some lands and/or buildings.
Real estate
realestate
true
1
Types of objects that can make up a piece of real estate, e.g., land and buildings.
Real estate component
true
realestatecomponent
true
An administrative geospatial unit larger than the individual real estate. For instance, "Lombary", "North America", "The Back Bay", "Elnätsområde Syd", etc.
Region
Base class for all more specific room types.
Room
room
true
true
Capability to detect or measure properties of the physical world.
Sensor
sensor
true
true
1
sensorinterface
true
1
Service
service
true
Setpoint
Any piece of software or similar digital resource (including data schemas, etc) that executes or can be loaded on some or many parts of a RealEstateCore-enabled distributed system.
Software
software
true
A contiguous part of the physical world that has a 3D spatial extent and that contains or can contain sub-spaces. E.g., a Region can contain many pieces of Land, which in turn can contain many Buildings.
Space
space
true
Space collection
State
state
true
Tower
Wing
A part of a larger building complex, e.g., a wing, a tower, or an interconnected (through walkways or other means) but largely free-standing building.
Sub-building
Type
true
Workspace
A sub-zone within a building, e.g., an HVAC zone, a security zone, etc.
Zone
ActiveEnergyL1
ActiveEnergyL2
ActiveEnergyL3
ActiveEnergyTotal
ActivePowerL1
ActivePowerL2
ActivePowerL3
ActivePowerTotal
When a human interacts with a system. E.g. pushes a button to turn on/off a light, force ventilation.
AgentInteraction
Danger for property
AlarmMajor
Notifications
AlarmMinor
Danger for life and property
AlarmSevere
A
Ampere. Current in a circuit.
Ampere
Angle
Area
Number of people counted in a specified area (at the observation time).
Area presence
Binary
This measurement unit is used to quantify the detection or lack thereof of a phenomenon, e.g., in a simple IR-sensor that can only detect some presence within its detection range, but is not able to quantify anything more specific about that presence.
BooleanDetection
CO
CO2
C
Temperature in Celsius degress. Note that correct SI Unit is Kelvin.
Celsius
Concentration
cos-phi
The angle between two electrical phases.
CosPhi
m3
Volume is the quantity of three-dimensional space enclosed by a closed surface, for example, the space that a substance (solid, liquid, gas, or plasma) or shape occupies or contains. Volume is often quantified numerically using the cubic metre (m3).
CubicMeter
Current
CurrentL1
CurrentL2
CurrentL3
db
Sound level
Decibel
Degrees
Efficiency
Total energy (not specified as Active or Reactive, used for e.g. district heating).
EnergyTotal
F
Temperature in Fahrenheit degress.
Fahrenheit
Flow
Number of people crossing a specified line (at the observation time)
Footfall
GlobalIrradiance
https://en.wikipedia.org/wiki/Solar_irradiance
Hz
One cycle per second.
Hertz
Humidity
Humidity
Illuminance
Integer
K
Temperature in Kelvin degrees
Kelvin
kg
Mass.
Kilogram
Lenght
true
Length
l/s
Flow
LiterPerSecond
Emitted light
lm
Lumen
lx
Light intensity in a specific area.
Lux
m
Lenght.
Meter
MeterPerSecond
For measuring Precipation
MillimeterPerHour
Number of people.
NumPeople
Number
Parts per billion.
PartsPerBillion
ppm
Measurement for concentration
PartsPerMillion
Pa
The pascal is the SI derived unit of pressure used to quantify internal pressure, stress. It is defined as one newton per square metre.
Pascal
In Haystack: barometric is described as "Defines the mean atmospheric pressure at sea level measured in millibar or in Hg."
Percentage
pf
The power factor of an AC electrical power system is defined as the ratio of the real power flowing to the load to the apparent power in the circuit, and is a dimensionless number in the closed interval of −1 to 1.
PowerFactor
PowerFactorL1
PowerFactorL2
PowerFactorL3
PowerFrequency
Measured in MillimeterPerHour
Precipation
true
Measured in MillimeterPerHour
Precipitation
Presence equivivalent
Presence
Pressure
Pressure
Tryck
Radiation
ReactivePowerL1
ReactivePowerL2
ReactivePowerL3
ReactivePowerTotal
RH
Relative Humidity. The amount of water vapour present in air expressed as a percentage of the amount needed for saturation at the same temperature.
RelativeHumidity
rpm
RevoultionsPerMinute
RotationSpeed
s
The second is the duration of 9 192 631 770 periods of the radiation corresponding to the transition between the two hyperfine levels of the ground state of the cesium 133 atom.
Second
Sound
Speed
m2
Area unit. It is the area of a square whose sides measure exactly one metre.
SquareMeter
SunshineTimePerHour
TVOC
Temperature
Temperature
Velocity
V
Voltage, electric potential difference, is the difference in electric potential between two points.
Volt
Voltage
VoltageL1
VoltageL2
VoltageL3
Volume
Waste that has been sent to, e.g., a landfill.
Waste diverted
The total amount of waste.
Waste total
W
This unit is typically used to express the momentaneous output power of engines and the power of electric motors, tools, machines, and heaters.
Watt
Wh
Enery. Watthour.
WattHour
WattPerSquareMeter
https://www.rapidtables.com/calc/light/how-watt-to-lux.html