Chamberbrain Lab Kit

:sparkles: Tools used by Chamberlab to sonify & visualise Nanobrain data. :dizzy:

Requirements

macOS

Tested on OS X 10.11 & 10.12.

• Build tools
  xcode-select --install
• Node.js v8.4.0 (via NVM (recommended), Installer Pkg or Package Manager)
• HDF5 library (e.g. Install via Homebrew)
  brew install hdf5

Installation

npm install -g https://github.com/chamberlab/node-chamberbrain-lab-kit.git

Usage

:zap: Commands can be executed from the terminal.

Convert

blob:node-chamberbrain-lab-kit anton$ nb-convert --help
Commands:
  csv2lmdb  Convert NanoBrains CSV to LMDB                             [default]
  csv2hdf5  Convert NanoBrains CSV to HDF5

Options:
  --infile, -i  CSV input file                                        [required]
  --outdir, -o  LMDB output directory                                 [required]
  --type, -t    Value type to be stored
                            [choices: "Float64", "Float32"] [default: "Float64"]
  --help        Show help                                              [boolean]
  --debug, -d                                                   [default: false]

Example

# Convert CSV to LMDB as Float32.

blob:node-chamberbrain-lab-kit anton$ nb-convert -i /Users/foo/goo.csv \
> -o /Users/foo -t Float32 csv2lmdb

Reduce

blob:node-chamberbrain-lab-kit anton$ nb-reduce --help
Commands:
  fps  Reduce FPS rate of an LMDB db and output as LMDB and HDF5       [default]

Options:
  --infile, -i   LMDB input file                                      [required]
  --outfile, -o  LMDB output file, also used for HDF5                 [required]
  --fps, -f      Target frames per second                     [default: "100.0"]
  --help         Show help                                             [boolean]
  --debug, -d                                                   [default: false]

Example

# Reduce LMDB to 50 frames per second.

blob:node-chamberbrain-lab-kit anton$ nb-reduce -i /Users/foo/goo.lmdb \
> -o /Users/foo/goo-50fps.lmdb -f 50.0

Playback

:zap: Broadcast can be activated using a remote IP like 192.168.0.255:9999.

blob:node-chamberbrain-lab-kit anton$ nb-playback --help
Commands:
  lmdb2osc  Realtime playback of an LMDB file as OSC packets           [default]

Options:
  --infile, -i   LMDB input file                                      [required]
  --fps, -f      Target frames per second                      [default: "50.0"]
  --local, -l    Local OSC address to listen on      [default: "127.0.0.1:8888"]
  --remote, -r   Remote OSC address to send to       [default: "127.0.0.1:9999"]
  --address, -a  Override default OSC address
  --help         Show help                                             [boolean]
  --debug, -d                                                   [default: false]

Example

# Play back LMDB with 50 frames per second.
# Bind to 0.0.0.0:7878 and broadcast OSC packets to 192.168.0.255:7777.

blob:node-chamberbrain-lab-kit anton$ nb-playback -i /Users/foo/goo.lmdb \
> -f 50.0 -l 0.0.0.0:7878 -r 192.168.0.255:7777

Credits

:godmode: 2017 Das Antonym / Chamberlab
Licensed under the Do What The Fuck You Want To Public License :trollface: