# Behavioral Imaging Toolbox
Bitbox is a free and open-source Python library including a comprehensive set of tools for the computational analysis of nonverbal human behavior. The provided tools enable analysis of face, head, and body movements, expressions, and actions from videos and images. Included algorithms and metrics have been validated using clinically vetted datasets and published extensively, therefore, can be reliably used by behavioral, social, and medical scientists in their human subject research. As we closely follow state-of-the-art in computer vision and machine learning, provided methodologies can also be relied upon by computer vision researchers and other engineers as well.
Please refer to our [Wiki](https://github.com/Computational-Psychiatry/bitbox/wiki) for further details.
## Installation
Before installing Bitbox, you need to install 3DI. If 3DI is not installed, you will receive an error when trying to use Bitbox. 3DI repository is located at [https://github.com/Computational-Psychiatry/3DI](https://github.com/Computational-Psychiatry/3DI).
To install Bitbox, follow these steps:
1. Clone the Bitbox repository:
```bash
git clone https://github.com/Computational-Psychiatry/bitbox.git
```
2. Change to the Bitbox directory:
```bash
cd bitbox
```
3. Install Bitbox using `python setup.py install`:
```bash
python setup.py install
```
4. Set the environment variable `PATH_3DI` to indicate the directory in which 3DI was installed:
- **Linux**:
```bash
export PATH_3DI=/path/to/3DI/directory
```
- **Windows** (Command Prompt):
```bash
set PATH_3DI=C:\path\to\3DI\directory
```
- **Mac**:
```bash
export PATH_3DI=/path/to/3DI/directory
```
Now you are ready to use Bitbox!
Raw data
{
"_id": null,
"home_page": "",
"name": "bitbox",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "ComPsy Group <tuncb@chop.edu>",
"keywords": "behavior,body actions,computer vision,facial expressions,psychiatry,psychology",
"author": "",
"author_email": "ComPsy Group <tuncb@chop.edu>",
"download_url": "https://files.pythonhosted.org/packages/f0/75/40c12f92529ecd79562d5e6c681ccf2bf88dff6c52b0e20db796274bd6d8/bitbox-2024.3.dev2.tar.gz",
"platform": null,
"description": "# Behavioral Imaging Toolbox\n\nBitbox is a free and open-source Python library including a comprehensive set of tools for the computational analysis of nonverbal human behavior. The provided tools enable analysis of face, head, and body movements, expressions, and actions from videos and images. Included algorithms and metrics have been validated using clinically vetted datasets and published extensively, therefore, can be reliably used by behavioral, social, and medical scientists in their human subject research. As we closely follow state-of-the-art in computer vision and machine learning, provided methodologies can also be relied upon by computer vision researchers and other engineers as well.\n\nPlease refer to our [Wiki](https://github.com/Computational-Psychiatry/bitbox/wiki) for further details.\n\n## Installation\n\nBefore installing Bitbox, you need to install 3DI. If 3DI is not installed, you will receive an error when trying to use Bitbox. 3DI repository is located at [https://github.com/Computational-Psychiatry/3DI](https://github.com/Computational-Psychiatry/3DI).\n\nTo install Bitbox, follow these steps:\n\n1. Clone the Bitbox repository:\n ```bash\n git clone https://github.com/Computational-Psychiatry/bitbox.git\n ```\n\n2. Change to the Bitbox directory:\n ```bash\n cd bitbox\n ```\n\n3. Install Bitbox using `python setup.py install`:\n ```bash\n python setup.py install\n ```\n\n4. Set the environment variable `PATH_3DI` to indicate the directory in which 3DI was installed:\n\n - **Linux**:\n ```bash\n export PATH_3DI=/path/to/3DI/directory\n ```\n\n - **Windows** (Command Prompt):\n ```bash\n set PATH_3DI=C:\\path\\to\\3DI\\directory\n ```\n\n - **Mac**:\n ```bash\n export PATH_3DI=/path/to/3DI/directory\n ```\n\nNow you are ready to use Bitbox!\n\n\n\n",
"bugtrack_url": null,
"license": "",
"summary": "Behavioral Imaging Toolbox",
"version": "2024.3.dev2",
"project_urls": {
"Documentation": "https://github.com/Computational-Psychiatry/bitbox/wiki",
"Homepage": "https://github.com/Computational-Psychiatry/bitbox",
"Issues": "https://github.com/Computational-Psychiatry/bitbox/issues"
},
"split_keywords": [
"behavior",
"body actions",
"computer vision",
"facial expressions",
"psychiatry",
"psychology"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "6d478896e0cdfb28ecb5bc0c913a2cfa6bb765b605342d133a94a14492c896d1",
"md5": "40886a424f2c8d9129963fe670a541d6",
"sha256": "e9cd2066b453c123ef71b72b17c991fb10878e7a0f483b103a8f969cc00b4ef6"
},
"downloads": -1,
"filename": "bitbox-2024.3.dev2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "40886a424f2c8d9129963fe670a541d6",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 24243,
"upload_time": "2024-03-14T19:38:58",
"upload_time_iso_8601": "2024-03-14T19:38:58.287075Z",
"url": "https://files.pythonhosted.org/packages/6d/47/8896e0cdfb28ecb5bc0c913a2cfa6bb765b605342d133a94a14492c896d1/bitbox-2024.3.dev2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "f07540c12f92529ecd79562d5e6c681ccf2bf88dff6c52b0e20db796274bd6d8",
"md5": "4bbed38e94f2bf5b5b794b7b602a703c",
"sha256": "7f92925e8dba6c5c5a9b621638779d6519feeb57dff405ab4cf84c3af2e7994a"
},
"downloads": -1,
"filename": "bitbox-2024.3.dev2.tar.gz",
"has_sig": false,
"md5_digest": "4bbed38e94f2bf5b5b794b7b602a703c",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 3023062,
"upload_time": "2024-03-14T19:39:02",
"upload_time_iso_8601": "2024-03-14T19:39:02.207310Z",
"url": "https://files.pythonhosted.org/packages/f0/75/40c12f92529ecd79562d5e6c681ccf2bf88dff6c52b0e20db796274bd6d8/bitbox-2024.3.dev2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-03-14 19:39:02",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Computational-Psychiatry",
"github_project": "bitbox",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "bitbox"
}
JSON
