blockOccupancySchedule

Occupancy schedule with look-ahead

Extends from Modelica.Blocks.Icons.Block.

Information

This model outputs whether the building is currently occupied, and how long it will take until the next time when the building will be occupied or non-occupied. The latter may be used, for example, to start a ventilation system half an hour before occupancy starts in order to ventilate the room.

The occupancy is defined by a time schedule of the form 

  occupancy = 3600*{7, 12, 14, 19}

This indicates that the occupancy is from 7:00 until 12:00 and from 14:00 to 19:00. This will be repeated periodically. The parameter periodicity defines the periodicity. The period always starts at t=0 seconds.

Parameters

TypeNameDefaultDescription
Real[:]occupancy3600*{7, 19}Occupancy table, each entry switching occupancy on or off
BooleanfirstEntryOccupiedtrueSet to true if first entry in occupancy denotes a changed from unoccupied to occupied
Modelica.Units.SI.Timeperiod86400End time of periodicity

Components

TypeNameDefaultDescription
Modelica.Blocks.Interfaces.RealOutputtNexNonOccTime until next non-occupancy
Modelica.Blocks.Interfaces.RealOutputtNexOccTime until next occupancy
Modelica.Blocks.Interfaces.BooleanOutputoccupiedOutputs true if occupied at current time

Contents

NameDescription
getOutputprotectedGet the next occupancy or non-occupancy outputs
switchIntegerprotectedSwitch two Integer arguments
switchRealprotectedSwitch two Real arguments

Revisions

  • February 7, 2025, by Jelger Jansen:
    Removed import statement. This is for IBPSA, #1961.
  • March 25, 2021, by Michael Wetter:
    Integrated changes from Buildings for IBPSA, #1454.
  • February 26, 2021, by Michael Wetter:
    Refactored implementation to use a function to compute the next time events.
    This is a work-around for Buildings, issue 2369.
  • October 30, 2017, by Michael Wetter:
    Rewrote using equation rather than algorithm and removed assertion.
    This is for issue 844.
  • September 11, 2012, by Michael Wetter:
    Added pre operator in when clause and relaxed tolerance in assert statement.
  • July 26, 2012, by Michael Wetter:
    Fixed a bug that caused an error in the schedule if the simulation start time was negative or equal to the first entry in the schedule.
  • February 16, 2012, by Michael Wetter:
    Removed parameter startTime. It was removed because startTime=0 would imply that the schedule should not start for one day if the simulation were to be started at t=-8760 seconds. Fixed bug that prevented schedule to start when the simulation was started at a time that is higher than endTime. Renamed parameter endTime to period.
  • April 2, 2009, by Michael Wetter:
    First implementation.