py: added documentation to the code

src/associators.py

src/filters.py

src/gaters.py

src/logic.py

src/models.py

src/trajectories.py

src/utility.py