Skip to content

humanbuildingsynergy/ResidentialOccupancyScheduleSimulator

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

17 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Residential Occupancy Schedule Simulator (ROSS)

Objective

ROSS creates a stochastic residential occupancy schedule by referencing occupancy schedules, extracted from a large smart thermostat dataset (over 90,000 thermostat data). Through ROSS, the Building Energy Modeling (BEM) community will have better access to data-driven residential occupancy schedules.

Methodology

ROSS references the occupancy schedules, identified through the time-series K-means clutering method using the ecobee Donate Your Data (DYD) dataset, to stochastically create a residential occupancy schedule.

The stochastic nature of ROSS comes from an inhomogeous Markov chain, where the transitional probabilities are calculated using the representative occupancy schedules, and the inverse function method, which selected the occupancy status of the next step. The representative schedules were found through the time-series K-means clustering method using over 90,000 thermostat data at a five-minute interval in the DYD dataset.

More details will be shared once the paper below gets published.

Other features.

In the 'resource' folder, there are csv files that contain the representative occupancy schedules, identified through this research effort. The following are the assumptions made in each method/subfolder:

  • method_00: This method assumed that the 'Sleep' schedule represents occupancy.
  • method_01: This method assumed that the 'Home' and 'Sleep' schedules represent occupancy.

The reasons for the abovementioned assumptions:

  • 'Sleep' schedule: Since occupants are stationary while asleep, which become undetectable by passive infrared sensors that ecobee utilizes.
  • 'Hhome' schedule: This schedule can be defined by the user(s), representing a typical time to be at home.

Instruction

  1. Clone this repository,
  2. Execute ROSS.py,
  3. Follow the instruction: ROSS requests three inputs from users to customize the results upon their needs.
    • Level of randomness: low, medium, and high
    • Occupancy identification approach: 0 (motion-based) or 1 (schedule-based).
      • motion-based: the occupancy schedule is more relied on motion data
      • schedule-based: the occupancy schedule is more relied on user-inputted schedules (e.g., the Home schedule)
    • Day of the week: from Mon to Sun
  4. Once success, check out the result folder to see the csv file you created!

Contributors

Key references

  • ecobee, Donate Your Data, https://ecobee.com/donate-your-data/, accessed 09.2022.
  • J. Page, D. Robinson, N. Morel, and J. L. Scartezzini, A generalised stochastic model for the simulation of occupant presence. Energy and Buildings, 2008. 40(2): p. 83-98.