https://github.com/csiro/orientation-uv-rppg

[CVPRW2024] Repository for the paper "Orientation-conditioned Facial Texture Mapping for Video-based Facial Remote Photoplethysmography Estimation"

https://github.com/csiro/orientation-uv-rppg

Science Score: 36.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
  • Academic publication links
    Links to: arxiv.org
  • Academic email domains
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (11.6%) to scientific vocabulary

Keywords

computer-vision deep-learning remote-photoplethysmography remote-physiological-measurement rppg
Last synced: 10 months ago · JSON representation

Repository

[CVPRW2024] Repository for the paper "Orientation-conditioned Facial Texture Mapping for Video-based Facial Remote Photoplethysmography Estimation"

Basic Info
Statistics
  • Stars: 1
  • Watchers: 1
  • Forks: 0
  • Open Issues: 0
  • Releases: 0
Topics
computer-vision deep-learning remote-photoplethysmography remote-physiological-measurement rppg
Created 11 months ago · Last pushed 11 months ago
Metadata Files
Readme

README.md

Orientation UV rPPG

A self-contained Python package containing the video processing module similar to that used in the paper Orientation-conditioned Facial Texture Mapping for Video-based Facial Remote Photoplethysmography Estimation. For the full experimental code-base used to obtain the results in the paper please check out the experiments branch.

:wrench: Installation

Prerequisites

  • Python 3.10 or higher
  • CUDA-compatible GPU (optional, but recommended for performance)

Install from GitHub

Bash pip install git+https://github.com/csiro-internal/orientation-uv-rppg.git@package

:computer: Quick Start

Basic Usage

The simplest way to use the package: ```Python import torch import orientationuvrppg as ouv

Create video processor with custom parameters

processor = ouv.OrientationMaskedTextureSpaceVideoProcessor( mindetectionconfidence=0.7, # Higher confidence threshold mintrackingconfidence=0.8, # More stable tracking device="cuda", # Use GPU acceleration outputsize=128, # Higher resolution output degreethreshold=45.0 # Stricter orientation filtering )

Load your video frames

frames = torch.randn(200, 720, 1280, 3) # HD video frames

Process the video

result = processor(frames) print(f"Input: {frames.shape}") print(f"Output: {result.shape}") # Should be [200, 128, 128, 3] ```

Please see the examples/ directory for usage examples and visualizations.

:scroll: Citation

If you find this useful please cite our work.

@inproceedings{cantrill2024orientationconditionedfacialtexturemapping, title={Orientation-conditioned Facial Texture Mapping for Video-based Facial Remote Photoplethysmography Estimation}, author={Sam Cantrill and David Ahmedt-Aristizabal and Lars Petersson and Hanna Suominen and Mohammad Ali Armin}, booktitle={Proceedings of the IEEE/CVF Computer Vision and Pattern Recognition Workshops} year={2024}, url={https://openaccess.thecvf.com/content/CVPR2024W/CVPM/papers/Cantrill_Orientation-conditioned_Facial_Texture_Mapping_for_Video-based_Facial_Remote_Photoplethysmography_Estimation_CVPRW_2024_paper.pdf}, }

Owner

  • Name: CSIRO
  • Login: csiro
  • Kind: organization
  • Location: Australia

CSIRO public facing GitHub organisation.

GitHub Events

Total
  • Watch event: 1
  • Delete event: 1
  • Push event: 3
  • Public event: 1
  • Pull request event: 1
Last Year
  • Watch event: 1
  • Delete event: 1
  • Push event: 3
  • Public event: 1
  • Pull request event: 1

Dependencies

pyproject.toml pypi
  • mediapipe >=0.10.21
  • torch >=2.8.0