updated docstrings for multiple functions in distance_map.pz, transition_map.py and schedule_generators.py