added new methods, updated README