Projektlabor Robotik MINTgrün

Diese Seite ist nicht editierbar. Sie können den Quelltext sehen, jedoch nicht verändern. Kontaktieren Sie den Administrator, wenn Sie glauben, dass hier ein Fehler vorliegt.
====== Projektdokumentation im Robotiklabor MINTgrün ======
===== Allgemeines =====
Die Projektdokumentation soll die Ergebnisse eurer Arbeit zusammenfassen und nach außen präsentieren. 
Sie soll so geschrieben sein, dass ein technisch interessierter Außenstehender ohne Wissen über eurer Projekt verstehen kann, was ihr gemacht habt und alle nötigen Informationen hat, um euer Projekt nachzubauen oder weiter zu entwickeln.
	
Sie bildet 20% der Endnote.

\\
\\
===== Gliederung und Inhalte: =====

Die Projektdokumentation orientiert sich grob an einer wissenschaftlichen Arbeit mit Einleitung, Methodenteil, Ergebnissen und Fazit. 
Zur besseren Übersichtlichkeit sollte die Seite durch Überschriften gegliedert werden.
Die folgenden Inhalte gehören rein:

==== Themenbeschreibung/Einleitung ====
  * Kurze Beschreibung der Aufgabenstellung, die das Programm hat bzw. löst (ca. 1/2  "Bildschirmseite")
  * u.U. Hinweise und Links auf schon existierende ähnliche Arbeiten bzw. Projekte aus den alten Semestern

==== Methoden/Umsetzung: ====
=== Überblick über das Gesamtsystem ===

    * Welche Aufgaben waren zu lösen (ganz knapp)
    * Welche Aufgaben wurden bewusst ausgeklammert?
    * Idealerweise eine schematische Darstellung davon, was euer Programm macht (z.B. ein Flussdiagramm)

=== Einzelne Abschnitte zur Beschreibung von Details der einzelnen Systembestandteile ===
Hier geht ihr ins Detail. Jeder wichtige Bestandteil eurer Lösung  (z.B. "GUI", "Erkennung von X im Bild", "Berechnung von Y", "Modell für die Simulation von Z, "Anwendung des Algorithmus ABC" ) bekommt einen eigenen Abschnitt. 

Dabei sollte kein für die Funktion wesentlicher Teil komplett unerwähnt bleiben. Erklärt insbeondere diejenigen Teile ausführlich, in die ihr besonders viel Hirnschmalz gesteckt habt, oder zu denen es aussagekräftige Messdaten gibt.
    

  * Welche besonderen technischen, mathematischen oder programmiererischen Anforderungen standen bei der Arbeit im Vordergrund und wie wurden sie gelöst?
  * Sprache: Technisch detailliert, präzise und eindeutig, aber knapp formuliert. 
  * Abbildungen: Oft sagt eine Skizze oder eine Zeichnung mehr als tausend Worte! Sie sollte im aber einen Bezug zum Text haben und aus sich heraus verständlich sein.
  * Hierher gehören auch Grafiken, die die Zwischenergebnisse darstellen, die in eurem Projekt entstanden sind.
=== Technische Daten, Bauteile, Pins, etc.===
Hierher gehört...

==== Ergebnis und Diskussion ====
  * Endstand des Projekts: Was leistet die entwickelte Lösung und woran scheitert sie?
  * Falls die Qualität des Ergebnisses in Zahlen zu messen ist, gehören diese oder ein Diagramm damit hierhin. 
  * Ausblick: Wo bestehen Verbesserungs- oder Erweiterungsmöglichkeiten? Wie könnte man das Projekt weiter entwickeln (z.B. in den nachfolgenden Semestern)?

==== Code ====
Eine Sammlung des Kompletten Programmcodes gehört zu eurer Dokumentation. Wenn ihr wollt, könnt ihr dafür  eine gesonderte Seite, so dass sie verfügbar sind, ohne den Lesefluss allzu sehr zu stören. 

**Hier solltet Ihr eine lauffähige Version eures Codes inkl. aller verwendeten Libraries als .zip-Datei zum Download anbieten.**
Selbst wenn ihr eine git-Seite habt, ladt bitte den Code herunter als .zip und ladet hier hoch. Grund: der Code soll zugänglich sein, selbst wenn ihr z.B. euren github-Account löscht. 

\\
\\
===== Stil und Formales =====
  * Es geht nicht darum, jemanden zu beeindrucken, sondern etwas möglichst verständlich und präzise zu erklären. Am besten gelingt das mit einer knappen, präzisen, aber freundlichen Sprache ohne allzuviele Floskeln.
  * Falls Ihr irgendetwas gemessen oder berechnet habt, gehört das in die Dokumentation
  * Falls Ihr Informationen verwendet, die ihr nicht selbst durch Experimente oder Nachdenken gefunden habt, sollten diese mit einer Quelle belegt werden. Die Quellen könnt ihr auch als Links im Wiki-Text angeben, z.B. so: [[https://www.tu-berlin.de | TU Berlin]] (Wiki-Syntax: ''%%[[https://www.tu-berlin.de | TU Berlin]]%%'').
  * Fachwörter, die ihr benutzt, solltet Ihr auch verstanden haben. Im Zweifelsfall besser nachschlagen, als Unsinn zu schreiben.
  * Skizzen dürfen bei uns durchaus auch handgezeichnet sein. Sie sehen am besten aus, wenn sie auf weißem Papier gezeichnet sind und nach dem Scannen der Weißpunkt so gesetzt wird, dass der Hintergrund reinweiß ist, z.B. [[techniken:grafikgimp#hintergrund_einer_zeichnung_weiss_machen_mit_gimp| so mit GIMP]]. [[https://www.gimp.org/ | GIMP]] ist ein open-source Bildverarbeitungsprogramm, welches auch sonst bei der Vorbereitung der Abbildung für die Dokumentation nützlich sein kann. 
  * Alle Abbildungen und Diagramme sollten nummeriert und mit einer kurzen Bildunterschrift versehen sein, die die wesentlichen Aussagen und Inhalte der Grafik knapp erklärt, z.B. so wie in Abb. {{ref>mosfet}} (s. den Wiki-Quelltext, wie der Link an der Stelle der Abbildungsnummer erstellt wurde): \\

<figure mosfet>
{{:techniken:mosfet_schalter_strombegrenzer_pulldown_induktiv.jpg?400|}}
<caption>Arduino-MOSFET-Schalter für induktive Lasten </caption>
</figure>

  * Das Gleiche gilt für Tabellen -- sie bekommen eine eigene Nummerierung. 
  * Bitte verteilt eure Dokumentation nicht auf zu viele Unterseiten, sie ist dann schwer zu lesen.

  * **Wir wollen von euch eine Wiki-Seite! Also keine PDFs, Papierausdrucke oder Word-Dateien!**

\\
\\
===== Beispiele besonders gelungener Projektdokus vergangener Semester: =====
  * [[projektews1415:soccerbot|soccerbot: Gute Schwerpunktsetzung und Erklärungen anhand von Formeln und die vielen Abbildungen.]]
  * [[projektews1415:malokal|malokal: Sehr schöne Bilder, sehr Umfangreich, es fehlt jedoch eine quantitative Schätzung des sich ansammelnden Lokalisiserungsfehlers]]
  * [[projekte2014:beerbot:dokumentation|beerbot:Großer Detailumfang, viele guten Abbildungen. Der Aufbau ist in der Grundstruktur gut. Der Endstand ist ehrlich dargestellt, eine tiefere Analyse der Fehlerursachen fehlt aber.]]
  * [[projektewise1718:haligalipublic:start|Halli Galli: Gute Abbildungen, aber eine Diskussion der Ergebnisse und Probleme hätte ausführlicher sein sollen.]]
  * [[projektewise1718:catcherpublic:start|CATcher: Gute schematische Abbildungen, ausführliche Diskussion der Ergebnisse.]]
Projektlabor Robotik MINTgrün

Benutzer-Werkzeuge

Webseiten-Werkzeuge

Seiten-Werkzeuge
