gazetimation

KO | EN

gitlite — search

#javascript #react #android #rust #linux #macos #java #windows #cli #kubernetes #pytorch #mcp #openai #open-source

(★ 13)

Gaze estimation from 2D image

gazetimation Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Gazetimation

![test](https://github.com/paul-shuvo/gazetimation/actions/workflows/test.yml/badge.svg) [![Docs](https://github.com/paul-shuvo/gazetimation/actions/workflows/docs.yml/badge.svg)](https://paul-shuvo.github.io/gazetimation/) [![PyPI version](https://badge.fury.io/py/gazetimation.svg)](https://badge.fury.io/py/gazetimation) [![License: MIT](https://img.shields.io/github/license/paul-shuvo/gazetimation)](https://opensource.org/licenses/MIT) ![downloads](https://img.shields.io/pypi/dm/gazetimation?color=blue) [![Codacy Badge](https://app.codacy.com/project/badge/Grade/1822d5b3047a4e3596404b4c0e636912)](https://www.codacy.com/gh/paul-shuvo/gazetimation/dashboard?utm_source=github.com&amp;utm_medium=referral&amp;utm_content=paul-shuvo/gazetimation&amp;utm_campaign=Badge_Grade)

<p>An out of the box solution for gaze estimation.

</div>

## Installation

```console
pip install gazetimation
```

## Usage

```python
from gazetimation import Gazetimation
gz = Gazetimation(device=0) # or any other device id
gz.run()
```

To run a video file
```python
gz.run(video_path='path/to/video')
```

To save as a video file
```python
gz.run(video_output_path='path/to/video.avi')
```

The [`run`](https://paul-shuvo.github.io/gazetimation/gazetimation.html#gazetimation.Gazetimation.run) method also accepts a handler function for further processing.
```python
gz.run(handler=my_handler)
```
__Attention__

The handler function will be called by passing the frame and the gaze information

```python
if handler is not None:
    handler([frame, left_pupil, right_pupil, gaze_left_eye, gaze_right_eye])
```

For more info check our [docs](https://paul-shuvo.github.io/gazetimation/).

## Citation

```tex

@INPROCEEDINGS{10654455,
  author={Paul, Shuvo Kumar and Nicolescu, Mircea and Nicolescu, Monica},
  booktitle={2024 8th International Conference on Robotics and Automation Sciences (ICRAS)}, 
  title={Enhancing Robotic Task Parameter Estimation Through Unified User Interaction: Gestures and Verbal Instructions in Collaboration}, 
  year={2024},
  volume={},
  number={},
  pages={66-71},
  keywords={Adaptation models;Parameter estimation;Human-robot interaction;Collaboration;Gesture recognition;Robot sensing systems;Real-time systems;task configuration;robotic task;verbal command;gesture recognition},
  doi={10.1109/ICRAS62427.2024.10654455}}
```

## Issues

If any issues are found, they can be reported
[here](https://github.com/paul-shuvo/gazetimation/issues).

## License

This project is licensed under the
[MIT](https://opensource.org/licenses/MIT) license.

<!-- ### Acknowledgement

This package was inspired from the amazing [Medium
post](https://medium.com/mlearning-ai/eye-gaze-estimation-using-a-webcam-in-100-lines-of-code-570d4683fe23)
by Amit Aflalo -->

gazetimation

gazetimation Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

gazetimation

gazetimation Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README