## page was renamed from DVA_Praktikum #language de #format rst DVA Praktikum für TI (Gruppe Högl) ================================== | Hubert Högl, , http://hhoegl.informatik.hs-augsburg.de | URL: http://hhoegl.informatik.hs-augsburg.de/hhwiki/DVATI_Praktikum | Moodle: https://moodle.hs-augsburg.de/course/view.php?id=4094 (Anmeldung, Ankündigungen, Forum) | Versuche: http://www.hs-augsburg.de/homes/hhoegl/dvati_versuche | Versuchsbelegungsplan: https://cloud.hs-augsburg.de/apps/onlyoffice/84444846 | Sphinx Demo-Bericht: http://hhoegl.informatik.hs-augsburg.de/dva/sphinxbericht | Gitlab Repos der Teams: https://r-n-d.informatik.hs-augsburg.de:8080/dvati/berichte-ws20 | Zoom Zugang: :: ============ Zoom, Mittwoch 08:15 Uhr ================= https://hs-augsburg.zoom.us/j/99468811182?pwd=ZlVYTlE0bzV2YXFOVkhvdjBvN0RJdz09 Meeting-ID: 994 6881 1182 Kenncode: 925295 .. contents:: Inhalt .. sectnum:: .. Ab dem Sommersemester 2010 betreue ich das DVA-Praktikum für die Technischen Informatiker (TI). Willkommen zum *DVA Praktikum für Technische Informatiker*. Die Veranstaltung soll dazu dienen, dass Sie ... * sich mit wichtigen Themen aus der Technischen Informatik vertraut machen. * verständlich über die Themen reden können, daher wird es eine wöchentliche Kommunikation mit dem Betreuer geben. * das, was Sie gelernt haben, auch in einem Bericht niederschreiben. Aus einer Themenliste werden Sie ein Semester lang alle ein bis zwei Wochen einen neuen Versuch bearbeiten. Insgesamt sind es fünf Versuche je Team. Die technische Schwierigkeit steht dabei wegen der kurzen Bearbeitungszeit nicht im Vordergrund. Die Versuche werden eher leichte bis mittlere Anforderungen stellen. Die Veranstaltung zählt mit 3 *Creditpoints*, das heisst der Arbeitswaufwand liegt bei 90 Stunden je Teammitglied. .. - Gruppe 1: Montag, 9:50-11:20 Uhr / G2.17 (Schöppler, ). **Achtung:** Dieser Termin ist parallel zum Elektrotechnik-Praktikum. - Gruppe 2: Montag, 11:40-13:10 Uhr / G2.17 (Schöppler) - Gruppe 3: Mittwoch, 8-9:30 Uhr / G2.16 (Högl, Schäferling , max. 16 TeilnehmerInnen) * Moodle: - https://moodle.hs-augsburg.de/course/view.php?id=2843 (Gruppe 3) - https://moodle.hs-augsburg.de/enrol/index.php?id=2916 (Gruppe 1 und 2) * Gitlab für Gruppe 3: https://r-n-d.informatik.hs-augsburg.de:8080/dvati/berichte-ws20 Die Anzahl der Teams innerhalb der Gruppe ändert sich noch. Je Team wird ein Student oder eine Studentin als Maintainer eingetragen. Alle weiteren Teammitglieder trägt der Maintainer ein. Ablauf ------ Am Anfang werden wir die Gruppen und Teams einteilen. Alle Studierenden werden wahrscheinlich in drei Gruppen eingeteilt. Jede Gruppe wird aus höchstens 16 Personen bestehen. Jede Gruppe wird aus mehreren Teams bestehen, jedes Team umfasst zwei bis drei Personen. Jedes Team sucht sich einen Versuch aus einer Liste von Versuchen (``_) aus und bearbeitet ihn in der vorgegebenen Zeit (siehe Abschnitt Termine_). Jedes Team schreibt im Semester *einen* Bericht, der für jeden Versuch ein Kapitel enthält. Der Bericht wird mit `Sphinx `_ geschrieben und in einem `Gitlab `_ Repository fortlaufend aktualisiert. Der Bericht existiert *nur in elektronischer Form*. Auch die pro Versuch angefertigten Quelltexte werden in gitlab abgespeichert. In der **Bearbeitungszeit** des Versuchs arbeiten alle Team-Mitglieder zusammen. Typische Tätigkeiten sind Recherche, Planung, Hardware aufbauen, Programmierung, Fehlersuche, Test und Dokumentation. Sie können entweder ausserhalb der Hochschule oder in den Laboren der Hochschule (G2.16, G2.17) arbeiten. Dazu sind die Labore täglich geöffnet von ca. 8:00 bis 17 Uhr. Die Zusammenarbeit aus der Ferne wird durch das Gitlab Versionskontrollsystem vereinfacht. .. figure:: http://hhoegl.informatik.hs-augsburg.de/dva/workflow/workflow1.png :width: 500 :align: center *Diese Menschen und Dienste sind beim DVA Praktikum beteiligt.* Die **Abgabe** erfolgt nach der ein- oder zweiwöchigen Bearbeitungszeit. Es ist unter Umständen nicht zwingend erforderlich, dass Sie bei der Abgabe persönlich anwesend sind, **die Anwesenheit kann jedoch von Ihren Betreuern jederzeit gefordert werden.** Eine Abgabe ohne Anwesenheit würde wie folgt ablaufen: Nach der Bearbeitungszeit befindet sich im Repository des Teams das entsprechende Versuchskapitel und alle sonstigen benötigten Dateien, Quelltexte, etc. Falls der Versuch vom Betreuer ohne Probleme aus dem Bericht nachvollzogen werden kann, und auch sonst alle Vorgaben erfüllt werden, dann kann der Versuch auch ohne Anwesenheit abgenommen werden. Dazu ist natürlich ein sehr gut geschriebener Bericht erforderlich. Verbesserungsvorschläge werden über Gitlab Issues an die Teams übermittelt. Auf diese Weise wäre es auch möglich, dass Studierende, die sich zu der Zeit nicht an der Hochschule aufhalten (z.B. Auslandssemester), am Praktikum teilnehmen können. Die Abgabe mit Anwesenheit findet im zuständigen Labor statt, z.B. G2.16. Bei der Abgabe hält das Projektteam einen kurzen Vortrag und zeigt eine Versuchsvorführung. Der Berichts kann dabei über einen Beamer an die Wand projeziert werden. In der Regel werden zur Vorführung und zum Bericht Verbesserungsvorschläge gemacht, die innerhalb der darauffolgenden Woche umgesetzt werden müssen. Bei einer zweiwöchigen Bearbeitungszeit kann der Zwischentermin für eine "Lagebesprechung" vor Ort im Labor oder virtuell über Videokonferenz genutzt werden. Jedes Team kann von den Betreuern dazu in die Labore eingeladen werden. Die Versuche werden je Team als **bestanden** oder **nicht bestanden** gewertet. Die Betreuer führen je Versuch und Team einen "Zustandsautomaten", der wie folgt funktioniert: .. figure:: http://hhoegl.informatik.hs-augsburg.de/dva/workflow/dvafsm.png :width: 350 :align: center *Der Zustandsautomat der Bewertung.* Jedes Team muss bei allen Versuchen den Zustand "bestanden" erreichen. Gitlab ------ Nach der Vorbesprechung lege ich die benötigte Anzahl Repositories auf Gitlab an und gebe über Moodle an alle Bescheid. Der *owner* der Repositories bin ich. Als *maintainer* wird ein Studierender pro Team ausgewählt, der dann selbständig die weiteren Teammitglieder einteilen kann. Die Repositories liegen alle unter dem Pfad https://r-n-d.informatik.hs-augsburg.de:8080/dvati/berichte-ws20/ In jedem Gitlab Repository liegt an oberster Stelle eine Datei ``README.md``. Der Inhalt wird im `Markdown `_ Format geschrieben. Gitlab zeigt den Inhalt dieser Datei schön formatiert an. Die Datei dient als erste Beschreibung, wenn jemand das Repository auswählt. Deshalb sollte in etwa der folgende Inhalt enthalten sein: .. code-block:: text # DVA Praktikum für Technische Informatiker Hochschule Augsburg \ Fakultät für Informatik \ Wintersemester 2020/2021 \ Prof. Dr. Hubert Högl **Gruppe: 1** 1. Hans Maier, #123456, INF6, 2. Anna Huber, #126987, INF6, 3. Franz Xaver, #349816, INF8, 4. Isolde Weber, #432190, INF8, Das Gitlab Repository dieses Berichts ist unter https://r-n-d.informatik.hs-augsburg.de:8080/dvati/berichte-ws20/1 Der Bericht im HTML Format liegt hier: http://www.hs-augsburg.de/~xxx/xxx. Statt der \\-Zeichen kann man zum Zeilenumbruch auch zwei oder mehr Leerzeichen am Zeilenende verwenden. Der Bericht ----------- Einen Demo-Bericht finden Sie im HTML Format unter http://hhoegl.informatik.hs-augsburg.de/dva/sphinxbericht. Im Bericht steht, wo der Quelltext des Berichtes auf gitlab liegt. Von dort können Sie ihn "klonen" und für Ihr Team anpassen. Gitlab und RZ-WWW ................. Der "Quelltext" des Berichtes liegt im Gitlab Repository. Nehmen Sie aber nur die Quelldateien in das Repository auf, *nicht* das Verzeichnis für die HTML Ausgabe ``_build/html/``! Die HTML Ausgabe wird erzeugt durch ``make html``. Die generierte HTML Ausgabe des Berichts (unter ``_build/html/``) soll in Ihrem RZ WWW-Verzeichnis gespeichert werden. Auf dem Rechner ``login.rz.hs-augsburg.de`` findet man dieses Verzeichnis in ``/www/``, wobei ```` Ihr Login-Name ist. Dieses Verzeichnis finden Sie im WWW unter ``http://www.hs-augsburg.de/~user``. Sie finden diese Angaben auch im Demo-Bericht auf Kapitel 4.7 (*Auf Webspace übertragen*). Es genügt, wenn der Bericht in dem Web-Verzeichnis eines einzigen Teammitglieds liegt und dieser URL in die README.md Datei aufgenommen wird. .. Der Bericht kann bei Bedarf über Sphinx auch als PDF Datei ausgegeben werden ("make latex"). Diese Option ist ganz praktisch, wenn man einen Überblick bekommen möchte, wie viele Seiten man schon geschrieben hat. Ausserdem sieht man, ob die Grösse der Bilder im PDF Format stimmt. Wir brauchen die Berichte **nicht auf Papier** (ganz nach dem Logo "paperless"). Zum Inhalt .......... Der Bericht enthält für jeden durchgeführten Versuch ein Kapitel. Jedes Versuchskapitel sollte in etwa folgende Gliederung aufweisen: Datum, Thema 1. Einleitung Motivation, Aufgabenstellung 2. Grundlagen 3. Versuchsdurchführung Vorbereitung, Durchführung, Ergebnisse, Probleme 4. Zusammenfassung Fazit, Tipps für spätere Teams 5. Literaturangaben **Ganz wichtig:** Bei jedem Versuch muss nachvollziehbar sein, wer im Team welche Arbeit gemacht hat und welcher Zeitaufwand dafür in etwa nötig war! Der Bericht muss darüber Auskunft geben. Hier ist ein Beispiel-Bericht: - Gitlab https://r-n-d.informatik.hs-augsburg.de:8080/dva/berichte-2019/1 - RZ Home https://www.hs-augsburg.de/~brobot/dva Die Vorbereitungsaufgaben ------------------------- (Das folgende gilt nur für meine Gruppe. Bei den anderen Gruppen regelt das der jeweilige Betreuer.) Die Vorbereitungsaufgaben dienen dazu, dass sich alle Teams an den Ablauf gewöhnen. Sie werden sich mit folgendem beschäftigen: - Mit Sphinx anfreunden (http://www.sphinx-doc.org/en/master/contents.html), siehe "Getting Started" - Mit Git und Gitlab anfreunden - http://hhoegl.informatik.hs-augsburg.de/hhwiki/GitSpicker - https://git-scm.com/doc - Freies "Pro Git" Buch in Deutsch https://git-scm.com/book/de/v2 - https://docs.gitlab.com/ce/ - Einloggen auf https://r-n-d.informatik.hs-augsburg.de, Beispiel-Repository anlegen, klonen, commit, push, pull, ... Das sollen alle Teammitglieder mit dem Beispiel-Repository testen, so dass Sie sich an die gemeinsame Arbeit in Gitlab gewöhnen. - ssh Schlüssel in gitlab anlegen (https://docs.gitlab.com/ce/ssh/README.html) - https://education.github.com/git-cheat-sheet-education.pdf - den Demobericht lesen und auf Ihr Team personalisieren und in Ihr Gitlab Repository aufnehmen - die HTML Ausgabe des Berichtes auf Ihr Web-Verzeichnis im RZ ablegen (das müssen Sie natürlich nach jeder Veränderung des Berichts wiederholen) .. _termine: Termine ------- Oktober bis Dezember 2020, Mittwoch, 8:15 - 9:30, G2.16 oder Videokonferenz :: 1. 7.10. Vorbesprechung 2. 14.10. Besprechung der Vorbereitungsaufgaben Ausgabe Versuch 1 21.10. 3. 28.10. Abgabe Versuch 1 Ausgabe Versuch 2 4.11. 4. 11.11. Abgabe Versuch 2 Ausgabe Versuch 3 18.11. 5. 25.11. Versuch 3 Ausgabe Versuch 4 2.12. 6. 9.12. Versuch 4 Ausgabe Versuch 5 7. 23.12. Abgabe Versuch 5 .. vim: et sw=4 ts=4