documented sim_manager.py