Changelog

All notable changes to this project will be documented in this file. Types of changes:

  • Added for new features.
  • Changed for changes in existing functionality.
  • Deprecated for soon-to-be removed features.
  • Removed for now removed features.
  • Fixed for any bug fixes.
  • Security in case of vulnerabilities.

The format is based on Keep a Changelog

2020-12-01 uvap-2.931

Changed

  • MGR docker container now requires host's /sys/firmware to be mounted to /host_sys/firmware (for read only). See Operating the Multi-Graph Runner
  • Kafka and Zookeeper should be updated to 5.4.0. See Setting Up UVAP. This UVAP version may work with older Kafka, but it has not been tested.

Deprecated

  • Licence data collector is now available from Docker repository ultinous/uvap_licence_data_collector. The old location should not be used anymore (ultinous/licence_data_collector). It will not be available from 2021-02-01.

Added

Fixed

  • Better YCbCr420 colorspace handling.
  • Windows EOL is now supported in .properties files.
  • Race condition fix for when target_options.handling is REPLACE.
  • Stability fixes.

2020-07-31 uvap-2.880

Fixed

  • UVAP Tracker MS no longer crashes.

2020-07-17 uvap-2.872.1, uvap-2.872.2

Added

  • Added Operation Guide for some details on using UVAP in a production environment.
  • Added documentation about using UVAP on computers with multiple GPUs.
  • Added Saving Video Streams feature (UVAP Video Capture MS)
  • Added delta_time parameter to UVAP Tracker MS

Changed

  • Replaced the usage of the deprecated nvidia-docker package with the nvidia-container-runtime package.
  • Faster (GPU based) pixel format conversion when reading videos.
  • UVAP Tracker MS now also uses head size for tracking.
  • Stability and bug fixes.

Regressions

  • UVAP Tracker MS crashes under certain circumstances. This issue is going to be fixed in the next release.

2020-05-22 uvap-2.812

Changed

Model file format has changed. Please request access to licensed resources via e-mail:

To: support@ultinous.com
Subject: UVAP - Requesting access to licensed resources

Please include your Docker Hub account ID in the e-mail body. Please extract the new model files to the uvap/models directory overwriting existing files. They will not interfere with the old version of the UVAP. After that you can upgrade UVAP: Upgrading UVAP, omitting the model downloading step which we have already completed here.

If you start the new UVAP without downloading the new model files then MGR will not start and will issue the following not well versed error message in the log:

2020-06-05 12:02:39.317940 fatal [multi-graph-runner-ms][0x00007fd548d7a040][main/427] Error: Error parsing prototxt from string: Error at line -1 column 0: Message missing required fields: uid

Added

  • Added Face Mask Detection feature.
  • Pass Detector configuration can be reloaded while running.
  • Tracker configuration can be reloaded while running.
  • Reidentifier configuration can be reloaded while running.
  • Feature Vector Clustering configuration can be reloaded while running.
  • Added Floating Licensingoption to licence MGR.
  • Added start_time option to MGR input configuration.
  • Added backend option to MGR for a choice of model optimization. See MGR Configuration

Changed

  • UVAP Training section updated.
  • Pass Detector configuration format adjusted to other microservices.
  • Tracker configuration format adjusted to other microservices.

Deprecated

  • Deprecated old Pass Detector configuration format.
  • Deprecated old Tracker configuration format.
  • Deprecated the image_scale_factor and blur_kernel_size technical parameters of MGR.

Fixed

  • Fixed demography demo crash.

2020-03-23 uvap-2.733.2

Added

  • Detection Filter configuration can be reloaded while running.
  • Added no-input policy for Multi-Graph Runner.

2020-03-04 uvap-2.707.1

Added

  • Multi-Graph Runner configuration can be reloaded while running.

Changed

  • New documentation layout and web hosting.

Fixed

  • Fixed clashing monitoring ports in the template configurations of Tracker and Reidentifier.

2020-02-07 uvap-2.680.1

Added

  • Added Detection Filter feature and documentation.
  • Added Feature Vector Clustering feature and documentation.

Changed

  • Replaced the Basic reidentification feature with the more advanced Reidentification feature.

Fixed

  • Fixed Pass Detector numbering of pass events; send pass_realized event for all realized passes.

2019-11-28 release-2.642

Added

  • Added Stream Configurator UI feature to use uploaded image.
  • Added Stream Configurator UI feature to find image by timestamp.

Changed

  • Improved dataflow_pub.proto code documentation.

Fixed

  • Fixed Tracker not to lose the first detections at the beginning of tracks.

2019-11-11 release-2.629

Added

  • Added Stream Configurator UI function and documentation.

Changed

  • Modified configuration of the Basic Reidentification.

2019-10-19 release-2.616

Added

  • Added new optional parameter of Multi Graph Runner miroservice: frame_period_ms.
  • Added Time Synchronization Using NTP chapter into the documentation.
  • Added UVAP Web Player Access from Client Machine chapter into the documentation.
  • Added Video Annotation function and documentation.

Changed

  • Restructured the UVAP documentation.
  • Remove all xhost + occourrences from the documentation.

Fixed

  • Renamed from 'run_web_player.sh' script to 'run_uvap_web_player.sh' in the documentation.
  • Fixed Invalid input may cause Pass Detection to crash bug.

2019-09-05 release-2.568

Added

  • Added Basic Reidentification microservice to the Docker repository (ultinous/uvap).
  • Added Basic Reidentification demos into Quick Start Guide.
  • Added Basic Reidentification microservice documentation into the Developer's Guide.
  • Added USB webCam (like Brio) usage to the run_mgr.sh.
  • Added 'Required packages' chapter into the Insall Guide.

Changed

  • Unified run_*.sh scripts for MS starting in /uvap/scripts directory.

Fixed

  • Fixed license vs. licence typo in the documentation.
  • Fixed: Images of demo (written by MGR) are original not lowres in Kafka.
  • Fixed: the javaproperties install is missing from 'Environment for Python Developers' chapter.

2019-08-14

Added

  • Added Kafka Pass Detection microservice to the Docker repository (ultinous/uvap).
  • Added Kafka Pass Detection demo into Quick Start Guide.
  • Added Kafka Pass Detection microservice documentation into the Developer's Guide.
  • Added an 'Update' chapter to the Install Guide.

Changed

  • Refactored the structure of Quick Start Guide.
  • Change configuration file for multi camera usage (Jinja templates).

Fixed

  • Fixed security issue in 'Environment for Python Developers' chapter, 'pip3 install' command is not required the sudo privilage.
  • Dropped display related lines from run_demo.sh.
  • Fixed: the Web Player ignores advertised host and port in index page.
  • Fixed: the nvidia-docker-binary-path parameter is not required in demo starter script.

2019-07-25

Added

  • Added Web Player microservice to the Docker repository (ultinous/uvap).
  • Added Kafka Tracker microservice to the Docker repository (ultinous/uvap).
  • Added Kafka Tracker demo and usage of Web Player into Quick Start Guide.
  • Added Kafka Tracker microservice documentation into the Developer's Guide.
  • Added 'Cross references' and 'Environment for Python Developers' sections into the Developer's Guide.
  • Added 'Notations of the UVAP Documentation' chapter for the documentation.
  • Added 'Example Analysis Results' chapter for the documentation.
  • Added 'Example Analysis Results' components (zookeeper-data, kafka-data) to the Docker repository (ultinous/kafka_demo).

Changed

  • Changed Demo Applications, now it can write the result images (.jpg) into the Kafka.
  • Highlight the 'Overview' in the home page of the documentation.
  • Parameterized the retention time setter script (set_retention.sh).

Fixed

  • Completed the Install Guilde with some technical details for the better efficiency.
  • Fixed some typos in the Install Guilde.

2019-07-01

Added

  • Added the Quick Start Guide, it is a step-by-step description of Demo Applications confiration and usage.
  • Added Demo Applications with the following features:
    • Head detection
    • 3D Head pose
    • Demography
    • List topic (from Kafka stream)
    • List message (from Kafka stream)
    • Show Image (from Kafka stream)
    • Visualise the human skeleton

Changed

  • Added 'Table of contents' to the Install Guide.
  • In Install Guide created the 'Acquiring the private resources' chapter for less required communication between Provider and Customer.
  • Changed git repository of UVAP documentation.
  • Changed install.sh script for easier set up process.

Removed

  • Reorganized our Example Scripts to Demo applications

2019-06-03

Added

  • Added the Multi Graph Runner (MGR) (uvap_mgr) microservice to the Docker repository (ultinous/uvap).
  • Added Install Guide, it contains all requirements and set up procss of UVAP.
  • Added Developer's Guide, it is technical details from Kakfa, Docker and our microservice.
  • Added a script which list message from Kafka stream into Example Scripts.
  • Added a script which show head or full body bounding boxes on Image into Example Scripts.
  • Added a script which display image from Kafka into Example Scripts.