refactored example with filter
factorization of filter management
removed an error-prone example
documentation
changed script examples