Building system with a building graph
A building energy management includes building equipment, one or more data platform services, a timeseries database, and an energy management application. The building equipment operate to monitor and control a variable and provide raw data samples of a data point associated with the variable. The timeseries database stores a plurality of timeseries associated with the data point. The plurality of timeseries include a timeseries of the raw data samples and the one or more optimized data timeseries generated by the data platform services based on the raw data timeseries. The energy management application generates an ad hoc dashboard including a widget and associates the widget with the data point. The widget displays a graphical visualization of the plurality of timeseries associated with the data point and includes interactive user interface options for switching between the plurality of timeseries associated with the data point.
1 . A building system of a building, comprising:
one or more non-transitory storage devices having instructions stored thereon that, when executed by one or more processors, cause the one or more processors to:
cause the one or more non-transitory storage devices to store a building graph comprising a plurality of a plurality of entities representing organizations, spaces, building equipment, or points of the building and a plurality of relationships between the plurality of entities;
receive a query from a requesting system, the query comprising:
a first parameter identifying an entity type to be returned for the query, wherein the entity type is at least one of an organization, a space, building equipment, or a point; and
a second parameter identifying a specific entity, wherein the specific entity is a specific organization, space, building equipment, or point of the plurality of entities;
identify a portion of the plurality of entities that are the entity type identified by the first parameter and that are related to the specific entity of the plurality of entities by relationships of the plurality of relationships; and
return identities of the portion of the plurality of entities to the requesting system.
2 . The building system of claim 1 , wherein the instructions cause the one or more processors to:
generate a flat list for the specific entity, the flat list identifying descendants and ancestors of the specific entity; and
search the flat list using the first parameter to identify the portion of the plurality of entities.
3 . The building system of claim 1 , wherein the instructions cause the one or more processors to:
receive the query, the query requesting ancestors of the specific entity or descendants of the specific entity;
search a flat list generated from the building graph using the first parameter to identify the portion of the plurality of entities that are ancestors of the specific entity responsive to the query requesting ancestors of the specific entity; and
search the flat list using the first parameter to identify the portion of the plurality of entities that are descendants of the specific entity responsive to the query requesting descendants of the specific entity.
4 . The building system of claim 1 , wherein:
each relationship of the plurality of relationships logically defines a particular relationship between a first entity of the plurality of entities and a second entity of the plurality of entities with one or more words or phrases, the one or more words or phrases comprising a predicate.
5 . The building system of claim 1 , wherein the instructions cause the one or more processors to:
generate an energy consumption metric based on at least the identities of the portion of the plurality of entities, the energy consumption metric indicating energy consumption of the building or a portion thereof, and
cause a user interface to include an indication of the energy consumption metric and cause a user device to display the user interface.
6 . The building system of claim 1 , wherein the plurality of relationships are directional relationships representing a relationship between a first entity of the plurality of entities and a second entity of the plurality of entities.
7 . The building system of claim 1 , wherein the instructions cause the one or more processors to:
receive building data from a building data source, the building data representing one or more conditions associated with the building; and
ingest the building data into the building graph based on at least the portion of the building graph.
8 . The building system of claim 1 , wherein the one or more processors are configured to:
retrieve building data from the building graph;
generate an energy consumption metric based on the building data retrieved from the building graph and a contextual representation of the building, wherein the portion of the building graph is the contextual representation of the building; and
ingest the energy consumption metric into the building graph.
9 . The building system of claim 1 , wherein the plurality of entities of the building comprise a space entity representing a particular space of the building and a system entity representing a system of the building;
wherein the plurality of relationships comprise a particular relationship between the space entity and the system entity, the particular relationship indicating at least one of the system operating to serve the space or the space being served by the system.
10 . The building system of claim 1 , wherein one or more of the plurality of relationships are bidirectional relationships, wherein the bidirectional relationships represent a first relationship between a first entity of the plurality of entities and a second entity of the plurality of entities and a second relationship between the second entity of the plurality of entities and the first entity of the plurality of entities.
11 . The building system of claim 1 , wherein the plurality of entities comprise a point entity representing a particular point and a system entity representing a system of the building, wherein a particular relationship of the plurality of relationships indicates that the point is a particular point of the system.
12 . The building system of claim 1 , wherein the plurality of entities and the plurality of relationships represent a hierarchy of spaces, wherein a first entity of the plurality of entities represents a first space, a second entity of the plurality of entities represents a second space, and a particular relationship of the plurality of relationships between the second entity and the first entity indicates that the second space is located within the first space.
13 . The building system of claim 1 , wherein the plurality of entities and the plurality of relationships represent a hierarchy of systems, wherein a first entity of the plurality of entities represents a first system, a second entity of the plurality of entities represents a second system, and a particular relationship of the plurality of relationships between the second entity and the first entity indicate that the second system is a sub-component of the first system.
14 . A method, comprising:
causing, by one or more processing circuits, one or more non-transitory storage devices to store a building graph comprising a plurality of a plurality of entities representing organizations, spaces, building equipment, or points of the building and a plurality of relationships between the plurality of entities;
receiving, by the one or more processing circuits, a query from a requesting system, the query comprising:
a first parameter identifying an entity type to be returned for the query, wherein the entity type is at least one of an organization, a space, building equipment, or a point; and
a second parameter identifying a specific entity, wherein the specific entity is a specific organization, space, building equipment, or point of the plurality of entities;
identifying, by the one or more processing circuits, a portion of the plurality of entities that are the entity type identified by the first parameter and that are related to the specific entity of the plurality of entities by relationships of the plurality of relationships; and
returning, by the one or more processing circuits, identities of the portion of the plurality of entities to the requesting system.
15 . The method of claim 14 , comprising
generating, by the one or more processing circuits, a flat list for the specific entity, the flat list identifying descendants and ancestors of the specific entity; and
searching, by the one or more processing circuits, the flat list using the first parameter to identify the portion of the plurality of entities.
16 . The method of claim 14 , comprising:
receiving, by the one or more processing circuits, the query, the query requesting ancestors of the specific entity or descendants of the specific entity;
searching, by the one or more processing circuits, a flat list generated from the building graph using the first parameter to identify the portion of the plurality of entities that are ancestors of the specific entity responsive to the query requesting ancestors of the specific entity; and
searching, by the one or more processing circuits, the flat list using the first parameter to identify the portion of the plurality of entities that are descendants of the specific entity responsive to the query requesting descendants of the specific entity.
17 . The method of claim 14 , wherein:
each relationship of the plurality of relationships logically defines a particular relationship between a first entity of the plurality of entities and a second entity of the plurality of entities with one or more words or phrases, the one or more words or phrases comprising a predicate.
18 . The method of claim 14 , comprising:
generating, by the one or more processing circuits, an energy consumption metric based on at least the identities of the portion of the plurality of entities, the energy consumption metric indicating energy consumption of the building or a portion thereof; and
causing, by the one or more processing circuits, a user interface to include an indication of the energy consumption metric and cause a user device to display the user interface.
19 . One or more non-transitory storage devices having instructions stored thereon that, when executed by one or more processors, cause the one or more processors to perform operations comprising:
causing the one or more non-transitory storage devices to store a building graph comprising a plurality of a plurality of entities representing organizations, spaces, building equipment, or points of the building and a plurality of relationships between the plurality of entities;
receiving a query from a requesting system, the query comprising:
a first parameter identifying an entity type to be returned for the query, wherein the entity type is at least one of an organization, a space, building equipment, or a point; and
a second parameter identifying a specific entity, wherein the specific entity is a specific organization, space, building equipment, or point of the plurality of entities;
identifying a portion of the plurality of entities that are the entity type identified by the first parameter and that are related to the specific entity of the plurality of entities by relationships of the plurality of relationships; and
returning identities of the portion of the plurality of entities to the requesting system.
20 . The one or more non-transitory storage devices of claim 19 , the operations comprising:
generating a flat list for the specific entity, the flat list identifying descendants and ancestors of the specific entity; and
searching the flat list using the first parameter to identify the portion of the plurality of entities.