# pheanyps010204-ai/face_recognition_pca architecture

> Architecture diagram of the GitHub repository pheanyps010204-ai/face_recognition_pca, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/pheanyps010204-ai/face_recognition_pca
- Repository: https://github.com/pheanyps010204-ai/face_recognition_pca

## Overview

This is a PCA–SVM face-recognition research project. Its user-facing workflow captures webcam frames, detects and preprocesses faces, applies the trained scaler, PCA transform and SVM, then displays an identity or threshold-based UNKNOWN result. Separate capture scripts build known-person and unknown-person image sets; notebooks and saved results document PCA analysis and model comparisons. The README documents training and analysis stages, but the supplied source excerpts do not show their implementations or wiring, so those links are documentation-based.

Main entry points: [`src/train_model.py`](https://github.com/pheanyps010204-ai/face_recognition_pca/blob/main/src/train_model.py) (Model training), [`src/webcam_recognition.py`](https://github.com/pheanyps010204-ai/face_recognition_pca/blob/main/src/webcam_recognition.py) (Recognition app), [`dataset`](https://github.com/pheanyps010204-ai/face_recognition_pca/tree/main/dataset) (Face dataset), [`results`](https://github.com/pheanyps010204-ai/face_recognition_pca/tree/main/results) (Experiment results)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_capture["Image capture"]
  node_known_capture["Known capture<br/>[collect_faces.py]"]
  node_unknown_capture["Unknown capture<br/>[collect_unknown.py]"]
  node_dataset[("Face dataset")]
end

subgraph group_recognition["Live recognition"]
  node_webcam(("Webcam input"))
  node_live_app["Recognition app"]
  node_face_detection["Face detection<br/>[face_detection.py]"]
  node_result["Identity result"]
end

subgraph group_modeling["Model pipeline"]
  node_preprocessing["Face preprocessing"]
  node_scaler["Standard scaling"]
  node_pca["PCA transform"]
  node_svm["SVM classifier"]
  node_training["Model training<br/>[train_model.py]"]
end

subgraph group_analysis["Experiments"]
  node_pca_study["PCA analysis"]
  node_model_comparison["Model comparison"]
  node_unknown_study["Unknown rejection study"]
  node_saved_results[("Experiment results")]
end

node_person(("Person"))

node_person -->|"provides images"| node_known_capture
node_known_capture -->|"saves faces"| node_dataset
node_person -->|"provides images"| node_unknown_capture
node_unknown_capture -->|"saves unknowns"| node_dataset
node_dataset -.->|"trains on"| node_training
node_webcam -->|"supplies frames"| node_live_app
node_live_app -.->|"detects faces"| node_face_detection
node_live_app -->|"prepares faces"| node_preprocessing
node_preprocessing -->|"flattens pixels"| node_scaler
node_scaler -->|"scales features"| node_pca
node_pca -->|"projects features"| node_svm
node_svm -->|"predicts identity"| node_result
node_training -.->|"fits transform"| node_scaler
node_training -.->|"fits transform"| node_pca
node_training -.->|"fits classifier"| node_svm
node_unknown_study -.->|"records findings"| node_saved_results
node_pca_study -.->|"records findings"| node_saved_results
node_model_comparison -.->|"records findings"| node_saved_results

click node_known_capture "https://github.com/pheanyps010204-ai/face_recognition_pca/blob/main/src/collect_faces.py"
click node_unknown_capture "https://github.com/pheanyps010204-ai/face_recognition_pca/blob/main/src/collect_unknown.py"
click node_dataset "https://github.com/pheanyps010204-ai/face_recognition_pca/tree/main/dataset"
click node_live_app "https://github.com/pheanyps010204-ai/face_recognition_pca/blob/main/src/webcam_recognition.py"
click node_face_detection "https://github.com/pheanyps010204-ai/face_recognition_pca/blob/main/src/face_detection.py"
click node_preprocessing "https://github.com/pheanyps010204-ai/face_recognition_pca/blob/main/src/webcam_recognition.py"
click node_scaler "https://github.com/pheanyps010204-ai/face_recognition_pca/blob/main/src/webcam_recognition.py"
click node_pca "https://github.com/pheanyps010204-ai/face_recognition_pca/blob/main/src/webcam_recognition.py"
click node_svm "https://github.com/pheanyps010204-ai/face_recognition_pca/blob/main/src/webcam_recognition.py"
click node_training "https://github.com/pheanyps010204-ai/face_recognition_pca/blob/main/src/train_model.py"
click node_result "https://github.com/pheanyps010204-ai/face_recognition_pca/blob/main/src/webcam_recognition.py"
click node_pca_study "https://github.com/pheanyps010204-ai/face_recognition_pca/blob/main/notebooks/05_pca_analysis.ipynb"
click node_model_comparison "https://github.com/pheanyps010204-ai/face_recognition_pca/blob/main/notebooks/06_comparison.ipynb"
click node_unknown_study "https://github.com/pheanyps010204-ai/face_recognition_pca/blob/main/notebooks/07_final_results.ipynb"
click node_saved_results "https://github.com/pheanyps010204-ai/face_recognition_pca/tree/main/results"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_known_capture,node_unknown_capture,node_dataset toneBlue
class node_webcam,node_live_app,node_face_detection,node_result toneAmber
class node_preprocessing,node_scaler,node_pca,node_svm,node_training toneMint
class node_pca_study,node_model_comparison,node_unknown_study,node_saved_results toneRose
class node_person toneIndigo
```

## Components

### Image capture

- [Known capture](https://github.com/pheanyps010204-ai/face_recognition_pca/blob/main/src/collect_faces.py): `src/collect_faces.py`
- [Unknown capture](https://github.com/pheanyps010204-ai/face_recognition_pca/blob/main/src/collect_unknown.py): `src/collect_unknown.py`
- [Face dataset](https://github.com/pheanyps010204-ai/face_recognition_pca/tree/main/dataset): `dataset`

### Live recognition

- **Webcam input**
- [Recognition app](https://github.com/pheanyps010204-ai/face_recognition_pca/blob/main/src/webcam_recognition.py): `src/webcam_recognition.py`
- [Face detection](https://github.com/pheanyps010204-ai/face_recognition_pca/blob/main/src/face_detection.py): `src/face_detection.py`
- [Identity result](https://github.com/pheanyps010204-ai/face_recognition_pca/blob/main/src/webcam_recognition.py): `src/webcam_recognition.py`

### Model pipeline

- [Face preprocessing](https://github.com/pheanyps010204-ai/face_recognition_pca/blob/main/src/webcam_recognition.py): `src/webcam_recognition.py`
- [Standard scaling](https://github.com/pheanyps010204-ai/face_recognition_pca/blob/main/src/webcam_recognition.py): `src/webcam_recognition.py`
- [PCA transform](https://github.com/pheanyps010204-ai/face_recognition_pca/blob/main/src/webcam_recognition.py): `src/webcam_recognition.py`
- [SVM classifier](https://github.com/pheanyps010204-ai/face_recognition_pca/blob/main/src/webcam_recognition.py): `src/webcam_recognition.py`
- [Model training](https://github.com/pheanyps010204-ai/face_recognition_pca/blob/main/src/train_model.py): `src/train_model.py`

### Experiments

- [PCA analysis](https://github.com/pheanyps010204-ai/face_recognition_pca/blob/main/notebooks/05_pca_analysis.ipynb): `notebooks/05_pca_analysis.ipynb`
- [Model comparison](https://github.com/pheanyps010204-ai/face_recognition_pca/blob/main/notebooks/06_comparison.ipynb): `notebooks/06_comparison.ipynb`
- [Unknown rejection study](https://github.com/pheanyps010204-ai/face_recognition_pca/blob/main/notebooks/07_final_results.ipynb): `notebooks/07_final_results.ipynb`
- [Experiment results](https://github.com/pheanyps010204-ai/face_recognition_pca/tree/main/results): `results`

### Other components

- **Person**

## Connections

- Person → Known capture: provides images (evidence: `src/collect_faces.py`)
- Known capture → Face dataset: saves faces (evidence: `src/collect_faces.py`)
- Person → Unknown capture: provides images (evidence: `src/collect_unknown.py`)
- Unknown capture → Face dataset: saves unknowns (evidence: `src/collect_unknown.py`)
- Face dataset → Model training: trains on (evidence: `README.md`)
- Webcam input → Recognition app: supplies frames (evidence: `src/webcam_recognition.py`)
- Recognition app → Face detection: detects faces (evidence: `README.md`)
- Recognition app → Face preprocessing: prepares faces (evidence: `src/webcam_recognition.py`)
- Face preprocessing → Standard scaling: flattens pixels (evidence: `src/webcam_recognition.py`)
- Standard scaling → PCA transform: scales features (evidence: `src/webcam_recognition.py`)
- PCA transform → SVM classifier: projects features (evidence: `src/webcam_recognition.py`)
- SVM classifier → Identity result: predicts identity (evidence: `src/webcam_recognition.py`)
- Model training → Standard scaling: fits transform (evidence: `README.md`)
- Model training → PCA transform: fits transform (evidence: `README.md`)
- Model training → SVM classifier: fits classifier (evidence: `README.md`)
- Unknown rejection study → Experiment results: records findings
- PCA analysis → Experiment results: records findings
- Model comparison → Experiment results: records findings
