OpenWillis is a python library for digital health measurement.
It was developed by Brooklyn Health to establish standardized methods in digital phenotyping and make them open and accessible to the scientific community.
It is freely available for non-commercial use (see license).
The OpenWillis Wiki contains detailed documentation on the following:
- Function methods and documentation
- Release notes
- Instructions for getting started
- Research guidelines
- Contribution guidelines
- User community events
Please use the following reference when reporting work that has used OpenWillis: Worthington, M., Efstathiadis, G., Yadav, V., & Abbas, A. (2024). 172. OpenWillis: An Open-Source Python Library for Digital Health Measurement. Biological Psychiatry, 95(10), S169-S170.
Please report any issues using the Issues tab.
If you’d like to contribute to OpenWillis or have general questions, please get in touch.
Certain requirements are required prior to installing OpenWillis. For full details, please see installation instructions here.
OpenWillis can be installed from PyPI using pip:
pip install openwillis
Below is an example use of the facial_expressivity
function to calculate expressivity from a video.
import openwillis as ow
framewise_loc, framewise_disp, summary = ow.facial_expressivity('data/video.mp4', 'data/baseline.mp4')
All OpenWillis functions are listed in the wiki's List of Functions.
Each function has a document that details its use, methods utilized, input and output parameters, primary outcome measures, and any additional information relevant for the use of the function.