AEDAT is a fast AEDAT 4 python reader, with a Rust underlying implementation.
Run pip install aedat to install it.
The aedat library provides a single class: Decoder. A decoder object is created by passing a file name to Decoder. The file name must be a path-like object.
Here's a short example: ```python import aedat
decoder = aedat.Decoder('/path/to/file.aedat') print(decoder.idtostream())
for packet in decoder: print(packet['stream_id'], end=': ') if 'events' in packet: print('{} polarity events'.format(len(packet['events']))) elif 'frame' in packet: print('{} x {} frame'.format(packet['frame']['width'], packet['frame']['height'])) elif 'imus' in packet: print('{} IMU samples'.format(len(packet['imus']))) elif 'triggers' in packet: print('{} trigger events'.format(len(packet['triggers']))) ```
And the same example with detailed comments:
```python import aedat
decoder = aedat.Decoder('/path/to/file.aedat')
"""
decoder is a packet iterator with an additional method idtostream
idtostream returns a dictionary with the following structure:
{
for packet in decoder:
"""
packet is a dictionary with the following structure:
{
'streamid': Because the lifetime of the file handle is managed by Rust, decoder objects are not compatible with the with statement. To ensure garbage collection, point the decoder variable to something else, for example decoder = aedat.Decoder('/path/to/file.aedat') decoder = None
``` This library requires Python 3.x, x >= 5, and NumPy. This guide assumes that they are installed on your machine. Note for Windows users: this library requires the x86-64 version of Python. You can download it here: https://www.python.org/downloads/windows/ (the default installer contains the x86 version). A Rust compiling toolchain is required during the installation (but can be removed afterwards). You can You can You can After changing any of the files in framebuffers, one must run:
To format the code, run:
Bump the version number in Cargo.toml. Install Cubuzoa in a different directory (https://github.com/neuromorphicsystems/cubuzoa) to build pre-compiled versions for all major operating systems. Cubuzoa depends on VirtualBox (with its extension pack) and requires about 75 GB of free disk space.
Install twine
Upload the compiled wheels and the source code to PyPI:
None, when you are done using it:
```py
import aedatdo something with decoder
Install from source
Linux
sh
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
git clone https://github.com/neuromorphicsystems/aedat.git
cd aedat
cargo build --release
cp target/release/libaedat.so aedat.so
import aedat from python scripts in the same directory as aedat.so, which can be placed in any directory.macOS
sh
brew install rustup
rustup-init
git clone https://github.com/neuromorphicsystems/aedat.git
cd aedat
cargo build --release
cp target/release/libaedat.dylib aedat.so
import aedat from python scripts in the same directory as aedat.so, which can be placed in any directory.Windows
sh
cargo build --release
copy .\target\release\aedat.dll .\aedat.pyd
import aedat from python scripts in the same directory as aedat.pyd, which can be placed in any directory.Contribute
sh
flatc --rust -o src/ flatbuffers/*.fbs
sh
cargo fmt
You may need to install rustfmt first with:
sh
rustup component add rustfmt
Publish
cd cubuzoa
python3 cubuzoa.py provision
python3 cubuzoa.py build /path/to/aedat --post /path/to/aedat/test.py
pip3 install maturin
pip3 install twine
maturin build --out wheels --interpreter
python3 -m twine upload wheels/*