It would be good to have a dosctring that explains the different parameters.