Skip to content

lib-phIoT 库参考(第 3 部分) ​

原文: https://finproducts.atlassian.net/wiki/spaces/JIDD3/pages/34793849125/FIN+5.3.1+lib-phIoT+part+3 中文整理基于 FIN 5.3.1

导读: 用于暖通空调加热的热水或供应到热水龙头的热水

以下为 API 参考,保留英文以便对照源码;目录已列出(英文标题便于检索);概述已尽量中译。


目录(导读) ​


概述(中译) ​

用于暖通空调加热的热水或供应到热水龙头的热水


API 正文(英文) ​

meta ​

defhot-water
iswater
liblib:phIoT
wikipediahttps://en.wikipedia.org/wiki/Water

usage ​

hot  water

supertypes ​

markerMarker labels a dict with typing information
phenomenonAspect of scientific interest with measurable quantities
substanceMatter in one the three states solid, liquid, or gas
fluidLiquid or gas
liquidSubstance with definite volume but takes the shape of its container
waterWater in its liquid form

quantities ​

concentrationAbundance of substance in the total volume of a mixture
flowMeasure of volumetric flow of fluid
levelRange from 0% to 100%
pressureMeasure of force applied
tempTemperature - measure of hot and cold
volumeThree dimensional space occupied by a substance


def ​

hot ​

Having high degree of heat


meta ​

defhot
ismarker
liblib:phIoT

supertypes ​

markerMarker labels a dict with typing information


def ​

hotDeck ​

Duct carries air for heating


meta ​

defhotDeck
isductDeck
liblib:phIoT
uiInputui::ChoiceInput

supertypes ​

markerMarker labels a dict with typing information
choiceChoice specifies an exclusive marker selection
ductDeckCold, hot, or neutral deck


def ​

hotWaterHeating ​

Heating using energy of hot water


meta ​

defhotWaterHeating
isheatingProcess, hot-water-input
liblib:phIoT
uiInputui::ChoiceInput

supertypes ​

markerMarker labels a dict with typing information
choiceChoice specifies an exclusive marker selection
heatingProcessProcessed used to heat a substance
inputEntity inputs a substance which flows from another entity
hot-water-inputEntity inputs hot water which flows from another entity

tags ​

hotWaterRefHot water flows from the referent to this entity


def ​

hotWaterRef ​

Hot water flows from the referent to this entity


meta ​

defhotWaterRef
inputshot-water
isref
liblib:phIoT
ofhot-water-output
tagOnhot-water-input

supertypes ​

valData value type
scalarScalar is an atomic value kind
refReference to an entity


def ​

humidifier-equip ​

Equipment which adds moisture to air to increase humidity


conjunct ​

humidifierAdding moisture to air
equipEquipment asset

meta ​

childrenFlatten
defhumidifier-equip
iconEquipIcon
isequip
liblib:phIoT
wikipediahttps://en.wikipedia.org/wiki/Humidifier

usage ​

humidifier  equip

supertypes ​

markerMarker labels a dict with typing information
entityTop-level dicts with a unique identifier
equipEquipment asset

tags ​

disDisplay name for an entity
disMacroDisplay name using macro syntax
equipRefReference to equip which contains this entity
ghgSourceRefRef to the emission source used to calculate Greenhouse Gas Emissions
idDefines the unique identifier of an entity in system using a ref value type
navNameNavigation name commonly used with disMacro to create computed display strings
siteRefReference to site which contains the entity
spaceRefReference to space which contains this entity
systemRefReference to system

children ​

humidifier enable cmd point
humidifier run cmd point
humidifier run cmd point


def ​

humidifier ​

Adding moisture to air


meta ​

defhumidifier
ismarker
liblib:phIoT

supertypes ​

markerMarker labels a dict with typing information


def ​

hvac-zone-space ​

Zone related to conditioning of a space's air temperature and quality. See Spaces and Zones chapters.


conjunct ​

hvacHeating, ventilation, and air conditioning
zoneRelated to spaces from a system perspective
spaceSpace is a three-dimensional volume in the built environment

meta ​

defhvac-zone-space
iszone-space, hvacZonePoints, airQualityZonePoints, air-input
liblib:phIoT

usage ​

hvac  zone  space

supertypes ​

markerMarker labels a dict with typing information
entityTop-level dicts with a unique identifier
pointGroupGrouping of children points used by spaces and equipment
airQualityZonePointsEntity with logical grouping of zone air quality points
hvacZonePointsEntity with logical grouping of zone HVAC air points
spaceSpace is a three-dimensional volume in the built environment
zone-spaceSpace associated with a specific system
inputEntity inputs a substance which flows from another entity
air-inputEntity inputs air which flows from another entity

tags ​

airRefAir flows from the referent to this entity
areaArea of a shape or floor space
disDisplay name for an entity
disMacroDisplay name using macro syntax
idDefines the unique identifier of an entity in system using a ref value type
navNameNavigation name commonly used with disMacro to create computed display strings
siteRefReference to site which contains the entity
spaceRefReference to space which contains this entity

children ​

occupancy sensor point
occupied sensor point
occupied sensor point
occupied sp point
occupied sp point
zone air ch2o concentration sensor point
zone air ch2o concentration sensor point
zone air co concentration sensor point
zone air co concentration sensor point
zone air co2 concentration sensor point
zone air co2 concentration sensor point
zone air co2 concentration sp point
zone air co2 concentration sp point
zone air dewPoint sensor point
zone air dewPoint sensor point
zone air dewPoint sp point
zone air dewPoint sp point
zone air enthalpy sensor point
zone air enthalpy sensor point
zone air enthalpy sp point
zone air enthalpy sp point
zone air humidity sensor point
zone air humidity sensor point
zone air humidity sp point
zone air humidity sp point
zone air hvacMode sp point
zone air hvacMode sp point
zone air nh3 concentration sensor point
zone air nh3 concentration sensor point
zone air no2 concentration sensor point
zone air no2 concentration sensor point
zone air o3 concentration sensor point
zone air o3 concentration sensor point
zone air pm01 concentration sensor point
zone air pm01 concentration sensor point
zone air pm10 concentration sensor point
zone air pm10 concentration sensor point
zone air pm25 concentration sensor point
zone air pm25 concentration sensor point
zone air pressure sensor point
zone air pressure sensor point
zone air pressure sp point
zone air pressure sp point
zone air temp effective cooling sp point
zone air temp effective cooling sp point
zone air temp effective heating sp point
zone air temp effective heating sp point
zone air temp effective sp point
zone air temp effective sp point
zone air temp occ cooling sp point
zone air temp occ cooling sp point
zone air temp occ heating sp point
zone air temp occ heating sp point
zone air temp sensor point
zone air temp sensor point
zone air temp standby cooling sp point
zone air temp standby cooling sp point
zone air temp standby heating sp point
zone air temp standby heating sp point
zone air temp unocc cooling sp point
zone air temp unocc cooling sp point
zone air temp unocc heating sp point
zone air temp unocc heating sp point
zone air tvoc concentration sensor point
zone air tvoc concentration sensor point


def ​

hvac ​

Heating, ventilation, and air conditioning


meta ​

defhvac
ismarker
liblib:phIoT
wikipediahttps://en.wikipedia.org/wiki/HVAC

supertypes ​

markerMarker labels a dict with typing information


def ​

hvacMode ​

Operational mode for HVAC equipment


meta ​

defhvacMode
enumSee below
ismarker
liblib:phIoT

enum ​

cooling
heating
reheat
warmupmorning warmup where AHU is supplying warm air
purgenight purge when AHU is supplying 100% fresh air
pressurize
depressurize
manual

supertypes ​

markerMarker labels a dict with typing information


def ​

hvacZonePoints ​

Entity with logical grouping of zone HVAC air points. See Zones chapter.


meta ​

defhvacZonePoints
ispointGroup
liblib:phIoT

supertypes ​

markerMarker labels a dict with typing information
entityTop-level dicts with a unique identifier
pointGroupGrouping of children points used by spaces and equipment

subtypes ​

hvac-zone-spaceZone related to conditioning of a space's air temperature and quality
thermostatSenses and controls temperature of space in HVAC system

tags ​

disDisplay name for an entity
idDefines the unique identifier of an entity in system using a ref value type

children ​

zone air hvacMode sp point
zone air temp sensor point
zone air temp sensor point
zone air temp effective sp point
zone air temp effective sp point
zone air temp effective cooling sp point
zone air temp effective cooling sp point
zone air temp effective heating sp point
zone air temp effective heating sp point
zone air temp occ cooling sp point
zone air temp occ cooling sp point
zone air temp occ heating sp point
zone air temp occ heating sp point
zone air temp unocc cooling sp point
zone air temp unocc cooling sp point
zone air temp unocc heating sp point
zone air temp unocc heating sp point
zone air temp standby cooling sp point
zone air temp standby cooling sp point
zone air temp standby heating sp point
zone air temp standby heating sp point
zone air pressure sensor point
zone air pressure sensor point
zone air pressure sp point
zone air pressure sp point
zone air humidity sensor point
zone air humidity sensor point
zone air humidity sp point
zone air humidity sp point
zone air dewPoint sensor point
zone air dewPoint sensor point
zone air dewPoint sp point
zone air dewPoint sp point
zone air enthalpy sensor point
zone air enthalpy sensor point
zone air enthalpy sp point
zone air enthalpy sp point


def ​

imbalance ​

Lacking balance


meta ​

defimbalance
ismarker
liblib:phIoT

supertypes ​

markerMarker labels a dict with typing information


def ​

import ​

Received into a system


meta ​

defimport
ismarker
liblib:phIoT

supertypes ​

markerMarker labels a dict with typing information


def ​

indoorUnit ​

Operates inside the conditioned space


meta ​

defindoorUnit
ismarker
liblib:phIoT

supertypes ​

markerMarker labels a dict with typing information


def ​

infiltration ​

Permeation of a substance into another substance


meta ​

definfiltration
ismarker
liblib:phIoT

supertypes ​

markerMarker labels a dict with typing information


def ​

inlet ​

Duct with air entering an equipment


meta ​

definlet
isductSection
liblib:phIoT
uiInputui::ChoiceInput

supertypes ​

markerMarker labels a dict with typing information
choiceChoice specifies an exclusive marker selection
ductSectionEquipment section of ductwork


def ​

isolation ​

Actuator used to isolate an equipment from a pipe or ductwork system


meta ​

defisolation
ismarker
liblib:phIoT

supertypes ​

markerMarker labels a dict with typing information


def ​

leaving ​

Pipe conveys fluid out of an equipment


meta ​

defleaving
ispipeSection
liblib:phIoT
uiInputui::ChoiceInput

supertypes ​

markerMarker labels a dict with typing information
choiceChoice specifies an exclusive marker selection
pipeSectionEquipment section of piping


def ​

lighting-system ​

System designed to provide lighting.


conjunct ​

lightingSystems associated with illumination in the built environment
systemGrouping of related equipment dedicated to a single application

meta ​

deflighting-system
iselec-system
liblib:phIoT

usage ​

lighting  system

supertypes ​

markerMarker labels a dict with typing information
entityTop-level dicts with a unique identifier
systemGrouping of related equipment dedicated to a single application
elec-systemSystem that generates, converts, distributes, and/or stores electricity

tags ​

disDisplay name for an entity
disMacroDisplay name using macro syntax
idDefines the unique identifier of an entity in system using a ref value type
navNameNavigation name commonly used with disMacro to create computed display strings
siteRefReference to site which contains the entity
systemRefReference to system

children ​

equip
point
point


def ​

lighting-zone-space ​

Zone related to lighting system. See Spaces and Zones chapters.


conjunct ​

lightingSystems associated with illumination in the built environment
zoneRelated to spaces from a system perspective
spaceSpace is a three-dimensional volume in the built environment

meta ​

deflighting-zone-space
iszone-space, lightingZonePoints
liblib:phIoT

usage ​

lighting  zone  space

supertypes ​

markerMarker labels a dict with typing information
entityTop-level dicts with a unique identifier
pointGroupGrouping of children points used by spaces and equipment
lightingZonePointsEntity with logical grouping of lighting points
spaceSpace is a three-dimensional volume in the built environment
zone-spaceSpace associated with a specific system

tags ​

areaArea of a shape or floor space
disDisplay name for an entity
disMacroDisplay name using macro syntax
idDefines the unique identifier of an entity in system using a ref value type
navNameNavigation name commonly used with disMacro to create computed display strings
siteRefReference to site which contains the entity
spaceRefReference to space which contains this entity

children ​

light illuminance sensor point
light level sensor point
light level sensor point
light level sp point
light level sp point
light luminous flux sensor point
light luminous flux sensor point
occupancy sensor point
occupancy sensor point
occupied sensor point
occupied sensor point
occupied sp point
occupied sp point


def ​

lighting ​

Systems associated with illumination in the built environment


meta ​

deflighting
ismarker
liblib:phIoT
wikipediahttps://en.wikipedia.org/wiki/Lighting

supertypes ​

markerMarker labels a dict with typing information


def ​

lightingZonePoints ​

Entity with logical grouping of lighting points. See Zones chapter.


meta ​

deflightingZonePoints
ispointGroup
liblib:phIoT

supertypes ​

markerMarker labels a dict with typing information
entityTop-level dicts with a unique identifier
pointGroupGrouping of children points used by spaces and equipment

subtypes ​

lighting-zone-spaceZone related to lighting system
luminaireLight fixture using electricity to provide illumination

tags ​

disDisplay name for an entity
idDefines the unique identifier of an entity in system using a ref value type

children ​

light level sensor point
light level sp point
light level sp point
light illuminance sensor point
light illuminance sensor point
light luminous flux sensor point
light luminous flux sensor point


def ​

lineAvg ​

Line average of single-phase electrical quantity measurements in an AC electric power system.

When applied to a point entity that has the elec and volt tags, indicates the average of all available lineVolt measurements.

When applied to a point entity that has the elec and current tags, indicates the average of all available lineCurrent measurements.

When applied to a point entity that has the elec and power tags, indicates the average of all available linePower measurements.

When applied to a point entity that has the elec and pf tags, indicates the average of all available linePf measurements.

When applied to a point entity that has the elec and energy tags, indicates the average of all available lineEnergy measurements.


meta ​

deflineAvg
ismarker
liblib:phIoT

supertypes ​

markerMarker labels a dict with typing information


def ​

lineCurrent ​

Single-phase line current measured in an AC electric power system.


meta ​

deflineCurrent
enumSee below
iselecLine
liblib:phIoT

enum ​

L1line 1 measurement
L2line 2 measurement
L3line 3 measurement

supertypes ​

valData value type
scalarScalar is an atomic value kind
strUnicode string of characters
elecLineSingle-phase line measurement of an electric quantity in a multi-phase AC electric power system


def ​

lineEnergy ​

Single-phase energy measured line-to-line in an AC electric power system.


meta ​

deflineEnergy
enumSee below
iselecLineToLine
liblib:phIoT

enum ​

L1-L2line 1 to line 2 measurement
L2-L3line 2 to line 3 measurement
L3-L1line 3 to line 1 measurement

supertypes ​

valData value type
scalarScalar is an atomic value kind
strUnicode string of characters
elecLineToLineSingle-phase electric quantity measured line-to-line in a multi-phase AC electric power system


def ​

linePf ​

Single-phase power factor measured line-to-line in an AC electric power system.


meta ​

deflinePf
enumSee below
iselecLineToLine
liblib:phIoT

enum ​

L1-L2line 1 to line 2 measurement
L2-L3line 2 to line 3 measurement
L3-L1line 3 to line 1 measurement

supertypes ​

valData value type
scalarScalar is an atomic value kind
strUnicode string of characters
elecLineToLineSingle-phase electric quantity measured line-to-line in a multi-phase AC electric power system


def ​

linePower ​

Single-phase power measured line-to-line in an AC electric power system. May also be referred to as a line power measurement.


meta ​

deflinePower
enumSee below
iselecLineToLine
liblib:phIoT

enum ​

L1-L2line 1 to line 2 measurement
L2-L3line 2 to line 3 measurement
L3-L1line 3 to line 1 measurement

supertypes ​

valData value type
scalarScalar is an atomic value kind
strUnicode string of characters
elecLineToLineSingle-phase electric quantity measured line-to-line in a multi-phase AC electric power system


def ​

lineVolt ​

Single-phase voltage measured line-to-line in an AC electric power system. May also be referred to as a line voltage measurement.


meta ​

deflineVolt
enumSee below
iselecLineToLine
liblib:phIoT

enum ​

L1-L2line 1 to line 2 measurement
L2-L3line 2 to line 3 measurement
L3-L1line 3 to line 1 measurement

supertypes ​

valData value type
scalarScalar is an atomic value kind
strUnicode string of characters
elecLineToLineSingle-phase electric quantity measured line-to-line in a multi-phase AC electric power system


def ​

load ​

Chiller point to command or measure the chiller's load as a percentage from "0%" to "100%". When paired with cmd this models the chiller's load limit. When paired with sensor this models the chiller's current load factor.


meta ​

defload
ismarker
liblib:phIoT

supertypes ​

markerMarker labels a dict with typing information


def ​

luminaire ​

Light fixture using electricity to provide illumination


meta ​

defluminaire
iconlightbulb
isequip, lightingZonePoints, elec-input
liblib:phIoT
wikipediahttps://en.wikipedia.org/wiki/Light_fixture

usage ​

luminaire  equip

supertypes ​

markerMarker labels a dict with typing information
entityTop-level dicts with a unique identifier
equipEquipment asset
pointGroupGrouping of children points used by spaces and equipment
lightingZonePointsEntity with logical grouping of lighting points
inputEntity inputs a substance which flows from another entity
elec-inputEntity inputs electricity which flows from another entity

tags ​

disDisplay name for an entity
disMacroDisplay name using macro syntax
elecRefElectricity flows from the referent to this entity
equipRefReference to equip which contains this entity
ghgSourceRefRef to the emission source used to calculate Greenhouse Gas Emissions
idDefines the unique identifier of an entity in system using a ref value type
navNameNavigation name commonly used with disMacro to create computed display strings
siteRefReference to site which contains the entity
spaceRefReference to space which contains this entity
systemRefReference to system

children ​

light illuminance sensor point
light level sensor point
light level sensor point
light level sp point
light level sp point
light luminous flux sensor point
light luminous flux sensor point


def ​

makeup-water-input ​

Entity inputs makeup water which flows from another entity


conjunct ​

makeupRestore something missed or lost
waterWater in its liquid form
inputEntity inputs a substance which flows from another entity

meta ​

defmakeup-water-input
isinput
liblib:phIoT

usage ​

makeup  water  input

supertypes ​

markerMarker labels a dict with typing information
inputEntity inputs a substance which flows from another entity

tags ​

makeupWaterRefMakeup water flows from the referent to this entity


def ​

makeup-water-output ​

Entity outputs makeup water to other entities


conjunct ​

makeupRestore something missed or lost
waterWater in its liquid form
outputEntity outputs a substance with flows to other entities

meta ​

defmakeup-water-output
isoutput
liblib:phIoT

usage ​

makeup  water  output

supertypes ​

markerMarker labels a dict with typing information
outputEntity outputs a substance with flows to other entities


def ​

makeup-water ​

Water used used to makeup water loss through leaks, evaporation, or blowdown


conjunct ​

makeupRestore something missed or lost
waterWater in its liquid form

meta ​

defmakeup-water
iswater
liblib:phIoT
wikipediahttps://en.wikipedia.org/wiki/Water

usage ​

makeup  water

supertypes ​

markerMarker labels a dict with typing information
phenomenonAspect of scientific interest with measurable quantities
substanceMatter in one the three states solid, liquid, or gas
fluidLiquid or gas
liquidSubstance with definite volume but takes the shape of its container
waterWater in its liquid form

quantities ​

concentrationAbundance of substance in the total volume of a mixture
flowMeasure of volumetric flow of fluid
levelRange from 0% to 100%
pressureMeasure of force applied
tempTemperature - measure of hot and cold
volumeThree dimensional space occupied by a substance


def ​

makeup ​

Restore something missed or lost


meta ​

defmakeup
ismarker
liblib:phIoT

supertypes ​

markerMarker labels a dict with typing information


def ​

makeupWaterRef ​

Makeup water flows from the referent to this entity


meta ​

defmakeupWaterRef
inputsmakeup-water
isref
liblib:phIoT
ofmakeup-water-output
tagOnmakeup-water-input

supertypes ​

valData value type
scalarScalar is an atomic value kind
refReference to an entity


def ​

mau ​

Makeup Air Unit: A DOAS that provides make-up air for a separate, dedicated exhaust system. That is, this equip does not contain an exhaust air section. See AHUs chapter.


meta ​

defmau
iconEquipIcon
isdoas
liblib:phIoT
navTargetequip
wikipediahttps://en.wikipedia.org/wiki/Air_handler

usage ​

mau  ahu  equip

supertypes ​

markerMarker labels a dict with typing information
entityTop-level dicts with a unique identifier
equipEquipment asset
airHandlingEquipHVAC equipment that conditions and delivers air via one or more fans
ahuAir Handling Unit
doasDedicated Outside Air System
inputEntity inputs a substance which flows from another entity
elec-inputEntity inputs electricity which flows from another entity
outputEntity outputs a substance with flows to other entities
air-outputEntity outputs air to other entities

tags ​

ahuZoneDeliveryAHU delivery method of conditioned air to the zone
airVolumeAdjustabilityAbility of air handling equip to adjust volume of air flow
coolingProcessProcessed used to cool a substance
disDisplay name for an entity
disMacroDisplay name using macro syntax
ductConfigDuctwork configuration
ductDeckCold, hot, or neutral deck
elecRefElectricity flows from the referent to this entity
equipRefReference to equip which contains this entity
ghgSourceRefRef to the emission source used to calculate Greenhouse Gas Emissions
heatingProcessProcessed used to heat a substance
idDefines the unique identifier of an entity in system using a ref value type
navNameNavigation name commonly used with disMacro to create computed display strings
siteRefReference to site which contains the entity
spaceRefReference to space which contains this entity
systemRefReference to system

children ​

bypass damper cmd point
cool cmd point
cool cmd point
dessicantDehumidifier cmd point
dessicantDehumidifier cmd point
discharge duct equip
discharge duct equip
economizer duct equip
economizer duct equip
economizing cmd point
economizing cmd point
exhaust duct equip
exhaust duct equip
faceBypass cmd point
faceBypass cmd point
filter sensor point
filter sensor point
freezeStat sensor point
freezeStat sensor point
heat cmd point
heat cmd point
heatWheel cmd point
heatWheel cmd point
humidifier equip
humidifier equip
hvacMode sp point
hvacMode sp point
mixed duct equip
mixed duct equip
outside duct equip
outside duct equip
return duct equip
return duct equip
thermostat equip
thermostat equip
ventilation duct equip
ventilation duct equip


def ​

mech ​

Associated with a machine or its mechanical force, torque, power, or energy. This is often opposed to elec electrical energy.


meta ​

defmech
ismarker
liblib:phIoT

supertypes ​

markerMarker labels a dict with typing information


def ​

meter ​

Equipment to meter a substance or phenomenon. See Meters chapter.


meta ​

defmeter
iconbolt
isequip
liblib:phIoT

usage ​

meter  equip

supertypes ​

markerMarker labels a dict with typing information
entityTop-level dicts with a unique identifier
equipEquipment asset

subtypes ​

elec-meterElectricity meter
ac-elec-meterAC Electricity meter
dc-elec-meterDC Electricity meter
evse-portAn EVSE port delivers electricity to a single EV charging inlet at a time
ac-evse-portAn AC EVSE port delivers ac electricity to a single EV charging inlet at a time
dc-evse-portA DC EVSE port delivers dc electricity to a single EV charging inlet at a time
flow-meterMeter to measure flow rate and total volume of fluid

tags ​

disDisplay name for an entity
disMacroDisplay name using macro syntax
equipRefReference to equip which contains this entity
ghgSourceRefRef to the emission source used to calculate Greenhouse Gas Emissions
idDefines the unique identifier of an entity in system using a ref value type
meterScopeClassifies a meter as a main site meter or submeter
navNameNavigation name commonly used with disMacro to create computed display strings
siteRefReference to site which contains the entity
spaceRefReference to space which contains this entity
submeterOfReference to parent meter which is immediately upstream of this meter
systemRefReference to system
tariffHisRefIf multiple meters share the same tariff history, then you can use this tag to reference the "master" point containing the tariff history

children ​

equip
point
point


def ​

meterScope ​

Classifies a meter as a main site meter or submeter


meta ​

defmeterScope
ischoice
liblib:phIoT
tagOnmeter
uiInputui::ChoiceInput

supertypes ​

markerMarker labels a dict with typing information
choiceChoice specifies an exclusive marker selection

subtypes ​

siteMeterMain meter for the associated site
submeterSubmeters measure usage of a sub-system or equipment within a site


def ​

mixed ​

Duct where fresh outside air and return air is mixed together


meta ​

defmixed
isductSection
liblib:phIoT
uiInputui::ChoiceInput

supertypes ​

markerMarker labels a dict with typing information
choiceChoice specifies an exclusive marker selection
ductSectionEquipment section of ductwork


def ​

mixing ​

Three way valve which inputs two pipes and outputs a mixture between the two to a single output pipe.


meta ​

defmixing
ismarker
liblib:phIoT

supertypes ​

markerMarker labels a dict with typing information


def ​

ml-point ​

See Synthetics chapter.


conjunct ​

mlMachine learning point
pointData point such as a sensor or actuator

meta ​

defml-point
issynthetic-point
liblib:phIoT

usage ​

ml  point

supertypes ​

markerMarker labels a dict with typing information
entityTop-level dicts with a unique identifier
pointData point such as a sensor or actuator
synthetic-pointSee Synthetics chapter

tags ​

curSupports current value
disDisplay name for an entity
disMacroDisplay name using macro syntax
disabledIndicates the entity is in a disabled state
enumDefines an eumeration of string key names
equipRefReference to equip which contains this entity
ghgFactorHisIdentifies point record with interval emission factor data that the Greenhouse Gas Emission Engine uses to calculate emissions
hisSupports historization of data
idDefines the unique identifier of an entity in system using a ref value type
kindKind name used to identity a value data type
maxValInclusive maximum for a numeric value
minValInclusive minimum for a numeric value
navNameNavigation name commonly used with disMacro to create computed display strings
pointFunctionClassifies the point as a sensor, command, or setpoint
pointQuantityQuantity the point senses or controls
pointSubjectWhat the point senses or controls
siteRefReference to site which contains the entity
spaceRefReference to space which contains this entity
syntheticModelRefSee Synthetics chapter
systemRefReference to system
tzTimezone identifier from standard timezone database
unitUnit identifier from standard unit database
writableSupports writing data


def ​

ml ​

Machine learning point. See Synthetics chapter.


meta ​

defml
issynthetic
liblib:phIoT
uiInputui::ChoiceInput

usage ​

ml  synthetic

supertypes ​

markerMarker labels a dict with typing information
choiceChoice specifies an exclusive marker selection
pointFunctionClassifies the point as a sensor, command, or setpoint
syntheticSynthetic point with computed operational data


def ​

mlIdentificationPeriod ​

Training period description, known as the identification period or baseline, utilized during the model training process.


meta ​

defmlIdentificationPeriod
isspan
liblib:phIoT
tagOnmlModel

supertypes ​

valData value type
scalarScalar is an atomic value kind
xstrExtended string - type name and string value encoding
spanTime span as modeled encoded as XStr


def ​

mlInputVarRefs ​

List of independent variables, also known as model inputs or features, associated with a machine learning model.


meta ​

defmlInputVarRefs
islist
liblib:phIoT
ofmlVarRef
tagOnmlModel

supertypes ​

valData value type
listOrdered list of zero or more values


def ​

mlModel ​

See Synthetics chapter.


meta ​

defmlModel
issyntheticModel
liblib:phIoT

usage ​

mlModel  syntheticModel

supertypes ​

markerMarker labels a dict with typing information
entityTop-level dicts with a unique identifier
syntheticModelSee Synthetics chapter

tags ​

disDisplay name for an entity
idDefines the unique identifier of an entity in system using a ref value type
mlIdentificationPeriodTraining period description, known as the identification period or baseline, utilized during the model training process
mlInputVarRefsList of independent variables, also known as model inputs or features, associated with a machine learning model
mlModelMetricsGoodness-of-fit metrics provided in the form of a simple dictionary
mlModelParametersResult of model identification, which may appear as a list of model parameters for simpler models or as a reference to a stored model, in the form of a file uri
mlOutputVarRefDependent variable, also known as the model output or target, associated, with a machine learning model


def ​

mlModelMetrics ​

Goodness-of-fit metrics provided in the form of a simple dictionary. For example: {r2:0.7889, cvrmse:58}.


meta ​

defmlModelMetrics
isdict
liblib:phIoT
tagOnmlModel

supertypes ​

valData value type
dictMap of name/value tag pairs


def ​

mlModelParameters ​

Result of model identification, which may appear as a list of model parameters for simpler models or as a reference to a stored model, in the form of a file uri. The structure of the dict is user-specific.


meta ​

defmlModelParameters
isdict
liblib:phIoT
tagOnmlModel

supertypes ​

valData value type
dictMap of name/value tag pairs


def ​

mlOutputVarRef ​

Dependent variable, also known as the model output or target, associated, with a machine learning model. Represents the predicted outcome generated by the model.


meta ​

defmlOutputVarRef
isref
liblib:phIoT
ofmlVar
tagOnmlModel

supertypes ​

valData value type
scalarScalar is an atomic value kind
refReference to an entity


def ​

mlVar ​

Machine learning variable representing both model inputs and outputs.


meta ​

defmlVar
isentity
liblib:phIoT
mandatory✓

supertypes ​

markerMarker labels a dict with typing information
entityTop-level dicts with a unique identifier

tags ​

disDisplay name for an entity
idDefines the unique identifier of an entity in system using a ref value type
mlVarFilterFilter used for querying points by tags, providing more flexibility than mlVarPoint, although it is not mandatory
mlVarPointReference to a point associated with a machine learning variable, known as a machine learning variable point


def ​

mlVarFilter ​

Filter used for querying points by tags, providing more flexibility than mlVarPoint, although it is not mandatory.


meta ​

defmlVarFilter
isfilterStr
liblib:phIoT
tagOnmlVar

supertypes ​

valData value type
scalarScalar is an atomic value kind
strUnicode string of characters
filterStrHaystack filter string


def ​

mlVarPoint ​

Reference to a point associated with a machine learning variable, known as a machine learning variable point.


meta ​

defmlVarPoint
isref
liblib:phIoT
ofpoint
tagOnmlVar

supertypes ​

valData value type
scalarScalar is an atomic value kind
refReference to an entity


def ​

mlVarRef ​

Reference to a machine learning variable.


meta ​

defmlVarRef
isref
liblib:phIoT
ofmlVar

supertypes ​

valData value type
scalarScalar is an atomic value kind
refReference to an entity


def ​

motor ​

Equipment that converts electrical energy into mechanical energy. See Motors chapter.


meta ​

defmotor
iconEquipIcon
isequip, elec-input
liblib:phIoT
wikipediahttps://en.wikipedia.org/wiki/Electric_motor

usage ​

motor  equip

supertypes ​

markerMarker labels a dict with typing information
entityTop-level dicts with a unique identifier
equipEquipment asset
inputEntity inputs a substance which flows from another entity
elec-inputEntity inputs electricity which flows from another entity

subtypes ​

fan-motorMotor used with a fan to create air flow
pump-motorMotor used with a pump to move fluid

tags ​

disDisplay name for an entity
disMacroDisplay name using macro syntax
elecRefElectricity flows from the referent to this entity
equipRefReference to equip which contains this entity
ghgSourceRefRef to the emission source used to calculate Greenhouse Gas Emissions
idDefines the unique identifier of an entity in system using a ref value type
navNameNavigation name commonly used with disMacro to create computed display strings
phaseCountNumber of phases for an AC electrical power system or connected equipment
siteRefReference to site which contains the entity
spaceRefReference to space which contains this entity
systemRefReference to system
vfdVariable-frequency drive

children ​

alarm sensor point
enable cmd point
enable cmd point
enable sensor point
enable sensor point
run cmd point
run cmd point
run sensor point
run sensor point
vfd freq cmd point
vfd freq cmd point
vfd freq sensor point
vfd freq sensor point
vfd speed cmd point
vfd speed cmd point
vfd speed sensor point
vfd speed sensor point


def ​

movingWalkway ​

Conveyor to move people across a horizontal or inclined plane.


meta ​

defmovingWalkway
iconEquipIcon
isverticalTransport, elec-input
liblib:phIoT
wikipediahttps://en.wikipedia.org/wiki/Moving_walkway

usage ​

movingWalkway  equip

supertypes ​

markerMarker labels a dict with typing information
entityTop-level dicts with a unique identifier
equipEquipment asset
verticalTransportEquipment to move humans and materials
inputEntity inputs a substance which flows from another entity
elec-inputEntity inputs electricity which flows from another entity

tags ​

disDisplay name for an entity
disMacroDisplay name using macro syntax
elecRefElectricity flows from the referent to this entity
equipRefReference to equip which contains this entity
ghgSourceRefRef to the emission source used to calculate Greenhouse Gas Emissions
idDefines the unique identifier of an entity in system using a ref value type
navNameNavigation name commonly used with disMacro to create computed display strings
siteRefReference to site which contains the entity
spaceRefReference to space which contains this entity
systemRefReference to system

children ​

equip
point
point


def ​

multiZone ​

AHU discharge air is split into a duct per zone


meta ​

defmultiZone
isahuZoneDelivery
liblib:phIoT
uiInputui::ChoiceInput

supertypes ​

markerMarker labels a dict with typing information
choiceChoice specifies an exclusive marker selection
ahuZoneDeliveryAHU delivery method of conditioned air to the zone


def ​

naturalGas-input ​

Entity inputs natural gas which flows from another entity


conjunct ​

naturalGasFossil fuel energy source consisting largely of methane and other hydrocarbons
inputEntity inputs a substance which flows from another entity

meta ​

defnaturalGas-input
isinput
liblib:phIoT

usage ​

naturalGas  input

supertypes ​

markerMarker labels a dict with typing information
inputEntity inputs a substance which flows from another entity

subtypes ​

naturalGasHeatingHeating by the combustion of natural gas

tags ​

naturalGasRefNatural gas flows from the referent to this entity


def ​

naturalGas-output ​

Entity outputs natural gas to other entities


conjunct ​

naturalGasFossil fuel energy source consisting largely of methane and other hydrocarbons
outputEntity outputs a substance with flows to other entities

meta ​

defnaturalGas-output
isoutput
liblib:phIoT

usage ​

naturalGas  output

supertypes ​

markerMarker labels a dict with typing information
outputEntity outputs a substance with flows to other entities


def ​

naturalGas ​

Fossil fuel energy source consisting largely of methane and other hydrocarbons.

The energy content of natural gas varies by region within a range determined on impurities in the gas. You can find a table of these conversions here


meta ​

defnaturalGas
disKeyghgExt::fuelSource.naturalGas
ghgFuelSource✓
isgas
liblib:phIoT
wikipediahttps://en.wikipedia.org/wiki/Natural_gas

supertypes ​

markerMarker labels a dict with typing information
phenomenonAspect of scientific interest with measurable quantities
substanceMatter in one the three states solid, liquid, or gas
fluidLiquid or gas
gasSubstance with neither definite volume nor shape

quantities ​

concentrationAbundance of substance in the total volume of a mixture
flowMeasure of volumetric flow of fluid
levelRange from 0% to 100%
pressureMeasure of force applied
tempTemperature - measure of hot and cold
volumeThree dimensional space occupied by a substance


def ​

naturalGasHeating ​

Heating by the combustion of natural gas


meta ​

defnaturalGasHeating
isheatingProcess, naturalGas-input
liblib:phIoT
uiInputui::ChoiceInput

supertypes ​

markerMarker labels a dict with typing information
choiceChoice specifies an exclusive marker selection
heatingProcessProcessed used to heat a substance
inputEntity inputs a substance which flows from another entity
naturalGas-inputEntity inputs natural gas which flows from another entity

tags ​

naturalGasRefNatural gas flows from the referent to this entity


def ​

naturalGasRef ​

Natural gas flows from the referent to this entity


meta ​

defnaturalGasRef
inputsnaturalGas
isref
liblib:phIoT
ofnaturalGas-output
tagOnnaturalGas-input

supertypes ​

valData value type
scalarScalar is an atomic value kind
refReference to an entity


def ​

net ​

Difference between import and export


meta ​

defnet
ismarker
liblib:phIoT

supertypes ​

markerMarker labels a dict with typing information


def ​

neutral ​

when applied to a point entity that has the elec and current tags, indicates electrical current being measured on an electrical neutral conductor.


meta ​

defneutral
ismarker
liblib:phIoT

supertypes ​

markerMarker labels a dict with typing information


def ​

neutralDeck ​

Duct carries air which by-passes both heating and cooling coils


meta ​

defneutralDeck
isductDeck
liblib:phIoT
uiInputui::ChoiceInput

supertypes ​

markerMarker labels a dict with typing information
choiceChoice specifies an exclusive marker selection
ductDeckCold, hot, or neutral deck


def ​

occ ​

Occupied mode of a space. See Zones chapter.


meta ​

defocc
ismarker
liblib:phIoT

supertypes ​

markerMarker labels a dict with typing information


def ​

occupancy ​

Number of occupants in a space. See Zones chapter.


meta ​

defoccupancy
ismarker
liblib:phIoT

supertypes ​

markerMarker labels a dict with typing information


def ​

occupants ​

People who use the built environment. See Zones chapter.


meta ​

defoccupants
ismarker
liblib:phIoT

supertypes ​

markerMarker labels a dict with typing information


def ​

occupied ​

Setpoint or sensor indicating occupancy of a space. See Zones chapter.


meta ​

defoccupied
ismarker
liblib:phIoT

supertypes ​

markerMarker labels a dict with typing information


def ​

op:hisRead ​

Read historized time series data from a his-point. See Ops chapter.


meta ​

defop:hisRead
isop
liblib:phIoT
noSideEffects✓

supertypes ​

featureFeature namespace of definitions formatted as feature:name
opOperation for HTTP API


def ​

op:hisWrite ​

Write historized time series data from a his-point. See Ops chapter.


meta ​

defop:hisWrite
isop
liblib:phIoT

supertypes ​

featureFeature namespace of definitions formatted as feature:name
opOperation for HTTP API


def ​

op:invokeAction ​

Invoke a user action on a target entity. See Ops chapter.


meta ​

defop:invokeAction
isop
liblib:phIoT

supertypes ​

featureFeature namespace of definitions formatted as feature:name
opOperation for HTTP API


def ​

op:pointWrite ​

Read or command a writable-point. See Ops chapter.


meta ​

defop:pointWrite
isop
liblib:phIoT

supertypes ​

featureFeature namespace of definitions formatted as feature:name
opOperation for HTTP API


def ​

outdoorUnit ​

operates outside the conditioned space


meta ​

defoutdoorUnit
ismarker
liblib:phIoT

supertypes ​

markerMarker labels a dict with typing information


def ​

outside ​

Duct to access fresh outside air for both ventilation and economizer.


meta ​

defoutside
isductSection
liblib:phIoT
uiInputui::ChoiceInput

supertypes ​

markerMarker labels a dict with typing information
choiceChoice specifies an exclusive marker selection
ductSectionEquipment section of ductwork


def ​

panel ​

Enclosure for electrical and control equipment. Panels may be used to isolate electrical connections and provide environmental protection.


meta ​

defpanel
iconEquipIcon
isequip
liblib:phIoT

usage ​

panel  equip

supertypes ​

markerMarker labels a dict with typing information
entityTop-level dicts with a unique identifier
equipEquipment asset

subtypes ​

controls-panelPanel housing controllers and networking gear
elec-panelPhysical housing for electrical circuits, fuses, and breakers

tags ​

disDisplay name for an entity
disMacroDisplay name using macro syntax
equipRefReference to equip which contains this entity
ghgSourceRefRef to the emission source used to calculate Greenhouse Gas Emissions
idDefines the unique identifier of an entity in system using a ref value type
navNameNavigation name commonly used with disMacro to create computed display strings
siteRefReference to site which contains the entity
spaceRefReference to space which contains this entity
systemRefReference to system

children ​

equip
point
point


def ​

parallel ​

Circuit with multiple paths of flow


meta ​

defparallel
ismarker
liblib:phIoT

supertypes ​

markerMarker labels a dict with typing information


def ​

perimeterHeat ​

Auxiliary heating points associated with a vav


meta ​

defperimeterHeat
ismarker
liblib:phIoT

supertypes ​

markerMarker labels a dict with typing information


def ​

pf ​

Electric power factor; which is the ratio of active power to apparent power in an AC electric power system. Measured with values in the range of -1.0 to 1.0 or 0.0 to 1.0 without a unit. When the range of -1.0 to 1.0 is applied, a negative value for power factor indicates the electrical current leads the electrical voltage and a positive value indicates the electrical current lags the electrical voltage.


meta ​

defpf
isquantity
liblib:phIoT
prefUnitpf
quantityOfac-elec
wikipediahttps://en.wikipedia.org/wiki/Power_factor

supertypes ​

markerMarker labels a dict with typing information
quantityMeasurable property of a substance or phenomenon


def ​

pfDisplacement ​

Displacement power factor, which accounts for the phase angle between voltage and current but excludes effects of nonlinear waveforms ( harmonic distortion).


meta ​

defpfDisplacement
ispfScope
liblib:phIoT
uiInputui::ChoiceInput

supertypes ​

markerMarker labels a dict with typing information
choiceChoice specifies an exclusive marker selection
pfScopePower factor scope


def ​

pfDistortion ​

Distortion power factor, which measures the component of power factor attributable to harmonic distortion in voltage and current waveforms.


meta ​

defpfDistortion
ispfScope
liblib:phIoT
uiInputui::ChoiceInput
wikipediahttps://en.wikipedia.org/wiki/Power_factor#Distortion_power_factor

supertypes ​

markerMarker labels a dict with typing information
choiceChoice specifies an exclusive marker selection
pfScopePower factor scope


def ​

pfIec ​

Power factor according to the IEC convention defines a positive or negative sign based on the direction of active power flow. Power factor is positive when active power flows into a load. Power factor is negative when active power flows out of a load.


meta ​

defpfIec
ispfStandard
liblib:phIoT
uiInputui::ChoiceInput

supertypes ​

markerMarker labels a dict with typing information
choiceChoice specifies an exclusive marker selection
pfStandardStandard for interpreting power factor's positive or negative sign


def ​

pfIeee ​

Power factor according to the IEEE convention defines a positive or negative sign based on whether the load is capacitive or inductive. Power factor is positive when the load is capacitive, or when voltage lags behind current. Power factor is negative when the load is inductive, or when current lags behind voltage.


meta ​

defpfIeee
ispfStandard
liblib:phIoT
uiInputui::ChoiceInput

supertypes ​

markerMarker labels a dict with typing information
choiceChoice specifies an exclusive marker selection
pfStandardStandard for interpreting power factor's positive or negative sign


def ​

pfScope ​

Power factor scope


meta ​

defpfScope
ischoice
liblib:phIoT
uiInputui::ChoiceInput

supertypes ​

markerMarker labels a dict with typing information
choiceChoice specifies an exclusive marker selection

subtypes ​

pfDisplacementDisplacement power factor, which accounts for the phase angle between voltage and current but excludes effects of nonlinear waveforms ( harmonic distortion)
pfDistortionDistortion power factor, which measures the component of power factor attributable to harmonic distortion in voltage and current waveforms
pfTrueTrue power factor, which includes effects of harmonic distortion


def ​

pfStandard ​

Standard for interpreting power factor's positive or negative sign


meta ​

defpfStandard
ischoice
liblib:phIoT
uiInputui::ChoiceInput

supertypes ​

markerMarker labels a dict with typing information
choiceChoice specifies an exclusive marker selection

subtypes ​

pfIecPower factor according to the IEC convention defines a positive or negative sign based on the direction of active power flow
pfIeeePower factor according to the IEEE convention defines a positive or negative sign based on whether the load is capacitive or inductive


def ​

pfTrue ​

True power factor, which includes effects of harmonic distortion. Power factor is assumed to be true power factor when pfScope is not defined. However, it is recommended to specify a scope for power factor to help avoid misinterpretation of data.


meta ​

defpfTrue
ispfScope
liblib:phIoT
uiInputui::ChoiceInput

supertypes ​

markerMarker labels a dict with typing information
choiceChoice specifies an exclusive marker selection
pfScopePower factor scope


def ​

phase ​

Phase measurement in a three-phase electrical system. This tag is deprecated in favor of more precise tags:

  • lineVolt
  • phaseVolt
  • lineCurrent
  • phaseCurrent
  • linePower
  • phasePower
  • linePf
  • phasePf
  • lineEnergy
  • phaseEnergy
  • lineAvg
  • phaseAvg
  • neutral
  • ground

meta ​

defphase
enumSee below
isstr
liblib:phIoT
wikipediahttps://en.wikipedia.org/wiki/Three-phase_electric_power

enum ​

Aline-to-neutral measurement
Bline-to-neutral measurement
Cline-to-neutral measurement
ABline-to-line measurement
BCline-to-line measurement
CAline-to-line measurement
Nneutral current

supertypes ​

valData value type
scalarScalar is an atomic value kind
strUnicode string of characters


def ​

phaseAvg ​

Phase average of single-phase electrical quantity measurements in an AC electric power system.

When applied to a point entity that has the elec and volt tags, indicates the average of all available phaseVolt measurements.

When applied to a point entity that has the elec and current tags, indicates the average of all available phaseCurrent measurements.

When applied to a point entity that has the elec and power tags, indicates the average of all available phasePower measurements.

When applied to a point entity that has the elec and pf tags, indicates the average of all available phasePf measurements.

When applied to a point entity that has the elec and energy tags, indicates the average of all available phaseEnergy measurements.


meta ​

defphaseAvg
ismarker
liblib:phIoT

supertypes ​

markerMarker labels a dict with typing information


def ​

phaseCount ​

Number of phases for an AC electrical power system or connected equipment: single-phase, split-phase, two-phase, or three-phase.


meta ​

defphaseCount
ischoice
liblib:phIoT
tagOnac-elec-meter, motor
uiInputui::ChoiceInput

supertypes ​

markerMarker labels a dict with typing information
choiceChoice specifies an exclusive marker selection

subtypes ​

singlePhaseSingle-phase AC electricity
splitPhaseSplit-phase AC electricity
threePhaseThree-phase AC electricity
twoPhaseTwo-phase AC electricity


def ​

phaseCurrent ​

Single-phase current measured line-to-line in an AC electric power system. May also be referred to as a phase current measurement.


meta ​

defphaseCurrent
enumSee below
iselecLineToLine
liblib:phIoT

enum ​

L1-L2line 1 to line 2 measurement
L2-L3line 2 to line 3 measurement
L3-L1line 3 to line 1 measurement

supertypes ​

valData value type
scalarScalar is an atomic value kind
strUnicode string of characters
elecLineToLineSingle-phase electric quantity measured line-to-line in a multi-phase AC electric power system


def ​

phaseEnergy ​

Single-phase energy measured line-to-neutral in an AC electric power system. Neutral might not be referenced, but implied.


meta ​

defphaseEnergy
enumSee below
iselecLine
liblib:phIoT

enum ​

L1line 1 measurement
L2line 2 measurement
L3line 3 measurement

supertypes ​

valData value type
scalarScalar is an atomic value kind
strUnicode string of characters
elecLineSingle-phase line measurement of an electric quantity in a multi-phase AC electric power system


def ​

phasePf ​

Single-phase power factor measured line-to-neutral in an AC electric power system. Neutral might not be referenced, but implied.


meta ​

defphasePf
enumSee below
iselecLine
liblib:phIoT

enum ​

L1line 1 measurement
L2line 2 measurement
L3line 3 measurement

supertypes ​

valData value type
scalarScalar is an atomic value kind
strUnicode string of characters
elecLineSingle-phase line measurement of an electric quantity in a multi-phase AC electric power system


def ​

phasePower ​

Single-phase power measured line-to-neutral in an AC electric power system. May also be referred to as a phase power measurement. Neutral might not be referenced, but implied.


meta ​

defphasePower
enumSee below
iselecLine
liblib:phIoT

enum ​

L1line 1 measurement
L2line 2 measurement
L3line 3 measurement

supertypes ​

valData value type
scalarScalar is an atomic value kind
strUnicode string of characters
elecLineSingle-phase line measurement of an electric quantity in a multi-phase AC electric power system


def ​

phaseVolt ​

Single-phase voltage measured line-to-neutral in an AC electric power system. May also be referred to as a phase voltage measurement.


meta ​

defphaseVolt
enumSee below
iselecLineToNeutral
liblib:phIoT

enum ​

L1-Nline 1 to neutral measurement
L2-Nline 2 to neutral measurement
L3-Nline 3 to neutral measurement

supertypes ​

valData value type
scalarScalar is an atomic value kind
strUnicode string of characters
elecLineToNeutralSingle-phase electric quantity measured line-to-neutral in a multi-phase AC electric power system


def ​

pipe ​

Conduit used to convey a fluid


meta ​

childrenFlattenfluid, pipeSection, plantLoop
defpipe
iconEquipIcon
isconduit
liblib:phIoT
wikipediahttps://en.wikipedia.org/wiki/Pipe_(fluid_conveyance)

usage ​

pipe  equip

supertypes ​

markerMarker labels a dict with typing information
entityTop-level dicts with a unique identifier
equipEquipment asset
conduitDuct, pipe, or cable to convey a substance or phenomenon

tags ​

disDisplay name for an entity
disMacroDisplay name using macro syntax
equipRefReference to equip which contains this entity
ghgSourceRefRef to the emission source used to calculate Greenhouse Gas Emissions
idDefines the unique identifier of an entity in system using a ref value type
navNameNavigation name commonly used with disMacro to create computed display strings
pipeFluidType of fluid conveyed by piping
pipeSectionEquipment section of piping
plantLoopPlant piping loop
siteRefReference to site which contains the entity
spaceRefReference to space which contains this entity
systemRefReference to system

children ​

flow sensor point
flow sp point
flow sp point
pressure sensor point
pressure sensor point
pressure sp point
pressure sp point
pump motor equip
pump motor equip
temp sensor point
temp sensor point
temp sp point
temp sp point
valve actuator equip
valve actuator equip


def ​

pipeFluid ​

Type of fluid conveyed by piping


meta ​

defpipeFluid
ischoice
liblib:phIoT
offluid
tagOnpipe, valve-actuator, pump-motor
uiInputui::ChoiceInput

supertypes ​

markerMarker labels a dict with typing information
choiceChoice specifies an exclusive marker selection


def ​

pipeSection ​

Equipment section of piping


meta ​

defpipeSection
ischoice
liblib:phIoT
tagOnpipe, valve-actuator, pump-motor
uiInputui::ChoiceInput

supertypes ​

markerMarker labels a dict with typing information
choiceChoice specifies an exclusive marker selection

subtypes ​

bypassPipe used to bypass an equipment
circPipe used to circulate fluid through an equipment or system
enteringPipe conveys fluid into an equipment
headerPipe used as central connection or manifold for other piping runs
leavingPipe conveys fluid out of an equipment


def ​

plant ​

Central plant used to generate a substance for a process. See Plants.


meta ​

defplant
iconEquipIcon
isequip
liblib:phIoT

usage ​

plant  equip

supertypes ​

markerMarker labels a dict with typing information
entityTop-level dicts with a unique identifier
equipEquipment asset

subtypes ​

chilled-water-plantPlant used to generate chilled water for cooling
hot-water-plantPlant used to generate hot water for heating
steam-plantPlant used to generate steam for heating
vrf-refrig-plantGroup of outdoor units in a VRF system

tags ​

disDisplay name for an entity
disMacroDisplay name using macro syntax
equipRefReference to equip which contains this entity
ghgSourceRefRef to the emission source used to calculate Greenhouse Gas Emissions
idDefines the unique identifier of an entity in system using a ref value type
navNameNavigation name commonly used with disMacro to create computed display strings
siteRefReference to site which contains the entity
spaceRefReference to space which contains this entity
systemRefReference to system

children ​

enable cmd point


def ​

plantLoop ​

Plant piping loop: primary, secondary, or tertiary


meta ​

defplantLoop
ischoice
liblib:phIoT
tagOnpipe
uiInputui::ChoiceInput

supertypes ​

markerMarker labels a dict with typing information
choiceChoice specifies an exclusive marker selection

subtypes ​

primaryLoopPipework which circulates closest to the energy source
secondaryLoopPipework which circulates closest to the building or end use
tertiaryLoopPipework which circulates within the building


def ​

point ​

Data point such as a sensor or actuator. See Points chapter.


meta ​

defpoint
iconPointIcon
isentity
liblib:phIoT
mandatory✓

supertypes ​

markerMarker labels a dict with typing information
entityTop-level dicts with a unique identifier

subtypes ​

calendarMarker tag for a calendar entity
connPointPoint associated with a connector for data synchronization with a remote system
arcbeamPointPoint which synchronizes data via a arcbeam connector
ecobeePointPoint which synchronizes data via an Ecobee connector
haystackPointPoint which synchronizes data via a Haystack connector
modbusPointPoint which synchronizes data via a Haystack connector
mqttPointPoint which synchronizes data via a MQTT connector
nestPointPoint which synchronizes data via a Nest connector
obixPointPoint which synchronizes data via a oBIX connector
opcPointPoint which synchronizes data via an OPC connector
sedonaPointPoint which synchronizes data via a Sedona connector
snmpPointPoint which synchronizes data via an SNMP connector
sqlPointPoint which synchronizes data via a SQL connector
tplTrendPointPoint which synchronizes data via the TplTrend connector
cur-pointPoint with support to report a "real-time" current value
his-pointHistorized point with a history log of timestamp/value pairs
tariffHisIdentifies the tariff history point for a meter
scheduleMarker tag for a schedule entity
synthetic-pointSee Synthetics chapter
computed-pointSee Synthetics chapter
ml-pointSee Synthetics chapter
sim-pointSee Synthetics chapter
weather-pointWeather station observation point
writable-pointPoint with writable output using 16-level priority array

tags ​

curSupports current value
disDisplay name for an entity
disMacroDisplay name using macro syntax
disabledIndicates the entity is in a disabled state
enumDefines an eumeration of string key names
equipRefReference to equip which contains this entity
ghgFactorHisIdentifies point record with interval emission factor data that the Greenhouse Gas Emission Engine uses to calculate emissions
hisSupports historization of data
idDefines the unique identifier of an entity in system using a ref value type
kindKind name used to identity a value data type
maxValInclusive maximum for a numeric value
minValInclusive minimum for a numeric value
navNameNavigation name commonly used with disMacro to create computed display strings
pointFunctionClassifies the point as a sensor, command, or setpoint
pointQuantityQuantity the point senses or controls
pointSubjectWhat the point senses or controls
siteRefReference to site which contains the entity
spaceRefReference to space which contains this entity
systemRefReference to system
tzTimezone identifier from standard timezone database
unitUnit identifier from standard unit database
writableSupports writing data


def ​

pointFunction ​

Classifies the point as a sensor, command, or setpoint. See Points chapter.


meta ​

defpointFunction
ischoice
liblib:phIoT
tagOnpoint
uiInputui::ChoiceInput

supertypes ​

markerMarker labels a dict with typing information
choiceChoice specifies an exclusive marker selection

subtypes ​

cmdPoint is a command, actuator, AO/BO
sensorPoint is a sensor, input, AI/BI
spPoint is a setpoint, soft point, internal control variable, schedule
syntheticSynthetic point with computed operational data
computedComputed point
mlMachine learning point
simSimulation point


def ​

pointGroup ​

Grouping of children points used by spaces and equipment


meta ​

defpointGroup
isentity
liblib:phIoT

supertypes ​

markerMarker labels a dict with typing information
entityTop-level dicts with a unique identifier

subtypes ​

airQualityZonePointsEntity with logical grouping of zone air quality points
hvac-zone-spaceZone related to conditioning of a space's air temperature and quality
hvacZonePointsEntity with logical grouping of zone HVAC air points
hvac-zone-spaceZone related to conditioning of a space's air temperature and quality
thermostatSenses and controls temperature of space in HVAC system
lightingZonePointsEntity with logical grouping of lighting points
lighting-zone-spaceZone related to lighting system
luminaireLight fixture using electricity to provide illumination

tags ​

disDisplay name for an entity
idDefines the unique identifier of an entity in system using a ref value type


def ​

pointQuantity ​

Quantity the point senses or controls


meta ​

defpointQuantity
ischoice
liblib:phIoT
ofquantity
tagOnpoint
uiInputui::ChoiceInput

supertypes ​

markerMarker labels a dict with typing information
choiceChoice specifies an exclusive marker selection


def ​

pointRef ​

See Synthetics chapter.


meta ​

defpointRef
isref
liblib:phIoT
ofpoint
tagOnsim-point

supertypes ​

valData value type
scalarScalar is an atomic value kind
refReference to an entity


def ​

pointSubject ​

What the point senses or controls


meta ​

defpointSubject
ischoice
liblib:phIoT
ofphenomenon
tagOnpoint
uiInputui::ChoiceInput

supertypes ​

markerMarker labels a dict with typing information
choiceChoice specifies an exclusive marker selection


def ​

port ​

A gateway or opening used to transfer a substance.


meta ​

defport
ismarker
liblib:phIoT

supertypes ​

markerMarker labels a dict with typing information


def ​

powerConverter ​

Converts one electrical waveform to another using power electronic circuitry. Involves the use of one or more power modules.

May convert:

  • ac to dc
  • ac to ac
  • dc to dc
  • dc to ac

Note: An AC/AC power converter performs the same task as a power transformer but using power electronics. Similarly, a DC/DC power converter transforms an input DC voltage to an output DC voltage at another level.


meta ​

defpowerConverter
ismarker
liblib:phIoT

supertypes ​

markerMarker labels a dict with typing information


def ​

pressureDependent ​

VAV damper modulates to control space temp; dependent on duct pressure being maintained


meta ​

defpressureDependent
isvavModulation
liblib:phIoT
uiInputui::ChoiceInput

supertypes ​

markerMarker labels a dict with typing information
choiceChoice specifies an exclusive marker selection
vavModulationHow does VAV modulate the temp based on duct pressure


def ​

pressureIndependent ​

VAV damper or a control valve that modulates to maintain desired flow setpoint; independent of the duct pressure


meta ​

defpressureIndependent
isvavModulation
liblib:phIoT
uiInputui::ChoiceInput

supertypes ​

markerMarker labels a dict with typing information
choiceChoice specifies an exclusive marker selection
vavModulationHow does VAV modulate the temp based on duct pressure


def ​

primaryFunction ​

Primary function of building as US Energy Star key


meta ​

defprimaryFunction
enumSee below
isstr
liblib:phIoT
tagOnsite

enum ​

Adult Education
Ambulatory Surgical Center
Aquarium
Automobile Dealership
Bank Branch
Bar/Nightclub
Barracks
Bowling Alley
Casino
College/University
Convenience Store with Gas Station
Convenience Store without Gas Station
Convention Center
Courthouse
Data Center
Distribution Center
Drinking Water Treatment & Distribution
Enclosed Mall
Energy/Power Station
Fast Food Restaurant
Financial Office
Fire Station
Fitness Center/Health Club/Gym
Food Sales
Food Service
Hospital (General Medical & Surgical)
Hotel
Ice/Curling Rink
Indoor Arena
K-12 School
Laboratory
Library
Lifestyle Center
Mailing Center/Post Office
Manufacturing/Industrial Plant
Medical Office
Mixed Use Property
Movie Theater
Multifamily Housing
Museum
Non-Refrigerated Warehouse
Office
Other - Education
Other - Entertainment/Public Assembly
Other - Lodging/Residential
Other - Mall
Other - Public Services
Other - Recreation
Other - Restaurant/Bar
Other - Services
Other - Stadium
Other - Technology/Science
Other - Utility
Other
Other/Specialty Hospital
Outpatient Rehabilitation/Physical Therapy
Parking
Performing Arts
Personal Services (Health/Beauty, Dry Cleaning, etc)
Police Station
Pre-school/Daycare
Prison/Incarceration
Race Track
Refrigerated Warehouse
Repair Services (Vehicle, Shoe, Locksmith, etc)
Residence Hall/Dormitory
Restaurant
Retail Store
Roller Rink
Self-Storage Facility
Senior Care Community
Single Family Home
Social/Meeting Hall
Stadium (Closed)
Stadium (Open)
Strip Mall
Supermarket/Grocery Store
Swimming Pool
Transportation Terminal/Station
Urgent Care/Clinic/Other Outpatient
Veterinary Office
Vocational School
Wastewater Treatment Plant
Wholesale Club/Supercenter
Worship Facility
Zoo

supertypes ​

valData value type
scalarScalar is an atomic value kind
strUnicode string of characters


def ​

primaryLoop ​

Pipework which circulates closest to the energy source. In a central plant, the primary loop indicates the pipes and equipment within the central plant. In context of heat exchangers between the primary and secondary loops, this tag indicates the side closest to the plant.


meta ​

defprimaryLoop
isplantLoop
liblib:phIoT
uiInputui::ChoiceInput

supertypes ​

markerMarker labels a dict with typing information
choiceChoice specifies an exclusive marker selection
plantLoopPlant piping loop


def ​

process ​

Industrial or HVAC process


meta ​

defprocess
ismarker
liblib:phIoT

supertypes ​

markerMarker labels a dict with typing information


def ​

propane ​

By-product of natural gas processing and petroleum refining (C₃H₈)


meta ​

defpropane
disKeyghgExt::fuelSource.propane
ghgFuelSource✓
isgas
liblib:phIoT
wikipediahttps://en.wikipedia.org/wiki/Propane

supertypes ​

markerMarker labels a dict with typing information
phenomenonAspect of scientific interest with measurable quantities
substanceMatter in one the three states solid, liquid, or gas
fluidLiquid or gas
gasSubstance with neither definite volume nor shape

quantities ​

concentrationAbundance of substance in the total volume of a mixture
flowMeasure of volumetric flow of fluid
levelRange from 0% to 100%
pressureMeasure of force applied
tempTemperature - measure of hot and cold
volumeThree dimensional space occupied by a substance


def ​

propaneHeating ​

Heating by the combustion of propane


meta ​

defpropaneHeating
isheatingProcess
liblib:phIoT
uiInputui::ChoiceInput

supertypes ​

markerMarker labels a dict with typing information
choiceChoice specifies an exclusive marker selection
heatingProcessProcessed used to heat a substance


def ​

pump-motor ​

Motor used with a pump to move fluid. See Motors chapter.


conjunct ​

pumpPump equipment or control point
motorEquipment that converts electrical energy into mechanical energy

meta ​

childrenFlattenfluid, pipeSection, pump
defpump-motor
iconEquipIcon
ismotor
liblib:phIoT
wikipediahttps://en.wikipedia.org/wiki/Pump

usage ​

pump  motor  equip

supertypes ​

markerMarker labels a dict with typing information
entityTop-level dicts with a unique identifier
equipEquipment asset
motorEquipment that converts electrical energy into mechanical energy
inputEntity inputs a substance which flows from another entity
elec-inputEntity inputs electricity which flows from another entity

tags ​

disDisplay name for an entity
disMacroDisplay name using macro syntax
elecRefElectricity flows from the referent to this entity
equipRefReference to equip which contains this entity
ghgSourceRefRef to the emission source used to calculate Greenhouse Gas Emissions
idDefines the unique identifier of an entity in system using a ref value type
navNameNavigation name commonly used with disMacro to create computed display strings
phaseCountNumber of phases for an AC electrical power system or connected equipment
pipeFluidType of fluid conveyed by piping
pipeSectionEquipment section of piping
siteRefReference to site which contains the entity
spaceRefReference to space which contains this entity
systemRefReference to system
vfdVariable-frequency drive

children ​

pump alarm sensor point
pump enable cmd point
pump enable cmd point
pump enable sensor point
pump enable sensor point
pump equip
pump equip
pump point
pump point
pump run cmd point
pump run cmd point
pump run sensor point
pump run sensor point
pump vfd freq cmd point
pump vfd freq cmd point
pump vfd freq sensor point
pump vfd freq sensor point
pump vfd speed cmd point
pump vfd speed cmd point
pump vfd speed sensor point
pump vfd speed sensor point


def ​

pump ​

Pump equipment or control point


meta ​

defpump
ismarker
liblib:phIoT
wikipediahttps://en.wikipedia.org/wiki/Pump

supertypes ​

markerMarker labels a dict with typing information


def ​

purge-water ​

Water expelled from a system to remove contaminants.


conjunct ​

purgeAssociated with a cleaning process to remove contaminants
waterWater in its liquid form

meta ​

defpurge-water
iswater
liblib:phIoT
wikipediahttps://en.wikipedia.org/wiki/Water

usage ​

purge  water

supertypes ​

markerMarker labels a dict with typing information
phenomenonAspect of scientific interest with measurable quantities
substanceMatter in one the three states solid, liquid, or gas
fluidLiquid or gas
liquidSubstance with definite volume but takes the shape of its container
waterWater in its liquid form

quantities ​

concentrationAbundance of substance in the total volume of a mixture
flowMeasure of volumetric flow of fluid
levelRange from 0% to 100%
pressureMeasure of force applied
tempTemperature - measure of hot and cold
volumeThree dimensional space occupied by a substance


def ​

purge ​

Associated with a cleaning process to remove contaminants. Most commonly it indicates purging water or air by using a filter or by letting out a certain amount of the substance at a high flow rate.


meta ​

defpurge
ismarker
liblib:phIoT

supertypes ​

markerMarker labels a dict with typing information


def ​

radiantEquip ​

HVAC equipment that conditions a space without forced air.


meta ​

defradiantEquip
iconEquipIcon
isequip
liblib:phIoT

usage ​

radiantEquip  equip

supertypes ​

markerMarker labels a dict with typing information
entityTop-level dicts with a unique identifier
equipEquipment asset

subtypes ​

chilledBeamConditions a space using a heat exchanger integrated into the ceiling
radiantFloorHeats a space using pipes or cables embedded beneath floor
radiatorHeats a space using exposed pipes or coils

tags ​

disDisplay name for an entity
disMacroDisplay name using macro syntax
equipRefReference to equip which contains this entity
ghgSourceRefRef to the emission source used to calculate Greenhouse Gas Emissions
idDefines the unique identifier of an entity in system using a ref value type
navNameNavigation name commonly used with disMacro to create computed display strings
siteRefReference to site which contains the entity
spaceRefReference to space which contains this entity
systemRefReference to system

children ​

equip
point
point


def ​

radiantFloor ​

Heats a space using pipes or cables embedded beneath floor.


meta ​

defradiantFloor
iconEquipIcon
isradiantEquip
liblib:phIoT
wikipediahttps://en.wikipedia.org/wiki/Underfloor_heating

usage ​

radiantFloor  equip

supertypes ​

markerMarker labels a dict with typing information
entityTop-level dicts with a unique identifier
equipEquipment asset
radiantEquipHVAC equipment that conditions a space without forced air

tags ​

disDisplay name for an entity
disMacroDisplay name using macro syntax
equipRefReference to equip which contains this entity
ghgSourceRefRef to the emission source used to calculate Greenhouse Gas Emissions
heatingProcessProcessed used to heat a substance
idDefines the unique identifier of an entity in system using a ref value type
navNameNavigation name commonly used with disMacro to create computed display strings
siteRefReference to site which contains the entity
spaceRefReference to space which contains this entity
systemRefReference to system

children ​

equip
point
point


def ​

radiator ​

Heats a space using exposed pipes or coils. Hot water and steam radiators are often cast iron and installed directly in the space or along the baseboard. Electric radiators are typically installed on the baseboard.


meta ​

defradiator
iconEquipIcon
isradiantEquip
liblib:phIoT
wikipediahttps://en.wikipedia.org/wiki/Radiator_(heating)

usage ​

radiator  equip

supertypes ​

markerMarker labels a dict with typing information
entityTop-level dicts with a unique identifier
equipEquipment asset
radiantEquipHVAC equipment that conditions a space without forced air

tags ​

disDisplay name for an entity
disMacroDisplay name using macro syntax
equipRefReference to equip which contains this entity
ghgSourceRefRef to the emission source used to calculate Greenhouse Gas Emissions
heatingProcessProcessed used to heat a substance
idDefines the unique identifier of an entity in system using a ref value type
navNameNavigation name commonly used with disMacro to create computed display strings
siteRefReference to site which contains the entity
spaceRefReference to space which contains this entity
systemRefReference to system

children ​

equip
point
point


def ​

rated ​

Data specified by a manufacturer or rating organization. Typically this information is from the equipment data plate or cut sheet. Also see design.


meta ​

defrated
ismarker
liblib:phIoT

supertypes ​

markerMarker labels a dict with typing information


def ​

reactive-energy ​

Reactive energy in an AC eletrical power system. Integral of reactive-power over time.


conjunct ​

reactiveRelating to reactance
energyMeasure of ability to do work

meta ​

defreactive-energy
isquantity
liblib:phIoT
quantityOfac-elec

usage ​

reactive  energy

supertypes ​

markerMarker labels a dict with typing information
quantityMeasurable property of a substance or phenomenon


def ​

reactive-power ​

Reactive power or imaginary power; represents energy that recirculates within an AC power system but does not contribute useful work.


conjunct ​

reactiveRelating to reactance
powerEnergy consumed per unit time

meta ​

defreactive-power
isquantity
liblib:phIoT
prefUnitkVAR
quantityOfac-elec

usage ​

reactive  power

supertypes ​

markerMarker labels a dict with typing information
quantityMeasurable property of a substance or phenomenon


def ​

reactive ​

Relating to reactance


meta ​

defreactive
ismarker
liblib:phIoT

supertypes ​

markerMarker labels a dict with typing information


def ​

reciprocal ​

Piston compressor driven by a crankshaft


meta ​

defreciprocal
ismarker
liblib:phIoT
wikipediahttps://en.wikipedia.org/wiki/Reciprocating_compressor

supertypes ​

markerMarker labels a dict with typing information

subtypes ​

chiller-reciprocalPiston compressor driven by a crankshaft


def ​

refrig-input ​

Entity inputs refrigerant which flows from another entity


conjunct ​

refrigFluid used in refrigeration and heat exchange
inputEntity inputs a substance which flows from another entity

meta ​

defrefrig-input
isinput
liblib:phIoT

usage ​

refrig  input

supertypes ​

markerMarker labels a dict with typing information
inputEntity inputs a substance which flows from another entity

subtypes ​

branchSelectorBranch selector used for heat recovery in a VRF system
vrf-indoorUnitIndoor unit in a VRF system
vrf-indoorUnit-fcuIndoor unit fan coil unit in a VRF system

tags ​

refrigRefRefrigerant flows from the referent to this entity


def ​

refrig-output ​

Entity outputs refrigerant to other entities


conjunct ​

refrigFluid used in refrigeration and heat exchange
outputEntity outputs a substance with flows to other entities

meta ​

defrefrig-output
isoutput
liblib:phIoT

usage ​

refrig  output

supertypes ​

markerMarker labels a dict with typing information
outputEntity outputs a substance with flows to other entities

subtypes ​

vrf-outdoorUnitOutdoor unit with one or more compressors in a VRF system
vrf-refrig-plantGroup of outdoor units in a VRF system


def ​

refrig-system ​

Refrigerant distribution to fulfill all or parts of a refrigeration cycle.


conjunct ​

refrigFluid used in refrigeration and heat exchange
systemGrouping of related equipment dedicated to a single application

meta ​

defrefrig-system
issystem
liblib:phIoT

usage ​

refrig  system

supertypes ​

markerMarker labels a dict with typing information
entityTop-level dicts with a unique identifier
systemGrouping of related equipment dedicated to a single application

subtypes ​

vrf-systemVariable refigerant flow system
vrf-coolingOnly-systemCooling only VRF system can only cool
vrf-heatPump-systemHeat pump VRF system can either heat, or cool, but not at the same time
vrf-heatRecovery-systemHeat recovery VRF system can operate cooling and heating by each indoor unit independently, at the same time

tags ​

disDisplay name for an entity
disMacroDisplay name using macro syntax
idDefines the unique identifier of an entity in system using a ref value type
navNameNavigation name commonly used with disMacro to create computed display strings
siteRefReference to site which contains the entity
systemRefReference to system

children ​

equip
point
point


def ​

refrig ​

Fluid used in refrigeration and heat exchange. Refrigerants typically alternate between liquid and gas state.


meta ​

defrefrig
isfluid
liblib:phIoT
wikipediahttps://en.wikipedia.org/wiki/Refrigerant

supertypes ​

markerMarker labels a dict with typing information
phenomenonAspect of scientific interest with measurable quantities
substanceMatter in one the three states solid, liquid, or gas
fluidLiquid or gas

quantities ​

concentrationAbundance of substance in the total volume of a mixture
flowMeasure of volumetric flow of fluid
levelRange from 0% to 100%
pressureMeasure of force applied
tempTemperature - measure of hot and cold
volumeThree dimensional space occupied by a substance


def ​

refrigRef ​

Refrigerant flows from the referent to this entity


meta ​

defrefrigRef
inputsrefrig
isref
liblib:phIoT
ofrefrig-output
tagOnrefrig-input

supertypes ​

valData value type
scalarScalar is an atomic value kind
refReference to an entity


def ​

reheat ​

Command point for reheating process


meta ​

defreheat
ismarker
liblib:phIoT

supertypes ​

markerMarker labels a dict with typing information


def ​

return ​

Duct returning air back to equipment


meta ​

defreturn
isductSection
liblib:phIoT
uiInputui::ChoiceInput

supertypes ​

markerMarker labels a dict with typing information
choiceChoice specifies an exclusive marker selection
ductSectionEquipment section of ductwork


def ​

roof-floor ​

The roof floor is the topmost level of a building. It is often where HVAC equipment is located such as rooftop AHUs.


conjunct ​

roofEnvelope covering the top of a building
floorStorey of a building

meta ​

defroof-floor
isfloor
liblib:phIoT
wikipediahttps://en.wikipedia.org/wiki/Storey

usage ​

roof  floor  space

supertypes ​

markerMarker labels a dict with typing information
entityTop-level dicts with a unique identifier
spaceSpace is a three-dimensional volume in the built environment
floorStorey of a building

tags ​

areaArea of a shape or floor space
disDisplay name for an entity
disMacroDisplay name using macro syntax
floorNumUnitless integer indicating the floor's distance from ground level
floorRefA legacy deprecated floor reference
idDefines the unique identifier of an entity in system using a ref value type
navNameNavigation name commonly used with disMacro to create computed display strings
siteRefReference to site which contains the entity
spaceRefReference to space which contains this entity

children ​

equip
point
point
space
space


def ​

roof ​

Envelope covering the top of a building


meta ​

defroof
ismarker
liblib:phIoT

supertypes ​

markerMarker labels a dict with typing information


def ​

room ​

Enclosed room of a building


meta ​

defroom
isspace
liblib:phIoT
wikipediahttps://en.wikipedia.org/wiki/Room

usage ​

room  space

supertypes ​

markerMarker labels a dict with typing information
entityTop-level dicts with a unique identifier
spaceSpace is a three-dimensional volume in the built environment

tags ​

areaArea of a shape or floor space
disDisplay name for an entity
disMacroDisplay name using macro syntax
idDefines the unique identifier of an entity in system using a ref value type
navNameNavigation name commonly used with disMacro to create computed display strings
siteRefReference to site which contains the entity
spaceRefReference to space which contains this entity

children ​

space
equip
equip
point
point


def ​

rotaryScrew ​

Rotary screw compression


meta ​

defrotaryScrew
ismarker
liblib:phIoT
wikipediahttps://en.wikipedia.org/wiki/Rotary-screw_compressor

supertypes ​

markerMarker labels a dict with typing information

subtypes ​

chiller-rotaryScrewRotary screw compression


def ​

rtu ​

Roof Top Unit: A unitary AHU that is weatherized for outdoor use. See AHUs chapter.


meta ​

defrtu
iconEquipIcon
isahu
liblib:phIoT
navTargetequip
wikipediahttps://en.wikipedia.org/wiki/Air_handler

usage ​

rtu  ahu  equip

supertypes ​

markerMarker labels a dict with typing information
entityTop-level dicts with a unique identifier
equipEquipment asset
airHandlingEquipHVAC equipment that conditions and delivers air via one or more fans
ahuAir Handling Unit
inputEntity inputs a substance which flows from another entity
elec-inputEntity inputs electricity which flows from another entity
outputEntity outputs a substance with flows to other entities
air-outputEntity outputs air to other entities

tags ​

ahuZoneDeliveryAHU delivery method of conditioned air to the zone
airVolumeAdjustabilityAbility of air handling equip to adjust volume of air flow
coolingProcessProcessed used to cool a substance
disDisplay name for an entity
disMacroDisplay name using macro syntax
ductConfigDuctwork configuration
ductDeckCold, hot, or neutral deck
elecRefElectricity flows from the referent to this entity
equipRefReference to equip which contains this entity
ghgSourceRefRef to the emission source used to calculate Greenhouse Gas Emissions
heatingProcessProcessed used to heat a substance
idDefines the unique identifier of an entity in system using a ref value type
navNameNavigation name commonly used with disMacro to create computed display strings
siteRefReference to site which contains the entity
spaceRefReference to space which contains this entity
systemRefReference to system

children ​

bypass damper cmd point
cool cmd point
cool cmd point
dessicantDehumidifier cmd point
dessicantDehumidifier cmd point
discharge duct equip
discharge duct equip
economizer duct equip
economizer duct equip
economizing cmd point
economizing cmd point
exhaust duct equip
exhaust duct equip
faceBypass cmd point
faceBypass cmd point
filter sensor point
filter sensor point
freezeStat sensor point
freezeStat sensor point
heat cmd point
heat cmd point
heatWheel cmd point
heatWheel cmd point
humidifier equip
humidifier equip
hvacMode sp point
hvacMode sp point
mixed duct equip
mixed duct equip
outside duct equip
outside duct equip
return duct equip
return duct equip
thermostat equip
thermostat equip
ventilation duct equip
ventilation duct equip


def ​

run ​

Primary on/off point of an equip especially used with a vfd. Run is used with Bool points where true indicates on and false indicates off. When paired with cmd this is the commanded state of the equipment. When paired with sensor this is the actual status of the equip. If the equipment also defines an enable point then both must be commanded on in order to run the equipment.


meta ​

defrun
ismarker
liblib:phIoT

supertypes ​

markerMarker labels a dict with typing information


def ​

secondaryLoop ​

Pipework which circulates closest to the building or end use. In a central plant, the secondary loop indicates the pipes and equipment between the central plant and the building. In context of heat exchangers between the primary and secondary loops, this tag indicates the side closest to the building.


meta ​

defsecondaryLoop
isplantLoop
liblib:phIoT
uiInputui::ChoiceInput

supertypes ​

markerMarker labels a dict with typing information
choiceChoice specifies an exclusive marker selection
plantLoopPlant piping loop


def ​

sensor ​

Point is a sensor, input, AI/BI. See Points chapter.


meta ​

defsensor
ispointFunction
liblib:phIoT
uiInputui::ChoiceInput

supertypes ​

markerMarker labels a dict with typing information
choiceChoice specifies an exclusive marker selection
pointFunctionClassifies the point as a sensor, command, or setpoint


def ​

series ​

Circuit with single path of flow


meta ​

defseries
ismarker
liblib:phIoT

supertypes ​

markerMarker labels a dict with typing information


def ​

serviceFactor ​

Ratio of the maximum continuous output capacity at which a machine or system may operate without damage to the machine or system’s nominal output capacity.


meta ​

defserviceFactor
ismarker
liblib:phIoT

supertypes ​

markerMarker labels a dict with typing information


def ​

sim-point ​

See Synthetics chapter.


conjunct ​

simSimulation point
pointData point such as a sensor or actuator

meta ​

defsim-point
issynthetic-point
liblib:phIoT

usage ​

sim  point

supertypes ​

markerMarker labels a dict with typing information
entityTop-level dicts with a unique identifier
pointData point such as a sensor or actuator
synthetic-pointSee Synthetics chapter

tags ​

curSupports current value
disDisplay name for an entity
disMacroDisplay name using macro syntax
disabledIndicates the entity is in a disabled state
enumDefines an eumeration of string key names
equipRefReference to equip which contains this entity
ghgFactorHisIdentifies point record with interval emission factor data that the Greenhouse Gas Emission Engine uses to calculate emissions
hisSupports historization of data
idDefines the unique identifier of an entity in system using a ref value type
kindKind name used to identity a value data type
maxValInclusive maximum for a numeric value
minValInclusive minimum for a numeric value
navNameNavigation name commonly used with disMacro to create computed display strings
pointFunctionClassifies the point as a sensor, command, or setpoint
pointQuantityQuantity the point senses or controls
pointRefSee Synthetics chapter
pointSubjectWhat the point senses or controls
simScenarioSee Synthetics chapter
siteRefReference to site which contains the entity
spaceRefReference to space which contains this entity
syntheticModelRefSee Synthetics chapter
systemRefReference to system
tzTimezone identifier from standard timezone database
unitUnit identifier from standard unit database
writableSupports writing data


def ​

sim ​

Simulation point. See Synthetics chapter.


meta ​

defsim
issynthetic
liblib:phIoT
uiInputui::ChoiceInput

usage ​

sim  synthetic

supertypes ​

markerMarker labels a dict with typing information
choiceChoice specifies an exclusive marker selection
pointFunctionClassifies the point as a sensor, command, or setpoint
syntheticSynthetic point with computed operational data


def ​

simBaseline ​

See Synthetics chapter.


meta ​

defsimBaseline
disBaseline
issimScenario
liblib:phIoT
uiInputui::ChoiceInput

supertypes ​

markerMarker labels a dict with typing information
choiceChoice specifies an exclusive marker selection
simScenarioSee Synthetics chapter


def ​

simModel ​

See Synthetics chapter.


meta ​

defsimModel
issyntheticModel
liblib:phIoT

usage ​

simModel  syntheticModel

supertypes ​

markerMarker labels a dict with typing information
entityTop-level dicts with a unique identifier
syntheticModelSee Synthetics chapter

tags ​

disDisplay name for an entity
idDefines the unique identifier of an entity in system using a ref value type


def ​

simOperation ​

See Synthetics chapter.


meta ​

defsimOperation
disOperation
issimScenario
liblib:phIoT
uiInputui::ChoiceInput

supertypes ​

markerMarker labels a dict with typing information
choiceChoice specifies an exclusive marker selection
simScenarioSee Synthetics chapter


def ​

simOptimum ​

See Synthetics chapter.


meta ​

defsimOptimum
disOptimum
issimScenario
liblib:phIoT
uiInputui::ChoiceInput

supertypes ​

markerMarker labels a dict with typing information
choiceChoice specifies an exclusive marker selection
simScenarioSee Synthetics chapter


def ​

simScenario ​

See Synthetics chapter.


meta ​

defsimScenario
ischoice
liblib:phIoT
tagOnsim-point
uiInputui::ChoiceInput

supertypes ​

markerMarker labels a dict with typing information
choiceChoice specifies an exclusive marker selection

subtypes ​

simBaselineSee Synthetics chapter
simOperationSee Synthetics chapter
simOptimumSee Synthetics chapter


def ​

singleDuct ​

One single duct


meta ​

defsingleDuct
isductConfig
liblib:phIoT
uiInputui::ChoiceInput

supertypes ​

markerMarker labels a dict with typing information
choiceChoice specifies an exclusive marker selection
ductConfigDuctwork configuration


def ​

singlePhase ​

Single-phase AC electricity. Power is provided by a single AC voltage source with a 2-wire connection.


meta ​

defsinglePhase
isphaseCount
liblib:phIoT
uiInputui::ChoiceInput
wikipediahttps://en.wikipedia.org/wiki/Single-phase_electric_power

supertypes ​

markerMarker labels a dict with typing information
choiceChoice specifies an exclusive marker selection
phaseCountNumber of phases for an AC electrical power system or connected equipment


def ​

site ​

Site is a geographic location of the built environment. Typically site maps to one building with its own unique street address. See Sites chapter.


meta ​

defsite
iconSiteIcon
isentity, geoPlace
liblib:phIoT
mandatory✓

supertypes ​

markerMarker labels a dict with typing information
entityTop-level dicts with a unique identifier
geoPlaceGeographic place

tags ​

areaArea of a shape or floor space
disDisplay name for an entity
energyStarSiteTag applied to a site record which marks a site as mapped into Portfolio Manager
geoAddrFree form street address
geoCityGeographic city or locality name
geoCoordGeographic coordinate as C(latitude,longitude)
geoCountryGeographic country as ISO 3166-1 two letter code
geoCountyGeographic subdivision of US state
geoElevationElevation above sea-level of the location
geoPostalCodeGeographic postal code
geoStateState or province name
geoStreetGeographic street address and name
idDefines the unique identifier of an entity in system using a ref value type
primaryFunctionPrimary function of building as US Energy Star key
tzTimezone identifier from standard timezone database
weatherStationRefReference to weather station for to use this entity
yearBuiltOriginal year of construction as four digit year such as 1980

children ​

space
equip
equip


def ​

siteMeter ​

Main meter for the associated site


meta ​

defsiteMeter
ismeterScope
liblib:phIoT
uiInputui::ChoiceInput

supertypes ​

markerMarker labels a dict with typing information
choiceChoice specifies an exclusive marker selection
meterScopeClassifies a meter as a main site meter or submeter


def ​

siteRef ​

Reference to site which contains the entity


meta ​

containedBysite
defsiteRef
isref
liblib:phIoT
ofsite
tagOnsystem, space, equip, point

supertypes ​

valData value type
scalarScalar is an atomic value kind
refReference to an entity


def ​

sp ​

Point is a setpoint, soft point, internal control variable, schedule. See Points chapter.


meta ​

defsp
ispointFunction
liblib:phIoT
uiInputui::ChoiceInput

supertypes ​

markerMarker labels a dict with typing information
choiceChoice specifies an exclusive marker selection
pointFunctionClassifies the point as a sensor, command, or setpoint


def ​

space ​

Space is a three-dimensional volume in the built environment. See Spaces chapter.


meta ​

defspace
isentity
liblib:phIoT
mandatory✓

supertypes ​

markerMarker labels a dict with typing information
entityTop-level dicts with a unique identifier

subtypes ​

dataCenterSpace used to house computer and networking gear
floorStorey of a building
ground-floorFloor at ground level
roof-floorThe roof floor is the topmost level of a building
subterranean-floorFloor below ground level
roomEnclosed room of a building
zone-spaceSpace associated with a specific system
hvac-zone-spaceZone related to conditioning of a space's air temperature and quality
lighting-zone-spaceZone related to lighting system

tags ​

areaArea of a shape or floor space
disDisplay name for an entity
disMacroDisplay name using macro syntax
idDefines the unique identifier of an entity in system using a ref value type
navNameNavigation name commonly used with disMacro to create computed display strings
siteRefReference to site which contains the entity
spaceRefReference to space which contains this entity

children ​

space
equip
equip
point
point


def ​

spaceRef ​

Reference to space which contains this entity


meta ​

containedByspace
defspaceRef
isref
liblib:phIoT
ofspace
tagOnspace, equip, point

supertypes ​

valData value type
scalarScalar is an atomic value kind
refReference to an entity


def ​

splitPhase ​

Split-phase AC electricity. Power is provided by a single AC voltage source with a 3-wire connection, consisting of two hot wires (phases), separated from each other by a 180-degree phase angle, and one neutral wire. Despite having two labeled phases, split-phase AC electricity is not a true two-phase system.


meta ​

defsplitPhase
isphaseCount
liblib:phIoT
uiInputui::ChoiceInput
wikipediahttps://en.wikipedia.org/wiki/Split-phase_electric_power

supertypes ​

markerMarker labels a dict with typing information
choiceChoice specifies an exclusive marker selection
phaseCountNumber of phases for an AC electrical power system or connected equipment


def ​

stage ​

Stage number of staged equipment operation such as coil or pump. The first stage is 1, second stage 2, etc.


meta ​

defstage
isint
liblib:phIoT
minVal1

supertypes ​

valData value type
scalarScalar is an atomic value kind
numberInteger or floating point numbers annotated with an optional unit
intUnitless integer number


def ​

standby ​

Readiness mode of a space


meta ​

defstandby
ismarker
liblib:phIoT

supertypes ​

markerMarker labels a dict with typing information