MODELL
    ogd_einwohner_heimat_herkunft_yyyy

BESCHREIBUNG MODELL
    Einwohner nach Heimat und Herkunft, pro Jahr.
    Daten vor dem Jahr 2014 werden aus historischen Aufzeichnungen übernommen und werden darum vorläufig nicht laufend neu generiert.
    
    ┌──────────┬────────────────────────────────────────┐
    │ Quelle   │ Einwohnerkontrolle Winterthur (NEST)   │
    ├──────────┼────────────────────────────────────────┤
    │ Sprache  │ Deutsch                                │
    └──────────┴────────────────────────────────────────┘
    
    File-Export (CSV)
    -----------------
    
    Die Daten werden im CSV-Format exportiert. Das File ist UTF-8 codiert und Spalten mittels Kommata (,) getrennt.
    Der Export richtet sich dabei den Leitlinien für einfach nutzbare Behördendaten [1] des Kantons Zürich.

VARIABLEN

    --------------------

    VARIABLE
        jahr

    BESCHREIBUNG VARIABLE
        Jahr, mit Stichtag 31. Dezember. Die Daten werden für gewöhnlich in den ersten Tagen des neuen Jahres exportiert (Wissensstand).
        
        ┌────────────────┬────────────────────┐
        │ Typ            │ Zahl (4-stellig)   │
        ├────────────────┼────────────────────┤
        │ kann leer sein │ nein               │
        ├────────────────┼────────────────────┤
        │ Beispiel       │ 2015               │
        └────────────────┴────────────────────┘

    --------------------

    VARIABLE
        gemeinde_bfs_nr

    BESCHREIBUNG VARIABLE
        Gemeinde-Nummer nach Definition des BFS [2].
        
        ┌────────────────┬────────────────────┐
        │ Typ            │ Zahl (4-stellig)   │
        ├────────────────┼────────────────────┤
        │ kann leer sein │ nein               │
        ├────────────────┼────────────────────┤
        │ Beispiel       │ 230                │
        └────────────────┴────────────────────┘

    --------------------

    VARIABLE
        gemeinde

    BESCHREIBUNG VARIABLE
        Amtlicher Gemeindename nach Definition des BFS [2].
        
        ┌────────────────┬────────────────────────────┐
        │ Typ            │ Text (max. 60 Charakter)   │
        ├────────────────┼────────────────────────────┤
        │ kann leer sein │ nein                       │
        ├────────────────┼────────────────────────────┤
        │ Beispiel       │ Winterthur                 │
        └────────────────┴────────────────────────────┘

    --------------------

    VARIABLE
        heimat

    BESCHREIBUNG VARIABLE
        Heimat Einwohner/innen, ausgehend von der Nationalität.
        
        ┌────────────────┬───────────────────────────────┐
        │ Typ            │ Enum (Schweiz oder Ausland)   │
        ├────────────────┼───────────────────────────────┤
        │ kann leer sein │ nein                          │
        ├────────────────┼───────────────────────────────┤
        │ Beispiel       │ Ausland                       │
        └────────────────┴───────────────────────────────┘

    --------------------

    VARIABLE
        herkunft

    BESCHREIBUNG VARIABLE
        Herkunft der Einwohner/in, ausgehend vom Geburtsstaat.
        
        ┌────────────────┬───────────────────────────────┐
        │ Typ            │ Enum (Schweiz oder Ausland)   │
        ├────────────────┼───────────────────────────────┤
        │ kann leer sein │ nein                          │
        ├────────────────┼───────────────────────────────┤
        │ Beispiel       │ Ausland                       │
        └────────────────┴───────────────────────────────┘

    --------------------

    VARIABLE
        anzahl

    BESCHREIBUNG VARIABLE
        Anzahl der Einwohner/innen in der ausgewiesenen Gruppe.
        Die Definition der Einwohner/innen richtet sich in Winterthur nach dem Prinzip der "Wohnbevölkerung".
        Diese unterscheidet sich von der Definition des Kantons, welche Einwohner für gewöhnlich nach dem zivilrechtlichen Prinzip definiert.
        Weitere Informationen zur Definition sind auf dem Statistikportal der Stadt Winterthur [3] zu finden.
        
        ┌────────────────┬────────┐
        │ Typ            │ Zahl   │
        ├────────────────┼────────┤
        │ kann leer sein │ nein   │
        ├────────────────┼────────┤
        │ Beispiel       │ 132    │
        └────────────────┴────────┘

    --------------------

QUELLEN
    [1] https://github.com/openZH/ogd-handbook/blob/main/publikationsleitlinien.md
    [2] https://www.bfs.admin.ch/asset/de/31265302
    [3] https://stadt.winterthur.ch/themen/die-stadt/winterthur/statistik/Definitionen