Skip to content

Commit

Permalink
Merge branch 'main' into srr-latest-Pritoni
Browse files Browse the repository at this point in the history
  • Loading branch information
steveraysteveray committed Oct 14, 2024
2 parents 7b80350 + aab8a9b commit f1b41ef
Show file tree
Hide file tree
Showing 17 changed files with 50,838 additions and 52,889 deletions.
3 changes: 2 additions & 1 deletion build_examples.sh
Original file line number Diff line number Diff line change
Expand Up @@ -34,4 +34,5 @@ python tools/generate-queries.py

# for each filename in the models/ directory, run tools/compile.py -o models/compiled/<filename>.ttl
mkdir -p models/compiled
make compile-models
make -j 4 compile-models
jb build .
4 changes: 3 additions & 1 deletion intro.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,9 +14,11 @@ kernelspec:

ASHRAE standard 223P is a proposed standard that formally defines knowledge concepts for representing building system information such as the connections between mechanical equipment, spaces within a building, and their measurement and control points. It is a metadata schema and semantic ontology that defines the modeling constructs and rules needed to construct semantically interoperable, machine-readable semantic models that provide software applications the ability to determine essential information about the meaning and context of building data to support the deployment of various advanced features such as advanced building controls, fault detection and diagnostics, and automated commissioning.

Most models are available in two variants: "original" and "compiled" where in the latter, SHACL Rules defined by the 223P ontology are applied to extend RDF instance data.

````{margin}
```{note}
Publication document is not yet publicly published
The 223P standard is not yet finalized and is still under development.
```
````

Expand Down
28 changes: 23 additions & 5 deletions models/design-patterns.ttl
Original file line number Diff line number Diff line change
Expand Up @@ -122,9 +122,9 @@ pt2:ElectricWireBothSwitches-Lum
.
pt2:Luminaire
a s223:Luminaire ;
s223:actuatedByProperty pt2:LuminaireCommand ;
s223:cnx pt2:LuminaireInletCP ;
s223:cnx pt2:LuminaireOutletCP ;
s223:commandedByProperty pt2:LuminaireCommand ;
s223:connected pt2:DumbSwitch ;
s223:connectedTo pt2:DomainSpace ;
rdfs:label "Luminaire" ;
Expand Down Expand Up @@ -209,9 +209,9 @@ pt3:Function1
.
pt3:Luminaire
a s223:Luminaire ;
s223:actuatedByProperty pt3:LuminaireCommand ;
s223:cnx pt3:LuminaireInletCP ;
s223:cnx pt3:LuminaireOutletCP ;
s223:commandedByProperty pt3:LuminaireCommand ;
s223:connectedTo pt3:DomainSpace ;
rdfs:label "Luminaire" ;
.
Expand Down Expand Up @@ -301,8 +301,8 @@ pt4:Function1
.
pt4:LightActuator
a s223:Actuator ;
s223:actuatedByProperty pt4:LuminaireCommand ;
s223:cnx pt4:LightActuatorOutletCP ;
s223:commandedByProperty pt4:LuminaireCommand ;
s223:connectedTo pt4:LightBulb ;
rdfs:label "Light actuator" ;
.
Expand Down Expand Up @@ -338,8 +338,8 @@ pt4:LightBulbOutletCP
.
pt4:Luminaire
a s223:Luminaire ;
s223:actuatedByProperty pt4:LuminaireCommand ;
s223:cnx pt4:LuminaireOutletCP ;
s223:commandedByProperty pt4:LuminaireCommand ;
s223:contains pt4:LightActuator ;
s223:contains pt4:LightBulb ;
rdfs:label "Luminaire" ;
Expand Down Expand Up @@ -444,8 +444,8 @@ pt6:Function1
.
pt6:LightActuator
a s223:Actuator ;
s223:actuatedByProperty pt6:LuminaireCommand ;
s223:actuates pt6:Relay ;
s223:commandedByProperty pt6:LuminaireCommand ;
rdfs:label "Light actuator" ;
.
pt6:Luminaire
Expand Down Expand Up @@ -565,13 +565,15 @@ pt7:Breaker
pt7:BreakerOutletCP
a s223:OutletConnectionPoint ;
s223:cnx pt7:Circuit1 ;
s223:hasMedium s223:AC-120VLN-1Ph-60Hz ;
rdfs:label "Breaker outlet CP" ;
.
pt7:Circuit1
a s223:ElectricWire ;
s223:cnx pt7:Motor1InletCP ;
s223:cnx pt7:Motor2InletCP ;
s223:cnx pt7:Motor3InletCP ;
s223:hasMedium s223:AC-120VLN-1Ph-60Hz ;
rdfs:label "Circuit1" ;
.
pt7:Motor1
Expand All @@ -581,6 +583,7 @@ pt7:Motor1
.
pt7:Motor1InletCP
a s223:InletConnectionPoint ;
s223:hasMedium s223:AC-120VLN-1Ph-60Hz ;
rdfs:label "Motor1Inlet CP" ;
.
pt7:Motor2
Expand All @@ -590,6 +593,7 @@ pt7:Motor2
.
pt7:Motor2InletCP
a s223:InletConnectionPoint ;
s223:hasMedium s223:AC-120VLN-1Ph-60Hz ;
rdfs:label "Motor2Inlet CP" ;
.
pt7:Motor3
Expand All @@ -599,6 +603,7 @@ pt7:Motor3
.
pt7:Motor3InletCP
a s223:InletConnectionPoint ;
s223:hasMedium s223:AC-120VLN-1Ph-60Hz ;
rdfs:label "Motor3Inlet CP" ;
.
pt8:Breaker
Expand All @@ -609,53 +614,63 @@ pt8:Breaker
pt8:BreakerOutletCP
a s223:OutletConnectionPoint ;
s223:cnx pt8:Circuit1 ;
s223:hasMedium s223:AC-120VLN-1Ph-60Hz ;
rdfs:label "Breaker outlet CP" ;
.
pt8:Circuit1
a s223:ElectricWire ;
s223:cnx pt8:JunctionInletCP ;
s223:hasMedium s223:AC-120VLN-1Ph-60Hz ;
rdfs:label "Circuit1" ;
.
pt8:CircuitBranch1
a s223:ElectricWire ;
s223:cnx pt8:Motor1InletCP ;
s223:hasMedium s223:AC-120VLN-1Ph-60Hz ;
rdfs:label "Circuit branch1" ;
.
pt8:CircuitBranch2
a s223:ElectricWire ;
s223:cnx pt8:Motor2InletCP ;
s223:hasMedium s223:AC-120VLN-1Ph-60Hz ;
rdfs:label "Circuit branch2" ;
.
pt8:CircuitBranch3
a s223:ElectricWire ;
s223:cnx pt8:Motor3InletCP ;
s223:hasMedium s223:AC-120VLN-1Ph-60Hz ;
rdfs:label "Circuit branch3" ;
.
pt8:Junction
a s223:Junction ;
s223:cnx pt8:JunctionOutletCP1 ;
s223:cnx pt8:JunctionOutletCP2 ;
s223:cnx pt8:JunctionOutletCP3 ;
s223:hasMedium s223:AC-120VLN-1Ph-60Hz ;
rdfs:label "Junction" ;
.
pt8:JunctionInletCP
a s223:InletConnectionPoint ;
s223:cnx pt8:Junction ;
s223:hasMedium s223:AC-120VLN-1Ph-60Hz ;
rdfs:label "Junction inlet CP" ;
.
pt8:JunctionOutletCP1
a s223:OutletConnectionPoint ;
s223:cnx pt8:CircuitBranch1 ;
s223:hasMedium s223:AC-120VLN-1Ph-60Hz ;
rdfs:label "Junction outlet CP1" ;
.
pt8:JunctionOutletCP2
a s223:OutletConnectionPoint ;
s223:cnx pt8:CircuitBranch2 ;
s223:hasMedium s223:AC-120VLN-1Ph-60Hz ;
rdfs:label "Junction outlet CP2" ;
.
pt8:JunctionOutletCP3
a s223:OutletConnectionPoint ;
s223:cnx pt8:CircuitBranch3 ;
s223:hasMedium s223:AC-120VLN-1Ph-60Hz ;
rdfs:label "Junction outlet CP3" ;
.
pt8:Motor1
Expand All @@ -665,6 +680,7 @@ pt8:Motor1
.
pt8:Motor1InletCP
a s223:InletConnectionPoint ;
s223:hasMedium s223:AC-120VLN-1Ph-60Hz ;
rdfs:label "Motor1Inlet CP" ;
.
pt8:Motor2
Expand All @@ -674,6 +690,7 @@ pt8:Motor2
.
pt8:Motor2InletCP
a s223:InletConnectionPoint ;
s223:hasMedium s223:AC-120VLN-1Ph-60Hz ;
rdfs:label "Motor2Inlet CP" ;
.
pt8:Motor3
Expand All @@ -683,5 +700,6 @@ pt8:Motor3
.
pt8:Motor3InletCP
a s223:InletConnectionPoint ;
s223:hasMedium s223:AC-120VLN-1Ph-60Hz ;
rdfs:label "Motor3Inlet CP" ;
.
144 changes: 100 additions & 44 deletions models/guideline36-2021-A-1.ttl
Original file line number Diff line number Diff line change
@@ -1,77 +1,133 @@
@prefix bldg: <urn:ex/> .
@prefix s223: <http://data.ashrae.org/standard223#> .
@prefix g36: <http://data.ashrae.org/standard223/1.0/extensions/g36#> .
@prefix mysystem1: <http://data.ashrae.org/standard223/1.0/data/guideline36-2021-A-1#> .
@prefix owl: <http://www.w3.org/2002/07/owl#> .
@prefix qudt: <http://qudt.org/schema/qudt/> .
@prefix qudtqk: <http://qudt.org/vocab/quantitykind/> .
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
@prefix s223: <http://data.ashrae.org/standard223#> .
@prefix unit: <http://qudt.org/vocab/unit/> .

bldg: a owl:Ontology .
mysystem1: a owl:Ontology ;
rdfs:label "" ;
owl:imports <http://data.ashrae.org/standard223/1.0/model/all> .

bldg:damper-actuator a s223:Actuator ;
s223:actuates bldg:damper ;
s223:commandedByProperty bldg:damper-command .
mysystem1:PhysicalSpace a s223:PhysicalSpace ;
rdfs:label "Physicalspace" ;
s223:encloses mysystem1:PhysicalSpace-hvac-domain .

bldg:discharge-air-flow-sensor a s223:Sensor ;
s223:hasObservationLocation bldg:out ;
s223:observes bldg:discharge-air-flow .
mysystem1:VAVCoolingOnly a s223:SingleDuctTerminal,
g36:VAV ;
rdfs:label "Vavcoolingonly" ;
s223:cnx mysystem1:VAVCoolingOnly-in,
mysystem1:VAVCoolingOnly-out ;
s223:contains mysystem1:VAVCoolingOnly-damper .

bldg:vav-cooling-only a s223:SingleDuctTerminal,
<http://data.ashrae.org/standard223/1.0/extensions/g36#VAV> ;
s223:cnx bldg:in,
bldg:out ;
s223:contains bldg:damper .
mysystem1:VAVCoolingOnly-damper-actuator a s223:Actuator ;
rdfs:label "Vavcoolingonly Damper Actuator" ;
s223:actuatedByProperty mysystem1:VAVCoolingOnly-damper-command ;
s223:actuates mysystem1:VAVCoolingOnly-damper .

bldg:damper-in a s223:InletConnectionPoint ;
s223:cnx bldg:duct-before-damper ;
s223:hasMedium s223:Fluid-Air ;
s223:mapsTo bldg:in .

bldg:damper-out a s223:OutletConnectionPoint ;
s223:cnx bldg:duct-after-damper ;
s223:hasMedium s223:Fluid-Air ;
s223:mapsTo bldg:out .
mysystem1:VAVCoolingOnly-discharge-air-flow-sensor a s223:Sensor ;
rdfs:label "Vavcoolingonly Discharge Air Flow Sensor" ;
s223:hasObservationLocation mysystem1:VAVCoolingOnly-out ;
s223:observes mysystem1:VAVCoolingOnly-discharge-air-flow .

bldg:damper-position a s223:QuantifiableObservableProperty ;
qudt:hasQuantityKind qudtqk:DimensionlessRatio ;
qudt:hasUnit unit:PERCENT .

bldg:duct-after-damper a s223:Connection,
mysystem1:VAVCoolingOnly-duct-after-damper a s223:Connection,
s223:Duct ;
rdfs:label "Vavcoolingonly Duct After Damper" ;
s223:hasMedium s223:Fluid-Air .

bldg:duct-before-damper a s223:Connection,
mysystem1:VAVCoolingOnly-duct-before-damper a s223:Connection,
s223:Duct ;
rdfs:label "Vavcoolingonly Duct Before Damper" ;
s223:hasMedium s223:Fluid-Air .

bldg:in-connection a s223:Connection ;
mysystem1:zone a s223:Zone,
g36:Zone ;
rdfs:label "Zone" ;
s223:hasDomain s223:Domain-HVAC ;
s223:hasDomainSpace mysystem1:PhysicalSpace-hvac-domain ;
s223:hasProperty mysystem1:zone-co2-concentration,
mysystem1:zone-temp .

mysystem1:PhysicalSpace-hvac-domain-in a s223:InletConnectionPoint ;
rdfs:label "Physicalspace Hvac Domain In" ;
s223:cnx mysystem1:vav-supply-to-room-connection ;
s223:hasMedium s223:Fluid-Air .

bldg:out-connection a s223:Connection ;
mysystem1:PhysicalSpace-hvac-domain-out a s223:OutletConnectionPoint ;
rdfs:label "Physicalspace Hvac Domain Out" ;
s223:cnx mysystem1:room-return-to-vav-connection ;
s223:hasMedium s223:Fluid-Air .

bldg:damper a s223:Damper,
<http://data.ashrae.org/standard223/1.0/extensions/g36#Damper> ;
s223:cnx bldg:damper-in,
bldg:damper-out ;
s223:hasProperty bldg:damper-command,
bldg:damper-position .
mysystem1:VAVCoolingOnly-damper-in a s223:InletConnectionPoint ;
rdfs:label "Vavcoolingonly Damper In" ;
s223:hasMedium s223:Fluid-Air ;
s223:mapsTo mysystem1:VAVCoolingOnly-in .

mysystem1:VAVCoolingOnly-damper-out a s223:OutletConnectionPoint ;
rdfs:label "Vavcoolingonly Damper Out" ;
s223:hasMedium s223:Fluid-Air ;
s223:mapsTo mysystem1:VAVCoolingOnly-out .

mysystem1:VAVCoolingOnly-damper-position a s223:QuantifiableObservableProperty ;
rdfs:label "Vavcoolingonly Damper Position" ;
qudt:hasQuantityKind qudtqk:DimensionlessRatio ;
qudt:hasUnit unit:PERCENT .

bldg:damper-command a s223:QuantifiableActuatableProperty ;
mysystem1:zone-co2-concentration a s223:QuantifiableObservableProperty ;
rdfs:label "Zone Co2 Concentration" ;
s223:ofSubstance s223:Constituent-CO2 ;
qudt:hasQuantityKind qudtqk:MoleFraction ;
qudt:hasUnit unit:PPM .

mysystem1:zone-temp a s223:QuantifiableObservableProperty ;
rdfs:label "Zone Temp" ;
qudt:hasQuantityKind qudtqk:Temperature ;
qudt:hasUnit unit:DEG_C .

mysystem1:PhysicalSpace-hvac-domain a s223:DomainSpace ;
rdfs:label "Physicalspace Hvac Domain" ;
s223:cnx mysystem1:PhysicalSpace-hvac-domain-in,
mysystem1:PhysicalSpace-hvac-domain-out ;
s223:hasDomain s223:Domain-HVAC .

mysystem1:VAVCoolingOnly-damper a s223:Damper,
g36:Damper ;
rdfs:label "Vavcoolingonly Damper" ;
s223:cnx mysystem1:VAVCoolingOnly-damper-in,
mysystem1:VAVCoolingOnly-damper-out ;
s223:hasProperty mysystem1:VAVCoolingOnly-damper-command,
mysystem1:VAVCoolingOnly-damper-position .

mysystem1:VAVCoolingOnly-damper-command a s223:QuantifiableActuatableProperty ;
rdfs:label "Vavcoolingonly Damper Command" ;
s223:hasAspect s223:EnumerationKind-Position ;
qudt:hasQuantityKind qudtqk:DimensionlessRatio ;
qudt:hasUnit unit:PERCENT .

bldg:discharge-air-flow a s223:QuantifiableObservableProperty ;
mysystem1:VAVCoolingOnly-discharge-air-flow a s223:QuantifiableObservableProperty ;
rdfs:label "Vavcoolingonly Discharge Air Flow" ;
s223:hasAspect s223:Role-Discharge ;
qudt:hasQuantityKind qudtqk:VolumeFlowRate ;
qudt:hasUnit unit:FT3-PER-MIN .

bldg:in a s223:InletConnectionPoint ;
s223:cnx bldg:in-connection ;
mysystem1:VAVCoolingOnly-in a s223:InletConnectionPoint ;
rdfs:label "Vavcoolingonly In" ;
s223:cnx mysystem1:room-return-to-vav-connection ;
s223:hasMedium s223:Fluid-Air .

mysystem1:room-return-to-vav-connection a s223:Connection ;
rdfs:label "Room Return To Vav Connection" ;
s223:hasMedium s223:Fluid-Air .

mysystem1:vav-supply-to-room-connection a s223:Connection ;
rdfs:label "Vav Supply To Room Connection" ;
s223:hasMedium s223:Fluid-Air .

bldg:out a s223:OutletConnectionPoint ;
s223:cnx bldg:out-connection ;
mysystem1:VAVCoolingOnly-out a s223:OutletConnectionPoint ;
rdfs:label "Vavcoolingonly Out" ;
s223:cnx mysystem1:vav-supply-to-room-connection ;
s223:hasMedium s223:Fluid-Air ;
s223:hasProperty bldg:discharge-air-flow .
s223:hasProperty mysystem1:VAVCoolingOnly-discharge-air-flow .

Loading

0 comments on commit f1b41ef

Please sign in to comment.