Rationalise and document the analysis routine interfaces (API)

It would be much nicer to have a common interface to the different core analysis routines before documenting them. For example the main collocation routine does some of the parsing of arguments itself, but doesn't write the data out. Conversely the others don't do the parsing themselves but do write the data out (which we don't want for the API). The plotting interface needs a lot of work...