add cores argument and update explanations...