Implement helpers functions

also contains issue #11 bug fix
v1.0:3-RC