Skip to content

Latest commit

 

History

History
19 lines (12 loc) · 1.1 KB

README.md

File metadata and controls

19 lines (12 loc) · 1.1 KB
Raw

civilite

Library for managing outdoor lighting when building occupancy and available daylight must be considered.

Overview

When a building is occupied on a given schedule for an event, outdoor lighting for the building and premises must also take the available daylight into account. This library aims to allow easy integration of this logic into an automation system.

Requirements

  1. An occupancy event is defined by a start time and an end time. This shall include time before the actual occupancy of the building to allow for outdoor activities directly before and after the event (parking, etc.)
  2. Sunrise and sunset times are defined as Civil Twilight.
  3. If sunset occurs during an event, lights shall turn on at sunset and turn off at end of event.
  4. If multiple events are scheduled, any gaps between events less than 30 minutes shall be considered as if the building is occupied.
  5. Occupancy schedule shall be loaded from an external source, preferably via a known API.

External Dependencies

  • See requirements.txt