class documentation for creation, affinity and rectifier.
corrections to README file.