added read me and example filtering