renamed numberOfPoints to samples (consistent with pgfplots) and misc tidying
updated readme, small misc tidying