added documentation for filter functions