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.
Table of Contents
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).
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:
Make sure that no Prophesee or Metavision software is running
Open the Start menu
Click Settings
Search for Apps & features via the search
In the list of installed programs, find any Prophesee or Metavision software and click the Uninstall button
Check that there is no
Prophesee
folder left in yourProgram 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:
Python 3.9 (“Windows installer (64-bit)”)
Python 3.10 (“Windows installer (64-bit)”)
Python 3.11 (“Windows installer (64-bit)”)
Python 3.12 (“Windows installer (64-bit)”)
Run the installer and follow the prompt
Add Python install and script directories in your
PATH
and make sure they are listed before theWindowsApps
folder which contains a Python alias launching the Microsoft Store. So, if you installed Python 3.9 in the default path, your userPATH
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:
Add the
bin
directory of FFMPEG to yourPATH
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).
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:
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):
Download the LibTorch version corresponding to the CUDA version with which our Machine Learning library was compiled (11.8):
Unzip the archive as a new folder
LIBTORCH_DIR_PATH
Add
LIBTORCH_DIR_PATH\lib
to yourPATH
(in Advanced system setting / Environment Variables) to be able to compile the ML samples depending on libtorch
Get Started with Machine Learning
To see the different tools, samples and tutorials available for our ML module, check out our Machine Learning guide.