Metadata-Version: 2.4
Name: behatrix
Version: 0.18
Summary: Behatrix - Behavioral Sequences Analysis with permutation test
Author-email: Olivier Friard <olivier.friard@unito.it>
License-Expression: GPL-3.0-only
Project-URL: Homepage, https://www.boris.unito.it/behatrix
Project-URL: Documentation, https://github.com/olivierfriard/behatrix/blob/master/README.rst
Project-URL: Change_log, https://github.com/olivierfriard/behatrix/wiki/revision-history
Project-URL: Source_code, https://github.com/olivierfriard/behatrix
Project-URL: Issues, https://github.com/olivierfriard/behatrix/issues
Classifier: Operating System :: OS Independent
Classifier: Intended Audience :: Science/Research
Classifier: Intended Audience :: Education
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Scientific/Engineering :: Visualization
Classifier: Operating System :: OS Independent
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE.TXT
Requires-Dist: numpy<3,>=2
Requires-Dist: pyside6==6.8.0.1
Requires-Dist: shiboken6>=6.8.0.1
Dynamic: license-file

Behatrix
=======================


# Behavioral sequences analysis with permutations test

![Behatrix logo](https://www.boris.unito.it/images/logo_behatrix.png)


Researchers who observe and study behavior often collect data in the
form of sequences of behavioral displays that they need to analyze and
visualize to test hypotheses. **Behatrix** is free and open-source
software available for GNU/Linux, Windows and Mac OS X.

By using a flexible and efficient approach, **Behatrix** allows
analyzing large sets of behavioral sequences and can organize data into
contingency tables. The program can also perform permutations test and
autonomously generate the code for a flow diagram representing the
transitions between behaviors.

**Behatrix** can read data exported from [**BORIS**](http://www.boris.unito.it)
(see [Events as behavioral sequences](http://www.boris.unito.it/user_guide/export_events/#export-events-as-behavioral-sequences))
and can also be used as a standalone program.

## Features

-   Behavioral sequences statistics (with n-gram size option)
-   Observed transitions matrix (with n-gram size option)
-   Generation of the [Graphviz](https://graphviz.org/) script from observed transitions
-   Flow diagram generation  (with n-gram size option)
-   Random permutations test (with multiprocessing module) with generation of the transitions significativity matrix
-   Flow diagram generation with transitions significativity
-   Behavioral sequences distances: **Levenshtein distances** and **Needleman-Wunsch identities**

The flow diagram generation requires the the [Graphviz](https://graphviz.org/) open source graph visualization software.


# User guide

[Usage of Behatrix](https://github.com/olivierfriard/behatrix/blob/master/user_guide.md)


[Behatrix GitHub repository](https://github.com/olivierfriard/behatrix)

Please report [issues and feature request](https://github.com/olivierfriard/behatrix/issues) on GitHub.


# Change Log

Please consult the [change log page](https://github.com/olivierfriard/behatrix/wiki/revision-history).
