ENH: observation_metadata_correlation.py

Includes commits in #1758. @gregcaporaso and I pair-programmed this and cleaned up small issues in the script documentation.

fixes #1395