Running dashapp projects

1. Prerekvizity

• java >=1.8
• git
• Eclipse IDE for Java Developers (http://www.eclipse.org/downloads/packages/eclipse-ide-java-developers/oxygenr)

2. Stažení

• checkout těchto repozitářů:
  • 3rd-party: branch devel (obsahuje některé pomocné externí věci, které využívá aplikace)
    • https://github.com/Jirka/3rd-party
  • dash: branch feature-4-segmentation (samotná aplikace)
    • https://github.com/Jirka/dash
  • použití ssh klíčů místo přihlašování loginem: https://github.com/Jirka/dash/wiki/Multiple-ssh-keys
• je možné udělat v eclipse:
  1. Window > Perspective > Open Perspective > Git
  2. V pohledu Git Repositories > Clone Git repository
  3. vyplnit údaje
  • (používám protokol ssh - asymetrické šifrování - veřejný klíč nahraný na githubu) https://developer.github.com/v3/guides/managing-deploy-keys/
  • případně běžné přihlašování (ale je to méně pohodlné)

4. vybrat patřičné branche > Finish
5. přepnutí do branche (pravým tlačítkem na repositář > Switch to)

3. Import projektů

• přes Git perspektivu:
  1. Window > Perspective > Open Perspective > Git (pokud již není otevřená)
  2. pravým tlačítkem na repositář > Import projects
  3. proklikat dialog, vybrat všechny projekty > Finish
  4. Window > Perspective > Open Perspective > Java (projekty by měly být vidět)
• nebo přes Java perspektivu:
  1. File > Import > General > Existing projects into workspace
  2. proklikat dialog, vybrat projekty > Finish
• neimportujte root projekty dash a 3rd_party, pouze zanořené projekty dash.* a 3rd_party.*

4. Překlad a spuštění

• nepoužívám žádný buildovací systém, překládám v Eclipse
• spouštím přes třídu DashApp obsahující metodu main
• třída je obsažena v projektu dashapp.rel.segmentation
• kliknout pravým tlačítkem na třídu DashApp > Run as > Java application

5. Ovládání aplikace

• http://www.fit.vutbr.cz/~ihynek/dashboards/doku.php?id=iis:2016#ovladani_aplikace

6. Struktura projektů

• zdrojové kódy jsou člěněny do několika projektů, většinu věcí pro začátek nebudeš potřebovat
• zde je stručný popis projektů
  • dashapp.core - jádro a model aplikace
  • dashapp.ui - UI aplikace
  • dashapp.rel.* - spuštění a konfigurace aplikace
    • mám několik konfigurací pro konkrétní účely
    • pro tvojí práci jsem vytvořil dashapp.rel.segmentation
  • dashapp.core.image, dashapp.ui.image (nějaké nástroje pro práci s obrázky)
  • dashapp.core.eval.*, dashapp.ui.eval - metriky pro ohodnocování dashboardů
  • dashapp.core.segmentation, dashapp.ui.segmentation - kostra připravená pro algoritmy segmentování

7. Kostra pro implementaci algoritmů

• dashapp.ui.segmentation - obsahuje implementaci menu Segmentation - třída SegmentationTool
• dashapp.core.segmentation - obsahuje kostru pro algoritmy segmentaci - zde budeš moci psát své rozšíření - ukázka ve třídě SegmentationAlgorithm1:
  • metoda Dashboard processImage(BufferedImage image)
    • převezme BufferedImage (rastr)
    • vrátí strukturu Dashboard reprezentující regiony (obdélníky) - vysvětlim osobně/přes Skype
    • samotný preprocesing obrázku není nutné dělat v javě (klidně můžeš zavolat nějakou externí aplikaci) - v takovém případě bych ti tu metodu upravil a předal ti raději File, aby si měl cestu k souboru