===========================
**Medienverarbeitung 2017/18**
===========================
*Carl-von-Ossietzky Universität, Oldenburg*
-------------------------------------------
Topic H - What mood expression is this?
'''''''''''''''''''''''''''''''''''''''

Setup
=====

1. Falls nicht vorhanden, `pip <https://pip.pypa.io/en/stable/installing/>`_ installieren

2. Falls nicht vorhanden, pip3 installieren::

    pip install pip3

**Info**: pip verwendet zur Installation der Packages den Python 2.7 Interpreter. pip3 hingegen verwendet Python3.

3. pip3 auf die aktuellste Version updaten::

    pip3 install --upgrade pip

4. Bei Bedarf eine virtuelle Umgebung anlegen::

    python3 -m venv <pfad>

4. Umgebung in der Konsole aktivieren::

    <pfad>\Scripts\activate.bat - Windows
    source <pfad>/bin/activate - macOS


5. Dependencies aus requirements.txt installieren::

    pip3 install -r requirements.txt



***************
Model Injection
***************

Um das Hauptprogramm ``webcam.py`` auszuführen,
muss ein konkretes Model übergeben werden und die darin beschriebenen Emotionen als Parameter definiert sein.

Im Ordner ``projectmood/resources/models/`` befinden sich zwei verschiedene Models: ``five_emotions.xml`` sowie ``three_emotions.xml``

Die drei Emotionen behandeln *neutral*, *happy* und *sadness*.
Der Fünf-Klassen-Classifier außerdem noch *anger* und *sadness*.

Konsolenbefehl um die beiden Classifier zu injizieren und das Programm zu starten:

1. ``python3 webcam.py -013 -m resources/models/three_emotions.xml -r 250``

2. ``python3 webcam.py -01236 -m resources/models/five_emotions -r 250``

Für weitere Informationen ``python3 webcam.py -h``