added doxygen comments and modified the names of a few model parameters.