evutils 0.3.0

Utilities for event-based vision

EV Utils

EV-utils is a collection of utilities for working event based data inspired by the event_utils library. This library aims at being camera independent (yet also supporting specific camera vendors) with minimal dependencies but also performent. The library is divided into severla modules some of which can be used without installing all the dependencies. These include:

└── augment - Event augmentations
└── dataset - Wrappers for various dataset loaders
└── events 
└── io
    ├── reader 
    └── writer
└── random
└── torch
└── types
└── vis
    ├── histogram
    └── reconstructor

Installation

From Git

git clone --recurse-submodules [e-mail]:pbl/research/event-camera/evutils.git

cd evutils
pip install . 
pip install -e . # Use this to install an editable version of the package

Quick API overview

augment

Event augmentations

dataset

Wrappers for various dataset loaders

io

The io module provides methods for reading and writing events into various event formats. It provides a simple .read() and .write() interface as well as more advanced interfaces using iterators and slicing.

from evutils.io.reader import EventReader_RAW


ev_file = EventReader_RAW("raw_file.raw", delta_t=10e3)

events = ev_file.read()

utils

Various utility functions

random

Generating random events and adding noise to event recordings

types

This provides several standard types for representing Events in numpy arrays

vis

The vis moduels provides several methods for visualizing the events (for example as histograms), but also provides a streamlined interface for more complex visualization techneques, such as using the E2Vid reconstructor.

You need to download the pretrained weights:

wget "http://rpg.ifi.uzh.ch/data/E2VID/models/E2VID_lightweight.pth.tar" -O models/E2VID_lightweight.pth.tar

from evutils.vis.reconstructor import RPG_Reconstructor

reconstructor = RPG_Reconstructor(1280, 720)

img = reconstructor.gen_frame(events)

Running tests

You can run tests on using the pytest utility:

pytest -s

Acknowledgements

Thanks to all the contributors for supporting this project:

• Elia Franc
• Jakub Mandula