% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/uitval.R
\name{bereken_uitval}
\alias{bereken_uitval}
\title{Bereken uitvalindicatoren per cohort}
\usage{
bereken_uitval(basisbestand, diploma_behaald, cohorten_instroom, jaar)
}
\arguments{
\item{basisbestand}{Tibble zoals gemaakt door \code{\link[=maak_basisbestand]{maak_basisbestand()}}}

\item{diploma_behaald}{Tibble zoals gemaakt door \code{\link[=maak_diploma_behaald]{maak_diploma_behaald()}}}

\item{cohorten_instroom}{Tibble zoals gemaakt door \code{\link[=maak_instroom_cohort]{maak_instroom_cohort()}}}

\item{jaar}{Integer, peiljaar van de analyse (bijv. \code{2025}). Studenten die
in \code{jaar - 1} nog ingeschreven staan, gelden als zittend.}
}
\value{
Een tibble met kolommen \code{persoonsgebonden_nummer},
\code{laatste_jaar_inschrijving}, \code{diploma}, \code{status} (factor:
Diploma behaald / Zittend / Uitgevallen), \code{uitval_xjr} (jaar van uitval
t.o.v. instroomjaar), \code{uitval_1jr} en \code{uitval_3jr} (factoren).
Gooit een fout bij dubbele studenten of ontbrekende statussen.
}
\description{
Bepaalt voor elke student in het instroomcohort of zij zijn uitgevallen,
zittend of gediplomeerd. Uitval wordt gemarkeerd als een student niet meer
ingeschreven staat en geen diploma heeft.
}
\examples{
basis <- tibble::tibble(
  persoonsgebonden_nummer = c("S1", "S1", "S2"),
  inschrijvingsjaar = c(2020L, 2021L, 2020L),
  soort_inschrijving_actuele_instelling = "hoofdinschrijving"
)
diploma <- tibble::tibble(
  persoonsgebonden_nummer = "S1",
  jaar_eerste_diploma = 2022L,
  verblijfsjaar_eerste_diploma = 3L,
  diploma = "Diploma behaald (excl. propedeuse)"
)
cohort <- tibble::tibble(
  persoonsgebonden_nummer = c("S1", "S2"),
  eerstejaar_instelling = 2020L
)
bereken_uitval(basis, diploma, cohort, jaar = 2023L)
}
