readme update and addition of active function