DOC: added documentation for the different functions
REFACTOR: some abstraction of the execution of the tests
FEATURE: slight optimization to a new method, same os #2 but filters before sorting