added README
more API + more robust constructors