/loris

python3 library to handle files from neuromorphic cameras

Primary LanguageC++GNU General Public License v3.0GPL-3.0

Loris

Travis

With loris you can read and write different file formats from neuromorphic cameras such as .aedat4, .dat, .es or .csv. Loris is also an amazing animal

Supported formats

version read write
.aedat4 4 ☑ ☐
.dat 1/2 ☑ ☐
.es 2.x ☑ ☑
.csv - ☑ ☐

Install

pip install loris

How to loris

Read a file, for example a .dat file and loop over all events
import loris
my_file = loris.read_file("/path/to/my-file.dat")
events = my_file['events']

for event in events:
    print("ts:", event.t, "x:", event.x, "y:", event.y, "p:", event.p)
Write events from an array to an .es file
ordering = "xytp"  # corresponds to the order in your array
loris.write_events_to_file(event_array, "/path/to/my-file.es", ordering)
Write structured events (with dtypes) to an .es file
loris.write_events_to_file(structured_event_array, "/path/to/my-file.es")

Windows test (for developers)

To make sure the library works on Windows (if you use macOS or Linux), follow these steps:

  1. Download Vagrant (https://www.vagrantup.com/)
  2. cd windows
  3. vagrant up (this will download a virtual machine and build the package)
  4. vargrant ssh (optional, to inspect the Windows VM)
  5. vagrant destroy -f (cleanup)

loris