.. _reports:

*****************************
Reports
*****************************

FindFace Multi allows you to build reports on the following system entities:

* object recognition events
* episodes 
* search events 
* persons 
* cameras
* dossiers
* analytical data
* audit logs 

.. rubric:: In this chapter:

.. contents::
   :local:


Configure Saving Images in Reports
========================================

When building a report, you will be able to choose to save the report images as links, thumbnails, or full frames. It is possible to configure the image parameters. To do so, open the ``/etc/findface-security/config.py`` configuration file and alter the default JPEG quality and the maximum height of thumbnails and full frames, subject to your free disc space.

.. code::

   sudo vi /etc/findface-security/config.py

   # reports image saving options
   'REPORT_THUMBNAIL_JPEG_QUALITY': 75,
   'REPORT_THUMBNAIL_MAX_HEIGHT': 100,
   'REPORT_FULLFRAME_JPEG_QUALITY': 75,
   'REPORT_FULLFRAME_MAX_HEIGHT': 250,


Build Report
=================

To build a report, do the following: 

#. Navigate to the tab associated with the required entity: :guilabel:`Events`, :guilabel:`Episodes`, :guilabel:`Search`, :guilabel:`Persons`, :guilabel:`Cameras`, :guilabel:`Dossiers`, :guilabel:`Analytics`, :guilabel:`Audit Logs`.
#. Set the filters for the report.
#. Click :guilabel:`Create Report`.

    |build_report_en|

     .. |build_report_en| image:: /_static/build_report_en.png
        :scale: 50%

     .. |build_report_ru| image:: /_static/build_report_ru.png
        :scale: 50%

#. Specify the report name. Choose whether to save the report images as links, thumbnails, or full frames. Click :guilabel:`Create`. 

    |report_window_en|

     .. |report_window_en| image:: /_static/report_window_en.png
        :scale: 60%

     .. |report_window_ru| image:: /_static/report_window_ru.png
        :scale: 60%

#. The report will be available for download on the :guilabel:`Reports` tab.

     |report_en|

     .. |report_en| image:: /_static/report_en.png
        :scale: 50%

     .. |report_ru| image:: /_static/report_ru.png
        :scale: 50%