update comment
update nomenclature
update comments
update readme