Add smart buildings dataset to tensorflow datasets.

This dataset contains 5 years of detailed telemetric readouts from 3 commercial office buildings.

PiperOrigin-RevId: 663821729

Author: The TensorFlow Datasets Authors

tensorflow_datasets/datasets/smart_buildings_dataset/CITATIONS.bib

@@ -0,0 +1 @@
+// TODO(smart_buildings_dataset): BibTeX citation

tensorflow_datasets/datasets/smart_buildings_dataset/README.md

@@ -0,0 +1,8 @@
+# Smart Buildings Dataset
+
+Dataset accompanying  the paper "Real-World Data and
+Calibrated Simulation Suite for Offline Training of
+Reinforcement Learning Agents to Optimize Energy and
+Emission in Office Buildings" by Judah Goldfeder and
+John Sipple, containing 6 years of detailed telemetric
+readouts from 3 commercial office buildings.

tensorflow_datasets/datasets/smart_buildings_dataset/TAGS.txt

@@ -0,0 +1,4 @@
+content.subject.computer-science # Relates to computer science.
+ml.task.reinforcement-learning # Relates to Reinforcement Learning (RL), a machine learning task.
+ml.task.sequence-modeling # Relates to Sequence Modeling, a machine learning task.
+content.data-type.time-series # Contains time-series data.

tensorflow_datasets/datasets/smart_buildings_dataset/__init__.py

@@ -0,0 +1,15 @@
+# coding=utf-8
+# Copyright 2024 The TensorFlow Datasets Authors.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+

tensorflow_datasets/datasets/smart_buildings_dataset/checksums.tsv

@@ -0,0 +1,6 @@
+https://storage.googleapis.com/gresearch/smart_buildings_dataset/SB1/SB1_19.zip	2265305448	10efa1145a9126fe40dc83ce39772956ef84a9510b0e01eea15ccf4fae155e5c	SB1_19.zip
+https://storage.googleapis.com/gresearch/smart_buildings_dataset/SB1/SB1_20.zip	2476964097	97c84576f957342d4e035533f211de06d1db806a16fca4071a8706eb3df62f99	SB1_20.zip
+https://storage.googleapis.com/gresearch/smart_buildings_dataset/SB1/SB1_21.zip	2385775843	cc3d4d142905e85406d8ad3fcf236e1cab79e5aaedbd830e047d7237fcf3f548	SB1_21.zip
+https://storage.googleapis.com/gresearch/smart_buildings_dataset/SB1/SB1_22.zip	1230285617	05d6757d63eedd7b4982294349b5728ca695c2b642c6f2568f4ed6426f66fa78	SB1_22.zip
+https://storage.googleapis.com/gresearch/smart_buildings_dataset/SB1/SB1_23.zip	2336317853	141ab72d6d2cd26fb763923fea566e50b3a40247f8746faa541e84eab5104522	SB1_23.zip
+https://storage.googleapis.com/gresearch/smart_buildings_dataset/SB1/SB1_24.zip	1101367620	b6d343bff8779f7cb32b9e73d10e7521cacd1ec9b885a9c71a5f7c8f19dd6799	SB1_24.zip

tensorflow_datasets/datasets/smart_buildings_dataset/constants.py

@@ -0,0 +1,72 @@
+# coding=utf-8
+# Copyright 2024 The TensorFlow Datasets Authors.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Single location for all constants related to the simulation and RL environment.
+
+Copyright 2022 Google LLC
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    https://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+"""
+
+# --------- Thermal Constants ---------------
+
+AIR_HEAT_CAPACITY = 1006.0  # J/kg/K, standard atmosphere
+WATER_HEAT_CAPACITY = 4180.0  # J/kg/K
+WATER_VAPOR_HEAT_CAPACITY = 1863.8  # J/kg/K
+
+# --------- Energy Constants ---------------
+BTU_PER_KWH: float = 3412.4
+JOULES_PER_KWH: float = 3.6e6
+JOULES_PER_BTU: float = 1055.06
+W_PER_KW: float = 1000.0  # Number of Watts in a kW.
+WATTS_PER_BTU_HR: float = 0.29307107  # Number of Watts in a BTU/hr
+HZ_PERCENT: float = 100.0 / 60.0  # Converts blower/pump Hz to Percentage Power
+
+# https://www.rapidtables.com/convert/power/hp-to-watt.html
+WATTS_PER_HORSEPOWER = 746.0
+
+# Natural gas energy conversion.
+# Sources:
+# http://www.kylesconverter.com/energy,-work,-and-heat/kilowatt--hours-to-cubic-feet-of-natural-gas#293.07
+# https://www.traditionaloven.com/tutorials/energy/convert-cubic-foot-natural-gas-to-kilo-watt-hr-kwh.html
+KWH_PER_KFT3_GAS = 293.07107  # kWh / 1000 cubic feet natural gas
+
+# Natural gas CO2 emission.
+# Source: https://www.eia.gov/environment/emissions/co2_vol_mass.php
+GAS_CO2 = 53.12  # kg/1000 cubic feet
+
+WATER_DENSITY = 1000.0  # kg/m3
+GRAVITY = 9.8  # m/s2
+
+# ------------ File Name Convention -----------------
+NORMALIZATION_FILENAME = 'normalization_info'
+OBSERVATION_RESPONSE_FILE_PREFIX = 'observation_response'
+ACTION_RESPONSE_FILE_PREFIX = 'action_response'
+IMAGES_DIR = 'images'
+BUILDING_IMAGE_CSV_FILE = 'building_images.csv'
+REWARD_INFO_PREFIX = 'reward_info'
+REWARD_RESPONSE_PREFIX = 'reward_response'
+DEVICE_INFO_PREFIX = 'device_info'
+ZONE_INFO_PREFIX = 'zone_info'