1CijferHO¶

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

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

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	Schone, gestructureerde bestanden klaar voor analyse

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?¶

Streamlit UICLIPython API

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.