added distance tests
new function names in examples and readme