Ga naar inhoud

1CijferHO

Maak 1cijferHO-data direct bruikbaar voor analyse en onderzoek.

1CijferHO Tool automatiseert het verwerken van DUO-onderwijsdata (fixed-width ASCII bestanden) naar CSV- en Parquet-bestanden — zonder programmeerkennis.

Windows macOS Linux License

Wat doet het?

Stap Wat er gebeurt
Upload Zet DUO-bestanden in data/01-input/
Extract Metadata uit .txt-beschrijvingen wordt uitgelezen
Validate Veldposities en bestandskoppelingen worden gecontroleerd
Convert Fixed-width ASCII → CSV / Parquet via multiprocessing
Output CSV met de ruwe data, plus optioneel varianten met gedecodeerde en verrijkte kolommen

De omzetting van het vaste-breedteformaat naar CSV is geverifieerd verliesvrij. Decoderen en verrijken zijn aanvullingen die codes kunnen wijzigen — controleer de logs in metadata/logs/ en vergelijk een _decoded.csv met de ruwe .csv voordat je die gebruikt.

Demo

Demo

Installatie in één minuut

git clone https://github.com/cedanl/1cijferho.git
cd 1cijferho
uv sync --extra frontend
uv run streamlit run src/main.py

Of installeer als Python-pakket:

pip install eencijferho

Zie Aan de slag voor de volledige installatiestappen.

Pakket of UI?

Geen programmeerkennis nodig. Start de tool en upload via de browser.

uv run streamlit run src/main.py

Voor automatisering in scripts en pipelines.

eencijferho pipeline --input data/01-input --output data/02-output

Zie de CLI-referentie voor alle commando's.

Integreer de verwerking in je eigen code.

from eencijferho import run_turbo_convert_pipeline
from eencijferho.config import OutputConfig

# Standaard: alles aan
run_turbo_convert_pipeline(
    input_dir="data/01-input",
    output_dir="data/02-output",
)

# Met koppelbestand voor lokaal studentnummer (optioneel, aangeleverd door instelling)
run_turbo_convert_pipeline(
    input_dir="data/01-input",
    output_dir="data/02-output",
    output_config=OutputConfig(
        bsn_mapping_file="data/koppeling_bsn_studentnummer.csv",
    ),
)

Zie de API-referentie voor de volledige API.

Achtergrond & presentaties

  • Presentatie DAIR 2025 — introductie op de tool en het 1cijferHO-verwerkingsproces.
  • SDP & compliance — analyse van de inzet op SURF's Developer Platform (NIS2, EU AI Act, Data Act) en de rol van de Object Store.