def set_auto_predict(auto_predict_):
    """Sets whether the analysis routine automatically runs a predict on the
    *training* data whenever a fit is performed to score the machine on
    reproducing training data (useful for measuring over-fitting).

    Args:
        auto-predict_ (bool): when True, analysis *will* automatically perform a
          predict on `Xtrain` and `ytrain` to see how well it matches the training
          data.
    """
    global auto_predict
    auto_predict = auto_predict_
