API changes

Made one significant change to the API and added two convenience methods