update and re-organize comments
update readme
add polymet test
add polymet test