add report method for programmating usage (also update readme)