some documentation of the math (particularly logistic)