add utilities and use them
update the makefile to include utilities
update user guide to reflect recent updates