updated filters, added documentation