Snelstart (5 min)¶

Van niets naar je eerste prognose — met demodata, dus je hebt nog geen eigen data nodig.

Eerst installeren

Nog niet geïnstalleerd? Zie Installeren (drie commando's).

1. Projectmap aanmaken en demodata ophalen¶

mkdir mijn-prognose && cd mijn-prognose
studentprognose init

init maakt de mapstructuur en een configuration/configuration.json met alle standaardwaarden. Aan het einde vraagt het of je demodata wilt downloaden (6 MB, telbestanden + individuele aanmelddata):

Wil je demodata downloaden om direct te starten? (6 MB, ~10 sec) [j/n]: j
  Downloaden...
  demo-data.zip: 5.60MB [00:08, 700kB/s]
  Uitpakken...
  Demodata geïnstalleerd in data/input_raw/ ✓

Kies n als je meteen je eigen data wilt gebruiken — zie dan Je data klaarzetten.

2. Draaien¶

studentprognose -d c -y 2024

Wat er op het scherm verschijnt:

==== Valideren van ruwe inputdata ====

  Bestand                                     Status    Nodig voor
  ──────────────────────────────────────────────────────────────────
  data/input_raw/telbestanden                 ✓         -d cumulative, -d both
  data/input_raw/individuele_aanmelddata.csv  ✓         -d individual, -d both
  data/input_raw/oktober_bestand.xlsx         ✓         studentaantallen (optioneel)

  Beschikbare modi:
    -d cumulative      ✓
    -d individual      ✓
    -d both            ✓

==== Processing raw input data ====
[1/4] Rowbinding telbestanden...        → data/input/vooraanmeldingen_cumulatief.csv
[2/4] Interpolating missing weeks...    → data/input/vooraanmeldingen_cumulatief.csv
[3/4] Calculating student counts...     → data/input/student_count_*.xlsx
==== ETL complete ====

Loading data...
Preprocessing...

========================================
  Dataset:       cumulatief
  Trainingsdata: jaren 2020-2024
  Voorspelling:  jaar [2024], vanaf week [20]
  Voorspelt:     week 21 t/m 36 (16 weken vooruit)
========================================

Predicting first-years: 2024-20...
Start parallel predicting...
Postprocessing...
Saving output...

Waarschuwingen zijn normaal bij de demodata

Zomergaten — week 35–40 ontbreken in de telbestanden (Studielink levert in die periode niet). Deze waarschuwing kun je negeren.

Een run duurt op de demodata typisch 2–4 minuten, afhankelijk van je machine.

3. Resultaat bekijken¶

De output staat in data/output/. Open output_first-years_cumulatief.xlsx; de kolom SARIMA_cumulative bevat de prognose per opleiding.

Wil je het visueel? Voeg --dashboard toe:

studentprognose -d c -y 2024 --dashboard

Cumulatief dashboard met kerncijfers en fout naar opleidingsgrootte en examentype

Voorbeelddashboard op de demodata: hoe goed het model presteert, per opleidingsgrootte en examentype. Zie Output lezen voor alle pagina's.

Wat nu?¶

Ik wil…	Ga naar
Mijn eigen data gebruiken	Je data klaarzetten
Begrijpen wat `-w`, `-y` en `-d` doen	Draaien & CLI
De output-cijfers interpreteren	Output lezen
Mijn eigen instelling instellen	Configuratie
Weten hoe de modellen werken	Methodologie

Kom je een term niet tegen?

De Begrippenlijst legt peilweek, spoor, ETL, ensemble en de rest in gewone taal uit.