Added option to convert results to data.frame

Results are by default returned as a list, which is more robust, but is
a very cumbersome R data object to work with. Therefore, I added an
option to convert this list into a data.frame.
Added the getObservations call
Added documentation for getObservations

Also updated documentation for other functions