added the ability to filter which elements should move
update readme for new filter function