# harshavardhannayaka20072007-png/activity-14-hackathon-preparation architecture

> Architecture diagram of the GitHub repository harshavardhannayaka20072007-png/activity-14-hackathon-preparation, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/harshavardhannayaka20072007-png/activity-14-hackathon-preparation
- Repository: https://github.com/harshavardhannayaka20072007-png/activity-14-hackathon-preparation

## Overview

PixelGuard is an image-forensics prototype with two distinct capabilities: interactive analysis of one uploaded image, and an offline CASIA-compatible dataset feature pipeline. In the app, an upload is validated before the user starts analysis; ELA, image statistics, and EXIF are then displayed. The dataset pipeline discovers and inspects labeled images, extracts forensic features, groups duplicates for leakage-safe splits, and scales features using training data. Classifier, localization, evaluation, and explainability modules are Phase 2 placeholders, not working prediction stages. The graph reflects sampled calls and README claims; unsampled internals are not inferred.

Main entry points: [`app/app.py`](https://github.com/harshavardhannayaka20072007-png/activity-14-hackathon-preparation/blob/main/app/app.py) (Streamlit app), [`src/dataset_pipeline.py`](https://github.com/harshavardhannayaka20072007-png/activity-14-hackathon-preparation/blob/main/src/dataset_pipeline.py) (Pipeline orchestration), [`src/features.py`](https://github.com/harshavardhannayaka20072007-png/activity-14-hackathon-preparation/blob/main/src/features.py) (Forensic features), [`src/ela.py`](https://github.com/harshavardhannayaka20072007-png/activity-14-hackathon-preparation/blob/main/src/ela.py) (ELA generation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interactive["Interactive analysis"]
  node_app["Streamlit app<br/>[app.py]"]
end

subgraph group_analysis["Forensic analysis"]
  node_validation["Image validation<br/>[preprocessing.py]"]
  node_ela["ELA generation<br/>[ela.py]"]
  node_basic_features["Basic features<br/>[features.py]"]
  node_forensic_features["Forensic features<br/>[features.py]"]
  node_metadata["EXIF extraction<br/>[metadata.py]"]
end

subgraph group_dataset["Dataset pipeline"]
  node_dataset_pipeline["Pipeline orchestration"]
  node_dataset_discovery["Dataset discovery<br/>[dataset.py]"]
  node_dataset_inspection["Dataset inspection<br/>[dataset.py]"]
  node_pipeline_artifacts["Feature and split files"]
end

subgraph group_future["Planned capabilities"]
  node_classifier["Classification placeholder<br/>[classifier.py]"]
  node_localization["Region localization<br/>[localization.py]"]
  node_evaluation["Model evaluation<br/>[evaluation.py]"]
  node_explainability["Prediction explanations<br/>[explainability.py]"]
end

node_user(("Image uploader"))

node_user -->|"uploads image"| node_app
node_app -->|"validates image"| node_validation
node_app -->|"requests ELA"| node_ela
node_app -->|"extracts statistics"| node_basic_features
node_app -->|"extracts EXIF"| node_metadata
node_app -->|"displays analysis"| node_user
node_forensic_features -->|"uses ELA"| node_ela
node_dataset_pipeline -->|"loads records"| node_dataset_discovery
node_dataset_pipeline -->|"extracts features"| node_forensic_features
node_dataset_pipeline -->|"inspects dataset"| node_dataset_inspection
node_dataset_pipeline -->|"writes tables"| node_pipeline_artifacts

click node_app "https://github.com/harshavardhannayaka20072007-png/activity-14-hackathon-preparation/blob/main/app/app.py"
click node_validation "https://github.com/harshavardhannayaka20072007-png/activity-14-hackathon-preparation/blob/main/src/preprocessing.py"
click node_ela "https://github.com/harshavardhannayaka20072007-png/activity-14-hackathon-preparation/blob/main/src/ela.py"
click node_basic_features "https://github.com/harshavardhannayaka20072007-png/activity-14-hackathon-preparation/blob/main/src/features.py"
click node_forensic_features "https://github.com/harshavardhannayaka20072007-png/activity-14-hackathon-preparation/blob/main/src/features.py"
click node_metadata "https://github.com/harshavardhannayaka20072007-png/activity-14-hackathon-preparation/blob/main/src/metadata.py"
click node_dataset_pipeline "https://github.com/harshavardhannayaka20072007-png/activity-14-hackathon-preparation/blob/main/src/dataset_pipeline.py"
click node_dataset_discovery "https://github.com/harshavardhannayaka20072007-png/activity-14-hackathon-preparation/blob/main/src/dataset.py"
click node_dataset_inspection "https://github.com/harshavardhannayaka20072007-png/activity-14-hackathon-preparation/blob/main/src/dataset.py"
click node_pipeline_artifacts "https://github.com/harshavardhannayaka20072007-png/activity-14-hackathon-preparation/blob/main/src/dataset_pipeline.py"
click node_classifier "https://github.com/harshavardhannayaka20072007-png/activity-14-hackathon-preparation/blob/main/src/classifier.py"
click node_localization "https://github.com/harshavardhannayaka20072007-png/activity-14-hackathon-preparation/blob/main/src/localization.py"
click node_evaluation "https://github.com/harshavardhannayaka20072007-png/activity-14-hackathon-preparation/blob/main/src/evaluation.py"
click node_explainability "https://github.com/harshavardhannayaka20072007-png/activity-14-hackathon-preparation/blob/main/src/explainability.py"

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_app toneBlue
class node_validation,node_ela,node_basic_features,node_forensic_features,node_metadata toneAmber
class node_dataset_pipeline,node_dataset_discovery,node_dataset_inspection,node_pipeline_artifacts toneMint
class node_classifier,node_localization,node_evaluation,node_explainability toneRose
class node_user toneIndigo
```

## Components

### Interactive analysis

- [Streamlit app](https://github.com/harshavardhannayaka20072007-png/activity-14-hackathon-preparation/blob/main/app/app.py): `app/app.py`

### Forensic analysis

- [Image validation](https://github.com/harshavardhannayaka20072007-png/activity-14-hackathon-preparation/blob/main/src/preprocessing.py): `src/preprocessing.py`
- [ELA generation](https://github.com/harshavardhannayaka20072007-png/activity-14-hackathon-preparation/blob/main/src/ela.py): `src/ela.py`
- [Basic features](https://github.com/harshavardhannayaka20072007-png/activity-14-hackathon-preparation/blob/main/src/features.py): `src/features.py`
- [Forensic features](https://github.com/harshavardhannayaka20072007-png/activity-14-hackathon-preparation/blob/main/src/features.py): `src/features.py`
- [EXIF extraction](https://github.com/harshavardhannayaka20072007-png/activity-14-hackathon-preparation/blob/main/src/metadata.py): `src/metadata.py`

### Dataset pipeline

- [Pipeline orchestration](https://github.com/harshavardhannayaka20072007-png/activity-14-hackathon-preparation/blob/main/src/dataset_pipeline.py): `src/dataset_pipeline.py`
- [Dataset discovery](https://github.com/harshavardhannayaka20072007-png/activity-14-hackathon-preparation/blob/main/src/dataset.py): `src/dataset.py`
- [Dataset inspection](https://github.com/harshavardhannayaka20072007-png/activity-14-hackathon-preparation/blob/main/src/dataset.py): `src/dataset.py`
- [Feature and split files](https://github.com/harshavardhannayaka20072007-png/activity-14-hackathon-preparation/blob/main/src/dataset_pipeline.py): `src/dataset_pipeline.py`

### Planned capabilities

- [Classification placeholder](https://github.com/harshavardhannayaka20072007-png/activity-14-hackathon-preparation/blob/main/src/classifier.py): `src/classifier.py`
- [Region localization](https://github.com/harshavardhannayaka20072007-png/activity-14-hackathon-preparation/blob/main/src/localization.py): `src/localization.py`
- [Model evaluation](https://github.com/harshavardhannayaka20072007-png/activity-14-hackathon-preparation/blob/main/src/evaluation.py): `src/evaluation.py`
- [Prediction explanations](https://github.com/harshavardhannayaka20072007-png/activity-14-hackathon-preparation/blob/main/src/explainability.py): `src/explainability.py`

### Other components

- **Image uploader**

## Connections

- Image uploader → Streamlit app: uploads image (evidence: `app/app.py`)
- Streamlit app → Image validation: validates image (evidence: `app/app.py`)
- Streamlit app → ELA generation: requests ELA (evidence: `app/app.py`)
- Streamlit app → Basic features: extracts statistics (evidence: `app/app.py`)
- Streamlit app → EXIF extraction: extracts EXIF (evidence: `app/app.py`)
- Streamlit app → Image uploader: displays analysis (evidence: `app/app.py`)
- Forensic features → ELA generation: uses ELA (evidence: `src/features.py`)
- Pipeline orchestration → Dataset discovery: loads records (evidence: `src/dataset_pipeline.py`)
- Pipeline orchestration → Forensic features: extracts features (evidence: `src/dataset_pipeline.py`)
- Pipeline orchestration → Dataset inspection: inspects dataset (evidence: `README.md`)
- Pipeline orchestration → Feature and split files: writes tables (evidence: `src/dataset_pipeline.py`)
