Skip to content
 
 

Repository files navigation

Uitnodigingsregel

Python implementatie van de Uitnodigingsregel — een machine learning model dat studenten met een verhoogd uitvalrisico signaleert. Bedoeld voor data scientists en developers die het model opzetten en beheren binnen hun onderwijsinstelling.

Waarom de Uitnodigingsregel

Onderwijsinstellingen worstelen al jaren om meer grip op uitval te krijgen. Steeds vaker wordt hierbij gebruikgemaakt van data over de studieontwikkeling van studenten.

In haar promotieonderzoek introduceerde Irene Eegdeman een methode om studenten met een verhoogd risico op uitval vroegtijdig te signaleren. Met behulp van studiedata en machine learning-modellen is de zogenaamde 'uitnodigingsregel' ontwikkeld. Deze methode biedt SLB'ers en mentoren een signaleringssysteem om uitvalpreventie en -interventies effectiever in te zetten.

De methodiek genereert een geordende lijst van studenten op basis van hun uitvalkans. Zie een concreet voorbeeld met synthetische data bij ROC Mondriaan.

Achtergrond

Wil je meer weten over de Uitnodigingsregel? Bekijk dan deze presentatie van de MBO Digitaal-conferentie, waarin de belangrijkste resultaten, geleerde lessen en praktische tips worden gedeeld. Daarnaast geeft deze praatplaat een visueel overzicht van de methode.

Meer informatie over het voorkomen van studentenuitval door middel van verklaringen en voorspellingen is te vinden in dit artikel. Voor de wetenschappelijke basis achter de methode kun je het proefschrift van Irene Eegdeman raadplegen.

Wil je de Uitnodigingsregel toepassen binnen jouw onderwijsinstelling? Houd dan rekening met een uitgebreide voorbereiding, waaronder een DPIA (Data Protection Impact Assessment) maar ook ethische toetsing en toetsing aan de AI-verordening. De Datacoalitie Datagedreven Onderzoek heeft deze methodiek zorgvuldig naar de praktijk vertaald. Lees hier meer over dit proces en bekijk de ontwikkelde producten die kunnen helpen bij een succesvolle implementatie van de Uitnodigingsregel.

Aan de slag

Volledige documentatie, pipeline-overzicht en projectstructuur: cedanl.github.io/Uitnodigingsregel

Datavoorbereiding

SQL-voorbeeldcode voor de invoerdata is beschikbaar via de Uitnodigingsregel_datapreparatie repo. Zorg dat de voorbereide data aanwezig is in data/02-prepared/ voordat je de pipeline draait. Of gebruik de synthetische demo-data. Een overzicht van alle basis variabelen staat in de data dictionary.

Installatie

Via Scoop (Windows, aanbevolen)

Installeer Scoop als je dat nog niet hebt, en voer daarna uit:

scoop bucket add uitnodigingsregel https://github.com/cedanl/Uitnodigingsregel
scoop install uitnodigingsregel
uitnodigingsregel

Handmatig (Windows, macOS, Linux)

  1. Installeer uv:

    Windows (PowerShell):

    powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

    macOS / Linux:

    curl -LsSf https://astral.sh/uv/install.sh | sh
  2. Clone de repository:

    git clone https://github.com/cedanl/Uitnodigingsregel.git
    cd Uitnodigingsregel
    
  3. Installeer dependencies:

    uv sync
    

Gebruik

1 Datakwaliteit

Gebruik Model_analysis.qmd om een HTML-rapport te genereren voor datakwaliteit en modelprestaties:

uv run quarto render Model_analysis.qmd

Het HTML-bestand wordt aangemaakt in dezelfde map als het analysebestand.

2 Voorspellingen draaien

Draai de pipeline om een gerangschikte lijst van studenten te genereren:

uv run python main.py

3 Interactieve app

Start de Streamlit-app voor interactieve verkenning:

uv run uitnodigingsregel

Outputbestanden

Na uitvoering worden de voorspellingsbestanden opgeslagen in models/predictions/.

Contributors

Thank you to all the people who have already contributed to Uitnodigingsregel [contributors].

tin900 MondriaanBI asewnandan StevenRamondt

Credits

This product was originally created with Cookiecutter Data Science and migrated to the CEDA package standard.


About

Python project for predicting student dropout in the first year

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages