updated docstring for metric.