Freq residency v2

Created by: mdigiorgio

This is v2 of #87.

It includes the requested changes. Also, some comments are added to ease understanding what the code does.