documentation
better unit conversion in definition