BUG/DOC: fix bandwidth mapping and improve filter docs

Closes #1591.
Also update docs, attempt to make the meaning and usage of filter parameters less ambiguous.