This is the program file of the Building Data Genome Directory, a comprehensive building dataset collection, where you can find the links for the datasets related with building energy research.
· For users:
Welcome to Building Data Genome Directory!
The Building Data Genome Directory is an open data-sharing platform (buildingdatadirectory.org/) providing essential data for building energy research. It offers valuable datasets at various spatial and temporal scales, covering meter, building-level, and community-level data. The 60 datasets were sourced from governments, research institutes, and online energy dashboards. Users can also contribute by suggesting datasets through the crowdsourcing mechanism. This directory supports research and applications for building energy efficiency, crucial for addressing global energy and environmental challenges.
The META DIRECTORY page shows the data categories included in our directory.
You can choose the desired category from the left-hand sidebar.
Or upload the dataset you want to share from the left-hand sidebar.
The sub-page of Building Energy and Water Data has filtering functions on the left-hand sidebar and visualization functions below the table.
The preprint of the paper The Building Data Genome Directory – An open, comprehensive data sharing platform for building performance research has been added to arxiv https://arxiv.org/abs/2307.00793
To cite the Building Data Genome Directory: Xiaoyu Jin et al. The Building Data Genome Directory – An open, comprehensive data sharing platform for building performance research. 2023 J. Phys.: Conf. Ser. 2600 032003. https://iopscience.iop.org/article/10.1088/1742-6596/2600/3/032003
Other relevant publications: A review and reflection on open datasets of city-level building energy use and their applications. https://10.1016/j.enbuild.2023.112911
Any questions or ideas? Join our GitHub community at building-data-directory Discussions
· For developers:
The files with the suffix of ".py" are built for the streamlit webpage, the "META_DIRECTORY.py" is the main page (i.e., the meta directory). Other files in the folder "pages" are for the sub-pages of the streamlit api.
The “Procfile” file is the instruction for running the main page. If there is any change on the main page program file name, remember to make revision on that.
If any new library is imported, please note to add "lirary_name == version" (e.g., "plotly == 5.10.0") in the "requirements.txt" file.
The media files required on the API website ("meta directory.png", "browsing.gif"), history codes and tables ("history codes", "previous lists") are also stored in this repository.