cleaning, fixing, documenting, and added compatibility for the filter creation