adds cleaned up read_actor_dict function

This is not the latest version Phil has sent us, that is still being
debugged. This has improved documentation, and has been verified to work
on the small dict in the repo.