update docs on units
update docs on units
fix unit mapping computation