Metadata-Version: 2.4
Name: perceul
Version: 0.4.0
Summary: A framework for unsupervised profiling of perception and cognitive-environmental ergonomics in the workplace.
Author-email: Jasper Gomez <gomezjasper123@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/jasper-gomez/perceul
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Intended Audience :: Science/Research
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: gradio>=6.20.0
Requires-Dist: hdbscan>=0.8.40
Requires-Dist: joblib>=1.5.0
Requires-Dist: matplotlib>=3.11.0
Requires-Dist: numpy>=2.5.0
Requires-Dist: pandas>=3.0.0
Requires-Dist: scikit-learn>=1.9.0
Requires-Dist: umap-learn>=0.5.10
Dynamic: license-file

# PERCEUL
A Framework and Prototype for Unsupervised Profiling of Perception and Cognitive Ergonomics in the Workplace

---

## 📌 Overview

PERCEUL aims to bridge ergonomics and AI, with the project using Unsupervised Learning for clustering latent perceptual profiles of workers in different work settings. It can be used by Ergonomics Analysts and Consultants who are sufficiently knowledgeable on Unsupervised Learning implementation, workflow, and cluster interpretation. The project includes using psychological, perceptual, self-reporting scales or tools, and Unsupervised Learning algorithms and workflow. PERCEUL exists to address the gap in AI and ergonomics, serving as an innovation that automates the profiling of workers for workspace reorganization, resource allocation, and strategic workplace dynamics, ultimately becoming a decision-support tool.

---

## 📂 Contents
```
- artifacts
  - perceul-framework.png
  - concept-brief.md
  - pipelines
    - core_pipeline.pkl
    - exploration_pipeline.pkl
- notebooks
  - PERCEUL.ipynb
- README.md
- LICENSE
- CITATION.cff
```

--- 
## 📄 License

This project is licensed under the **MIT License**, which allows commercial and non-commercial use, modification, and distribution, provided that proper attribution is given.

See the full license text in the [`LICENSE`](./LICENSE) file.

---

## 📑 Citation

If you use PERCEUL — whether the framework, methodology, prototype implementation, or any derived components — please cite the repository using the metadata provided in the [`CITATION.cff`](./CITATION.cff) file.

GitHub will automatically generate a “Cite this repository” button that you can use.

---

## 📝 Attribution Requirements

When building upon or reusing this work, please include:

- **Author name**: Jasper Gomez  
- **Repository name**: PERCEUL  
- **Repository link**: https://github.com/jasper-gomez/perceul/tree/main
- **Citation using the `CITATION.cff` metadata**  
- A note in your documentation, publication, or code comments acknowledging the original work

Example acknowledgment:

> “This work builds on *PERCEUL: A Framework and Prototype for Unsupervised Profiling of Perception and Cognitive Ergonomics in the Workplace* by Jasper Gomez (MIT Licensed).”

Following these guidelines helps support academic and ethical reuse.
