state total metric

The docstring function name and arguments need updating.