range+sample functions plus readme update