OpenDBM
Supported OS Platforms
| OS | Build Status |
|---|---|
| Linux |  |
| Windows |  |
| macOS-Intel |  |
What is it
OpenDBM is a software package that allows for calculation of digital biomarkers of health and functioning from video or audio of an individual’s behavior. It integrates existing tools for behavioral measurements such as facial activity, voice, speech, and movement into a single package for measurement of overall behavior.
More About OpenDBM
At a modular level, OpenDBM is a library that consists of the following components:
| Component | Description |
|---|---|
| Facial | An OpenDBM module to get facial attributes |
| Movement | An OpenDBM module to get movement attributes |
| Acoustic | An OpenDBM module to get acoustic attributes |
| Audio | An OpenDBM module to get audio attributes |
Usually, OpenDBM is used for:
- A digital biomaker extraction app
- A helper tools to give insight of patient condition
Table of Contents
⭐️ Installation
Prerequisites (Install Dependencies)
With Conda Environment (recommended)
Make sure to install conda first at anaconda
On Linux/macOS
conda install -c conda-forge cmake ffmpeg soxOn Windows
#Make sure to run in Anaconda Prompt, or add conda to the path.
conda install -c conda-forge ffmpeg sox dlibWithout Conda Environment
OpenDBM Installation
pip install opendbm Model Download ( Facial and Movement Components)
Make sure you have installed docker and already login to Docker Hub.
If you haven't, Find the tutorial here
docker pull opendbmteam/dbm-openface
⭐️ Usage
Basic Usage
Try your first OpenDBM program
from opendbm import FacialActivity
#make sure Docker is active to access the model
model = FacialActivity()
path = "sample.mp4"
model.fit(path)
landmark = model.get_landmark()To get the attribute like mean and std is as straighforward as .mean():
landmark.mean()
landmark.std()
landmark.to_dataframe() # convert results as pandas dataframeFor more in-depth tutorials about OpenDBM, you can check out:
⭐️ More resources
⭐️ License
OpenDBM is published under the GNU AGPL 3.0 license.
⭐️ People
OpenDBM was developed by Anzar Abbas and Vijay Yadav, alongside Vidya Koesmahargyo and Isaac Galatzer-Levy, from within the Research and Development department at AiCure––a health tech startup in New York. It was made open source in October 2020. You can contact us at opendbm@aicure.com.
