Ga naar inhoud

Aan de slag

Vereisten

  • Besturingssysteem: Windows, macOS of Linux
  • Software: uv — Python package manager

uv installeren

curl -LsSf https://astral.sh/uv/install.sh | sh

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Controleer daarna: 

uv self update

Optie 1: Streamlit UI (aanbevolen)

Geen programmeerkennis nodig.

# 1. Download de tool
git clone https://github.com/cedanl/1cijferho.git
cd 1cijferho

# 2. Installeer dependencies
uv sync --extra frontend

# 3. Start de applicatie
uv run streamlit run src/main.py

De browser opent automatisch met de interface.

Optie 2: Python-pakket

Voor gebruik als backend-bibliotheek of via de CLI.

pip install eencijferho

uv add eencijferho

poetry add eencijferho

Optionele backends

# MinIO (S3-compatibele opslag)
pip install eencijferho[minio]

# PostgreSQL
pip install eencijferho[postgres]

# Alle backends
pip install eencijferho[all-backends]

Mapstructuur verwacht

data/
├── 01-input/
│   ├── EV_2023.asc          # fixed-width databestand
│   ├── EV_2023.txt          # bijbehorende bestandsbeschrijving
│   └── Bestandsbeschrijving_Dec-bestanden.txt   # optioneel: DEC-opzoektabellen
└── 02-output/               # wordt aangemaakt door de tool

Demo-modus

Zet bestanden met *_DEMO* in de naam in data/01-input/ om de tool te testen zonder echte data.

Volledig in één stap

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

Of stap voor stap — zie de CLI-referentie.

Studentnummer koppeling (optioneel)

Instellingen kunnen een eigen koppelbestand aanleveren om een lokaal studentnummer toe te voegen aan de uitvoerbestanden.

Bestandsformaat: CSV (puntkomma-gescheiden) of Parquet, met minimaal twee kolommen:

burgerservicenummer;studentnummer
123456789;S0001
234567890;S0002

Een voorbeeldbestand staat in data/koppeling_bsn_studentnummer_VOORBEELD.csv.

Vul het pad in bij Studentnummer koppeling op de Turbo Convert-pagina. Gebruik een pad relatief aan de projectmap (bijv. data/koppeling.csv) of een absoluut pad.

eencijferho pipeline \
  --input data/01-input \
  --output data/02-output \
  --bsn-mapping-file data/koppeling_bsn_studentnummer.csv

from eencijferho import run_turbo_convert_pipeline
from eencijferho.config import OutputConfig

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",
    ),
)

Kolomnamen aanpassen

Standaard worden de kolommen burgerservicenummer en studentnummer verwacht. Afwijkende kolomnamen zijn configureerbaar via de geavanceerde instellingen in de UI of via OutputConfig(bsn_mapping_right_on=..., bsn_mapping_id_col=...) in de Python API.