Installation on Linux Ubuntu

This section describes how to install the latest available Prophesee’s Software on Linux Ubuntu 18.04 64-bit.

This guide assumes that you signed up to use our software. If not, sign up for Metavision Essentials first.

Requirements

Please, note that the following requirements must be fulfilled:

  • Operating system: Linux Ubuntu 18.04 64-bit (versions 19 and 20 of Ubuntu are not supported for the moment)

  • Architecture: amd64 (a.k.a. x64)

  • Graphic card: must support OpenGL 3.0 minimum

  • CPU: must support AVX2 (see the list of processor supporting AVX2)

For other Operating Systems and architecture compatibilities, contact us.

Prerequisites

  1. Add Prophesee’s servers to the list of repositories.

  • First, clean your sources list directory from earlier installation of Prophesee software:

    • check if you have prophesee.list, sdk.list or designer.list files in the folder /etc/apt/sources.list.d and remove them

    sudo rm /etc/apt/sources.list.d/prophesee.list /etc/apt/sources.list.d/sdk.list /etc/apt/sources.list.d/designer.list

    • check if you have any Prophesee Server in the file /etc/apt/sources.list and remove it

  • Then, copy the new .list file (that you should have been provided during sign-up) in the folder /etc/apt/sources.list.d

  1. Update the list of repositories and packages:

sudo apt update

  1. Remove the previously installed Prophesee software:

sudo apt remove 'prophesee-*' 'metavision-*' --purge

Installation

  1. To install the Metavision Essential, use the following command:

sudo apt install 'metavision-*'

In case you get a warning message like “Install these packages without verification? [y/N]”, then please, confirm with “y”.

  1. Install an additional package required to display videos:

sudo apt install libcanberra-gtk-module

  1. For Metavision Designer and Machine Learning modules, you will also need Python and some additional libraries. For Python, both versions 3.6 and 3.7 are supported. If you have none of this version installed, install one of them and then these extra libraries:

sudo apt install python3-pip python3-tk
pip3 install opencv-python matplotlib jupyter

Warning

You can use Anaconda/Conda to install Python and manage your packages, but ensure to use Python 3.6 or 3.7. Other versions are not supported. In this documentation, we chose to use pip. If you wish to use Anaconda/Conda, adapt the library installation accordingly and use conda instead of pip.

Note

If opencv-python installation fails, make sure that your pip version is up-to-date (19.3 is the minimum supported version): pip3 install --upgrade pip

Plugins

If you installed a third-party vendor plugin, you also need to specify where this plugin is located by using the MV_HAL_PLUGIN_PATH environment variable. For example:

export MV_HAL_PLUGIN_PATH=/path/to/my/plugins/

Note

If you want to permanently set this environment variable, you should include the export in your ~/.bashrc (or in the appropriate “rc file” depending on the shell you are using, like .zshrc for Zsh).