heavily revised this code -KL

large revisions were made to generate a better figure 2 -KL
Added 'Files' section to README.md -KL
Update README.md
added several files -KL
Merge branch 'master' of github.com:klocey/partitions
removed some files -KL
added metrics folder -KL
Merge remote-tracking branch 'upstream/master'