update helper functions and README