Skip to content

lib-ph 库参考 ​

原文: https://finproducts.atlassian.net/wiki/spaces/JIDD3/pages/34793881990/FIN+5.3.1+lib-ph 中文整理基于 FIN 5.3.1

导读: Project Haystack 核心定义

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


目录(导读) ​


概述(中译) ​

Project Haystack 核心定义


API 正文(英文) ​

tags ​

accumulateAccumulate the tag's value during inheritance and defx
associationAssociations model ontological relationships between definitions
baseUriBase URI for normalizing relative URIs
boolBoolean value true or false
childrenList of prototypes contained by this entity
childrenFlattenList of aspects to flatten into children prototypes
choiceChoice specifies an exclusive marker selection
computedFromReciprocalIndicates a relationship that is computed from its reciprocal
containedByThe entity is logically contained by the referent
containsEntities logically contained by this entity
coordGeographic coordinate in latitude/longitude in decimal degrees
dateISO 8601 date as year, month, day
dateTimeISO 8601 timestamp followed by timezone identifier
defCreate a new definition bound to the given symbol
defxExtends the given definition with additional meta tags
dependsList of this library's dependencies
deprecatedObsoleted
dictMap of name/value tag pairs
disDisplay name for an entity
docDocumentation in simplified flavor of markdown
docAssociationsGenerate a section in the docs for this association
docTaxonomyGenerate a taxonomy tree for this term in the documentationindex
durationNumber with a unit of time
entityTop-level dicts with a unique identifier
enumDefines an eumeration of string key names
featureFeature namespace of definitions formatted as feature:name
fileExtFilename extension such as "csv"
filetypeFile format type definition
filterStrHaystack filter string
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
geoPlaceGeographic place
geoPostalCodeGeographic postal code
geoStateState or province name
geoStreetGeographic street address and name
gridTwo dimension table of columns and rows
idDefines the unique identifier of an entity in system using a ref value type
inputEntity inputs a substance which flows from another entity
inputsThe entity inputs a substance from the referent
intUnitless integer number
isDefines one or more supertypes of a subtyping relationship
kindKind name used to identity a value data type
libLibrary module of symbolic definitions
listOrdered list of zero or more values
mandatoryRequires that the marker be applied to dicts which use the marker's subtypes
markerMarker labels a dict with typing information
maxMaximum
maxValInclusive maximum for a numeric value
mimeMime type formatted as type/subtype
minMinimum
minValInclusive minimum for a numeric value
naNot available used to indicate invalid or missing data
noSideEffectsMarks a function or operation as having no side effects
nodocUndocumented and not officially supported
nosrcDo not include source code in documentation
notInheritedMarker applied to a def to indicate that is not inherited into subtype definitions
numberInteger or floating point numbers annotated with an optional unit
ofExpected value type of a collection, reference, or choice
opOperation for HTTP API
openEnumApply to str enum tags where the enumeration range is open ended
outputEntity outputs a substance with flows to other entities
outputsThe entity outputs a substance to the referent
reciprocalOfSpecifies the inverse of an association or relationships
refReference to an entity
relationshipRef tags used to model entity-to-entity relationships
removeSingleton for remove operation
scalarScalar is an atomic value kind
spanTime span as modeled encoded as XStr
strUnicode string of characters
symbolSymbol to a def
tagOnThis tag is used on the given entity
tagsTags used with this entity
timeISO 8601 time as hour, minute, seconds
transientIndicates a value tag which should not be persisted
transitiveThis marker is applied to a relationship to indicate it is transitive
tzTimezone identifier from standard timezone database
unitUnit identifier from standard unit database
uriUniversal resource identifier
valData value type
versionVersion string formatted as decimal integers separated by a dot
wikipediaHyperlink to the subject's page on Wikipedia
xstrExtended string - type name and string value encoding

ops ​

aboutQuery basic information about the server
closeClose the current session and cancel the auth bearer token
defsQuery the definitions in the current namespace
filetypesQuery the filetype defs in the current namespace
libsQuery the lib defs in the current namespace
navQuery the navigation tree for discovery
opsQuery the op defs in the current namespace
readQuery the a set of entity records by id or by filter
watchPollPoll a watch subscription
watchSubSubscribe to entity data
watchUnsubUnsubscribe to entity data

filetypes ​

csvComma Separated Values - see CSV
jsonHaystack JavaScript Object Notation format - see Json
jsonldJavaScript Object Notation for Linked Data - see RDF
trioHaystack Tag Record Input Output - see Trio
turtleRDF Turtle - see RDF
zincHaystack typed CSV format - see Zinc


def ​

accumulate ​

Accumulate the tag's value during inheritance and defx. Tags marked as accumulate are aggregated together during normalization and deduplicated. This marker must only be used on tags which expect a list value.


meta ​

defaccumulate
ismarker
liblib:ph

supertypes ​

markerMarker labels a dict with typing information


def ​

association ​

Associations model ontological relationships between definitions. See Associations chapter.


meta ​

defassociation
islist
liblib:ph
ofsymbol
uiInputuiDev::SymbolListInput

supertypes ​

valData value type
listOrdered list of zero or more values

subtypes ​

isDefines one or more supertypes of a subtyping relationship
quantitiesQuantities used to measure this phenomenon
quantityOfAssociates quantity as measurement of a phenomenon
tagOnThis tag is used on the given entity
tagsTags used with this entity


def ​

baseUri ​

Base URI for normalizing relative URIs


meta ​

defbaseUri
isuri
liblib:ph
tagOnlib

supertypes ​

valData value type
scalarScalar is an atomic value kind
uriUniversal resource identifier


def ​

bool ​

Boolean value true or false. See Kinds chapter.


meta ​

defbool
isscalar
liblib:ph

supertypes ​

valData value type
scalarScalar is an atomic value kind

subtypes ​

mqttCleanSessionWhether to set the clean session flag on the connect request to the broker
mqttRetainSet the retention flag on a published message


def ​

children ​

List of prototypes contained by this entity. See Protos chapter for more details.


meta ​

accumulate✓
defchildren
islist
liblib:ph
ofdict

supertypes ​

valData value type
listOrdered list of zero or more values


def ​

childrenFlatten ​

List of aspects to flatten into children prototypes. See Protos chapter for more details.


meta ​

defchildrenFlatten
islist
liblib:ph
ofsymbol

supertypes ​

valData value type
listOrdered list of zero or more values


def ​

choice ​

Choice specifies an exclusive marker selection. See Choices chapter.


meta ​

defchoice
ismarker
liblib:ph
uiInputui::ChoiceInput

supertypes ​

markerMarker labels a dict with typing information

subtypes ​

ahuZoneDeliveryAHU delivery method of conditioned air to the zone
chilledBeamZoneAHU supplies air to chilled beam terminal units
directZoneAHU supplies air directly to the zone
multiZoneAHU discharge air is split into a duct per zone
vavZoneAHU supplies air to VAV terminal units
airVolumeAdjustabilityAbility of air handling equip to adjust volume of air flow
constantAirVolumeDelivers a constant volume of air flow
variableAirVolumeDelivers a variable volume of air flow
arcTypeDocument type which determines workflow
atesDesignDesign type of the ATES underground system
atesClosedLoopThe ATES uses closed piping to transport a water/glycol mixture through the ground
atesDoubletThe ATES has one or more pairs of a separate warm and cool well
atesDoubletPairedThe ATES is as a doublet, but with specific warm and cool wells linked together
atesMonoThe ATES has only one physical well
atesUnidirectionalSimilar to a doublet, but water always flows in the same direction from the extraction to the infiltration well
chillerMechanismPrimary mechanism of chiller
chiller-absorptionCooling process using energy from heat source such as hot water
chiller-centrifugalCompression via a continuous flow of fluid through an impeller
chiller-reciprocalPiston compressor driven by a crankshaft
chiller-rotaryScrewRotary screw compression
condenserLoopOpen or closed loop for condenser working fluid
condenserClosedLoopWorking fluid is kept separate from fluid used for heat transfer into the atmosphere
condenserOpenLoopUses working fluid itself for evaporation into the atmosphere
coolingProcessProcessed used to cool a substance
airCoolingCooling by dissipating heat into the surrounding air
chilledWaterCoolingCooling using transfer of heat to chilled water
condenserCoolingRemoval of heat through the process of water condensation
dxCoolingCooling using direct expansion of a refrigerant vapor
waterCoolingCooling using transfer of heat to water which is not explicitly chilled
ductConfigDuctwork configuration
dualDuctTwo ducts
singleDuctOne single duct
tripleDuctThree ducts
ductDeckCold, hot, or neutral deck
coldDeckDuct carries air for cooling
hotDeckDuct carries air for heating
neutralDeckDuct carries air which by-passes both heating and cooling coils
ductSectionEquipment section of ductwork
dischargeDuct for air leaving an equipment
economizerDuct to access fresh outside air only for economizing, not ventilation
exhaustDuct used to expel air back outside
flueDuct for exhausting combustion
inletDuct with air entering an equipment
mixedDuct where fresh outside air and return air is mixed together
outsideDuct to access fresh outside air for both ventilation and economizer
returnDuct returning air back to equipment
ventilationDuct to access fresh outside air only for ventilation, not economizing
heatingProcessProcessed used to heat a substance
biomassHeatingHeating by the combustion of biomass
coalHeatingHeating by the combustion of coal
dxHeatingHeating using direct expansion of a refrigerant vapor
elecHeatingHeating by the conversion of electrical energy
fuelOilHeatingHeating by the combustion of fuel oil
hotWaterHeatingHeating using energy of hot water
naturalGasHeatingHeating by the combustion of natural gas
propaneHeatingHeating by the combustion of propane
steamHeatingHeating using energy of steam
meterScopeClassifies a meter as a main site meter or submeter
siteMeterMain meter for the associated site
submeterSubmeters measure usage of a sub-system or equipment within a site
observesObservable subscription - see docs
pfScopePower factor scope
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
pfStandardStandard for interpreting power factor's positive or negative sign
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
phaseCountNumber of phases for an AC electrical power system or connected equipment
singlePhaseSingle-phase AC electricity
splitPhaseSplit-phase AC electricity
threePhaseThree-phase AC electricity
twoPhaseTwo-phase AC electricity
pipeFluidType of fluid conveyed by piping
pipeSectionEquipment section of piping
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
plantLoopPlant piping loop
primaryLoopPipework which circulates closest to the energy source
secondaryLoopPipework which circulates closest to the building or end use
tertiaryLoopPipework which circulates within the building
pointFunctionClassifies the point as a sensor, command, or setpoint
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
pointQuantityQuantity the point senses or controls
pointSubjectWhat the point senses or controls
ruleTypeRule type choice
curRuleMarker tag for a cur rule type
kpiRuleMarker tag for a KPI rule type
sparkRuleMarker tag for a spark rule type
simScenarioSee Synthetics chapter
simBaselineSee Synthetics chapter
simOperationSee Synthetics chapter
simOptimumSee Synthetics chapter
tankSubstanceSubstance stored by a tank
vavAirCircuitHow does the VAV pull in air
vav-parallelVAV pulls air from outside the primary air flow
vav-seriesVAV pulls air from the primary air flow
vavModulationHow does VAV modulate the temp based on duct pressure
pressureDependentVAV damper modulates to control space temp
pressureIndependentVAV damper or a control valve that modulates to maintain desired flow setpoint


def ​

computedFromReciprocal ​

Indicates a relationship that is computed from its reciprocal. Computed defs cannot be used as tags themselves.


meta ​

defcomputedFromReciprocal
ismarker
liblib:ph

supertypes ​

markerMarker labels a dict with typing information


def ​

containedBy ​

The entity is logically contained by the referent.


meta ​

defcontainedBy
isrelationship
liblib:ph
reciprocalOfcontains
transitive✓
uiInputuiDev::SymbolInput

supertypes ​

valData value type
scalarScalar is an atomic value kind
symbolSymbol to a def
relationshipRef tags used to model entity-to-entity relationships


def ​

contains ​

Entities logically contained by this entity


meta ​

computedFromReciprocal✓
defcontains
isrelationship
liblib:ph
reciprocalOfcontainedBy
transitive✓
uiInputuiDev::SymbolInput

supertypes ​

valData value type
scalarScalar is an atomic value kind
symbolSymbol to a def
relationshipRef tags used to model entity-to-entity relationships


def ​

coord ​

Geographic coordinate in latitude/longitude in decimal degrees. See Kinds chapter.


meta ​

defcoord
isscalar
liblib:ph

supertypes ​

valData value type
scalarScalar is an atomic value kind

subtypes ​

geoCoordGeographic coordinate as C(latitude,longitude)


def ​

date ​

ISO 8601 date as year, month, day: 2011-06-07. See Kinds chapter.


meta ​

defdate
isscalar
liblib:ph

supertypes ​

valData value type
scalarScalar is an atomic value kind

subtypes ​

dueDateDate expected for completion of the workflow task
expiresExpiration date


def ​

dateTime ​

ISO 8601 timestamp followed by timezone identifier. See Kinds chapter.


meta ​

defdateTime
isscalar
liblib:ph

supertypes ​

valData value type
scalarScalar is an atomic value kind

subtypes ​

ackedTime that the alarm was acknowledged
cloneModModified timestamp of the clone's progenitor
createdThe timestamp when entity was created
finMailSentDateThe email Sent date
hisEndTimestamp of newest item in history
hisStartTimestamp of oldest item in history
modLast modified time of record - see docSkySpark
nextTimeNext time stamp when the schedule transition
occurredDate/Time that the alarm actually occurred
statsResetTsSet the start time used to calculate the statistics
tsTimestamp


def ​

def ​

Create a new definition bound to the given symbol. See Defs chapter.


meta ​

defdef
issymbol
liblib:ph
uiInputui::SymbolNameInput

supertypes ​

valData value type
scalarScalar is an atomic value kind
symbolSymbol to a def

tags ​

docDocumentation in simplified flavor of markdown
enumDefines an eumeration of string key names
isDefines one or more supertypes of a subtyping relationship
mandatoryRequires that the marker be applied to dicts which use the marker's subtypes
maxValInclusive maximum for a numeric value
minValInclusive minimum for a numeric value
notInheritedMarker applied to a def to indicate that is not inherited into subtype definitions
ofExpected value type of a collection, reference, or choice
tagOnThis tag is used on the given entity
transientIndicates a value tag which should not be persisted
wikipediaHyperlink to the subject's page on Wikipedia


def ​

defx ​

Extends the given definition with additional meta tags. See Normalization.


meta ​

defdefx
issymbol
liblib:ph
uiInputuiDev::SymbolInput

supertypes ​

valData value type
scalarScalar is an atomic value kind
symbolSymbol to a def


def ​

depends ​

List of this library's dependencies. The dependent libs define the lib namespace. Also see Normalization.


meta ​

defdepends
islist
liblib:ph
ofref
tagOnlib

supertypes ​

valData value type
listOrdered list of zero or more values


def ​

deprecated ​

Obsoleted


meta ​

defdeprecated
ismarker
liblib:ph

supertypes ​

markerMarker labels a dict with typing information


def ​

dict ​

Map of name/value tag pairs. See Kinds chapter.


meta ​

defdict
isval
liblib:ph

supertypes ​

valData value type

subtypes ​

arcPartArc document part
arcTransitionsState transitions used on an arcState def
confirmUsed on actions to prompt for confirmation
connFeaturesDefines the features supported by a given connector
enumxExtened enum tag definitions
finInteractionMap of name/value tag pairs
metadataInformation related to the alarm that will live with the lifecycle of the alarm
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
userAuthDefines how a user authenticates
userMfaIndicates the user requires multifactor authentication and which multifactor authentication method is configured
viewLinkView name and state for linking to a saved view


def ​

dis ​

Display name for an entity. See Ontology chapter.


meta ​

defdis
isstr
liblib:ph
tagOnentity, finSetting, func

supertypes ​

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


def ​

doc ​

Documentation in simplified flavor of markdown. The first sentence up to the period is used as the summary.

Specific formatting options:

// inline formatting
*italic*           // italics font
**bold**           // bold font
'code'             // code or API term
`point`            // hyperlink to def (code link)
[text]`point`      // hyperlink with explicit link text
![alt]`image.png`  // image

// unordered list
- one
- two
- three

// ordered list; use numbers or letters
1. one
2. two
3. three

The main difference between markdown is that inline code uses single ticks and hyperlinks are annotated using the backtick. Links may be:

  • absolute http/https URIs
  • def symbol such as "site" or "hot-water"

meta ​

defdoc
isstr
liblib:ph
multiLine✓
tagOnarcPart, def, fav, func, projMeta

supertypes ​

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


def ​

docAssociations ​

Generate a section in the docs for this association.


meta ​

defdocAssociations
ismarker
liblib:ph

supertypes ​

markerMarker labels a dict with typing information


def ​

docTaxonomy ​

Generate a taxonomy tree for this term in the documentationindex. When applied to a def, then it will will be listed in the docs under the taxonomies section.


meta ​

defdocTaxonomy
ismarker
liblib:ph
notInherited✓

supertypes ​

markerMarker labels a dict with typing information


def ​

duration ​

Number with a unit of time


meta ​

defduration
isnumber
liblib:ph

supertypes ​

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

subtypes ​

actorTimeoutTimeout for messages send to the connector's actor thread
arcbeamMinEventTimeApplied to arcbeamConn to tune how fast the server should send current value updates
bacnetInitIntervalApplied to ConnTuning to tune the duration between driver re-initialization
bacnetScheduleReadFreqThis tag denotes the frequency duration at which schedule read sync will occur
connLingerLinger timeout used to keep a connector open
connOpenRetryFreqDuration used for connector open retries
connPingFreqDuration used to configure the auto-ping feature on a given connector
durTotal duration of the spark periods measured in hours
haystackPollFreqApplied to haystackConn to tune the duration between watch polls
hisAppendNASpecifies the amount of time after a history point's hisEnd that the hisRead() function should append an NA
hisCollectCovRateLimitRate limits the frequency for hisCollectCov
hisCollectIntervalEnables interval history collection of the curVal
hisCollectWriteFreqThis tag configures how long to buffer collected history items in memory before flushing them to the historian
hisIntervalThe interval at which sampled or consumption data is collected
hisRollupAutoMinIntervalForces hisRollupAuto() to do a rollup using this interval when none is specified and the range of the source history grid is less than 2 days
hisRollupIntervalIndicates the roll-up interval in his grid column meta-data
hisTsPrecisionControls the precision used to store timetamps in the historian
modbusReadTimeoutHow long to wait before timing out on a modbus read
modbusWriteTimeoutHow long to wait before timing out on a modbus write
mqttRetryIntervalHow long to wait between retries for messages that require acknowlegment
obixPollFreqDuration between obixConn watch polls
obsScheduleFreqSchedule events with given frequency
pollTimeFrequency between polls of curVal
ruleFreqExecution frequency of a curRule
staleTimeTime before a point's curStatus marked from "ok" to "stale" See Connector Tuning
steadyStateThe delay before transitioning to the steady state
timeoutMaximum elapsed time to allow an operation to continue
writeMaxTimeMaximum time between writes used to send periodic writes
writeMinTimeMinimum time between writes used to throttle the speed of writes


def ​

entity ​

Top-level dicts with a unique identifier. See Ontology chapter.


meta ​

defentity
iconBorderOutlined
ismarker
liblib:ph

supertypes ​

markerMarker labels a dict with typing information

subtypes ​

arcArc document
noteNote is a simple document without workflow
ticketTicket tracks a software or help case
workorderWorkorder tracks maintenance case
cloneSetDefines a clone set to subscribe to records in a remote project
connConnector for communication to a remote system
arcbeamConnArcbeam connector
ecobeeConnEcobee connector
energyStarConnEnergy Star connector to a portfolio manager account
haystackConnHaystack connector to a Haystack REST API server
modbusConnModbus connector
mqttConnMQTT connector to an MQTT Broker
nestConnGoogle Nest connector
obixConnConnector to an oBIX HTTP server
opcConnMarker tag for OPC connector record which stores the configuration for connectivity to an OPC UA endpoint
sedonaConnSedona Sox connector to a remote device
snmpConnSNMP connector
sqlConnSQL connector to a relational database using JDBC
tplTrendConnTplTrend connector
connTuningMarker applied to a rec which defines a tuning configuration
deviceMicroprocessor based hardware device
computerGeneral purpose computer
laptopPortable laptop computer
server-computerGeneral purpose computer used as a server
controllerMicroprocessor based device used in a control system
networking-deviceMicroprocessor device used to establish networks
networking-routerNetworking device used to route data between different networks
networking-switchNetworking device used to connect devices on the same network
phoneTelephone used for voice telecommunication
mobile-phoneCellular phone providing telecommunication over radio links
tabletMobile device with touch screen for user input
dockerContainerDocker container
dockerImageDocker image
equipEquipment asset
actuatorEquipment to move or control a mechanism
damper-actuatorActuator to regulate the flow of air
valve-actuatorActuator to regulate the flow of fluid
airHandlingEquipHVAC equipment that conditions and delivers air via one or more fans
ahuAir Handling Unit
doasDedicated Outside Air System
mauMakeup Air Unit
rtuRoof Top Unit
fcuFan Coil Unit
cracComputer Room Air Conditioner
unitVentUnit Ventilator
vrf-indoorUnit-fcuIndoor unit fan coil unit in a VRF system
airTerminalUnitEquipment in air distribution systems which terminate at the space
cavConstant air volume terminal unit
vavVariable air volume terminal unit
atesAquifer Thermal Energy Storage system
batteryEquipment used to store electric energy
boilerEquipment to generate hot water or steam for heating
hot-water-boilerBoiler which outputs hot water
steam-boilerBoiler which outputs steam
cableAn assembly of one or more insulated conductors
chillerEquipment to remove heat from a liquid
circuitElectrical circuit and its associated components such as breakers
conduitDuct, pipe, or cable to convey a substance or phenomenon
ductConduit used to convey air for HVAC
pipeConduit used to convey a fluid
wireCabling used to convey electricity or data
coolingTowerEquipment to transfer waste heat into the atmosphere
evse-equipEquipment that supports the delivery of electricity to charging inlets located on EVs
evse-cableThe electrical cable between an evse-port and an EV charging inlet on a vehicle
evse-dispenserEquipment that dispenses electricity to an EV
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
evse-powerConverterA power converter that has a dc electrical output applied to a dc-evse-port
flowInverterSystem to change direction of substance flow
fumeHoodVentilation equipment to limit exposure to hazardous fumes
heatExchangerEquipment to transfer heat between two working fluids
coilHeat exchanger used to heat or cool air
coolingCoilCoil used to cool air
heatingCoilCoil used to heat air
humidifier-equipEquipment which adds moisture to air to increase humidity
luminaireLight fixture using electricity to provide illumination
meterEquipment to meter a substance or phenomenon
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
motorEquipment that converts electrical energy into mechanical energy
fan-motorMotor used with a fan to create air flow
pump-motorMotor used with a pump to move fluid
panelEnclosure for electrical and control equipment
controls-panelPanel housing controllers and networking gear
elec-panelPhysical housing for electrical circuits, fuses, and breakers
plantCentral plant used to generate a substance for a process
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
rackEnclosure or chassis used to mount computer and networking gear
radiantEquipHVAC equipment that conditions a space without forced air
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
tankTank used to store a substance for temporary holding
thermostatSenses and controls temperature of space in HVAC system
upsUninterruptible power supply
verticalTransportEquipment to move humans and materials
elevatorEnclosure used to move people between floors
escalatorMoving staircase used to move people between floors
movingWalkwayConveyor to move people across a horizontal or inclined plane
vrf-equipEquipment used in VRF systems
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
vrf-outdoorUnitOutdoor unit with one or more compressors in a VRF system
wellA well is a source of groundwater and potentially thermal energy
evseSessionDescribes an event during which an evse-port can deliver power to an EV
favFavorite saved view link
ghgSourceIdentifies an emission source
ghgDirectSourceDirect emissions include
ghgIndirectSourceIndirect emissions are from the generation of purchased electricity
jobBackground job
mlVarMachine learning variable representing both model inputs and outputs
networkLogical communications network between two or more devices
nodeCluster node
pointData point such as a sensor or actuator
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
pointGroupGrouping of children points used by spaces and equipment
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
projMetaSingleton record for project meta data
provManifestA provisioning manifest
provBuildThe manifest contains all files for a SkySpark build
provImageThe manifest is an image and can be used to deploy files to nodes in the cluster
provNodeThe manifest contains files which should be applied to a specific node in the cluster
provOverlayThe manifest contains files which should be applied after the SkySpark build and patches
provPatchThe manifest contains patches for a SkySpark build
provPlatformThe manifest contains files which should be applied to a specific platform as determined by the hostModel tag
ruleMarker tag for a rule record
ruleTuningMarker applied to a rec which defines a rule tuning configuration
siteSite is a geographic location of the built environment
spaceSpace is a three-dimensional volume in the built environment
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
syntheticModelSee Synthetics chapter
computedModelSee Synthetics chapter
mlModelSee Synthetics chapter
simModelSee Synthetics chapter
systemGrouping of related equipment dedicated to a single application
air-systemSystem for moving air to maintain indoor thermal comfort and/or air quality
air-conditioning-systemSystem for air treatment to control its temperature, humidity, cleanliness, and distribution to meet the requirements of a conditioned space
air-exhaust-systemSystem consisting of one or more fans that remove air from the building
air-ventilation-systemSystem that supplies or removes air by natural or mechanical means to or from any space in order to provide outdoor air to the space
elec-systemSystem that generates, converts, distributes, and/or stores electricity
evse-systemA system that supplies electricity to EVSE assembly equipment and its auxiliary loads
lighting-systemSystem designed to provide lighting
refrig-systemRefrigerant distribution to fulfill all or parts of a refrigeration cycle
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
water-systemSystem that supplies or collects potable or non-potable water in any state
chilled-water-systemSystem that circulates water in its liquid state below ambient temperature for cooling a space or process
condenser-water-systemSystem that circulates water in its liquid state for rejecting heat from a space or process
domestic-water-systemSystem that circulates potable water in its liquid state for purposes other than space conditioning and process requirements
domestic-cold-water-systemSystem that circulates potable cold water in its liquid state for purposes other than space cooling and process requirements
domestic-hot-water-systemSystem that circulates potable hot water in its liquid state for purposes other than space heating and process requirements
hot-water-systemSystem that circulates water in its liquid state for heating a space or process
steam-systemSystem that circulates water in its vapor state for heating a space or process
tariffA tariff rec
tariffChargeA tariff charge rec
tariffAxonChargeAn Axon charge rec
tariffConsumptionChargeA consumption charge rec
tariffDemandChargeA demand charge rec
tariffFixedChargeA fixed charge rec
tariffPercentageChargeA percentage charge rec
taskDispatch task function
notifyTopicA topic that can be subscribed
userUser account
userCertificateA user certificate
userProtoA user prototype
weatherStationLogical weather station and its measurement points

tags ​

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


def ​

enum ​

Defines an eumeration of string key names. The range may also be applied to format a Bool ordered as "false,true". The value of this tag may be formatted in one of five ways:

  • dict of dicts keyed by name and Dict values for meta such as doc tag
  • comma separated names on one line
  • names separated by a "\n" newline character
  • markdown unordered list formatted as a series of "- name: description\n"
  • ref to a Xeto sys::Enum spec

Enum names should follow valid tag naming rules (start with lowercase ASCII letter and contain only ASCII letters and numbers). However in cases where mapping directly to external enumerations enum names can contain arbitrary characters such as space.


meta ​

defenum
isval
liblib:ph
tagOndef, finSetting, point
uiInputui::EnumDefInput

supertypes ​

valData value type


def ​

feature ​

Feature namespace of definitions formatted as feature:name


meta ​

deffeature
liblib:ph

subtypes ​

appUI application grouping of views
filetypeFile format type definition
finDashboardFeature namespace of definitions formatted as feature:name
finDropOverrideFeature namespace of definitions formatted as feature:name
funcAxon function
libLibrary module of symbolic definitions
extExtension library
sysModSystem module library
opOperation for HTTP API
tagLegacy backward compatible tag definitions
viewFresco UI view


def ​

fileExt ​

Filename extension such as "csv"


meta ​

deffileExt
isstr
liblib:ph
tagOnfiletype

supertypes ​

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


def ​

filetype ​

File format type definition


meta ​

deffiletype
isfeature
liblib:ph

supertypes ​

featureFeature namespace of definitions formatted as feature:name

tags ​

fileExtFilename extension such as "csv"
mimeMime type formatted as type/subtype


def ​

filetype:csv ​

Comma Separated Values - see CSV


meta ​

deffiletype:csv
disCSV
fileExtcsv
icontable
isfiletype
liblib:ph
mimetext/csv
optsTemplatecsvOpts
readerhaystack::CsvReader
wikipediahttps://wikipedia.org/wiki/Comma-separated_values
writerhaystack::CsvWriter

supertypes ​

featureFeature namespace of definitions formatted as feature:name
filetypeFile format type definition

tags ​

fileExtFilename extension such as "csv"
mimeMime type formatted as type/subtype


def ​

filetype:json ​

Haystack JavaScript Object Notation format - see Json


meta ​

deffiletype:json
disJSON
fileExtjson
iconpage
isfiletype
liblib:ph
mimeapplication/json
readerhaystack::JsonReader
wikipediahttps://wikipedia.org/wiki/JSON
writerhaystack::JsonWriter

supertypes ​

featureFeature namespace of definitions formatted as feature:name
filetypeFile format type definition

tags ​

fileExtFilename extension such as "csv"
mimeMime type formatted as type/subtype


def ​

filetype:jsonld ​

JavaScript Object Notation for Linked Data - see RDF


meta ​

deffiletype:jsonld
disJSON-LD
fileExtjsonld
iconrdf
isfiletype
liblib:ph
mimeapplication/ld+json
wikipediahttps://wikipedia.org/wiki/JSON-LD
writerdef::JsonLdWriter

supertypes ​

featureFeature namespace of definitions formatted as feature:name
filetypeFile format type definition

tags ​

fileExtFilename extension such as "csv"
mimeMime type formatted as type/subtype


def ​

filetype:trio ​

Haystack Tag Record Input Output - see Trio


meta ​

deffiletype:trio
disTrio
fileExttrio
iconpage
isfiletype
liblib:ph
mimetext/trio
readerhaystack::TrioReader
writerhaystack::TrioWriter

supertypes ​

featureFeature namespace of definitions formatted as feature:name
filetypeFile format type definition

tags ​

fileExtFilename extension such as "csv"
mimeMime type formatted as type/subtype


def ​

filetype:turtle ​

RDF Turtle - see RDF


meta ​

deffiletype:turtle
disTurtle
fileExtttl
iconrdf
isfiletype
liblib:ph
mimetext/turtle
wikipediahttps://wikipedia.org/wiki/Turtle_(syntax)
writerdef::TurtleWriter

supertypes ​

featureFeature namespace of definitions formatted as feature:name
filetypeFile format type definition

tags ​

fileExtFilename extension such as "csv"
mimeMime type formatted as type/subtype


def ​

filetype:zinc ​

Haystack typed CSV format - see Zinc


meta ​

deffiletype:zinc
disZinc
fileExtzinc
iconpage
isfiletype
liblib:ph
mimetext/zinc
readerhaystack::ZincReader
writerhaystack::ZincWriter

supertypes ​

featureFeature namespace of definitions formatted as feature:name
filetypeFile format type definition

tags ​

fileExtFilename extension such as "csv"
mimeMime type formatted as type/subtype


def ​

filterStr ​

Haystack filter string. See Filters


meta ​

deffilterStr
isstr
liblib:ph

supertypes ​

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

subtypes ​

arcAccessFilterRestricts access to arc document records
cloneFilterFilter string for clone set data
ghgConsumptionOnAn axon filter used by the Greenhouse Gas Emission Engine to identify the usage data to calculate emissions
mlVarFilterFilter used for querying points by tags, providing more flexibility than mlVarPoint, although it is not mandatory
navAuxFilterApply extra filter string to a navigation tree
obsFilterFilter string to define the record data set observed
obsRuleFilterFilter string for rule records to observe
obsTargetFilterFilter string for target records to observe
projAccessFilterApplied to users to defines access to projects
projIncludeFilterSelects other projects to include in UI navigation
ruleOnTarget filter for a rule or rule ready func
ruleTuningTargetFilterFilter string to match rule target records
siteAccessFilterRestricts access to sites
tariffUsageOnAn axon filter used by the tariff engine to identify the charge's historical usage data
userAccessFilterRestricts which users are visible


def ​

geoAddr ​

Free form street address. Best practice is to follow local norms for a postal address. Typically this string includes the geoStreet, geoCity, geoState (in US), and geoPostalCode:

Examples:

"1600 Pennsylvania Avenue NW, Washington, DC 20500"

"10 Downing St, Westminster, London SW1A 2AA, United Kingdom"

"Champ de Mars, 5 Avenue Anatole France, 75007 Paris, France"

meta ​

defgeoAddr
isstr
liblib:ph
tagOngeoPlace

supertypes ​

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


def ​

geoCity ​

Geographic city or locality name


meta ​

defgeoCity
isstr
liblib:ph
tagOngeoPlace

supertypes ​

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


def ​

geoCoord ​

Geographic coordinate as C(latitude,longitude)


meta ​

defgeoCoord
iscoord
liblib:ph
tagOngeoPlace

supertypes ​

valData value type
scalarScalar is an atomic value kind
coordGeographic coordinate in latitude/longitude in decimal degrees


def ​

geoCountry ​

Geographic country as ISO 3166-1 two letter code


meta ​

defgeoCountry
enumSee below
isstr
liblib:ph
tagOngeoPlace

enum ​

AFAfghanistan
AXAland Islands
ALAlbania
DZAlgeria
ASAmerican Samoa
ADAndorra
AOAngola
AIAnguilla
AQAntarctica
AGAntigua and Barbuda
ARArgentina
AMArmenia
AWAruba
AUAustralia
ATAustria
AZAzerbaijan
BSBahamas
BHBahrain
BDBangladesh
BBBarbados
BYBelarus
BEBelgium
BZBelize
BJBenin
BMBermuda
BTBhutan
BOBolivia
BAHerzegovina
BWBotswana
BVBouvet Island
BRBrazil
IOBritish Indian Ocean Territory
BNBrunei Darussalam
BGBulgaria
BFBurkina Faso
BIBurundi
KHCambodia
CMCameroon
CACanada
CVCape Verde
KYCayman Islands
CFCentral African Republic
TDChad
CLChile
CNChina
CXChristmas Island
CCCocos
COColombia
KMComoros
CGCongo
CDCongo, the Democratic Republic of the
CKCook Islands
CRCosta Rica
CICote D'ivoire
HRCroatia
CUCuba
CYCyprus
CZCzech Republic
DKDenmark
DJDjibouti
DMDominica
DODominican Republic
ECEcuador
EGEgypt
SVEl Salvador
GQEquatorial Guinea
EREritrea
EEVatican City State See Holy
ETEthiopia
FKFalkland Islands
FOFaroe Islands
FJFiji
FIFinland
FRFrance
GFFrench Guiana
PFFrench Polynesia
TFFrench Southern Territories
GAGabon
GMGambia
GEGeorgia
DEGermany
GHGhana
GIGibraltar
GRGreece
GLGreenland
GDGrenada
GPGuadeloupe
GUGuam
GTGuatemala
GGGuernsey
GNGuinea
GWGuinea-bissau
GYGuyana
HTHaiti
HMHeard Island and Mcdonald Islands
VAVatican
HNHonduras
HKHong Kong
HUHungary
ISIceland
INIndia
IDIndonesia
IRIran
IQIraq
IEIreland
IMIsle of Man
ILIsrael
ITItaly
JMJamaica
JPJapan
JEJersey
JOJordan
KZKazakhstan
KEKenya
KIKiribati
KPKorea, Democratic People's Republic of
KRKorea
KWKuwait
KGKyrgyzstan
LALao
LVLatvia
LBLebanon
LSLesotho
LRLiberia
LYLibyan Arab Jamahiriya
LILiechtenstein
LTLithuania
LULuxembourg
MOMacao
MKMacedonia
MGMadagascar
MWMalawi
MYMalaysia
MVMaldives
MLMali
MTMalta
MHMarshall Islands
MQMartinique
MRMauritania
MUMauritius
YTMayotte
MXMexico
FMMicronesia
MDMoldova
MCMonaco
MNMongolia
MEMontenegro
MSMontserrat
MAMorocco
MZMozambique
MMMyanmar
NANamibia
NRNauru
NPNepal
NLNetherlands
ANNetherlands Antilles
NCNew Caledonia
NZNew Zealand
NINicaragua
NENiger
NGNigeria
NUNiue
NFNorfolk Island
MPNorthern Mariana Islands
NONorway
OMOman
PKPakistan
PWPalau
PSPalestine
PAPanama
PGPapua New Guinea
PYParaguay
PEPeru
PHPhilippines
PNPitcairn
PLPoland
PTPortugal
PRPuerto Rico
QAQatar
REReunion
RORomania
RURussian Federation
RWRwanda
BLSaint Barthelemy
SHSaint Helena
KNSaint Kitts and Nevis
LCSaint Lucia
MFSaint Martin
PMSaint Pierre and Miquelon
VCSaint Vincent and the Grenadines
WSSamoa
SMSan Marino
STSao Tome and Principe
SASaudi Arabia
SNSenegal
RSSerbia
SCSeychelles
SLSierra Leone
SGSingapore
SKSlovakia
SISlovenia
SBSolomon Islands
SOSomalia
ZASouth Africa
GSSouth Georgia and the South Sandwich Islands
ESSpain
LKSri Lanka
SDSudan
SRSuriname
SJSvalbard and Jan Mayen
SZSwaziland
SESweden
CHSwitzerland
SYSyrian Arab Republic
TWTaiwan
TJTajikistan
TZTanzania
THThailand
TLTimor-leste
TGTogo
TKTokelau
TOTonga
TTTrinidad and Tobago
TNTunisia
TRTurkey
TMTurkmenistan
TCTurks and Caicos Islands
TVTuvalu
UGUganda
UAUkraine
AEUnited Arab Emirates
GBGreat Britain
USUSA
UMUnited States Minor Outlying Islands
UYUruguay
UZUzbekistan
VUVanuatu
VEVenezuela
VNViet Nam
VGVirgin Islands, British
VIVirgin Islands, U.S.
WFWallis and Futuna
EHWestern Sahara
YEYemen
ZMZambia
ZWZimbabwe

supertypes ​

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


def ​

geoCounty ​

Geographic subdivision of US state


meta ​

defgeoCounty
isstr
liblib:ph
tagOngeoPlace

supertypes ​

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


def ​

geoElevation ​

Elevation above sea-level of the location


meta ​

defgeoElevation
isnumber
liblib:ph
tagOngeoPlace

supertypes ​

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


def ​

geoPlace ​

Geographic place


meta ​

defgeoPlace
ismarker
liblib:ph

supertypes ​

markerMarker labels a dict with typing information

subtypes ​

siteSite is a geographic location of the built environment
weatherStationLogical weather station and its measurement points

tags ​

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


def ​

geoPostalCode ​

Geographic postal code; for US this is a five digit zip code


meta ​

defgeoPostalCode
isstr
liblib:ph
tagOngeoPlace

supertypes ​

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


def ​

geoState ​

State or province name; for US this is two letter state code. May be used in other countries to model administrative area between the geoCity and geoCountry level.


meta ​

defgeoState
enumSee below
isstr
liblib:ph
openEnum✓
tagOngeoPlace

enum ​

ALAlabama
AKAlaska
ASAmerican Samoa
AZArizona
ARArkansas
CACalifornia
COColorado
CTConnecticut
DEDelaware
DCDistrict of Columbia
FMFederated States of Micronesia
FLFlorida
GAGeorgia
GUGuam
HIHawaii
IDIdaho
ILIllinois
INIndiana
IAIowa
KSKansas
KYKentucky
LALouisiana
MEMaine
MHMarshall Islands
MDMaryland
MAMassachusetts
MIMichigan
MNMinnesota
MSMississippi
MOMissouri
MTMontana
NENebraska
NVNevada
NHNew Hampshire
NJNew Jersey
NMNew Mexico
NYNew York
NCNorth Carolina
NDNorth Dakota
MPNorthern Mariana Islands
OHOhio
OKOklahoma
OROregon
PWPalau
PAPennsylvania
PRPuerto Rico
RIRhode Island
SCSouth Carolina
SDSouth Dakota
TNTennessee
TXTexas
UTUtah
VAVirginia
VIVirgin Islands
VTVermont
WAWashington
WVWest Virginia
WIWisconsin
WYWyoming

supertypes ​

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


def ​

geoStreet ​

Geographic street address and name


meta ​

defgeoStreet
isstr
liblib:ph
tagOngeoPlace

supertypes ​

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


def ​

grid ​

Two dimension table of columns and rows. See Kinds chapter.


meta ​

defgrid
isval
liblib:ph

supertypes ​

valData value type

subtypes ​

calendarGridConfigures the items for a daily calendar
ghgFactorGridIdentifies emission factor values to calculate the emissions of the associated Greenhouse Gas
scheduleGridConfigures the items for a schedule
tariffRangesThe fee ranges for a usage-based charge


def ​

id ​

Defines the unique identifier of an entity in system using a ref value type. The scope of an entity is undefined, but must be unique with a given system or project. This identifier may be used by other entities for cross-referencing. See Ontology chapter.


meta ​

defid
isref
liblib:ph
tagOnentity

supertypes ​

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


def ​

input ​

Entity inputs a substance which flows from another entity


meta ​

definput
ismarker
liblib:ph

supertypes ​

markerMarker labels a dict with typing information

subtypes ​

air-inputEntity inputs air which flows from another entity
airCoolingCooling by dissipating heat into the surrounding air
airTerminalUnitEquipment in air distribution systems which terminate at the space
cavConstant air volume terminal unit
vavVariable air volume terminal unit
hvac-zone-spaceZone related to conditioning of a space's air temperature and quality
blowdown-water-inputEntity inputs blowdown water which flows from another entity
chilled-water-inputEntity inputs chilled water which flows from another entity
chilledWaterCoolingCooling using transfer of heat to chilled water
condensate-inputEntity inputs condensate which flows from another entity
condenser-water-inputEntity inputs condenser water which flows from another entity
domestic-water-inputEntity inputs domestic water which flows from another entity
elec-inputEntity inputs electricity which flows from another entity
actuatorEquipment to move or control a mechanism
damper-actuatorActuator to regulate the flow of air
valve-actuatorActuator to regulate the flow of fluid
airHandlingEquipHVAC equipment that conditions and delivers air via one or more fans
ahuAir Handling Unit
doasDedicated Outside Air System
mauMakeup Air Unit
rtuRoof Top Unit
fcuFan Coil Unit
cracComputer Room Air Conditioner
unitVentUnit Ventilator
vrf-indoorUnit-fcuIndoor unit fan coil unit in a VRF system
airTerminalUnitEquipment in air distribution systems which terminate at the space
cavConstant air volume terminal unit
vavVariable air volume terminal unit
boilerEquipment to generate hot water or steam for heating
hot-water-boilerBoiler which outputs hot water
steam-boilerBoiler which outputs steam
chillerEquipment to remove heat from a liquid
circuitElectrical circuit and its associated components such as breakers
coolingTowerEquipment to transfer waste heat into the atmosphere
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
elec-panelPhysical housing for electrical circuits, fuses, and breakers
elecHeatingHeating by the conversion of electrical energy
elevatorEnclosure used to move people between floors
escalatorMoving staircase used to move people between floors
evse-equipEquipment that supports the delivery of electricity to charging inlets located on EVs
evse-cableThe electrical cable between an evse-port and an EV charging inlet on a vehicle
evse-dispenserEquipment that dispenses electricity to an EV
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
evse-powerConverterA power converter that has a dc electrical output applied to a dc-evse-port
fumeHoodVentilation equipment to limit exposure to hazardous fumes
luminaireLight fixture using electricity to provide illumination
motorEquipment that converts electrical energy into mechanical energy
fan-motorMotor used with a fan to create air flow
pump-motorMotor used with a pump to move fluid
movingWalkwayConveyor to move people across a horizontal or inclined plane
fuelOil-inputEntity inputs fuel oil which flows from another entity
fuelOilHeatingHeating by the combustion of fuel oil
gasoline-inputEntity inputs gasoline which flows from another entity
hot-water-inputEntity inputs hot water which flows from another entity
hotWaterHeatingHeating using energy of hot water
makeup-water-inputEntity inputs makeup water which flows from another entity
naturalGas-inputEntity inputs natural gas which flows from another entity
naturalGasHeatingHeating by the combustion of natural gas
refrig-inputEntity inputs refrigerant which flows from another entity
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
steam-inputEntity inputs steam which flows from another entity
steamHeatingHeating using energy of steam


def ​

inputs ​

The entity inputs a substance from the referent. The value of this tag is what is received.


meta ​

definputs
isrelationship
liblib:ph
reciprocalOfoutputs
transitive✓
uiInputuiDev::SymbolInput

supertypes ​

valData value type
scalarScalar is an atomic value kind
symbolSymbol to a def
relationshipRef tags used to model entity-to-entity relationships


def ​

int ​

Unitless integer number


meta ​

defint
isnumber
liblib:ph

supertypes ​

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

subtypes ​

arcbeamWriteLevelNumber between 1 and 16 used with arcbeamWrite to determine which priority level of the remote system is written to
floorNumUnitless integer indicating the floor's distance from ground level
haystackWriteLevelNumber between 1 and 16 used with haystackWrite to determine which priority level of the remote system is written to
hisSizeApproximate number of timestamp/value pairs stored in history
modbusBlockGapApplied to modbusConn to allow for gaps in block reads
modbusBlockMaxApplied to modbusConn to limit the maximum number of registers to read in a block read
modbusSlaveApplied to modbusConn to identify the slave address on this modbus network
mqttMaxRetryHow many times to retry sending messages that require acknowlegment
obixWritableServer export of a writable point as an obix:Writable:Point
obixWriteLevelNumber between 1 and 16 used with obixWrite to determine which priority level of the remote system is written to
schedulableBinds a schedule to a writable point
stageStage number of staged equipment operation such as coil or pump
writeLevelCurrent priority level for writeVal as number between 1 and 17
yearBuiltOriginal year of construction as four digit year such as 1980


def ​

is ​

Defines one or more supertypes of a subtyping relationship. See Subtyping chapter.


meta ​

defis
isassociation
liblib:ph
ofsymbol
tagOndef
uiInputuiDev::SymbolListInput

supertypes ​

valData value type
listOrdered list of zero or more values
associationAssociations model ontological relationships between definitions


def ​

kind ​

Kind name used to identity a value data type


meta ​

defkind
enumSee below
isstr
liblib:ph
tagOnfinSetting, point
uiInputui::KindInput

enum ​

Markeris-a label
Booltrue or false
NAnot available
Numberfloating point with optional unit
StrUnicode string
UriUniversal resource identifier
Refreference to an entity
Datean ISO 8601 date as year, month, day: 2011-06-07
Timean ISO 8601 time as hour, minute, seconds: 09:51:27.354
DateTimean ISO 8601 timestamp followed by timezone name
Coordgeographic coordinate in latitude/longitude formatted as C(lat,lng)
XStrextended string with type name
Listordered sequence
Dictkey/value map
Gridtwo dimensional tabular data collection

supertypes ​

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


def ​

lib ​

Library module of symbolic definitions. See Namespaces chapter.


meta ​

deflib
isfeature
liblib:ph

supertypes ​

featureFeature namespace of definitions formatted as feature:name

subtypes ​

extExtension library
sysModSystem module library

tags ​

baseUriBase URI for normalizing relative URIs
connTuningRefReference to a tuning configuration defined by a connTuning rec
dependsList of this library's dependencies
versionVersion string formatted as decimal integers separated by a dot


def ​

list ​

Ordered list of zero or more values. See Kinds chapter.


meta ​

deflist
isval
liblib:ph

supertypes ​

valData value type

subtypes ​

associationAssociations model ontological relationships between definitions
isDefines one or more supertypes of a subtyping relationship
quantitiesQuantities used to measure this phenomenon
quantityOfAssociates quantity as measurement of a phenomenon
tagOnThis tag is used on the given entity
tagsTags used with this entity
attachmentsList of attachments as URIs in the virtual file tree
childrenList of prototypes contained by this entity
childrenFlattenList of aspects to flatten into children prototypes
dependsList of this library's dependencies
fileAccessList of directory Uris that a non-su user has read-write access to
fileAccessReadOnlyList of directory Uris that a non-su user has read-only access to
linterFantom qname of Linter class
meterPointsThis point, configured on the uiMeta record, defines the meter points that will be available in the energy app
mlInputVarRefsList of independent variables, also known as model inputs or features, associated with a machine learning model
notificationsThe set of notifications a user is subscribed to
obsScheduleTimesSchedule events for given times of the day
prefUnitDefines a preferred unit to be used with a quantity
spanModesRestrict Span input modes
tariffChargeRefsThe charges that a percentage charge applies to
userAllowList of function names to allow on this user
weatherSyncIdsApplied to a weatherStation to indicate which weather points to sync for that station


def ​

mandatory ​

Requires that the marker be applied to dicts which use the marker's subtypes. This tag is typically applied to top-level entity tags such as equip. For example if an instance is tagged with a subtype of equip such as tank, then the instance must also include the equip tag as a mandatory marker.


meta ​

defmandatory
ismarker
liblib:ph
notInherited✓
tagOndef

supertypes ​

markerMarker labels a dict with typing information


def ​

marker ​

Marker labels a dict with typing information. See Kinds chapter.


meta ​

defmarker
liblib:ph

subtypes ​

absorptionCooling process using energy from heat source such as hot water
chiller-absorptionCooling process using energy from heat source such as hot water
acRelating to alternating current (AC) electricity
accumulateAccumulate the tag's value during inheritance and defx
ackInProgressThis alarm is current being acknowledged
ackMessageRequiredThis alarm requires a message when acknowledging
ackRequiredThis alarm requires acknowledgement
activeWorking, operative, effective
addOnFeature which may be enabled or disabled at runtime
adminRequires admin permission
advanced
alarmNotification of a condition which requires attention
alarmHistoryAlarm history record
alarmConfigThis tag identifies a tag bundle as an alarm configuration
alarmEmailToggleHaving to do with the alarm email toggle
angleMeasurement of the relative difference in direction between two vectors or phasors
apparentPerceived quantity
arcLabelBase type for arc document label tags
arcBreakdownMechanical failure
arcBugSoftware defect causing improper behavior
arcDamageEquipment has been physically damaged
arcElectricalTask is electrical in nature
arcEnhancementSoftware request to add new functionality
arcHvacTask is HVAC in nature
arcInspectionEquipment requires inspection
arcMaintenancePreventative or scheduled maintenance task
arcPlumbingTask is plumbing in nature
arcSafetyHazardous situation
arcSupportAssistance required
arcWishWish list for future enhancement
arcTypeDefaultMake an arc type the default selection in the UI
arcUnassignableHides the user from assignedTo field on arc documents
atmosphericRelated to the atmosphere of the earth
auditCommitLog each time a diff is committed to the folio database
avgAverage
axonTemplateThis is a sample axon query that can be used like a template
baSuExecBA Super User (Defined here because the BA connector does not support 5.0)
bacnetConnMarker tag for BACnet connection
bacnetDeviceApplied to a record to create a BACnet device object
bacnetDisableCovApplied to ConnTuning to disable the COV for a specific point or all the points in a connector
bacnetEnableOutOfServiceApplied to ConnTuning will enable getting the overridden value for points that have the BACnet OUT_OF_SERVICE (Remote Disabled) status flag
bacnetEnumPropMappingMarker tag for Enum and property value conversion mapping for schedule object
bacnetServerDeviceApplied to a record to create a BACnet device object
bacnetServerIgnoreApply the bacnetServerIgnore marker tag to any point you do not want to process or expose via the BACnet server
bacnetServerReadOnlyApply the bacnetServerReadOnly marker tag to any points you wish to expose as read-only via the BACnet server, while still allowing them to be writable within FIN.Execute the folio query bacnetServerSyncDevices() to ensure all devices are synchronized with this new configuration
bacnetUseConfirmedCovApplied to ConnTuning to make the COV subscription mechanism to use confirmed COV messages
barometricRelating atmospheric pressure
baseChartBasic charting functions
batchRecordsIndicates that the function will process multiple records
betaIndicates a beta quality definition
blowdownRemoval from container or pipe
centrifugalCompression via a continuous flow of fluid through an impeller
chiller-centrifugalCompression via a continuous flow of fluid through an impeller
chartFunctions related to charting
chartLegendNoSortDisable sorting series by their display name in the legend
chartNoScrollDisable scrollbars in viz charts
chartOnDownload
chartTest
childData
chilledSubstance is cooled using cooling process
choiceChoice specifies an exclusive marker selection
ahuZoneDeliveryAHU delivery method of conditioned air to the zone
chilledBeamZoneAHU supplies air to chilled beam terminal units
directZoneAHU supplies air directly to the zone
multiZoneAHU discharge air is split into a duct per zone
vavZoneAHU supplies air to VAV terminal units
airVolumeAdjustabilityAbility of air handling equip to adjust volume of air flow
constantAirVolumeDelivers a constant volume of air flow
variableAirVolumeDelivers a variable volume of air flow
arcTypeDocument type which determines workflow
atesDesignDesign type of the ATES underground system
atesClosedLoopThe ATES uses closed piping to transport a water/glycol mixture through the ground
atesDoubletThe ATES has one or more pairs of a separate warm and cool well
atesDoubletPairedThe ATES is as a doublet, but with specific warm and cool wells linked together
atesMonoThe ATES has only one physical well
atesUnidirectionalSimilar to a doublet, but water always flows in the same direction from the extraction to the infiltration well
chillerMechanismPrimary mechanism of chiller
chiller-absorptionCooling process using energy from heat source such as hot water
chiller-centrifugalCompression via a continuous flow of fluid through an impeller
chiller-reciprocalPiston compressor driven by a crankshaft
chiller-rotaryScrewRotary screw compression
condenserLoopOpen or closed loop for condenser working fluid
condenserClosedLoopWorking fluid is kept separate from fluid used for heat transfer into the atmosphere
condenserOpenLoopUses working fluid itself for evaporation into the atmosphere
coolingProcessProcessed used to cool a substance
airCoolingCooling by dissipating heat into the surrounding air
chilledWaterCoolingCooling using transfer of heat to chilled water
condenserCoolingRemoval of heat through the process of water condensation
dxCoolingCooling using direct expansion of a refrigerant vapor
waterCoolingCooling using transfer of heat to water which is not explicitly chilled
ductConfigDuctwork configuration
dualDuctTwo ducts
singleDuctOne single duct
tripleDuctThree ducts
ductDeckCold, hot, or neutral deck
coldDeckDuct carries air for cooling
hotDeckDuct carries air for heating
neutralDeckDuct carries air which by-passes both heating and cooling coils
ductSectionEquipment section of ductwork
dischargeDuct for air leaving an equipment
economizerDuct to access fresh outside air only for economizing, not ventilation
exhaustDuct used to expel air back outside
flueDuct for exhausting combustion
inletDuct with air entering an equipment
mixedDuct where fresh outside air and return air is mixed together
outsideDuct to access fresh outside air for both ventilation and economizer
returnDuct returning air back to equipment
ventilationDuct to access fresh outside air only for ventilation, not economizing
heatingProcessProcessed used to heat a substance
biomassHeatingHeating by the combustion of biomass
coalHeatingHeating by the combustion of coal
dxHeatingHeating using direct expansion of a refrigerant vapor
elecHeatingHeating by the conversion of electrical energy
fuelOilHeatingHeating by the combustion of fuel oil
hotWaterHeatingHeating using energy of hot water
naturalGasHeatingHeating by the combustion of natural gas
propaneHeatingHeating by the combustion of propane
steamHeatingHeating using energy of steam
meterScopeClassifies a meter as a main site meter or submeter
siteMeterMain meter for the associated site
submeterSubmeters measure usage of a sub-system or equipment within a site
observesObservable subscription - see docs
pfScopePower factor scope
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
pfStandardStandard for interpreting power factor's positive or negative sign
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
phaseCountNumber of phases for an AC electrical power system or connected equipment
singlePhaseSingle-phase AC electricity
splitPhaseSplit-phase AC electricity
threePhaseThree-phase AC electricity
twoPhaseTwo-phase AC electricity
pipeFluidType of fluid conveyed by piping
pipeSectionEquipment section of piping
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
plantLoopPlant piping loop
primaryLoopPipework which circulates closest to the energy source
secondaryLoopPipework which circulates closest to the building or end use
tertiaryLoopPipework which circulates within the building
pointFunctionClassifies the point as a sensor, command, or setpoint
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
pointQuantityQuantity the point senses or controls
pointSubjectWhat the point senses or controls
ruleTypeRule type choice
curRuleMarker tag for a cur rule type
kpiRuleMarker tag for a KPI rule type
sparkRuleMarker tag for a spark rule type
simScenarioSee Synthetics chapter
simBaselineSee Synthetics chapter
simOperationSee Synthetics chapter
simOptimumSee Synthetics chapter
tankSubstanceSubstance stored by a tank
vavAirCircuitHow does the VAV pull in air
vav-parallelVAV pulls air from outside the primary air flow
vav-seriesVAV pulls air from the primary air flow
vavModulationHow does VAV modulate the temp based on duct pressure
pressureDependentVAV damper modulates to control space temp
pressureIndependentVAV damper or a control valve that modulates to maintain desired flow setpoint
cloneMarks a record as a clone
co2eCarbon dioxide equivalent
coldHaving low degree of heat
compressorDevice for mechanically increasing the pressure of a gas or refrigerant vapor by reducing its volume
computedFromReciprocalIndicates a relationship that is computed from its reciprocal
condenserDevice or related to process of condensation
conditioningRelated to cleaning, heating, cooling, humidifying, dehumidifying, ventilating or circulating  air.
connDebugConnector debugging functions
connTreesRelated to dbAddEdit
contextSensitiveThis is docs or video that are context Sensitive
controlsAssociated with the control system for an industrial process
coolAssocited with low temperature or cooling processes
coolingCooling mode or process
coolingOnlyEquipment without heating
curSupports current value
curTracksWriteWhen configured curVal automatically tracks changes to writeVal and curStatus is set to "ok"
currentMovement of fluid or electricity
customaryUnitsAdd this tag to the WeatherExt rec to force all units in forecast and history syncs to be in US customary system (degrees F)
damperDamper equipment or control point
dbAddEditMarks a function that holds add/edit logic for DB Builder forms
dcRelating to direct current (DC) electricity
deadbandThe range in a process where no changes to output are made
deleteTop
deltaDifferential of fluid between entering and leaving sensors
demandRate required for a process
deprecatedObsoleted
designData related to intended design and operating conditions
dessicantDehumidifierDecreases humidity from air using a substance which absorbs moisture
digTimeRelated to digest time functions
disableOverridableChecksDisables function overridable checking
disabledIndicates the entity is in a disabled state
disjoinCurValWriteArrayThis marker tag is applied on <bacnetServer> ext
dispenserEquipment that releases a specific amount of a substance
divertingThree way valve which inputs one pipe and diverts between two output pipes
docAssociationsGenerate a section in the docs for this association
docTaxonomyGenerate a taxonomy tree for this term in the documentationindex
domesticFor human use
ductAreaConfig point on a vav for duct area measured in ft² or m²
economizingEnergy reduction mode which augments heating/cooling with outside air
editSum
effectiveCurrent control setpoint in effect taking into account other factors
efficiencyEfficiency point of a chiller measured in "COP" or "kW/ton"
enableSecondary on/off point of an equip especially used with a vfd
energyBaselineFuncMarker tag on a function which can be used to generate a baseline curve
energyNormFuncMarker tag on a function which can be used to normalize energy data
entityTop-level dicts with a unique identifier
arcArc document
noteNote is a simple document without workflow
ticketTicket tracks a software or help case
workorderWorkorder tracks maintenance case
cloneSetDefines a clone set to subscribe to records in a remote project
connConnector for communication to a remote system
arcbeamConnArcbeam connector
ecobeeConnEcobee connector
energyStarConnEnergy Star connector to a portfolio manager account
haystackConnHaystack connector to a Haystack REST API server
modbusConnModbus connector
mqttConnMQTT connector to an MQTT Broker
nestConnGoogle Nest connector
obixConnConnector to an oBIX HTTP server
opcConnMarker tag for OPC connector record which stores the configuration for connectivity to an OPC UA endpoint
sedonaConnSedona Sox connector to a remote device
snmpConnSNMP connector
sqlConnSQL connector to a relational database using JDBC
tplTrendConnTplTrend connector
connTuningMarker applied to a rec which defines a tuning configuration
deviceMicroprocessor based hardware device
computerGeneral purpose computer
laptopPortable laptop computer
server-computerGeneral purpose computer used as a server
controllerMicroprocessor based device used in a control system
networking-deviceMicroprocessor device used to establish networks
networking-routerNetworking device used to route data between different networks
networking-switchNetworking device used to connect devices on the same network
phoneTelephone used for voice telecommunication
mobile-phoneCellular phone providing telecommunication over radio links
tabletMobile device with touch screen for user input
dockerContainerDocker container
dockerImageDocker image
equipEquipment asset
actuatorEquipment to move or control a mechanism
damper-actuatorActuator to regulate the flow of air
valve-actuatorActuator to regulate the flow of fluid
airHandlingEquipHVAC equipment that conditions and delivers air via one or more fans
ahuAir Handling Unit
doasDedicated Outside Air System
mauMakeup Air Unit
rtuRoof Top Unit
fcuFan Coil Unit
cracComputer Room Air Conditioner
unitVentUnit Ventilator
vrf-indoorUnit-fcuIndoor unit fan coil unit in a VRF system
airTerminalUnitEquipment in air distribution systems which terminate at the space
cavConstant air volume terminal unit
vavVariable air volume terminal unit
atesAquifer Thermal Energy Storage system
batteryEquipment used to store electric energy
boilerEquipment to generate hot water or steam for heating
hot-water-boilerBoiler which outputs hot water
steam-boilerBoiler which outputs steam
cableAn assembly of one or more insulated conductors
chillerEquipment to remove heat from a liquid
circuitElectrical circuit and its associated components such as breakers
conduitDuct, pipe, or cable to convey a substance or phenomenon
ductConduit used to convey air for HVAC
pipeConduit used to convey a fluid
wireCabling used to convey electricity or data
coolingTowerEquipment to transfer waste heat into the atmosphere
evse-equipEquipment that supports the delivery of electricity to charging inlets located on EVs
evse-cableThe electrical cable between an evse-port and an EV charging inlet on a vehicle
evse-dispenserEquipment that dispenses electricity to an EV
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
evse-powerConverterA power converter that has a dc electrical output applied to a dc-evse-port
flowInverterSystem to change direction of substance flow
fumeHoodVentilation equipment to limit exposure to hazardous fumes
heatExchangerEquipment to transfer heat between two working fluids
coilHeat exchanger used to heat or cool air
coolingCoilCoil used to cool air
heatingCoilCoil used to heat air
humidifier-equipEquipment which adds moisture to air to increase humidity
luminaireLight fixture using electricity to provide illumination
meterEquipment to meter a substance or phenomenon
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
motorEquipment that converts electrical energy into mechanical energy
fan-motorMotor used with a fan to create air flow
pump-motorMotor used with a pump to move fluid
panelEnclosure for electrical and control equipment
controls-panelPanel housing controllers and networking gear
elec-panelPhysical housing for electrical circuits, fuses, and breakers
plantCentral plant used to generate a substance for a process
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
rackEnclosure or chassis used to mount computer and networking gear
radiantEquipHVAC equipment that conditions a space without forced air
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
tankTank used to store a substance for temporary holding
thermostatSenses and controls temperature of space in HVAC system
upsUninterruptible power supply
verticalTransportEquipment to move humans and materials
elevatorEnclosure used to move people between floors
escalatorMoving staircase used to move people between floors
movingWalkwayConveyor to move people across a horizontal or inclined plane
vrf-equipEquipment used in VRF systems
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
vrf-outdoorUnitOutdoor unit with one or more compressors in a VRF system
wellA well is a source of groundwater and potentially thermal energy
evseSessionDescribes an event during which an evse-port can deliver power to an EV
favFavorite saved view link
ghgSourceIdentifies an emission source
ghgDirectSourceDirect emissions include
ghgIndirectSourceIndirect emissions are from the generation of purchased electricity
jobBackground job
mlVarMachine learning variable representing both model inputs and outputs
networkLogical communications network between two or more devices
nodeCluster node
pointData point such as a sensor or actuator
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
pointGroupGrouping of children points used by spaces and equipment
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
projMetaSingleton record for project meta data
provManifestA provisioning manifest
provBuildThe manifest contains all files for a SkySpark build
provImageThe manifest is an image and can be used to deploy files to nodes in the cluster
provNodeThe manifest contains files which should be applied to a specific node in the cluster
provOverlayThe manifest contains files which should be applied after the SkySpark build and patches
provPatchThe manifest contains patches for a SkySpark build
provPlatformThe manifest contains files which should be applied to a specific platform as determined by the hostModel tag
ruleMarker tag for a rule record
ruleTuningMarker applied to a rec which defines a rule tuning configuration
siteSite is a geographic location of the built environment
spaceSpace is a three-dimensional volume in the built environment
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
syntheticModelSee Synthetics chapter
computedModelSee Synthetics chapter
mlModelSee Synthetics chapter
simModelSee Synthetics chapter
systemGrouping of related equipment dedicated to a single application
air-systemSystem for moving air to maintain indoor thermal comfort and/or air quality
air-conditioning-systemSystem for air treatment to control its temperature, humidity, cleanliness, and distribution to meet the requirements of a conditioned space
air-exhaust-systemSystem consisting of one or more fans that remove air from the building
air-ventilation-systemSystem that supplies or removes air by natural or mechanical means to or from any space in order to provide outdoor air to the space
elec-systemSystem that generates, converts, distributes, and/or stores electricity
evse-systemA system that supplies electricity to EVSE assembly equipment and its auxiliary loads
lighting-systemSystem designed to provide lighting
refrig-systemRefrigerant distribution to fulfill all or parts of a refrigeration cycle
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
water-systemSystem that supplies or collects potable or non-potable water in any state
chilled-water-systemSystem that circulates water in its liquid state below ambient temperature for cooling a space or process
condenser-water-systemSystem that circulates water in its liquid state for rejecting heat from a space or process
domestic-water-systemSystem that circulates potable water in its liquid state for purposes other than space conditioning and process requirements
domestic-cold-water-systemSystem that circulates potable cold water in its liquid state for purposes other than space cooling and process requirements
domestic-hot-water-systemSystem that circulates potable hot water in its liquid state for purposes other than space heating and process requirements
hot-water-systemSystem that circulates water in its liquid state for heating a space or process
steam-systemSystem that circulates water in its vapor state for heating a space or process
tariffA tariff rec
tariffChargeA tariff charge rec
tariffAxonChargeAn Axon charge rec
tariffConsumptionChargeA consumption charge rec
tariffDemandChargeA demand charge rec
tariffFixedChargeA fixed charge rec
tariffPercentageChargeA percentage charge rec
taskDispatch task function
notifyTopicA topic that can be subscribed
userUser account
userCertificateA user certificate
userProtoA user prototype
weatherStationLogical weather station and its measurement points
enumMetaProject singleton record with enumeration name/code definitions
errIndicates an error condition, dis should contain display message
evaporatorMechanism used to convert a refrigerant from its liquid to gaseous state
eventEvent dict - see docs
evseElectric Vehicle Supply Equipment
excludeMarks a series are excluded from the chart
exportSupplied out of a system
extractionTaking a substance out of another substance
faceBypassPoint of an ahu indicating air flow is by-passing the heating/cooling coils
fanFan equipment or control point
fanPoweredDevice with a fan
filterRelated to an air or fluid filter
finActionCatIndicates that the function will process fin actions
finAssetMarks resources published from FIN Builder as asset files
finBestPracticeThis is either docs or videos that are best practices, typically videos
finBucketThis tag means that the resource is a FIN Bucket resource
finBuilderThis tag is used for content that is used in FIN Builder
finBuilderActionThis resource belongs to a FIN Builder Action
finBuilderComponentThis tag means that the resource is associated with a component
finBuilderCustomThis tag means that the finp file is a custom graphic, IE.
finBuilderMenuIdentifies functions that have elements for right-click menus in Graphics Builder
finCommonQueryIdentifies functions that return common queries to be used with folio
finDocsTag that has a link to docs.finproducts.com
finDocsPathThis is the path where you find the docs in docs.finproducts.com
finExampleThis tag is for an something that is an example, either for a video, or docs typically
finFileMarker for Fin Builder published file resource, the actual file stored on disk
finFileUploadMarker for Fin Builder uploaded files
finFormForm Record Selector Tag
finIconMarker for Fin Builder published project icon file
finKeyWordsA Comma Seperated string that we can add keywords too, so the user can search on this tag
finMailConnMarker tag for finMail connection
finMailDEBUGMarker tag to set the mail connection in debug mode
finMailRecMarker tag for an email message record
finMailSSLMarker tag to set the connection to use SSL
finMimeMarker for Fin Builder published file resource mime type
finModelThis asset is a FIN Model that can be opened in FIN BUilder
finModelFuncDefines functions that returns FIN Models
finNavTreeIndentifies a function as containing a root node for a DB Builder tree
finProjectMarks resources published from FIN Builder as project files
finRemoteAssetDefines functions that returns graphics remote assets
finRemoteResource
finResourceMarks resources published from FIN Builder
finRuntimeMarks resources published from FIN Builder as runtime files (i.e
finSavedChart
finScreenshotMarker for Fin Builder published project screen shot file
finStackThis tag means the asset can be used in FIN
finStackMobileMenu
finStringHaving to do with fin string related functions
finTemplateFuncDefines functions that returns FIN Templates
finThumbMarker for Fin Builder published project thumb file
finTipsAndTricksThis is a resource for FIN Tips and Tricks
finUpdateRecords
finUriMarker for Fin Builder published resource Uri
finVideoThis tag means it's a video
finVideoPathThis is the path that goes to youTube for the video
finWatcherAddedMarker tag for an added record
finWatcherCallbackMarker tag for a callback function that instructs the watcher to call it when changes are detected
finWatcherChangedMarker tag for a changed record
finWatcherRemovedMarker tag for a removed record
finpFileThe asset is a finp file, that can be downloaded and opened in FIN Builder
fluxMeasurement through a given surface
folderPathFolder Path Tag
fooUseless
freezeStatA boolean point of an ahu indicating a freezing condition
geoPlaceGeographic place
siteSite is a geographic location of the built environment
weatherStationLogical weather station and its measurement points
ghgFactorHisIdentifies point record with interval emission factor data that the Greenhouse Gas Emission Engine uses to calculate emissions
ghgFuelSourceIdentifies a direct fuel source used for combustion
ghgHeatContentIdentifies a direct emission with local heat content data
ghgMobileCombustionIdentifies direct GHG emissions associated with fuel combustion in owned or operated mobile sources
ghgStationaryCombustionIdentifies direct GHG emissions from stationary (non-transport) combustion of fossil fuels at a facility (e.g., boilers, turbines, process heat)
globalContDefines usage in Global Control
groundRelated to the surface of the earth
haystackApiFunction which is a published Hasytack REST API op
heatAssociated with a heating process
heatPumpEquipment that employs a vapor compression cycle with a reversing valve to provide heating or cooling
heatRecoveryTransfer of heat from one substance to another to reduce energy consumption
heatWheelBoolean point indicating command state of AHU's heat wheel
heatingHeating mode or process
heatingOnlyEquipment without cooling
hiddenHide a column in a table or a field on a form
hideFromMobileDBHide from database builder
hideMobileUsed to hide forms in mobile
hisSupports historization of data
hisCollectCovEnables COV history collection of the curVal
hisCollectNAHistorize the NA value whenever the curVal is null or curStatus is not equal to "ok"
hisConfigThis tag identifies a tag bundle as a history configuration
hisFuncReadyIndicates a function designed to be used directly as a computed history
hisFuncWritableAllow writing raw data to a point that has the hisFunc tag
hisSrcLegacy 2.1 support for function picker in History App
hisTotalizedIndicates values which are a continuous stream of totalization
hotHaving high degree of heat
humidifierAdding moisture to air
hvacHeating, ventilation, and air conditioning
hvacModeOperational mode for HVAC equipment
imbalanceLacking balance
importReceived into a system
indoorUnitOperates inside the conditioned space
infiltrationPermeation of a substance into another substance
inputEntity inputs a substance which flows from another entity
air-inputEntity inputs air which flows from another entity
airCoolingCooling by dissipating heat into the surrounding air
airTerminalUnitEquipment in air distribution systems which terminate at the space
cavConstant air volume terminal unit
vavVariable air volume terminal unit
hvac-zone-spaceZone related to conditioning of a space's air temperature and quality
blowdown-water-inputEntity inputs blowdown water which flows from another entity
chilled-water-inputEntity inputs chilled water which flows from another entity
chilledWaterCoolingCooling using transfer of heat to chilled water
condensate-inputEntity inputs condensate which flows from another entity
condenser-water-inputEntity inputs condenser water which flows from another entity
domestic-water-inputEntity inputs domestic water which flows from another entity
elec-inputEntity inputs electricity which flows from another entity
actuatorEquipment to move or control a mechanism
damper-actuatorActuator to regulate the flow of air
valve-actuatorActuator to regulate the flow of fluid
airHandlingEquipHVAC equipment that conditions and delivers air via one or more fans
ahuAir Handling Unit
doasDedicated Outside Air System
mauMakeup Air Unit
rtuRoof Top Unit
fcuFan Coil Unit
cracComputer Room Air Conditioner
unitVentUnit Ventilator
vrf-indoorUnit-fcuIndoor unit fan coil unit in a VRF system
airTerminalUnitEquipment in air distribution systems which terminate at the space
cavConstant air volume terminal unit
vavVariable air volume terminal unit
boilerEquipment to generate hot water or steam for heating
hot-water-boilerBoiler which outputs hot water
steam-boilerBoiler which outputs steam
chillerEquipment to remove heat from a liquid
circuitElectrical circuit and its associated components such as breakers
coolingTowerEquipment to transfer waste heat into the atmosphere
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
elec-panelPhysical housing for electrical circuits, fuses, and breakers
elecHeatingHeating by the conversion of electrical energy
elevatorEnclosure used to move people between floors
escalatorMoving staircase used to move people between floors
evse-equipEquipment that supports the delivery of electricity to charging inlets located on EVs
evse-cableThe electrical cable between an evse-port and an EV charging inlet on a vehicle
evse-dispenserEquipment that dispenses electricity to an EV
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
evse-powerConverterA power converter that has a dc electrical output applied to a dc-evse-port
fumeHoodVentilation equipment to limit exposure to hazardous fumes
luminaireLight fixture using electricity to provide illumination
motorEquipment that converts electrical energy into mechanical energy
fan-motorMotor used with a fan to create air flow
pump-motorMotor used with a pump to move fluid
movingWalkwayConveyor to move people across a horizontal or inclined plane
fuelOil-inputEntity inputs fuel oil which flows from another entity
fuelOilHeatingHeating by the combustion of fuel oil
gasoline-inputEntity inputs gasoline which flows from another entity
hot-water-inputEntity inputs hot water which flows from another entity
hotWaterHeatingHeating using energy of hot water
makeup-water-inputEntity inputs makeup water which flows from another entity
naturalGas-inputEntity inputs natural gas which flows from another entity
naturalGasHeatingHeating by the combustion of natural gas
refrig-inputEntity inputs refrigerant which flows from another entity
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
steam-inputEntity inputs steam which flows from another entity
steamHeatingHeating using energy of steam
intensityMeasure of an electromagnetic field
isolateIsolate this node from making inbound requests
isolationActuator used to isolate an equipment from a pipe or ductwork system
knxConnMarker tag for the KNX connector record which stores the connectivity configuration used to access a KNX access point
knxDeviceMarker tag on records that represent a physical KNX device
knxRouterWhen present on a knxConn, the watchdog will ping router devices (detected from the ETS project file) first and skip bus device checks if the router is unreachable
knxWatchdogEnabledEnable periodic KNX device connectivity watchdog polling
kpiMarker tag to indicate a KPI dict
lightingSystems associated with illumination in the built environment
lineAvgLine average of single-phase electrical quantity measurements in an AC electric power system
loadChiller point to command or measure the chiller's load as a percentage from "0%" to "100%"
luminousRelating to light as perceived by the eye
magnitudeSize or extent
makeupRestore something missed or lost
mandatoryRequires that the marker be applied to dicts which use the marker's subtypes
maxMaximum
mechAssociated with a machine or its mechanical force, torque, power, or energy
metricUnitsAdd this tag to the WeatherExt rec to force all units in forecast and history syncs to be in metric system (degrees C)
minMinimum
mixingThree way valve which inputs two pipes and outputs a mixture between the two to a single output pipe
mobileRelating to mobile phones, hand-held computers, and similar technology
multiIndicates multiple selection
multiLineIndicates that a multi-line text input should be used
navClusterSelect from all the nodes in the cluster
navHiddenHide an entity in the navigation selection pickers
navSelAnySelect any level of a navigation tree which might include groupings
navSelAnyRecSelect any level of a navigation tree which maps to Folio record
netDifference between import and export
networkingRelated to data communication networks
neutralwhen applied to a point entity that has the elec and current tags, indicates electrical current being measured on an electrical neutral conductor
noDocDocumentation Ignore Tag
noSideEffectsMarks a function or operation as having no side effects
noSkyarcMarks a Haxall library as not runnable on SkySpark enabled products
nodocUndocumented and not officially supported
nosrcDo not include source code in documentation
notInheritedMarker applied to a def to indicate that is not inherited into subtype definitions
obsAddOnInitFire add event for all existing records in data set on initialization
obsAddsProcess when a new data item is added to the observed data set
obsRemovesProcess when an existing data item is removed from the observed data set
obsUpdatesProcess when an existing data item is updated in the observed data set
observableObservable subscription - see docs
obsEventsSubscribe to event creation - see docs
obsMqttSubscribe to MQTT connector published messages
obsRecsBase class for observables on database records
obsArcsSubscribe to arc document changes - see docs
obsCommitsSubscribe to record commits in Folio - see docs
obsCurValsSubscribe to transient commits of curVal or curStatus - see docs
obsHisWritesSubscribe to history data updates- see docs
obsPointWritesSubscribe to writable point priority array updates - see docs
obsWatchesSubscribe to watch and unwatch events - see docs
obsScheduleSubscribe to scheduled timer event - see docs
obsSparksSubscribe to rule engine sparks - see docs
obsoleteMarks a function as obsolete and that it needs to be reviewed before removal
occOccupied mode of a space
occupancyNumber of occupants in a space
occupantsPeople who use the built environment
occupiedSetpoint or sensor indicating occupancy of a space
openEnumApply to str enum tags where the enumeration range is open ended
optionalNot required
outdoorUnitoperates outside the conditioned space
outputEntity outputs a substance with flows to other entities
air-outputEntity outputs air to other entities
airHandlingEquipHVAC equipment that conditions and delivers air via one or more fans
ahuAir Handling Unit
doasDedicated Outside Air System
mauMakeup Air Unit
rtuRoof Top Unit
fcuFan Coil Unit
cracComputer Room Air Conditioner
unitVentUnit Ventilator
vrf-indoorUnit-fcuIndoor unit fan coil unit in a VRF system
airTerminalUnitEquipment in air distribution systems which terminate at the space
cavConstant air volume terminal unit
vavVariable air volume terminal unit
blowdown-water-outputEntity outputs blowdown water to other entities
chilled-water-outputEntity outputs chilled water to other entities
chilled-water-plantPlant used to generate chilled water for cooling
condensate-outputEntity outputs condensate to other entities
condenser-water-outputEntity outputs condenser water to other entities
domestic-water-outputEntity outputs domestic water to other entities
elec-outputEntity outputs electricity to other entities
batteryEquipment used to store electric energy
circuitElectrical circuit and its associated components such as breakers
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
elec-panelPhysical housing for electrical circuits, fuses, and breakers
evse-equipEquipment that supports the delivery of electricity to charging inlets located on EVs
evse-cableThe electrical cable between an evse-port and an EV charging inlet on a vehicle
evse-dispenserEquipment that dispenses electricity to an EV
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
evse-powerConverterA power converter that has a dc electrical output applied to a dc-evse-port
fuelOil-outputEntity outputs fuel oil to other entities
gasoline-outputEntity outputs gasoline to other entities
hot-water-outputEntity outputs hot water to other entities
hot-water-boilerBoiler which outputs hot water
hot-water-plantPlant used to generate hot water for heating
makeup-water-outputEntity outputs makeup water to other entities
naturalGas-outputEntity outputs natural gas to other entities
refrig-outputEntity outputs refrigerant to other entities
vrf-outdoorUnitOutdoor unit with one or more compressors in a VRF system
vrf-refrig-plantGroup of outdoor units in a VRF system
steam-outputEntity outputs steam to other entities
steam-boilerBoiler which outputs steam
steam-plantPlant used to generate steam for heating
overridableApplied to an ext function to enable override by project record functions
parallelCircuit with multiple paths of flow
perimeterHeatAuxiliary heating points associated with a vav
phaseAvgPhase average of single-phase electrical quantity measurements in an AC electric power system
phenomenonAspect of scientific interest with measurable quantities
elecAssociated with electricity or with electrical force, power, or energy
ac-elecAlternating current electricity
dc-elecDirect current electricity
lightElectromagnetic radiation in the visible spectrum
solarRelating to energy from the sun
substanceMatter in one the three states solid, liquid, or gas
biomassPlant or animal material used as fuel to produce electricity or heat
fluidLiquid or gas
gasSubstance with neither definite volume nor shape
airThe mixture of gases which surrounds the earth
ch2oFormaldehyde (CH₂O)
ch4Methane (CH₄)
coCarbon monoxide (CO)
co2Carbon dioxide (CO₂)
hfcHydrofluorocarbons
n2oNitrous oxide (N₂O)
naturalGasFossil fuel energy source consisting largely of methane and other hydrocarbons
nf3Nitrogen trifluoride (NF₃)
nh3Ammonia (NH₃)
no2Nitrogen dioxide (NO₂)
o2Oxygen (O₂) - the common dioxygen allotrope in the air
o3Ozone (O₃)
pfcPerfluorocarbons
propaneBy-product of natural gas processing and petroleum refining (C₃H₈)
sf6Sulphur hexafluoride (SF₆)
steamWater in its gas form
tvocTotal volatile organic compound (TVOC)
liquidSubstance with definite volume but takes the shape of its container
condensateLiquid phase produced by the condensation of steam or other gas
dieselLiquid fuel specifically designed for use in diesel engines
fuelOilPetroleum based oil burned for energy
gasolinePetroleum derived liquid used as a fuel source
waterWater in its liquid form
blowdown-waterWater expelled from a system to remove mineral build up
chilled-waterWater cooled for use in HVAC and industrial processes
cold-waterWater supplied to cold taps
condenser-waterWater used used to remove heat through condensation
cool-waterRelatively cool water without active chilling
domestic-waterTap water for drinking, washing, cooking, and flushing of toilets
ground-waterWater present under the ground or from a well
hot-waterHot water used for HVAC heating or supplied to hot taps
makeup-waterWater used used to makeup water loss through leaks, evaporation, or blowdown
purge-waterWater expelled from a system to remove contaminants
warm-waterRelatively warm water without active heating
refrigFluid used in refrigeration and heat exchange
solidSubstance with definite shape and volume
coalCombustible sedimentary rock
iceWater in its solid form
pm01Particulate matter 0.1
pm10Particulate matter 10
pm25Particulate matter 2.5
weatherAssociated with atmospheric air or phenomenon
windFlow of air on surface of the Earth
polyStats
pooUseless
portA gateway or opening used to transfer a substance
powerConverterConverts one electrical waveform to another using power electronic circuitry
privateMarks the function as private
processIndustrial or HVAC process
protocolCommunication protocol used for devices on a network
bacnetASHRAE building automation and control protocol
bluetoothShort range wireless communication protocol
coapConstrained Application Protocol
daliDigital Addressable Lighting Interface protocol for lighting
ftpFile Transfer Protocol
haystackHaystack HTTP protocol for exchanging tagged data
httpHypertext Transfer Protocol which is foundation of the web
imapInternet Message Access Protocol for retrieving email
knxKNX protocol commonly used for lighting systems
modbusRegister based communication protocol used with industrial devices
mqttMessage Queuing Telemetry Transport publish/subscribe protocol
obixXML based Open Building Information eXchange protocol
pop3Post Office Protocol version 3 for retrieving email
smtpSimple Mail Transfer Protocol for sending email
snmpSimple Network Management Protocol for managing IP devices
soxSedona Framework UDP based communication protocol
zigbeeLow power wireless communication protocol for home automation
zwaveLow power wireless communication protocol for home automation
pumpPump equipment or control point
purgeAssociated with a cleaning process to remove contaminants
qualityQuantity measured against standard metric
quantityMeasurable property of a substance or phenomenon
air-velocityRate of air movement as distance over time
apparent-energyApparent energy in an AC eletrical power system
apparent-powerApparent power
cloudagePercentage of sky obscured by clouds
concentrationAbundance of substance in the total volume of a mixture
airQualityConcentration of contaminants in the air
ch2o-concentrationConcentration of formaldehyde (CH₂O) in the air
co-concentrationConcentration of carbon monoxide (CO) in the air
co2-concentrationConcentration of carbon dioxide (CO₂) in the air
nh3-concentrationConcentration of ammonia (NH₃) in the air
no2-concentrationConcentration of nitrogen dioxide (NO₂) in the air
o3-concentrationConcentration of ozone (O₃) in the air
pm01-concentrationConcentration of particulate matter 0.1 in the air
pm10-concentrationConcentration of particulate matter 10 in the air
pm25-concentrationConcentration of particulate matter 2.5 in the air
tvoc-concentrationConcentration of total volatile organic compounds (TVOC) in the air
current-angleAC current phase angle
current-imbalanceAC current phase imbalance
current-thdTotal harmonic distortion (THD) of AC current
daytimeTime between sunrise and sunset
dewPointDew point temperature at which water vapor will form dew
directionCompass direction measured in degrees
wind-directionCompass direction from which wind originates
elec-currentElectrical current
current-magnitudeRoot-mean-square (RMS) magnitude of AC electrical current
elec-voltElectrical voltage, potential difference
volt-magnitudeRoot-mean-square (RMS) magnitude of AC electrical voltage
emissionAmount of a substance discharged into the air
ch4-emissionGreenhouse gas emission of methane (CH₄) into the air
co2-emissionGreenhouse gas emission of carbon dioxide (CO₂) into the air
hfc-emissionGreenhouse gas emission of hydrofluorocarbons into the air
n2o-emissionGreenhouse gas emission of nitrous oxide (N₂O) into the air
nf3-emissionGreenhouse gas emission of nitrogen trifluoride (NF₃) into the air
pfc-emissionGreenhouse gas emission of perfluorocarbons into the air
sf6-emissionGreenhouse gas emission of sulphur hexafluoride (SF₆) into the air
energyMeasure of ability to do work
elec-energyElectrical energy
active-energyActive energy in an AC eletrical power system
enthalpyTotal heat content of a system
feelsLikeApparent temperature perceived when considering humidity, wind chill, and heat index
flowMeasure of volumetric flow of fluid
freqOccurrences per unit time
ac-freqFrequency of an alternating current waveform
humidityPercent relative humidity
illuminanceLuminous flux hitting the inside of the sphere at a specific point
irradianceEnergy received at a surface by area
solar-irradianceEnergy received on surface of the earth from the sun
levelRange from 0% to 100%
light-levelSensed or controlled dimming level of electrical lighting
luminanceEnergy of light in a given direction
luminous-fluxTotal perceived light in all directions
luminous-intensityPerceived light in a particular direction per unit solid angle
pfElectric power factor
powerEnergy consumed per unit time
elec-powerRate of electrical energy transfer
active-powerActive power or real power
elec-demandActive power averaged over a regular interval
precipitationAmount of atmospheric water vapor fallen including rain, sleet, snow, and hail
pressureMeasure of force applied
atmospheric-pressureBarometric pressure exerted by the weight of the atmosphere
reactive-energyReactive energy in an AC eletrical power system
reactive-powerReactive power or imaginary power
speedDistance per unit time
wind-speedWind flow speed
stateOfChargeState of charge (SoC) of an electric battery
tempTemperature - measure of hot and cold
air-tempDry bulb temperature
vfd-freqVFD frequency measured in "Hz"
vfd-speedVFD speed measured in "%"
visibilityDistance at which light can be clearly discerned
volt-angleAC voltage phase angle
volt-imbalanceAC voltage phase imbalance
volt-thdTotal harmonic distortion (THD) of AC voltage
volumeThree dimensional space occupied by a substance
weatherCondEnumeration of weather conditions
wetBulbWet bulb air temperature
ratedData specified by a manufacturer or rating organization
reactiveRelating to reactance
readonlyIndicates a value which may be read, but not written
reciprocalPiston compressor driven by a crankshaft
chiller-reciprocalPiston compressor driven by a crankshaft
refreshIndicates an operation which requires a page refresh
reheatCommand point for reheating process
relationshipFuncIndentifies functions that hold pre-configured relationships
relationshipTreeRelated to dbAddEdit
removeTagsA comma separated list of tags to be removed from records
reportCanSaveEnables an operator user to save reports to the database
restartIndicates a setting which requires restart when modified
roofEnvelope covering the top of a building
rotaryScrewRotary screw compression
chiller-rotaryScrewRotary screw compression
routerDevice used to route data packets
runPrimary on/off point of an equip especially used with a vfd
savedQueryFilterTreeRelated to dbAddEdit
scheduleConfigThis tag identifies a tag bundle as a schedule configuration
selectUsed on an action to use current selection
seriesCircuit with single path of flow
serverHardware or software which provides services for other programs or devices
serviceFactorRatio 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
showDisShow display names in UI instead of programmatic names
sitePointMarker tag applied to a point to indicate the point is site-wide
sparkMarker tag to indicate a spark dict
standbyReadiness mode of a space
suRequires superuser permission
subterraneanBelow the surface of the earth
summs
switchDevice for toggling state or routing data
tagBundleThis tag identifies records as tag bundles
tagBundleFuncIndentifies functions that hold pre-configured tag bundles
tagBundleTreeRelated to dbAddEdit
templateTreeRelated to dbAddEdit
thdTotal harmonic distortion
thermalRelated to energy of heat
timezDefinition of a timezone function
topics
totalComplete or absolute
trackBundleThis tag indicates records should keep track of when this tag bundle is applied to them
transientIndicates a value tag which should not be persisted
transitiveThis marker is applied to a relationship to indicate it is transitive
trashMarks a record for deletion
uiMetaSingleton used to configure project level user interface settings
unitlessHide the unit picker for a number field
unoccUnoccupied mode of a space
update
userLockOutIndicates the user is locked out because of too many failed login attempts
valveValve equipment or control point
velocitySpeed in a given direction
vfdVariable-frequency drive
voltElectrical potential difference or electromotive force
vrfVariable refigerant flow
warmRelatively warm in comparison to another substance, without being actively heated
weatherAutoSyncForecastApplied to a weatherStation to indicate that the weather forecast should be automatically synchronized using built-in weather subscription
weatherAutoSyncHisApplied to a weatherStation to indicate that point histories should automatically be synchronized with built-in weather subscription
writableSupports writing data
writeOnOpenIssue a write every time the connector transitions from open to closed
writeOnStartIssue a write when the system first starts up
zoneRelated to spaces from a system perspective


def ​

max ​

Maximum


meta ​

defmax
ismarker
liblib:ph

supertypes ​

markerMarker labels a dict with typing information


def ​

maxVal ​

Inclusive maximum for a numeric value.


meta ​

defmaxVal
isnumber
liblib:ph
tagOndef, point

supertypes ​

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


def ​

mime ​

Mime type formatted as type/subtype


meta ​

defmime
isstr
liblib:ph
tagOnfiletype

supertypes ​

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


def ​

min ​

Minimum


meta ​

defmin
ismarker
liblib:ph

supertypes ​

markerMarker labels a dict with typing information


def ​

minVal ​

Inclusive minimum for a numeric value.


meta ​

defminVal
isnumber
liblib:ph
tagOndef, point

supertypes ​

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


def ​

na ​

Not available used to indicate invalid or missing data. See Kinds chapter.


meta ​

defna
isscalar
liblib:ph

supertypes ​

valData value type
scalarScalar is an atomic value kind


def ​

noSideEffects ​

Marks a function or operation as having no side effects. The function may or may not be pure in that calling it multiple times with the same arguments always evaluates to the same result.


meta ​

defnoSideEffects
ismarker
liblib:ph
wikipediahttps://en.wikipedia.org/wiki/Side_effect_(computer_science)

supertypes ​

markerMarker labels a dict with typing information


def ​

nodoc ​

Undocumented and not officially supported


meta ​

defnodoc
ismarker
liblib:ph

supertypes ​

markerMarker labels a dict with typing information


def ​

nosrc ​

Do not include source code in documentation


meta ​

defnosrc
ismarker
liblib:ph

supertypes ​

markerMarker labels a dict with typing information


def ​

notInherited ​

Marker applied to a def to indicate that is not inherited into subtype definitions.


meta ​

defnotInherited
ismarker
liblib:ph
tagOndef

supertypes ​

markerMarker labels a dict with typing information


def ​

number ​

Integer or floating point numbers annotated with an optional unit. See Kinds chapter.


meta ​

defnumber
isscalar
liblib:ph

supertypes ​

valData value type
scalarScalar is an atomic value kind

subtypes ​

areaArea of a shape or floor space
bacnetAlarmPidIt specifies the connector will only handle alarms associated with that process identifier
bacnetCovResubscribeTimeoutApplied to ConnTuning specifies when the COV re-subscribe should be performed for points that failed to be subscribed
bacnetCovTimeoutApplied to ConnTuning to specify the lifetime for a COV subscription sent to the device
bacnetInstanceApplied to bacnetDevice it specifies what device instance number is used when the connector is in COV mode, the default instance number randomly picked between 50000 and 200000
bacnetServerCovIncrementNumeric tag that sets the delta threshold for when a COV notification should be send
bacnetServerInstanceApplied to a bacnetDevice to export it as an BACnet device
bacnetServerMacAddressApplied to a bacnetServerDevice assigns an unique mac address to this device
bacnetServerNetworkApplied to a bacnetServer ext record assigns an unique BACnet network number to the current project the extension is enabled in
bacnetServerRefreshIntervalNumeric tag that says how often the BACnet server will rescan equipments on the current project
bacnetWriteLevelNumber between 1 and 17 used with bacnetWriteLevel to determine which priority level of the remote system is written to
chartHeightFixes the height of a chart plot
chartMaxDefine explicit max value for series axis
chartMinDefine explicit min value for series axis
coolingCapacityMeasurement of a chiller ability to remove heat measured
curCalibrationCalibration value to apply to adjust the value read from the connector before updating curVal
durationNumber with a unit of time
actorTimeoutTimeout for messages send to the connector's actor thread
arcbeamMinEventTimeApplied to arcbeamConn to tune how fast the server should send current value updates
bacnetInitIntervalApplied to ConnTuning to tune the duration between driver re-initialization
bacnetScheduleReadFreqThis tag denotes the frequency duration at which schedule read sync will occur
connLingerLinger timeout used to keep a connector open
connOpenRetryFreqDuration used for connector open retries
connPingFreqDuration used to configure the auto-ping feature on a given connector
durTotal duration of the spark periods measured in hours
haystackPollFreqApplied to haystackConn to tune the duration between watch polls
hisAppendNASpecifies the amount of time after a history point's hisEnd that the hisRead() function should append an NA
hisCollectCovRateLimitRate limits the frequency for hisCollectCov
hisCollectIntervalEnables interval history collection of the curVal
hisCollectWriteFreqThis tag configures how long to buffer collected history items in memory before flushing them to the historian
hisIntervalThe interval at which sampled or consumption data is collected
hisRollupAutoMinIntervalForces hisRollupAuto() to do a rollup using this interval when none is specified and the range of the source history grid is less than 2 days
hisRollupIntervalIndicates the roll-up interval in his grid column meta-data
hisTsPrecisionControls the precision used to store timetamps in the historian
modbusReadTimeoutHow long to wait before timing out on a modbus read
modbusWriteTimeoutHow long to wait before timing out on a modbus write
mqttRetryIntervalHow long to wait between retries for messages that require acknowlegment
obixPollFreqDuration between obixConn watch polls
obsScheduleFreqSchedule events with given frequency
pollTimeFrequency between polls of curVal
ruleFreqExecution frequency of a curRule
staleTimeTime before a point's curStatus marked from "ok" to "stale" See Connector Tuning
steadyStateThe delay before transitioning to the steady state
timeoutMaximum elapsed time to allow an operation to continue
writeMaxTimeMaximum time between writes used to send periodic writes
writeMinTimeMinimum time between writes used to throttle the speed of writes
finBoolStatsFreqTune how often the FinWatcher computes boolean runStarts and runTime
finMailMaxMsgCountSet the maximum numbers of email records this connector can store
finMailNewMessagesShows the number of unread email
finMailPollFreqApplied to finMailConn to tune the duration between email checks
finMailTotalMessagesShows the number of email on the inbox folder
finWatcherFreqTune how often the FinWatcher looks for changes
geoElevationElevation above sea-level of the location
hisCollectCovEnables COV history collection of the curVal
hisTotalizedRolloverDefines the rollover value for a totalized history - see totalized
intUnitless integer number
arcbeamWriteLevelNumber between 1 and 16 used with arcbeamWrite to determine which priority level of the remote system is written to
floorNumUnitless integer indicating the floor's distance from ground level
haystackWriteLevelNumber between 1 and 16 used with haystackWrite to determine which priority level of the remote system is written to
hisSizeApproximate number of timestamp/value pairs stored in history
modbusBlockGapApplied to modbusConn to allow for gaps in block reads
modbusBlockMaxApplied to modbusConn to limit the maximum number of registers to read in a block read
modbusSlaveApplied to modbusConn to identify the slave address on this modbus network
mqttMaxRetryHow many times to retry sending messages that require acknowlegment
obixWritableServer export of a writable point as an obix:Writable:Point
obixWriteLevelNumber between 1 and 16 used with obixWrite to determine which priority level of the remote system is written to
schedulableBinds a schedule to a writable point
stageStage number of staged equipment operation such as coil or pump
writeLevelCurrent priority level for writeVal as number between 1 and 17
yearBuiltOriginal year of construction as four digit year such as 1980
knxWatchdogFreqKNX watchdog polling interval
maxValInclusive maximum for a numeric value
minValInclusive minimum for a numeric value
mqttQosMQTT Quality of Service (QoS) - 0 - At most once (fire-and-forget) - 1 - At least once - 2 - Exactly once
opacityAlpha transparency for colors as number between 0.0 (transparent) to 1.0 (completely opaque)
orderUsed to order definitions
percentageA percentage specified as as <percent> * 100
strokeWidthStroke width for rendering lines
tariffContractMinThe minimum contractual demand necessary for this charge to apply
tariffFeeA fixed numeric fee for the charge
tariffRatchetPercentageThe peak demand identified during the ratchet period will be multiplied by this percentage to obtain the minimum peak demand
userFailedLoginsHow many failed login attempts the user has made since last successful login


def ​

of ​

Expected value type of a collection, reference, or choice


meta ​

defof
issymbol
liblib:ph
tagOndef
uiInputuiDev::SymbolInput

supertypes ​

valData value type
scalarScalar is an atomic value kind
symbolSymbol to a def


def ​

op ​

Operation for HTTP API. See Ops chapter.


meta ​

defop
isfeature
liblib:ph

supertypes ​

featureFeature namespace of definitions formatted as feature:name


def ​

openEnum ​

Apply to str enum tags where the enumeration range is open ended. User interfaces should support data entry for arbitrary strings, but also provide a dropdown for the predefined enumeration.


meta ​

defopenEnum
ismarker
liblib:ph

supertypes ​

markerMarker labels a dict with typing information


def ​

op:about ​

Query basic information about the server. See Ops chapter.


meta ​

defop:about
isop
liblib:ph
noSideEffects✓

supertypes ​

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


def ​

op:close ​

Close the current session and cancel the auth bearer token. See Ops chapter.


meta ​

defop:close
isop
liblib:ph

supertypes ​

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


def ​

op:defs ​

Query the definitions in the current namespace. See Ops chapter.


meta ​

defop:defs
isop
liblib:ph
noSideEffects✓

supertypes ​

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


def ​

op:filetypes ​

Query the filetype defs in the current namespace. See Ops chapter.


meta ​

defop:filetypes
isop
liblib:ph
noSideEffects✓

supertypes ​

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


def ​

op:libs ​

Query the lib defs in the current namespace. See Ops chapter.


meta ​

defop:libs
isop
liblib:ph
noSideEffects✓

supertypes ​

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


def ​

op:nav ​

Query the navigation tree for discovery. See Ops chapter.


meta ​

defop:nav
isop
liblib:ph
noSideEffects✓

supertypes ​

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


def ​

op:ops ​

Query the op defs in the current namespace. See Ops chapter.


meta ​

defop:ops
isop
liblib:ph
noSideEffects✓

supertypes ​

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


def ​

op:read ​

Query the a set of entity records by id or by filter. See Ops chapter.


meta ​

defop:read
isop
liblib:ph
noSideEffects✓

supertypes ​

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


def ​

op:watchPoll ​

Poll a watch subscription. See Ops chapter.


meta ​

defop:watchPoll
isop
liblib:ph

supertypes ​

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