added utility functions; updated nomenclature