add filter and documentation
add example