The complaint analytics function calculates the frequency of hot/cold-related occupant complaints and the conditions that produce them.

Building occupants will naturally complain if indoor conditions are undesirable or unpleasant. Though typically infrequent, these complaints can be used to gauge overall occupant satisfaction and can even serve as an indicator of anomalous operations. Thermal complaints related to room air temperature can be used to inform room air temperature setpoints or airflow setpoints and can even be used to monitor the effects of energy-saving actions such as lowering the temperature setpoint in the heating season or altering schedules to better suit occupant arrival and departure times. These complaints are typically logged by a building operator in a building's computerized maintenance and management system (CMMS) along with various other work-related orders. By extracting only the occupant complaints related to room air temperature, we can determine the frequency of complaints and the conditions that produce them to inform energy-saving decisions.

The complaint analytics function calculates the frequency of thermal complaints related to room air temperature and generates visuals depicting the conditions which produce them. Thermal complaints are defined as complaints containing the word "hot" or "cold", which suggests unduly hot or cold room air temperature; there criteria excludes any complaints containing the word "water". The frequency of complaints is calculated twice, once for hot complaints and another for cold complaints, for the heating season (October - April, inclusive) and twice again for the cooling season (May - September, inclusive). Visuals plot the monthly distribution of when the complaints were registered, the time of day they were registered, and the conditions that produce them.