readme and notebook update