additional helper methods, added javadoc