updated readme and samples with new interface