Mit OGD Daten arbeiten

In dieser Zusatzaufgabe geht es darum einen Datensatz selbst zu identifizieren und zu bearbeiten. Für die Daten nutzen wir den OGD (Open Government Data - offene Behördendaten) Datenkatalog des Statistischen Amts des Kantons Zürich. Das Repository wird von euch selbst auf GitHub erstellt und wir bereiten den Datenimport vor, ein Thema womit wir uns in Modul 4 intensiver beschäftigen.

Schritt 1: Daten herunterladen

  1. Öffne: https://www.zh.ch/de/politik-staat/statistik-daten/datenkatalog.html#/

  2. Unter der Eingabemaske “Thema auswählen” klicke die Auswahl “Daten”. Dies wird nur Datensätze welche als CSV of XLSX abgelegt sind anzeigen.

  1. Durchsuche nun den Katalog, entweder nach einem Thema in den du auf “Thema auswählen” klickst oder nach einem bestimmten Suchkriterium im Suchfeld “Suchen”.

  2. Klicke auf einen Datensatz der dich interessiert um weitere Informationen zu erhalten. Stelle sicher, dass der Datensatz als CSV verfügbar ist.

  1. Lade die CSV Datei herunter und speicher diese an einem von dir gewählten Ort auf deinem Arbeitsgerät.

  1. Öffne die Daten NICHT mit MS Excel. Dies kann zu Problemen führen, da Excel die Daten automatisch formatiert und somit die Daten verfälscht.

Schritt 2: Erstelle ein neues Repository auf GitHub & clone es in die Posit Cloud

  1. Öffne die GitHub Organisation für den Kurs https://github.com/rstatszh-k009
  2. Rechts neben dem Feld “Find a repository” klicke auf den grünen “New” Button.

  1. Im Feld “Repository name” schreibe ogd-daten-USERNAME. Ersetze USERNAME durch deinen GitHub Benutzernamen. Vermeide Leerzeichen.

  1. Skrolle auf der gleichen Seite nach unten und klicke auf “Create repository”.

  1. Im Feld “Quick setup” klicke auf das Clipboard neben der HTTPs URL.

  1. Öffne den rstatszh-k009 Arbeitsbereich (Workspace) auf posit.cloud

  2. Klicke auf “New Project” > “New Project from Git Repository”

  3. Füge die HTTPS-URL von GitHub in das Feld “URL of your Git Repository” ein. Beachte: Stelle sicher, dass die Box unter Packages ein Häkchen gesetzt hat.

  4. Warte, bis das Projekt bereitgestellt wurde.

Schritt 3: Lade die Daten in das Projekt auf Posit Cloud

  1. Im Datei Manager im Fenster unten rechts, klicke auf “Folder” um einen neuen Ordner zu erstellen.

  1. Benenne den Ordner “daten”.

  1. Klicke auf den Ordner “daten” im Datei Manager im Fenster unten rechts.

  1. Innerhalb des Ordners “daten”, klicke auf “Upload” um die CSV Datei hochzuladen.

  1. Im Dialogfenster unter “File to upload:” klicke auf “Choose file” und navigiere zu der CSV Datei aus Schritt 1. Klicke auf OK.

  1. Schaue im Fenster unten rechts nach, ob die Datei erfolgreich hochgeladen wurde.

  2. Mache einen Commit für alle Dateien indem du im Git Fenster oben rechts neben allen Dateien das Kontrollkästchen anwählst und dann auf “Commit” klickst. Verwende die Commit-Nachricht “Projekt aufsetzen”.

Schritt 4: Erstelle eine Quarto Datei für die Datenimportierung

In deinem ogd-daten-USERNAME Projekt in RStudio auf Posit Cloud, gehe in der Menüleiste zu [File > New File > Quarto document] um ein Quarto Dokument mit HTML Output zu erstellen. Render das Dokument, welches dich nach einem Namen fragt - du kannst ogd-daten-analyse.qmd verwenden und die Datei im Stammordner speichern.

  1. Füge einen Titel und deinen Namen als Autor in die YAML Metadaten am Anfang des Dokuments ein.

  2. Lösche den Text und Code-Blöcke unterhalb der YAML Metadaten.

  3. Füge eine Sektion formatiert als Heading 2 und Titel: “R Pakete laden” hinzu.

  1. Unterhalb der Sektion füge einen Code-Block hinzu.

  2. Innerhalb des Code-Blocks, lade die R-Pakete: readr, dplyr, ggplot2.

  3. Unterhalb des Code-Blocks, füge eine weitere Sektion formatiert als Heading 2 und Titel: “Daten importieren” hinzu.

  4. Unterhalb der Sektion füge einen Code-Block hinzu.

  1. Mache einen Commit für alle Dateien und verwende die Commit-Nachricht “Quarto Dokument für Datenimport erstellen”.

Schritt 5: Übertrage deine Änderungen auf GitHub

  1. Navigiere zum Git-Bereich im Fenster oben rechts und stelle sicher, dass dieses leer ist. Sollte es leer sein, dann überspringe 2. bis 5. und mache bei Unterschritt 6. weiter.

  2. Aktiviere die Kontrollkästchen neben allen Dateien, um sie für den Commit vorzubereiten.

  3. Klicke auf die Schaltfläche “Commit”.

  4. Gib eine Commit-Nachricht in das Feld “Commit Message” ein (z.B. ODG Daten Modul 3 abgeschlossen).

  5. Klicke auf die Schaltfläche “Commit”. Das Fenster, welches sich daraufhin öffnet kann geschlossen werden.

Hinweis: Git configuration aus Zusatzaufgabe von Modul 1

Es ist möglich, dass Git dich erneut darauf hinweist, dass es nicht weiss, wer du bist. Diese Einstellung haben wir in Modul 1 zwar gemacht, jedoch habe ich in der Vergangenheit beobachtet, dass es bei einigen Teilnehmer:innen erneut zu dieser Meldung kommt. In diesem Fall musst du erneut folgenden Schritt ausführen, um deinen Namen und deine E-Mail-Adresse zu konfigurieren.

  1. Klicke auf die Schaltfläche “Push”.

  2. Gib deinen GitHub-Benutzernamen im Feld Username an.

  3. Gib deinen GitHub Personal Access Token (PAT) im Feld “Password” ein.

  4. Das Fenster kann geschlossen werden.

Verwende nicht dein GitHub-Passwort

Du musst GitHub Personal Access Token (PAT) eingeben, den du in der Vorbereitung auf den Kurs erstellt hast um deine Änderungen zurück an GitHub zu übertragen.

Schritt 6: Eröffne ein Issue auf GitHub

  1. Öffne github.com in deinem Browser.

  2. Navigiere zur GitHub-Organisation für den Kurs: github.com/rstatszh-k009

  3. Finde das Repository ogd-daten-USERNAME, das mit deinem GitHub-Benutzernamen endet.

  4. Klicke auf die Schaltfläche “Issues”.

  5. Klicke auf die grüne Schaltfläche “New issue”.

  6. Schreibe in das Feld “Title”: “Zusatzaufgaben abgeschlossen”.

  7. Markiere im Feld “Leave a comment” den Kursleiter mit @larnsce und hinterlasse eine Nachricht oder offene Frage.