weltby Ergodic Sign inGet started
All use cases

How Will This Student Finish the Course?

From earlier marks and study habits, family support and wellbeing, which performance class will this postgraduate student end up in? Tutors want to know who needs help while there's still time.

Use caseSciencePredictionModel evaluation

The table

3,892 postgraduate students with earlier marks and study, family and wellbeing factors, and their final performance class. It's in Welt's research catalogue as Student Performance Analysis 1, 3,892 rows by 36 columns, licensed CC0. The catalogue measures its signal at 0.56. At 3,892 rows and 35 features, TabICLv2 and Kumo Tabular Medium take the table as it is. The others can't take a table this size, so the walkthrough leaves them out.

Walkthrough

  1. Load it from the catalogue

    Find the table, read its recorded target and print the column names.

    import pandas as pd
    from welt import Client
    
    with Client() as client:
        item = client.research_datasets(q="student performance analysis", limit=1)["items"][0]
        info = client.research_dataset(item["id"])
        data = client.load_research_dataset(item["id"])
    
    target = info["targets"][0]
    target = target["name"] if isinstance(target, dict) else target
    print([column["name"] for column in info["schema"]], target)
  2. Pick the rows

    Set aside 20 rows to predict at the end, and keep the rest for the models to learn from.

    known = data.dropna(subset=[target])
    new_rows = known.sample(20, random_state=1)
    table = known.drop(new_rows.index)
  3. Compare the models and predict

    The models compete on the same folds against a simple guess, then the top-ranked one is fitted on the whole table. ROC AUC runs from 0.5, a coin toss, to 1, a perfect ranking, and a lower Brier score means the probabilities can be trusted more. The last table puts each prediction next to the real answer.

    with Client() as client:
        evaluation = client.evaluate(table, target, task="classification", seed=7,
                                     models=["tabicl-v2", "kumo-medium"])
        model = evaluation.fit()
    
    print(evaluation.summary()[["name", "rank", "roc_auc_mean", "brier_mean"]])
    features = new_rows.drop(columns=target)
    print(pd.DataFrame({"actual": new_rows[target].values, "predicted": model.predict(features),
                        "probability": model.predict_proba(features).max(axis=1)}))

What you get

A predicted classFor each student, with a probability.
Help where it's neededContact the students most at risk.
A clear signalThe catalogue measures a good signal.

Try it

Use Open with to run the research datasets notebook in Colab, Kaggle or Jupyter and search for "student performance analysis", or run the code above after pip install "welt-client[parquet]".