add library methods and update readme