Skip to content
An open source Python server to deploy energy management solutions for buildings
Python Other
  1. Python 99.9%
  2. Other 0.1%
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
bemserver Fix versions and update INSTALL.md Sep 12, 2019
docs Fix install - set correct versions on libraries and add a configurati… Aug 30, 2019
migrations Initial commit Jul 16, 2019
tests Fix versions and update INSTALL.md Sep 12, 2019
.flaskenv Remove all references to the Hit2gap project; adpat calls to the onto… Jul 29, 2019
.gitignore Initial commit Jul 16, 2019
.gitmodules
.pylintrc Initial commit Jul 16, 2019
CONTRIBUTING.md Remove all references to the Hit2gap project; adpat calls to the onto… Jul 29, 2019
INSTALL.md INSTALL.md update code blocks display on shell Sep 12, 2019
LICENSE Remove all references to the Hit2gap project; adpat calls to the onto… Jul 29, 2019
README.md Add links to installation and contribution Aug 8, 2019
dev-requirements.txt Initial commit Jul 16, 2019
requirements.txt Initial commit Jul 16, 2019
setup.py Fix versions and update INSTALL.md Sep 12, 2019
tox.ini Remove all references to the Hit2gap project; adpat calls to the onto… Jul 29, 2019
tox_install_ifcopenshell.sh Initial commit Jul 16, 2019

README.md

BEMServer

drawing

Table of Contents

  1. Description
    1. Technologies used
    2. Installation
  2. User guidelines
  3. Developer guidelines
  4. Related work

Description

BEMServer is an open source platform to ease the deployment of energy management software in monitored buildings.

Based on standard technologies (REST APIs, formal ontologies...) it is a Python software that is used to

  • collect data from buildings. Data are currently pushed to BEMServer through a specific REST API. Therefore, for smart meters, adapters need to be developed to connect the meters to BEMServer. For BMS, specific adapters need to be developed, or a third-party solution need to be used to collect data from proprietary protocols (KNX, BACNet...)
  • agregate data collected. Data in buildings are heterogeneous by nature, and come from a variety of sources (meters, sensors, but also human interactions, building descriptions, IFC files...). To ease data access, all data need first to be aggregated and aligned according to a specific model. We use our specific BEMOnt formal ontology to do so.
  • preprocess data. Data from sensors may not be as reliable as expected. In BEMServer we are continuously developing new algorithms to facilitate data access for software developers: data cleansing to avoid blanks and outliers, unit conversion, airhtmetic operations... are at the disposal to get the data as you need them.
  • present data. Through its REST APIs, data are exposed in a standard way to thrid-party developers.

Technologies used

BEMServer is a Python-based software. As a server is it developed using the flask library.

Additionally, its storage system uses 3 different technologies:

  • Apache Jena to store the metadata (i.e. data used to describe all relevant information, from the building, to the measures made by a sensor)
  • HDF5 file format to store timeseries, which are a big part of the data stored, coming from sensors and meters.
  • SQLite to store events. An event is typically generated by a service connected to BEMServer, and can be an alert (e.g. an abnormal energy consumption), or an advice (e.g. potential for energy saving).

Installation

Follow the guideline in INSTALL.md.

User guidelines

BEMServer is mainly dedicated to people and company who want to develop smart energy services for building. As such, it was already used as the support for load forecasting, fault detection and diagnosis, or confort simulation tools. In brief, BEMServer is a tool to be used for domain expert and software developers who do not want to become experts on how to collect data and access them.

In order to install BEMServer, please check the INSTALL.md file. Once up and running, simply use the online REST APIs to interact with your BEMServer instance.

Developer guidelines

Want to be part of the developing team? Want to contribute to the project and join effort in providing the community with an open source tool to deploy energy management softwares? Then, just download the project, fork it, start developing and make a pull request.

Also check the CONTRIBUTING.md file.

Related work

Also, see the presentation on slideShare

You can’t perform that action at this time.