update usage examples and add filter example