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.
- BehavioPy - Python Evaluation, Analysis, and Plotting for Behaviour and Physiology, at EuroSciPy 2017 in Erlangen (DE).
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.
Depending on your preferred package manager you may choose one of the following methods:
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'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'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
.
- Matplotlib
- NumPy
- pandas
- PsychoPy (optional - only needed for manual event tracking)
- SciPy
- Seaborn
- Statsmodels