support for running straight with simulator, changed arguments, better doc, checks for errors