removed unused add_id functions
documented simulation functions in simulate.R