Skip to content

Handbuch

Jump to bottom
Markus Kurtz edited this page Dec 15, 2016 · 2 revisions

Allgemeines

  • Der VUKL sollte einen eigenen Ordner haben, in es mindestens die Unterordner „csv“, „db“, „scheme“ und „tex“ gibt. Die Dateien VUKLin.py und VUKLout.py sollten im Ordner VUKL liegen.
  • Im Ordner „schemes“ gibt es verschiedene Schemata, nach denen ausgewertet wird. Durch ein Schema kann man beispielsweise angeben, in welcher Reihenfolge Fragen ausgewertet werden sollen oder ob man bei einer Frage filtern will (siehe Neue Fragebögen im VUKL)
  • Im Folgenden gehen wir davon aus, dass „umfrageschema“ das Schema ist, in dem alle Fragen drin stehen und nicht nach verschiedenen Studiengängen o. Ä. aufgetrennt wird. Einzig nach den Übungsleitern ist bereits aufgetrennt.

Ablauf bei Vorlesungsumfrage

Dann ist das Vorgehen wie folgt:

  1. Dateien im csv-Format aus dem EvaSys exportieren und im Ordner …/VUKL/csv abspeichern. Zum Exportieren im EvaSys als Teilbereichsadministrator links Datenexport anklicken. Oben müssen nun Rohdaten und csv ausgewählt sein. Dann wählt man wie üblich Mathematik, aktuelles Semester, Vorlesung, einen Fragebogentyp und alle Vorlesungen, zu denen man eine Umfrage mit diesem Fragebogen hat (per STRG-Taste kann man mehrere Umfragen markieren). Dann klickt man auf Abrufen und speichert die Datei ordnungsgemäß. Intelligenterweise steht im Dateinamen sogar, um welchen Fragebogen es sich handelt. Um sich später die Arbeit etwas zu vereinfachen, kann man die Dateinamen, sobald die Dateien im Ordner …/VUKL/csv abgespeichert sind, verkürzen (dabei sollte klar bleiben, um welchen Fragebogentyp und welche Sprache es sich handelt!).
  2. Sind die Daten unter …/VUKL/csv gespeichert, so kann man die Daten importieren. Dazu geht man in den Ordner …/VUKL und öffnet dort ein Terminal. Hier tippt man nun python3 VUKLin.py ein, woruafhin folgender Dialog erscheint:
  • _ ### VUKLin ### Eineleseroutine von VUKL_ -- als Titelzeile
  • Folgende Dateien wurden im Ordner 'csv' gefunden: -- Darunter aufgelistet stehen alle Dateien in selbigem Ordner.
  • Welche Datei soll eingelesen werden? -- Doppelklick auf die gewünschte Datei und mittlere Maustaste zum Einfügen. Alternativ kann man den Dateinamen auch abtippen (auf Groß-/Kleinschreibung achten, Tab-Vervollständigung geht nicht)
  • Sind die Daten von einem deutschen (default) oder englischen Fragebogen (en)? -- Hier muss man logischerweise die richtige Sprache auswählen.
  • Folgende Tabellen wurden in der Datenbank bereits gefunden: -- Dies wird gefolgt von einer Liste der existierenden Tabellen. Diese sollten analog zu den Fragebogennamen im EvaSys benannt sein.
  • Welcher Tabelle sollen die Daten angefügt werden, bzw. wie soll die neue Tabelle genannt werden? -- Hier tippt man den Tabellennamen einfach ab oder nutzt wieder Doppelklick und die mittlere Maustaste.
  • Danach wird, Vorlesung für Vorlesung, nach dem deutschen (und englischen) Vorlesungstitel gefragt; diese tippt man einfach ein. Wenn der vorgesehene Titel bereits richtig ist, kann man auch einfach direkt Enter drücken.
  • Nun gibt es noch eine Frage nach dem LV-Subdozent. Hier drückt man einfach Enter und ignoriert die Frage ansonsten.
  • Bei Übungen wird zusätzlich gefragt, wodurch die Werte in Frage 1 ersetzt werden sollen. Das heißt: Welche Nummer gehört zu welchem Übungsleiter? Das tippt man ebenfalls einfach im Terminal ein, sobald man danach gefragt wird.
  1. Hat man dies für alle Vorlesungen eines Fragebogentyps gemacht, so startet man den Prozess neu, um den nächsten Fragebogentyp einzulesen. Danach sind die Dateien in der Datenbank vorhanden.
  2. Nun geht es an die Ausgabe: Dazu öffnet man, wieder im Ordner …/VUKL ein Terminal und tippt ein: python3 VUKLout.py. Es erscheint folgender Dialog:
  • Welche Auswahl von Veranstaltungen möchten Sie auswerten?
    any: komplettes Semester
    1: Alle Veranstaltungen eines Dozenten
    2: Alle Veranstaltungen eines Übungsleiters
    3: Einzelne Lehrveranstaltungen Hier können auch nach und nach mehrere Veranstaltungen zusammen ausgewertet werden.
  • Aus der nun folgenden Liste an Semestern/Dozenten/Übungsleitern/Vorlesungen (je nachdem, was man eben ausgewählt hat), wählt man die passende ID und tippt die richtige Nummer ein.
  • Hat man oben Option 3 gewählt, so kann man nun weitere Vorlesungen hinzufügen oder eben nicht.
  • Als nächstes muss das Auswertungsschema gewählt werden. Bis alle Tippfehler korrigiert und die VU vollständig korrekturgelesen wurde, sollte man hier immer umfrageschema wählen.
  1. Im Ordner …/VUKL/tex sollte nun eine Datei vukl.tex existieren. Es gibt dann zwei verschiedene Unterordner (auswertung und aushang); die darin enthaltenen tex-Dateien greifen jeweils auf vukl.tex zu und erstellen entsprechende pdf-Dateien:
  • aushang: (momentan farbige) Auswertung, die ausgehängt werden kann; insbesondere sind passend Leerseiten eingefügt, sodass das Aushängen (auch wenn man doppelseitig druckt) einfach möglich ist.
  • auswertung: farbige Auswertung ohne Leerseiten zwischen Vorlesungen, die an die Dozenten verschickt werden kann. Diese ist auch zum Korrekturlesen am einfachsten zu handhaben :)
  1. Hat man eine kompilierte pdf-Datei (bspw. im Terminal durch pdflatex aushang.tex, analog in den anderen Ordnern), generiert, so kann man mit dem Korrekturlesen beginnen. Fallen einem dabei Fehler auf, so korrigiert man diese wie folgt:
  • Design/tex-Fehler: an Markus Kurtz wenden und ihn freundlich bitten, dass er einem helfen möge. Alternativ irgendjemanden fragen, der Ahnung von tex/latex hat; Markus hat allerdings schon seeehr viel mit den vukl-Dateien gearbeitet und kennt sich daher am besten aus.
  • Tippfehler in Kommentaren: Man öffne im Ordner …/VUKL/db ein Terminal, tippe ./sqlitestudio-2.1.5.bin ein und die Datenbank öffnet sich. Dort klickt man auf den passenden Fragebogentyp und wählt im rechten Fenster oben Daten aus. Dort existiert ein Suchfeld; darüber findet man am leichtesten den passenden Bogen. Ein Doppelklick in das Feld mit dem Kommentar ermöglicht das Ändern des Inhalts des Feldes. Nachdem man fertig korrigiert hat, drückt man Enter und klickt in der Leiste oben auf den Haken im orange-roten Feld (namens commit changes, Achtung: klickt man diesen Haken nicht an, so werden die Änderungen nicht gespeichert!).
  1. Nach dem Korrekturlesen und Fehlerverbessern muss man erneut VUKLout.py ausführen, wodurch eine neue Datei vukl.tex erstellt wird (oBdA überschreibt diese die alte vukl.tex).
  2. Die Schritte 4 bis 7 wiederholt man, bis die Auswertung fehlerfrei ist.
  3. Ist die Vorlesungsumfrage vollständig korrekturgelesen, so kompiliert man die aushang.tex-Datei und hat einen fertigen Aushang, den man drucken und aushängen kann. Es gibt übrigens auch eine schwarz-weiß-Version, dazu wählt man in der Datei aushang.tex einfach die Option \documentclass[aushang,gray]{../vukl} aus.
  4. Wenn man nach verschiedenen Dingen filtern will (bspw. eine Auftrennung nach Studiengängen), so legt man dafür am besten ein eigenes Schema an (dies funktioniert einfach analog zu den alten Schema-Dateien). Dann lässt man VUKLout.py für die verschiedenen Schemata durchlaufen und kompiliert entsprechend die Dateien.

Neue Fragebögen im VUKL

Die neuen Fragebögen müssen natürlich auch im VUKL eingelesen werden. Dieser muss dazu in der Datenbank eine neue Tabelle für diesen Fragebogen anlegen (damit dort nicht irgendwann eine sehr große Anzahl an Fragebögen vorhanden ist, kann man sich dafür auch ein schöneres Konzept überlegen). Das Vorgehen dabei ist Folgendes:

  1. unter …/VUKL/db die Datei meta.csv öffnen (vorher eine Sicherheitskopie zu erstellen, ist sehr empfehlenswert). Als Kodierung sollte wie immer Westeuropa (ISO-8859-1) verwendet werden (im Vorschaumodus erkennt man auch, ob alle Sonderzeichen ordentlich lesbar sind).
  2. Die Tabelle sollte nun analog zu den existierenden Fragebögen aufgefüllt werden. Dabei haben die Spalten folgende Funktionen:
  • A: Jeder Fragebogen bekommt eine eigene ID (bspw. MA-ID), die meistens dem Kürzel im EvaSys entspricht (Konsistenz ist durchaus sinnvoll, Bindestriche darf man aber auch weglassen, um die IDs nicht allzu lang werden zu lassen). Die Fragen werden dann durchnummeriert, sodass die erste Spalte immer von der Form MA-ID_i für Frage i ist.
  • B: Fragentext deutsch
  • C: Fragentext englisch
  • D: Datentyp (1). Bisher reichten die Typen Integer (für fast alles) und String (für Kommentare) aus. %Von anderen Datentypen habe ich keine Ahnung.
  • E: Datentyp (2). Hier gibt es weiter beschreibende Datentypen:
    • Single: Für Aufzählungen in der Auswertung (bspw. bei Studiengängen und Vertiefungen).
    • SemesterBA/SemesterMA: Einzig und allein für die Semesterfrage. Hintergrund ist, dass dies im EvaSys zwei Fragen sind, die für die Auswertung zusammen gemergt werden, was diese beiden Befehle irgendwie tun.
    • Skala: Für alle Skala-Fragen, die eine Wertung haben (bspw. trifft voll zu als positiv). In der Auswertung haben diese Fragen eine bunte Skala in den Farben rot, gelb und grün.
    • SingleGraph: Für neutrale Skala-Fragen, die in der Auswertung als blauer Graph erscheinen (bspw. Arbeitsaufwand).
    • YesNoComment: Für Ja-Nein-Fragen (bspw. die Fragen nach terminlichen Überschneidungen).
    • Offen: Für Kommentare.
  • F: Poltext links (deutsch), also was auf der linken Seite der Skala zu lesen ist.
  • G: Poltext rechts (deutsch), also was auf der rechten Seite der Skala zu lesen ist.
  • H: Poltext links (englisch)
  • I: Poltext rechts (englisch)
  • J: Was ist das Positive, also das, was wir erreichen wollen? Bei den meisten Fragen (insbesondere trifft zu-Fragen) kann dies leer gelassen werden (aktuell ist hier nur bei SingleGraph- und einigen Skala-Fragen etwas einzutragen). Bei Fragen, deren Skala von viel zu niedrig bis viel zu hoch reicht, ist das Positive die Mitte, deshalb muss hier ein C eingetragen werden (für center). Nicht bewertete Fragen (bspw. nach dem Arbeitsaufwand) müssen hier ein N (für neutral) stehen haben.
  • K: Diese Spalte einfach ignorieren (ich habe keine Ahnung, was sie tut, lässt man sie leer, funktioniert es).
  • L: Range = Anzahl der Antwortmöglichkeiten
  • M und folgende Spalten: Single_de_i ist der i-te deutsche Antworttext der Frage; Single_en_i ist der i-te englische Antworttext der Frage.
  1. Die meta.csv-Datei muss nun mit dem Programm Mousepad oder TeXstudio geöffnet werden und die letzte Leerzeile entfernt werden (die meisten anderen Programme können das tatsächlich nicht bzw. fügen immer wieder eine Leerzeile hinten an).
  2. Nun öffnet man ein Terminal in …/VUKL/db und tippt ./sqlitestudio-2.1.5.bin, was die Datenbank öffnet (wieder ist es empfehlenswert, eine Sicherheitskopie zu haben). Hier muss man nun die Tabelle meta anklicken und dann oben unter Tabelle die Option Erase table data auswählen. Dies löscht alle Daten in dieser Tabelle. Ebenfalls unter Tabelle oben wählt man nun Import data to a table aus. In dem sich öffnenden Feld klickt man auf Konfigurieren und wählt als Inputfile meta.csv aus. Nun möchte man alle Optionen angezeigt bekommen und kreuzt die Optionen Treat first row as column names, Expect Microsoft format of csv und Convert from encoding an. Bei letzterer wählt man utf-8 im Feld darunter. Des Weiteren wählt man als Spalten Trennzeichen \t tab. Nun klickt man auf OK und wählt als Datenbank vukl.db aus. Nachdem man als Tabelle Existing angeklickt hat, wählt man die Option meta.

Nachdem dies passiert ist, exportiert man Daten aus dem EvaSys und tut so, als ob man sie normal einVUKLn möchte (wie unter Ablauf beschrieben). Wenn nach der Tabelle für den neuen Fragebogen gefragt wird, gibt man einfach den Titel der neuen Tabelle ein. Da diese Tabelle noch überhaupt nicht in der Datenbank existiert und dementsprechend nicht in der Liste auftaucht, wird diese Tabelle nun angelegt. Um die Daten tatsächlich in der Datenbank zu haben, ist ein erneutes EinVUKLn notwendig.

Clone this wiki locally