allow all objects to be input
update readme and add examples