Plan my project static preview
Paste the abstract of a project that needs CBS microdata. You get an educated first guess of the datasets and variables to request, with the exact Dutch names. No AI model is called on this page: the preview matches your text against a hand-made concept map of the 411 documents in the catalog. Your text stays in your browser: nothing is sent anywhere. The live version will let a model read your abstract and the documentation.
Worked example
Example abstract (a shortened school-choice project):
We develop an agent-based model of primary school choice in the Netherlands to study school segregation. Households choose a primary school for their child based on the distance from home, the school's denomination, and the composition of the pupils (migration background and parental education). We estimate the model parameters with neural ratio estimation on household-level register data, comparing simulated and observed segregation across neighbourhoods and municipalities, and test how household income shapes the choice.
Primary-school pupils and their school matched: primary school, pupil, school choice
| Variable | Dataset | Label | Why | |
|---|---|---|---|---|
RINPERSOONS | INSCHRWPOTAB page 11 | RINPERSOONS RINPERSOONS | person key of the pupil | |
RINPERSOON | INSCHRWPOTAB page 11 | RINPERSOON RINPERSOON | person key of the pupil | |
WPOBRIN_crypt | INSCHRWPOTAB page 12 | Code of the educational institution for (special) primary education Code van de onderwijsinstelling voor het (speciaal) basisonderwijs | which school (institution) the pupil attends | |
WPOBRINVEST | INSCHRWPOTAB page 12 | School-location number of the location where the pupil attends (special) primary education Het onderwijsvestigingsnummer van de vestiging waar de leerling het (speciaal) basisonderwijs volgt | which school location; with WPOBRIN_crypt it identifies the location | |
WPOLEERJAAR | INSCHRWPOTAB page 20 | Grade (leerjaar) of the pupil in (special) primary education. Het leerjaar in het (speciaal) basisonderwijs waarin de betreffende leerling zit. | grade (groep), e.g. to select school entrants | |
WPOTYPEPO | INSCHRWPOTAB page 22 | Type of primary education the pupil follows in (special) primary education. Het soort primair onderwijs dat de leerling in het (speciaal) basisonderwijs volgt. | regular vs special primary education |
School characteristics (type, denomination, location) matched: denomination
| Variable | Dataset | Label | Why | |
|---|---|---|---|---|
DENOMINATIEWPOWEC | BRINWPOWECTAB page 9 | Denominatie (religious or ideological denomination) of the educational institution Denominatie van de onderwijsinstelling | religious or ideological denomination of the school | |
WPODENOMINATIE | INSCHRWPOTAB page 23 | Denominatie (religious or ideological denomination) of the educational institution Denominatie van de onderwijsinstelling | denomination as recorded on the pupil enrolment | |
BRINSOORTWPOWEC | BRINWPOWECTAB page 8 | Type of institution in (special) primary education and (secondary) special education. Het soort instelling in het (speciaal) basisonderwijs en het (voortgezet) speciaal onderwijs. | type of institution (regular, special primary, special) | |
RINOBJECTNUMMERWPOWEC | BRINWPOWECTAB page 11 | Identification number of the address of a school location in (special) primary education or (secondary) special education Identificatienummer van een locatie van een school in het (speciaal) basisonderwijs of speciaal (voortgezet) onderwijs | address of the school location, for distances and neighbourhoods | |
SOORTOBJECTNUMMERWPOWEC | BRINWPOWECTAB page 11 | Indicator of the origin of the address of a school location in (special) primary education or (secondary) special education Indicator voor de oorsprong van de locatie van een school in het (speciaal) basisonderwijs of speciaal (voortgezet) onderwijs | always used together with RINOBJECTNUMMERWPOWEC |
Distance to schools matched: distance
| Variable | Dataset | Label | Why | |
|---|---|---|---|---|
VZAFSTANDBASISOND | NABIJHEIDONDERWIJSTAB page 8 | Road distance in metres from an address to the nearest primary school Afstand in meters van een adres tot de dichtstbijzijnde school voor basisonderwijs, berekend over de weg | road distance from a home address to the nearest primary school | |
VZAANTBASISOND01KM | NABIJHEIDONDERWIJSTAB page 9 | Number of primary schools within 1 km Aantal scholen voor basisonderwijs binnen 1 km | number of primary schools within 1 km (choice set size) | |
VZAANTBASISOND03KM | NABIJHEIDONDERWIJSTAB page 9 | Number of primary schools within 3 km Aantal scholen voor basisonderwijs binnen 3 km | number of primary schools within 3 km | |
RINOBJECTNUMMER | NABIJHEIDONDERWIJSTAB page 8 | address key; link to the household's address |
Where people live (address history) matched: from home
| Variable | Dataset | Label | Why | |
|---|---|---|---|---|
RINOBJECTNUMMER | GBAADRESOBJECTBUS page 11 | Address ID of a person Adres-id van een persoon | address of the person in each period | |
SOORTOBJECTNUMMER | GBAADRESOBJECTBUS page 10 | SOORTOBJECTNUMMER of a person's address SOORTOBJECTNUMMER van het adres van een persoon | always used together with RINOBJECTNUMMER | |
GBADATUMAANVANGADRESHOUDING | GBAADRESOBJECTBUS page 9 | Start date of the person's residence at the address Datum aanvang adresbewoning persoon | start date at that address | |
GBADATUMEINDEADRESHOUDING | GBAADRESOBJECTBUS page 10 | End date of the person's residence at the address Datum beeïndiging adresbewoning persoon | end date at that address | |
GBADATUMWIJZIGINGADRES | GBAADRESGEBEURTENISBUS page 9 | Date of move. Verhuisdatum. | date of each move (frozen per publication year, matches StatLine) | |
VERHUISRICHTING | GBAADRESGEBEURTENISBUS page 10 | Type of move. Soort verhuizing. | move within or between municipalities | |
GemJJJJ | VSLGTAB page 8 | municipality of an address, for any year's boundaries |
Neighbourhood, district and municipality matched: neighbourhood, municipal, segregat
| Variable | Dataset | Label | Why | |
|---|---|---|---|---|
BCJJJJ | VSLGWBTAB page 11 | neighbourhood (buurt) code of an address, per classification year | ||
WCJJJJ | VSLGWBTAB page 11 | district (wijk) code | ||
GemJJJJ | VSLGWBTAB page 10 | municipality code | ||
VRLXCOORDADRES | VSLCOORDTAB page 9 | x coordinate (RD) of the address | ||
VRLYCOORDADRES | VSLCOORDTAB page 9 | y coordinate (RD) of the address | ||
VRLVIERKANT100M | VRLVSLVIERKANTTAB page 9 | Coordinate of the lower-left corner of the 100x100 square in which the residential object lies Coördinaat van linkeronderhoek van 100x100 vierkant waarin verblijfsobject valt | 100 x 100 m grid square of the address |
Migration background and origin matched: migra, segregat
| Variable | Dataset | Label | Why | |
|---|---|---|---|---|
GBAHERKOMSTGROEPERING | GBAPERSOONTAB page 14 | Migration background (CBS definition) Migratieachtergrond (CBS definitie) | country-of-origin grouping (being replaced by a new classification since 2022) | |
GBAGENERATIE | GBAPERSOONTAB page 15 | Generation Generatie | first or second generation | |
GBAGEBOORTELAND | GBAPERSOONTAB page 11 | Country of birth Geboorteland | country of birth | |
GBAHERKOMSTLAND | GBAPERSOONTAB page 20 | Country of origin (herkomstland, CBS definition) herkomstland (CBS definitie) | new origin classification (country) | |
GBAGEBOORTELANDNL | GBAPERSOONTAB page 21 | Country of birth: the Netherlands or abroad Geboorteland Nederland of buitenland | born in the Netherlands or abroad | |
GBAAANTALOUDERSBUITENLAND | GBAPERSOONTAB page 13 | Number of parents born abroad Aantal ouders in het buitenland geboren | number of parents born abroad | |
GBAGEBOORTELANDMOEDER | GBAPERSOONTAB page 12 | Country of birth of the mother Geboorteland moeder | mother's country of birth | |
GBAGEBOORTELANDVADER | GBAPERSOONTAB page 13 | Country of birth of the father Geboorteland vader | father's country of birth |
Parents of a child matched: parent, child
| Variable | Dataset | Label | Why | |
|---|---|---|---|---|
RINPERSOONSMa | KINDOUDERTAB page 9 | Type of RINPERSOON of the (legal) mother Soort RINPERSOON (juridische) moeder | key of the legal mother (type) | |
RINPERSOONMa | KINDOUDERTAB page 10 | Together with RINPERSOONSMa, this is the (legal) mother Samen met RINPERSOONSMa is dit de (juridische) moeder | key of the legal mother | |
RINPERSOONSpa | KINDOUDERTAB page 9 | Type of RINPERSOON of the (legal) father Soort RINPERSOON (juridische) vader | key of the legal father (type) | |
RINPERSOONpa | KINDOUDERTAB page 9 | Together with RINPERSOONSpa, this is the (legal) father Samen met RINPERSOONSpa is dit de (juridische) vader | key of the legal father |
Household and personal income matched: income
| Variable | Dataset | Label | Why | |
|---|---|---|---|---|
INHGESTINKH | INHATAB page 18 | Standardised disposable income of the household. Gestandaardiseerd besteedbaar inkomen van het huishouden. | standardised (equivalised) disposable household income, 2011 onwards | |
INHP100HGEST | INHATAB page 20 | Percentile groups of standardised (equivalised) disposable income of private households. Percentiegroepen gestandaardiseerd besteedbaar inkomen particuliere huishoudens. | percentile group of that income | |
INHARMLAG | INHATAB page 12 | Income relative to the low-income threshold in the reporting year. Inkomen ten opzichte van de lage-inkomensgrens in het verslagjaar. | income relative to the low-income threshold | |
RINPERSOONSHKW | INHATAB page 9 | Together with RINPERSOONHKW, this indicator identifies the main breadwinner (hoofdkostwinner) of a household. Samen met RINPERSOONHKW identificeert deze indicator de hoofdkostwinner van een huishouden. | household key (main breadwinner, type) | |
RINPERSOONHKW | INHATAB page 9 | Together with RINPERSOONSHKW, this number identifies the main breadwinner (hoofdkostwinner) of a household Samen met RINPERSOONSHKW identificeert dit nummer de hoofdkostwinner van een huishouden | household key (main breadwinner) | |
INPPERSINK | INPATAB page 21 | Personal income. Persoonlijk inkomen. | personal income, 2011 onwards | |
BVRGESTINKH | IHI page 12 | Standardised disposable income of the household. Gestandaardiseerd besteedbaar inkomen van het huishouden. | standardised household income for 2001–2010 (older files) |
Educational attainment (e.g. of parents) matched: education
| Variable | Dataset | Label | Why | |
|---|---|---|---|---|
WEINDKINDPAMA | IWOTAB page 14 | intergenerational final weight for education level of child, father and mother intergenerationeel eindgewicht opleidingsniveau kind, vader en moeder | intergenerational final weight: education of child, father and mother | |
OPLNIVSOI2021AGG4HBmetNIRWO | HOOGSTEOPLTAB page 17 | Education level (SOI 2021) in 18 categories, highest attained education opleidingsniveau (SOI 2021) in 18 categorieën hoogst behaalde opleiding | highest education level attained (SOI 2021, aggregated) | |
OPLNIVSOI2021AGG4HGmetNIRWO | HOOGSTEOPLTAB page 18 | Education level (SOI 2021) in 18 categories, highest attended education opleidingsniveau (SOI 2021) in 18 categorieën hoogst gevolgde opleiding | highest education level followed (SOI 2021, aggregated) | |
RICHTSOI2021SCEDF2013HBNIRWO | HOOGSTEOPLTAB page 19 | Field of study of the highest attained education (SOI 2021), including an estimate for Education Not Observed in Registers (NIRWO) Opleidingsrichting hoogst behaald onderwijs (SOI 2021) incl. bijschatting voor Niet in Registers Waargenomen Onderwijs | field of study of the highest education attained (ISCED-F 2013) | |
OPLNRHB | HOOGSTEOPLTAB page 11 | Education number of the highest attained education Opleidingsnummer hoogst behaalde opleiding | programme number of the highest education attained | |
GEWICHTHOOGSTEOPL | HOOGSTEOPLTAB page 14 | Grossing-up weight; 1 for register records, <>1 for EBB (Labour Force Survey) records Ophooggewicht; 1 bij registerrecords, <>1 bij EBB-records | weight: the file is partly survey-based, so use the weight | |
SOORTEDIPLSOORTHO | EDIPLOMAHOTAB page 9 | Level of the first final diploma obtained in higher education Niveau van het in het hoger onderwijs behaalde eerste einddiploma | type of first higher-education diploma | |
VSV3CAT | VSVTAB page 9 | Distinction between early school leavers, persons continuing in education and persons who left education with a basic qualification. Onderscheid tussen voortijdige schoolverlaters, door in onderwijs of uit het onderwijs met een startkwalificatie. | early school leaver vs. continuing vs. left with basic qualification | |
STARTKWREG | HDIPLOMAREGTAB page 9 | Characteristic indicating whether a basic qualification for higher education has been obtained. Kenmerk dat aangeeft of een startkwalificatie voor het hoger onderwijs behaald is. | holds a basic qualification (startkwalificatie) |
Social networks (family, classmates, neighbours, colleagues, housemates) matched: neighbour
| Variable | Dataset | Label | Why | |
|---|---|---|---|---|
RINPERSOONRELATIE | FAMILIENETWERKTAB page 9 | Together with RINPERSOONSRELATIE, this number identifies the person with whom RINPERSOON(S) has a network relationship Samen met RINPERSOONSRELATIE identificeert dit nummer de persoon met wie RINPERSOON(S) een netwerkrelatie heeft | key of the related person (family network) | |
RINPERSOONSRELATIE | FAMILIENETWERKTAB page 9 | Together with RINPERSOONRELATIE, this number identifies the person Samen met RINPERSOONRELATIE identificeert dit nummer de persoon | key type of the related person | |
RELATIE | FAMILIENETWERKTAB page 9 | Type of network relationship between RINPERSOON(S) and RINPERSOON(S)RELATIE. Type netwerkrelatie tussen RINPERSOON(S) en RINPERSOON(S)RELATIE. | type of family relation | |
RINPERSOONRELATIE | KLASGENOTENNETWERKTAB page 10 | Together with RINPERSOONSRELATIE, this number identifies the person with whom RINPERSOON(S) has a network relationship Samen met RINPERSOONSRELATIE identificeert dit nummer de persoon met wie RINPERSOON(S) een netwerkrelatie heeft | key of the classmate | |
RELATIE | KLASGENOTENNETWERKTAB page 10 | Type of network relationship between RINPERSOON(S) and RINPERSOON(S)RELATIE. Type netwerkrelatie tussen RINPERSOON(S) en RINPERSOON(S)RELATIE. | type of classmate relation | |
RELATIE | BURENNETWERKTAB page 9 | Type of network relationship between RINPERSOON(S) and RINPERSOON(S)RELATIE. Type netwerkrelatie tussen RINPERSOON(S) en RINPERSOON(S)RELATIE. | neighbour (10 nearest addresses) or neighbourhood resident (20 within 200 m) | |
RINPERSOONRELATIE | COLLEGANETWERKTAB page 9 | Together with RINPERSOONSRELATIE, this number identifies the person with whom RINPERSOON(S) has a network relationship Samen met RINPERSOONSRELATIE identificeert dit nummer de persoon met wie RINPERSOON(S) een netwerkrelatie heeft | colleague key (up to 100 colleagues living closest) | |
RELATIE | HUISGENOTENNETWERKTAB page 9 | Type of network relationship between RINPERSOON(S) and RINPERSOON(S)RELATIE. Type netwerkrelatie tussen RINPERSOON(S) en RINPERSOON(S)RELATIE. | housemate or institutional housemate |
Linking keys
| Variable | Dataset | Label | Why | |
|---|---|---|---|---|
RINPERSOONS | GBAPERSOONTAB page 11 | type of person key; always pair with RINPERSOON | ||
RINPERSOON | GBAPERSOONTAB page 11 | person key used to link all person files |
Not in the catalog yet
- KOPPELPERSOONHUISHOUDEN links persons to the income/wealth household; it is needed but its documentation is not in the corpus yet.
Read this before you request data
- This is a starting point, not an approved selection. CBS decides access per project.
- The preview only knows the 411 documents translated so far. A topic it does not match may still exist in the other CBS files.
- Check years: several files start or stop in particular years (for example the income files before and after 2011).
- Sub-municipal geography (neighbourhood codes, distances) has its own disclosure rules for output.
How the live version will work
- A model reads your abstract and lists the concepts you need.
- Each concept is searched in the catalog and the translated documentation.
- The model proposes variables with a reason and the PDF page.
- Every proposed name is checked against the catalog before you see it; unknown names are dropped.