Parameter for avoiding events in heat pump models

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.