add detail to comment with regards to frequency spacing
update a few thoughts in comments
add first shot at high level api and stub impl