avoiding events to be generated in heat pumps

When enabling this functionality the heat pump does not switch off discretely but is modulated down over a period of time.

Also added documentation for heat pump models and examples.