copied in updated versions of k_means.py and test_k_means.py
cleaned up docstrings and reorganized functions.  slight code cleanup as well.