# udrasht/face-recognition-using-principal-component-analysis architecture

> Architecture diagram of the GitHub repository udrasht/face-recognition-using-principal-component-analysis, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/udrasht/face-recognition-using-principal-component-analysis
- Repository: https://github.com/udrasht/face-recognition-using-principal-component-analysis

## Overview

##### Project type and purpose
- This is an academic/data-science mini-project implemented in a Jupyter Notebook. Its purpose is to perform face recognition via Principal Component Analysis (PCA) on the AT&T “faces” dataset, generating eigenfaces, projecting new images, and evaluating recognition accuracy.

##### File structure
- Top-level files:
- README.md – describes PCA steps, dataset, and results.
- code.ipynb – the main implementation: data loading, preprocessing, PCA training, projection, plotting.
- docs/images – example result plots.
- ATnT/ – dataset folder holding 40 subject directories (s1…s40), each containing 10 grayscale PGM images.
- No separate “src,” “frontend,” or “backend” directories; the entire pipeline lives in the notebook.

##### README for additional insights
- It outlines six conceptual steps: data collection & preprocessing → compute covariance → eigenvectors/eigenvalues → select principal components → project images → compare & evaluate.
- It shows two result images under docs/images.

##### Detailed guidance
- “Eigenface Basis” (persisted model)
- “Training Projections” (feature database)
- Enclose the entire flow inside a “Jupyter Notebook” boundary to show orchestration.
- Module with key libraries (e.g., NumPy, Matplotlib).

## Diagram (Mermaid)

```mermaid
flowchart TB
    Data["ATnT Dataset"]:::data
    Read["Project Overview & PCA Methodology"]:::external

    subgraph "Jupyter Notebook Kernel"
        direction TB
        Pre["Image Preprocessing<br/>(NumPy)"]:::compute
        PCA["PCA Trainer<br/>(NumPy, scikit-learn)"]:::compute
        Basis["Eigenface Basis<br/>(model)"]:::data
        ProjTrain["Training Projections<br/>(feature DB)"]:::data
        Recog["Projection & Recognition<br/>(NumPy)"]:::compute
        Eval["Evaluation & Visualization<br/>(Matplotlib)"]:::result
    end

    Test["Test Image"]:::data

    Data -->|"raw images"| Pre
    Pre -->|"normalized images"| PCA
    PCA -->|"eigenfaces"| Basis
    PCA -->|"feature vectors"| ProjTrain
    Test -->|"test image"| Recog
    Basis --> Recog
    ProjTrain --> Recog
    Recog -->|"predicted labels"| Eval

    Read -.-> Pre

    click Data "https://github.com/udrasht/face-recognition-using-principal-component-analysis/tree/main/ATnT/"
    click Read "https://github.com/udrasht/face-recognition-using-principal-component-analysis/blob/main/README.md"
    click Pre "https://github.com/udrasht/face-recognition-using-principal-component-analysis/blob/main/code.ipynb"
    click PCA "https://github.com/udrasht/face-recognition-using-principal-component-analysis/blob/main/code.ipynb"
    click Basis "https://github.com/udrasht/face-recognition-using-principal-component-analysis/blob/main/code.ipynb"
    click ProjTrain "https://github.com/udrasht/face-recognition-using-principal-component-analysis/blob/main/code.ipynb"
    click Recog "https://github.com/udrasht/face-recognition-using-principal-component-analysis/blob/main/code.ipynb"
    click Eval "https://github.com/udrasht/face-recognition-using-principal-component-analysis/blob/main/code.ipynb"
    click Eval "https://github.com/udrasht/face-recognition-using-principal-component-analysis/tree/main/docs/images/"

    classDef data fill:#bbdefb,stroke:#1e88e5,color:#0d47a1;
    classDef compute fill:#c8e6c9,stroke:#43a047,color:#1b5e20;
    classDef result fill:#ffe0b2,stroke:#fb8c00,color:#e65100;
    classDef external fill:#e1bee7,stroke:#8e24aa,color:#4a148c;
```
