Installation of SDK on Windows with installer

This section describes how to install Metavision SDK on Windows 10 64-bit.

Note

Metavision SDK comes as pre-built Windows installer of our whole software offer. If you want to work from source (for example to compile on other platforms than those we officially support), follow the specific guide on the Installation of SDK on Windows from sources.

See also

Before following this installation guide, you may want to watch our EVK4 unboxing video as it includes an overview of the installation of Metavision SDK on Windows along the first steps with the EVK.

Supported Cameras

Metavision SDK comes with a Prophesee camera plugin, enabling to stream data from our event-based cameras and to read recordings of event-based data. The supported cameras are:

If you want to use a Prophesee EVK that is not in the list above, it might have been discontinued. Refer to the Prophesee EVKs Support section to find out which previous version of the SDK is supporting it.

If you own a third-party vendor event-based camera, refer to the Camera Plugin Installation page to see how it can be deployed and configured.

Required Configuration

Please note the base system requirements for using Metavision SDK:

  • Operating system: Windows 10 64-bit

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

  • Graphic card: must support OpenGL 3.0 minimum

  • CPU: must support AVX2

To install the SDK on Linux, see the page SDK installation on Linux from packages.

Required Artifacts

When installing Metavision SDK using Windows installer, the required artifact should be retrieved from our JFrog Artifactory APT server:

  • If you don’t have a Prophesee Microsoft Entra ID account yet, request one by completing this form

  • Ensure you are not currently logged into any other domains with a Microsoft Entra ID account besides Prophesee. To avoid conflicts, consider using a private or incognito browsing window, which will isolate your login session.

  • Connect to https://propheseeai.jfrog.io

  • Choose “SAML SSO” login type

  • Enter your Entra ID credentials. Your login should follow this format: jdoe@customers.prophesee.ai

  • The windows installers can then be found at this URL or can also be retrieved by browsing the Artifacts menu (metavision-sdk-5-windows / main / installers).

    Prophesee JFrog Artifactory Windows Installer
  • Among the list of SDK Windows installers (Metavision_SDK_xyz_Setup.exe), download the one with highest version number

Note

If the SDK version you are looking for is not in the installer repository, please look for your version in the Knowledge Center Download section

Upgrading Metavision

If you are upgrading Metavision from a previous version, you should first read carefully the Release Notes as some changes may impact your usage of our SDK (e.g. API updates) and cameras (e.g. firmware update might be necessary).

Then, if you have previously installed any Prophesee software, you will need to uninstall it first:

  1. Make sure that no Prophesee or Metavision software is running

  2. Open the Start menu

  3. Click Settings

  4. Search for Apps & features via the search

  5. In the list of installed programs, find any Prophesee or Metavision software and click the Uninstall button

  6. Check that there is no Prophesee folder left in your Program Files folder (if still present, delete it)

Warning

Removing the old version of Metavision SDK is mandatory even for patch upgrade (e.g. from x.y.0 to x.y.1)

Installation

Just run the SDK installer and follow the instructions.

Installing Dependencies

To execute our Python Samples and use the Python API, you will need Python and some additional libraries. If you plan to use only Metavision Studio for now, you can skip this Python dependencies section.

If Python is not available on your system, install it:

  • Download the installer for one of the supported Python versions:

  • Run the installer and follow the prompt

  • Add Python install and script directories in your PATH and make sure they are listed before the WindowsApps folder which contains a Python alias launching the Microsoft Store. So, if you installed Python 3.9 in the default path, your user PATH should contain those three lines in that order:

    %USERPROFILE%\AppData\Local\Programs\Python\Python39
    %USERPROFILE%\AppData\Local\Programs\Python\Python39\Scripts
    %USERPROFILE%\AppData\Local\Microsoft\WindowsApps
    

We recommend using Python with virtualenv to avoid conflicts with other installed Python packages.

Create a virtual environment:

python -m venv C:\tmp\prophesee\py3venv --system-site-packages

When creating the virtual environment, it is necessary to use the --system-site-packages option to ensure that the SDK packages installed in the system directories are accessible. However, this option also makes your local user site-packages visible by default. To prevent this and maintain a cleaner virtual environment, you should set the environment variable PYTHONNOUSERSITE to true (which you may add to your system configuration to make it permanent):

set PYTHONNOUSERSITE=true

Finally, install the necessary dependencies:

C:\tmp\prophesee\py3venv\Scripts\python -m pip install pip --upgrade
C:\tmp\prophesee\py3venv\Scripts\python -m pip install -r "C:\Program Files\Prophesee\share\metavision\python_requirements\requirements_openeb.txt" -r "C:\Program Files\Prophesee\share\metavision\python_requirements\requirements_sdk_advanced.txt"

Optionally, you can run the activate command (C:\tmp\prophesee\py3venv\Scripts\activate) to modify your shell’s environment variables, setting the virtual environment’s Python interpreter and scripts as the default for your current session. This allows you to use simple commands like python without needing to specify the full path each time.

For simplicity, throughout the documentation of the Code Samples, we will assume the python command refers to the interpreter within the activated virtual environment.

Note

You can also use anaconda to install Python and conda to manage your Python packages, but be sure to use a Python version that we support. You will need to adapt the library installation steps accordingly and use conda whenever we use pip.

In addition, check that conda PYTHONPATH contains the aforementioned PATH. For example for Python 3.9:

%USERPROFILE%\AppData\Local\Programs\Python\Python39
%USERPROFILE%\AppData\Local\Programs\Python\Python39\Scripts
%USERPROFILE%\AppData\Local\Microsoft\WindowsApps

If not, add them. For example with sys.path.append() method of python module sys:

import sys
print(sys.path)
# Add %USERPROFILE%\AppData\Local\Programs\Python\Python39 to PYTHONPATH if the output of print(sys.path) does not mention it.
sys.path.append("%USERPROFILE%\AppData\Local\Programs\Python\Python39")

In this documentation, we chose to use pip as a package manager.

Finally, install FFMPEG library which is required to write videos:

Camera Plugins

Prophesee camera plugin is included in the SDK and the drivers for most of the Prophesee cameras are deployed during the installation. But if you own an EVK2 or an RDK2, you will need to install the driver manually.

First, download wdi-simple.exe from our file server.

Then, verify in your device manager that you have the three following interfaces when your camera is connected: CDC NCM; EVK2; fastboot, displayed as below with a warning sign (from left to right, picture 1). If not, uninstall the device already installed as shown in picture 2 and 3 (generally the already installed device is, either EVK2 if you connect an EVK2 device or fastboot if you connect an RDK2 device).

pic1 pic2 pic3

Kindly note that you should repeat this uninstall operation until your device (EVK2/fastboot) is not recognized anymore and appears in other devices with a warning sign.

Now, you should install the relevant driver for each of the three interfaces (EVKv2, CDC-NCM and FastbootInterface).

To do so, follow those steps for each interface:

  • find out the name of interface by checking the Device Manager as shown in the picture below:

    pic4 pic5

    For example, we can see on the right picture that the interface number is 03.

  • install the relevant driver with the following command launched as an administrator:

    wdi-simple.exe -n "EVK" -m "Prophesee" -v 0x03fd -p 0x5832 -i <INTERFACE_NUMBER>
    

Get started!

You are now ready to use Metavision SDK. The best way to start getting familiar with the event-based technology is to open an event-based camera with Metavision Studio to begin data collection and visualization. You can choose to dive directly in the SDK by following a getting started guide or looking at a Code Sample.

If you want to use the Machine Learning modules, please follow the next section that describes the required additional dependencies.

Additional Dependencies for Machine Learning Module

To use Machine Learning features, you need to install some additional dependencies.

If you have some Nvidia hardware with GPUs, you can optionally install CUDA and cuDNN to leverage them with PyTorch and LibTorch. Make sure that you install a version of CUDA that is compatible with your GPUs by checking Nvidia compatibility page.

Note

At the moment, we don’t support OpenCL and AMD GPUs.

LibTorch for C++

To compile and run the ML C++ samples that leverage the Torch library, you need LibTorch (PyTorch’s C++ frontend):

Get Started with Machine Learning

To see the different tools, samples and tutorials available for our ML module, check out our Machine Learning guide.