abc 2024

.gitignore

@@ -0,0 +1,223 @@
+# Created by https://www.toptal.com/developers/gitignore/api/python,macos,jupyternotebooks
+# Edit at https://www.toptal.com/developers/gitignore?templates=python,macos,jupyternotebooks
+
+### JupyterNotebooks ###
+# gitignore template for Jupyter Notebooks
+# website: http://jupyter.org/
+
+.ipynb_checkpoints
+*/.ipynb_checkpoints/*
+
+# IPython
+profile_default/
+ipython_config.py
+
+# Remove previous ipynb_checkpoints
+#   git rm -r .ipynb_checkpoints/
+
+### macOS ###
+# General
+.DS_Store
+.AppleDouble
+.LSOverride
+
+# Icon must end with two \r
+Icon
+
+
+# Thumbnails
+._*
+
+# Files that might appear in the root of a volume
+.DocumentRevisions-V100
+.fseventsd
+.Spotlight-V100
+.TemporaryItems
+.Trashes
+.VolumeIcon.icns
+.com.apple.timemachine.donotpresent
+
+# Directories potentially created on remote AFP share
+.AppleDB
+.AppleDesktop
+Network Trash Folder
+Temporary Items
+.apdisk
+
+### macOS Patch ###
+# iCloud generated files
+*.icloud
+
+### Python ###
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+
+# IPython
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#pdm.lock
+#   pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
+#   in version control.
+#   https://pdm.fming.dev/#use-with-ide
+.pdm.toml
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+#.idea/
+
+### Python Patch ###
+# Poetry local configuration file - https://python-poetry.org/docs/configuration/#local-configuration
+poetry.toml
+
+# ruff
+.ruff_cache/
+
+# LSP config files
+pyrightconfig.json
+
+# End of https://www.toptal.com/developers/gitignore/api/python,macos,jupyternotebooks
+
+/dataset/*
+/dataset.zip

README.md

@@ -0,0 +1,90 @@
+<img width="1750" alt="FacePsy" src="./imgs/header.png">
+
+This challenge is part of the **[7th International Conference on Activity and Behavior Computing](https://autocare.ai/abc2025)**.
+
+<img width="1750" alt="FacePsy" src="./imgs/conflogo.png">
+
+---
+
+## Dataset Information
+
+The dataset used for this challenge was collected as part of the FacePsy study. It contains facial behavior and head gesture data aimed at detecting depressive episodes. The dataset is available for download:
+
+**[Download Dataset](https://github.com/stevenshci/BeyondSmile/releases/download/dataset.v1/dataset.zip)**
+
+### Dataset Structure
+```
+
+dataset/ 
+├── data/ 
+│ ├── P08.json
+│ ├── P10.json 
+│ ├── ... 
+│ └── P38.json 
+├── groundtruth/ 
+│ └── phq9.csv
+```
+
+
+### Data Description
+- **`data/`:** Contains participant data in JSON format, capturing facial features and behavior during the study. A feature description can be found in [here](https://github.com/stevenshci/BeyondSmile/blob/main/sample/datasetDescription.pdf)
+- **`groundtruth/`:** Includes `phq9.csv`, which provides the PHQ-9 scores used as ground truth for depressive episode labeling. The `phq9.csv` ground truth has columns as
+  -  **`pid`:** Participant ID of the the participants. For each participant, we have one JSON file in the `data/` folder.
+  -  **`start_ts`:** Start of oberservation period. An observation period has a length of 2 weeks.
+  -  **`end_ts`:** End of the observation period. NOTE: Some participants may have reported their PHQ-9 a few days after the 2-week period. For those observations, the length may be a few days longer.
+  -  **`start_phq9`:** PHQ-9 score at the start of observation period.
+  -  **`end_phq9`:** PHQ-9 score at the end of the observation period.
+  -  **`depression_episode`:** Depression label. A participant observation period (i.e., 2 weeks) is labeled as having a depressive episode(label=1) if and only if the participant reported PHQ-9 >= 5 both at the start and end of the observation period; otherwise, it is labeled a non-depressive (label=0).
+
+---
+
+## Tutorial
+
+A detailed tutorial for processing and analyzing the dataset is available in **[Tutorial.ipynb](https://github.com/stevenshci/BeyondSmile/blob/main/Tutorial.ipynb)**.
+
+---
+
+## Evaluation Guidelines
+
+The evaluation involves building models to predict depressive episodes using the dataset. There are two evaluation approaches:
+1. **Universal Model:**  
+   - Train a single model using all participant data.
+   - Use leave-one-participant-out (LOPO) cross-validation.
+   - Evaluate using metrics like AUROC, Accuracy, Precision, Recall, F1 Score.
+
+2. **Hybrid Model:**  
+   - Combine user-specific data with general data for training.
+   - Use nested cross-validation (e.g., leave-one-participant-day-out with time-series awareness).
+   - Focus on personalized depression detection while maintaining generalizability.
+
+---
+
+## Citation
+
+If you use this dataset, please cite the FacePsy paper:
+
+```
+@article{10.1145/3676505,
+author = {Islam, Rahul and Bae, Sang Won},
+title = {FacePsy: An Open-Source Affective Mobile Sensing System - Analyzing Facial Behavior and Head Gesture for Depression Detection in Naturalistic Settings},
+year = {2024},
+issue_date = {September 2024},
+publisher = {Association for Computing Machinery},
+address = {New York, NY, USA},
+volume = {8},
+number = {MHCI},
+url = {https://doi.org/10.1145/3676505},
+doi = {10.1145/3676505},
+month = sep,
+articleno = {260},
+numpages = {32},
+keywords = {affective computing, application instrumentation, depression, empirical study that tells us about people, field study, machine learning, mobile computing, system}
+}
+```
+---
+
+## Contact
+
+For any inquiries, please contact **Rahul Islam** at [[email protected]](mailto:[email protected]).
+
+---