Skip to content

TheChymera/behaviopy

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

BehavioPy

Build Status

BehavioPy is a Python toolkit providing evaluation (e.g. event tracking) and plotting functions for behavioural data. Manual event tracking is done via a simple and configurable PsychoPy-based interface. Plotting functions are designed to work with preformatted data in CSV format (e.g. as exported by pandas), and use Seaborn and custom BehavioPy styles for maximum beautification.

Presentations

Examples

These are some of the plot types which BehavioPy can generate. The following examples can be reproduced (contingent on dependency availability) solely from the example functions and data distributed in this repository.

Correlation Matrices

Correlation Matrix

Correlation Matrix Significance

Correlation Matrix Significance, Corrected

Pointplot With Significance Levels

Forced Swim Test Pointplot Forced Swim Test Pointplot

Timeseries Plots

Forced Swim Test Timeseries

Installation

Depending on your preferred package manager you may choose one of the following methods:

Portage (e.g. on Gentoo Linux):

SAMRI is available via Portage (the package manager of Gentoo Linux, derivative distributions, and installable on any other Linux distribution, or BSD) via the Science Overlay. Upon enabling the overlay, the package can be emerged:

emerge behaviopy

Alternatively, the live (i.e. latest) version of the package can be installed along with all of its dependencies without the need to enable to overlay:

git clone [email protected]:TheChymera/behaviopy.git
cd SAMRI/.gentoo
./install.sh

Python Package Manager (Users):

Python's setuptools allows you to install Python packages independently of your distribution (or operating system, even). This approach cannot manage any of our numerous non-Python dependencies (by design) and at the moment will not even manage Python dependencies; as such, given any other alternative, we do not recommend this approach:

git clone [email protected]:TheChymera/behaviopy.git
cd SAMRI
python setup.py install --user

If you are getting a Permission denied (publickey) error upon trying to clone, you can either:

  • Add an SSH key to your GitHub account.
  • Pull via the HTTPS link git clone https://github.com/TheChymera/behaviopy.git.

Python Package Manager (Developers):

Python's setuptools allows you to install Python packages independently of your distribution (or operating system, even); it also allows you to install a "live" version of the package - dynamically linking back to the source code. This permits you to test code (with real module functionality) as you develop it. This method is sub-par for dependency management (see above notice), but - as a developer - you should be able to manually ensure that your package manager provides the needed packages.

git clone [email protected]:TheChymera/behaviopy.git
cd behaviopy
echo "export PATH=\$HOME/.local/bin/:\$PATH" >> ~/.bashrc
source ~/.bashrc
python setup.py develop --user

If you are getting a Permission denied (publickey) error upon trying to clone, you can either:

  • Add an SSH key to your GitHub account.
  • Pull via the HTTPS link git clone https://github.com/TheChymera/behaviopy.git.

Dependencies