<?xml version="1.0"?>
<api>
  <query-continue>
    <allpages gapcontinue="Retail_Analytics/Setup" />
  </query-continue>
  <query>
    <pages>
      <page pageid="118" ns="0" title="Retail Analytics">
        <revisions>
          <rev contentformat="text/x-wiki" contentmodel="wikitext" xml:space="preserve">&lt;languages /&gt;

&lt;translate&gt;

{{TOC right}}

=Retail Analytics=

Retail analytics is a system based on face recognition providing a beautiful and innovative tool to trace and analyze your costumers and their reactions, triggering contents accordingly. Q-Better RA allows a quick detection and analysis of faces in image sequences, videos and single frames. 
Begin with [[Retail Analytics/Setup|Setup]] to install the application, then [[Retail Analytics/Run|Run]] to configure it. To configure your triggers or analyze the generated data, please refer to [[Retail Analytics/Statistics|Statistics]].


[[File:RA_System.png|thumb|750px|none|Retail Analytics system]]

&lt;/translate&gt;</rev>
        </revisions>
      </page>
      <page pageid="127" ns="0" title="Retail Analytics/Run">
        <revisions>
          <rev contentformat="text/x-wiki" contentmodel="wikitext" xml:space="preserve">=Run=

[[File:Main_RA.png|thumb|650px|none|Retail Analytics main window]]

==Getting Started==

This is Retail Analytics main window, where you can start the software engine.
In the left side, you have &quot;Video Source&quot;. Select the camera you want to use with the system. Click the play button on the right.
Below this, there's &quot;Video Settings&quot;. This is where you can configure some properties of the video source, like brightness or contrast.
In the right top corner, you can select &quot;Full Screen&quot; to run the system in full screen. To configure your triggers please refer to [[Retail Analytics/Statistics#Triggers|Triggers]].

[[File:VideoSettings_RA.png|thumb|250px|none|Video Settings]]

==Advanced Settings==
===Engine Mode===

There are two modes for the engine: &quot;Kiosk&quot; and &quot;Big Space&quot;. The differences between the two are related to the trigger activation.

;Kiosk
: In Kiosk mode, the trigger is activated as soon as a person stands in front of the camera. The system analyses the person's data and starts its trigger, for the respective kind of consumer (by gender, age group, ...).
;Big Space
: &quot;Engine Settings&quot; has an option named &quot;Big space tick frequency&quot;. This option is defined in minutes and refers to the time interval of analysis. If set to 30 (minutes) this means that, for 30 minutes the engine will analyse the consumer's data (gender, age group) without any trigger during that time. After 30 minutes and after find the predominant kind of consumer, the specific trigger will start.

==Engine Settings==

[[File:EngineSettings_RA.png|thumb|250px|none|Engine Settings]]

;Learn time
: After recognize a face, this is the amount of time spent analyzing data (gender, age, ...) that is stored in Database.
;Minimum face size
: Minimum needed area on screen to consider as a face (in pixels).
;Maximum face size
: Maximum needed area on screen to consider as a face (in pixels).
;Analyse gender
: Enable if you want to analyse gender.
;Analyse age
: Enable if you want to analyse age.
;Analyse happiness
: Enable if you want to analyse happiness.
;Analyse angriness
: Enable if you want to analyse angriness.
;Analyse sadness
: Enable if you want to analyse sadness.
;Analyse surprisedness
: Enable if you want to analyse surprisedness.
; Show face size
: Enable if you want to see the face size (area occupied) on screen.
; Show resolution
: Enable if you want to see the video source resolution.
; Show frame rate
: Enable if you want to see the video source frame rate.
; Search eyes
: Enable if you want the system to search by eyes for a more accurate recognition.
; Search nose
: Enable if you want the system to search by nose for a more accurate recognition.
; Search mouth
: Enable if you want the system to search by mouth for a more accurate recognition.
; Track faces
: Enable if you want keep tracking faces even if their data is not stored. A tracker is activated that tries to track the faces that were lost by the face detection module.
; Time base
: Related with fps. The smaller this value is, the greater the value of fps you'll get (if your system can handle it). 25fps would require a value of 0.04 (40ms).
; Thread count
: Set number of threads used for processing. If you run this system on a machine with more than one single cpu (or core), it typically will be faster to use all cpus. The number of threads is limited to 10. But it only makes sense to provide at most the number of available cpus available.
; Model type
: Defines which model is used to detect faces. For the value &quot;Front&quot;, a model is used to detect upright frontal faces. For the value &quot;Rotated&quot;, the detection model used is able to detect -60 to +60 degree in-plane rotated faces. For the value &quot;Profile&quot;,  the model used is able to detect upright frontal and out-of-plane rotated faces.
; Memory length
: An identity number is assigned to each face, an 'id', which is constant as long as the trajectory can be determined without discontinuity. This option defines for how long (in seconds) a face is remembered internally, so that a connection of a currently detected face to the same face detected some time ago can be made. 
; Memory type
: Only takes effect if &quot;Memory length&quot; &gt; 0. For &quot;Spatial&quot; the face id is remembered internally and assigned again if a face is lost and found again at approximately the same position in the image. However if a face is lost and found again in a different position a new id is assigned. This is the fastest method of the three. 
; Phantom trap
: Tries to find false detections (phantoms). If &quot;Off&quot;, this module is not used. If &quot;Delete&quot;, false detections are identified and deleted on the fly. If &quot;Mark&quot;, identified false detections are marked by the module. Each object will have an additional attribute with the key ’Phantom’. No objects are deleted in this mode but their data is stored.
; Minimum face score
: This is the minimal face detection threshold. Each face has a rating with key ’Score’ that indicates how likely it is to be a face. Using this parameter you can set a minimal score for the faces that will be returned by the engine. The lower this value is the more faces but also false detections will be found. A good value is 9.
; Auto start engine
: Enable if you want to start the engine (store data) whenever the application starts.
; Show log
: A log window appears on the bottom.
; Web server port
: Port used in the Web Server.
; Database port
: Port used in the Database.

==Start Engine==

After click the &quot;Start Engine&quot; button, the system will start collecting the consumer's data, storing them in a Database. Whenever you want to view/analyse the data stored in a graphical mode click &quot;Retail Analytics &amp; Targeted Advertising&quot;. Please refer to [[Retail Analytics/Statistics|Statistics]].</rev>
        </revisions>
      </page>
    </pages>
  </query>
</api>