added convenience methods and example