Synthetic Indoor Climate and Occupancy Data from Office and Meeting Room Simulations
<p>This is the dataset used for the publication "Coddora: CO2-based Occupancy Detection model<br>trained via DOmain RAndomization". The goal is to provide training data for occupancy detection.<br><br>The dataset contains one million days of data including 10 occupied days for each of 100,000 randomized room models (50,000 rooms considering office activity and 50,000 meeting room activity). Data were generated in EnergyPlus simulations according to the methodology described in the paper.<br><br>When using the dataset, please cite:</p> <blockquote> <p><em>Manuel Weber, Farzan Banihashemi, Davor Stjelja, Peter Mandl, Ruben Mayer, and Hans-Arno Jacobsen. 2024. Coddora: CO2-Based Occupancy Detection Model Trained via Domain Randomization. In International Joint Conference on Neural Networks (IJCNN). June 30 - July 5, 2024, Yokohama, Japan.</em></p> </blockquote> <h2>Dataset Structure</h2> <p>The following files are provided:<br><br> 1. dataset_office_rooms.h5 (provided as zip file)<br> 2. dataset_meeting_rooms.h5 (provided as zip file)<br> 3. simulated_occupancy_office_rooms.csv<br> 4. simulated_occupancy_meeting_rooms.csv</p> <p>Please use an archiving tool such as 7zip to unzip the hdf5 files.<br>Both hdf5 files contain two datasets with the following keys:<br><br> 1. "<em>data</em>": contains the simulated indoor climate and occupancy data<br> 2. "metadata": contains the metadata that were used for each simulation</p> <p>The csv files contain the time series of occupancy that were used for the simulations.<br><br></p> <h2>Data</h2> <p><em>Data</em> includes the following fields:</p> <p><em>Datetime:</em> day of the year (may be relevant due to seasonal differences) and time of the day<br><em>Zone Air CO2 Concentration:</em> CO2 level in ppm<br><em>Zone Mean Air Temperature:</em> temperature in °C<br><em>Zone Air Relative Humidity: </em>relative humidity in %<br><em>Occupancy: </em>level of occupancy relative to the maximum capacity of the room (in the range [0-1])<br><em>Ventilation:</em> fraction of window opening in the range [0.01, 1]<br><em>SimID:</em> foreign key to reference the room properties the simulation was based on<br><em>BinaryOccupancy:</em> 0 or 1 denoting absence or presence (for binary classification)</p> <p> </p> <p>Example row:</p> <table> <tbody> <tr> <th><em>Datetime</em></th> <th><em>Zone Air CO2 Concentration</em></th> <th><em>Zone Mean Air Temperature</em></th> <th><em>Zone Air Relative Humidity</em></th> <th><em>Occupancy</em></th> <th><em>Ventilation</em></th> <th><em>simID</em></th> <th><em>BinaryOccupancy</em></th> </tr> <tr> <td> <p>10/09 11:21:00</p> </td> <td> <p>1084.5624647371608</p> </td> <td> <p>24.545635909907148</p> </td> <td> <p>41.18393114737054</p> </td> <td> <p>0.7</p> </td> <td> <p>0.0</p> </td> <td>99</td> <td>1</td> </tr> </tbody> </table> <pre> </pre> <h2>Metadata</h2> <p><em>Metadata</em> includes the following fields. <br>Underscores denote that the field was not selected during randomization but calculated from the other values.</p> <p>width: room width in m<br>length: room length in m<br>height: hoom height in m<br>infiltration: infiltration per exterior area in m³/m²s<br>outdoor_co2: co2 concentration in the outdoor air in ppm (set to a random value between [300, 500])<br>orientation: angle between the room's facade orientation and the north direction in degrees<br>maxOccupants: room occupation limit, i.e. the maximum number of occupants<br>_floorArea: floor area in m² (calculated from room dimensions)<br>_volume: room volume in m³ (calculated from room dimensions)<br>_exteriorSurfaceArea: surface area of the facade wall (calculated from room dimensions)<br>_winToFloorRatio: ratio between total window area and floor area (calculated from room model)<br>firstDayUsedOfOccupancySequence: selected starting day in the sequence of occupancy data for rooms with the respective maxOccupants value<br>simID: unique identifier of the simulation to relate between simulation metadata and resulting simulated data</p> <p> </p> <p>Example row:</p> <table> <tbody> <tr> <th>width</th> <th>length</th> <th>height</th> <th>infiltration</th> <th>outdoor_co2</th> <th>orientation</th> <th>maxOccupants</th> <th>_floorArea</th> <th>_volume</th> <th>_exteriorSurfaceArea</th> <th>_winToFloorRatio</th> <th>firstDayOfUsedOccupancySequence</th> <th>simID</th> </tr> <tr> <td>5.481</td> <td>5.190</td> <td>3.264</td> <td>0.000214</td> <td>438.0</td> <td>316.0</td> <td>4.0</td> <td>28.446</td> <td>92.849</td> <td>16.940</td> <td>0.216</td> <td>192</td> <td>0</td> </tr> </tbody> </table> <p> </p> <h2>Occupancy Data</h2> <p>The occupancy data provided through the separate csv files contain the data from the upfront occupancy simulations that the climate simulation was based on. For each level of considered room occupancy limit (maxOccupants), the datasets provide minute values of occupancy throughout 1000 days.</p> <p><em>Datetime, </em><em>Date, </em><em>Timestamp: fictive time of simulated occupancy record (sequences are in 1-minute resolution)</em><br><em>Occupants: number of present occupants</em><br><em>Occupancy: binary occupancy state (0=unoccupied, 1=occupied)</em><br><em>WindowState: binary state of ventilation (0=windows closed, 1=room is ventilated)</em><br><em>maxOccupants: maximum number of occupants considered for the simulated sequence</em><br><em>WindowOpeningFraction: fractional extent to which windows are opened, within the interval [0.01, 1]<br><br></em></p> <p>Example row:</p> <table> <tbody> <tr> <th>Datetime</th> <th>Date</th> <th>Timestamp</th> <th>Occupants</th> <th>Occupancy</th> <th>WindowState</th> <th>maxOccupants</th> <th>WindowOpeningFraction</th> </tr> <tr> <td>2023-01-01 00:00:00</td> <td>2023-01-01</td> <td>1.672531e+09</td> <td>0</td> <td>0</td> <td>0</td> <td>1</td> <td>0.0</td> </tr> </tbody> </table> <p> </p> <p> </p>
ShareScore
40/100
Overall dataset sharing score
Score breakdown
These five areas show where the dataset supports — or may limit — practical reuse.
- Stewardship
- 8
- Harmonization
- 4
- Access
- 20
- Reuse readiness
- 8
- Engagement
- 0