Updating the readme file

Adding documentation of the plugin architecture and the keywords passed
to PV calculation functions to the readme file.  (They're currently
large block comments in the python code and I want them some place more
visible.)