changed return type and arguments of computeMaxFroudeNumber
added documentation for computeMaxFroudeNumber