add filtering and update readme