polished som code files and updated doxygen documentation