update readme
add distance threshold
log progress
Merge branch 'master' into gh-pages
add early return