# aryan-virdi/cse-324 architecture

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

- Interactive diagram: https://gitdiagram.com/aryan-virdi/cse-324
- Repository: https://github.com/aryan-virdi/cse-324

## Overview

Carrot Field Vision System is a field-image analysis and visualization application intended to estimate carrot density for yield analysis. In the documented Streamlit workflow, users manage fields, upload images, and inspect or export recorded field data. The sampled ResNet processing path segments foliage, predicts a count, and stores density metadata; a separate YOLO live-processing path also detects carrots and records metadata. Database access and image storage support these workflows. The README also lists disease and weed detection as bonus goals, but the available evidence does not establish implemented runtime components for them.

Main entry points: [`src/Database/data_requester.py`](https://github.com/aryan-virdi/cse-324/blob/main/src/Database/data_requester.py) (Database Requester), [`src/Visualization_App/app.py`](https://github.com/aryan-virdi/cse-324/blob/main/src/Visualization_App/app.py) (Streamlit App), [`src/Models/resnet_liveprocessing.py`](https://github.com/aryan-virdi/cse-324/blob/main/src/Models/resnet_liveprocessing.py) (ResNet Processing), [`src/Database/database.py`](https://github.com/aryan-virdi/cse-324/blob/main/src/Database/database.py) (Database Setup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Field Application"]
  node_streamlit["Streamlit App<br/>[app.py]"]
  node_field_mgmt["Field Management<br/>[createField.py]"]
  node_authentication["Authentication<br/>[authentication.py]"]
  node_upload["Image Upload<br/>[dataUpload.py]"]
  node_heatmap["Heatmap View<br/>[heatmap.py]"]
  node_export["Field Export<br/>[exportData.py]"]
end

subgraph group_vision["Vision Processing"]
  node_resnet_live["ResNet Processing"]
  node_segmentation["Foliage Segmentation<br/>[segmentation.py]"]
  node_inference["Count Inference<br/>[inference.py]"]
  node_resnet_training["ResNet Training<br/>[resnet.py]"]
  node_augmentation["Image Augmentation<br/>[augment_image.py]"]
end

subgraph group_data["Data Services"]
  node_requester["Database Requester<br/>[data_requester.py]"]
  node_database["Database Setup<br/>[database.py]"]
  node_models["Field Data Models<br/>[models.py]"]
  node_image_storage["Image Storage<br/>[image_storage.py]"]
end

subgraph group_yolo["YOLO Detection"]
  node_yolo_live["YOLO Processing<br/>[liveprocessing.py]"]
  node_carrot_model["Carrot Detector<br/>[carrotmodel.py]"]
end

node_user(("Field User"))
node_postgres[("PostgreSQL")]
node_s3[("S3 / MinIO")]

node_user -->|"uses"| node_streamlit
node_streamlit -->|"routes to"| node_field_mgmt
node_streamlit -->|"routes to"| node_authentication
node_streamlit -->|"routes to"| node_upload
node_streamlit -->|"routes to"| node_heatmap
node_streamlit -->|"routes to"| node_export
node_streamlit -->|"initializes"| node_database
node_field_mgmt -->|"uses"| node_requester
node_upload -->|"processes images"| node_resnet_live
node_heatmap -->|"retrieves data"| node_requester
node_export -->|"retrieves data"| node_requester
node_resnet_live -->|"segments foliage"| node_segmentation
node_resnet_live -->|"predicts count"| node_inference
node_resnet_live -->|"writes density"| node_requester
node_resnet_training -->|"imports augmentation"| node_augmentation
node_yolo_live -->|"runs detection"| node_carrot_model
node_yolo_live -->|"writes density"| node_requester
node_requester -->|"uses engine"| node_database
node_database -->|"creates tables"| node_models
node_requester -->|"queries records"| node_models
node_requester -->|"fetches images"| node_image_storage
node_database -.->|"connects"| node_postgres
node_image_storage -->|"stores images"| node_s3

click node_streamlit "https://github.com/aryan-virdi/cse-324/blob/main/src/Visualization_App/app.py"
click node_field_mgmt "https://github.com/aryan-virdi/cse-324/blob/main/src/Visualization_App/createField.py"
click node_authentication "https://github.com/aryan-virdi/cse-324/blob/main/src/Visualization_App/authentication.py"
click node_upload "https://github.com/aryan-virdi/cse-324/blob/main/src/Visualization_App/dataUpload.py"
click node_heatmap "https://github.com/aryan-virdi/cse-324/blob/main/src/Visualization_App/heatmap.py"
click node_export "https://github.com/aryan-virdi/cse-324/blob/main/src/Visualization_App/exportData.py"
click node_resnet_live "https://github.com/aryan-virdi/cse-324/blob/main/src/Models/resnet_liveprocessing.py"
click node_segmentation "https://github.com/aryan-virdi/cse-324/blob/main/src/Models/segmentation.py"
click node_inference "https://github.com/aryan-virdi/cse-324/blob/main/src/Models/inference.py"
click node_resnet_training "https://github.com/aryan-virdi/cse-324/blob/main/src/Models/RESNET/resnet.py"
click node_augmentation "https://github.com/aryan-virdi/cse-324/blob/main/src/Models/RESNET/augment_image.py"
click node_yolo_live "https://github.com/aryan-virdi/cse-324/blob/main/src/yolo/liveprocessing.py"
click node_carrot_model "https://github.com/aryan-virdi/cse-324/blob/main/src/yolo/Scripts/carrotmodel.py"
click node_requester "https://github.com/aryan-virdi/cse-324/blob/main/src/Database/data_requester.py"
click node_database "https://github.com/aryan-virdi/cse-324/blob/main/src/Database/database.py"
click node_models "https://github.com/aryan-virdi/cse-324/blob/main/src/Database/models.py"
click node_image_storage "https://github.com/aryan-virdi/cse-324/blob/main/src/Database/image_storage.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_streamlit,node_field_mgmt,node_authentication,node_upload,node_heatmap,node_export,node_user toneBlue
class node_resnet_live,node_segmentation,node_inference,node_resnet_training,node_augmentation,node_postgres,node_s3 toneAmber
class node_requester,node_database,node_models,node_image_storage toneMint
class node_yolo_live,node_carrot_model toneRose
```

## Components

### Field Application

- [Streamlit App](https://github.com/aryan-virdi/cse-324/blob/main/src/Visualization_App/app.py): `src/Visualization_App/app.py`
- [Field Management](https://github.com/aryan-virdi/cse-324/blob/main/src/Visualization_App/createField.py): `src/Visualization_App/createField.py`
- [Authentication](https://github.com/aryan-virdi/cse-324/blob/main/src/Visualization_App/authentication.py): `src/Visualization_App/authentication.py`
- [Image Upload](https://github.com/aryan-virdi/cse-324/blob/main/src/Visualization_App/dataUpload.py): `src/Visualization_App/dataUpload.py`
- [Heatmap View](https://github.com/aryan-virdi/cse-324/blob/main/src/Visualization_App/heatmap.py): `src/Visualization_App/heatmap.py`
- [Field Export](https://github.com/aryan-virdi/cse-324/blob/main/src/Visualization_App/exportData.py): `src/Visualization_App/exportData.py`

### Vision Processing

- [ResNet Processing](https://github.com/aryan-virdi/cse-324/blob/main/src/Models/resnet_liveprocessing.py): `src/Models/resnet_liveprocessing.py`
- [Foliage Segmentation](https://github.com/aryan-virdi/cse-324/blob/main/src/Models/segmentation.py): `src/Models/segmentation.py`
- [Count Inference](https://github.com/aryan-virdi/cse-324/blob/main/src/Models/inference.py): `src/Models/inference.py`
- [ResNet Training](https://github.com/aryan-virdi/cse-324/blob/main/src/Models/RESNET/resnet.py): `src/Models/RESNET/resnet.py`
- [Image Augmentation](https://github.com/aryan-virdi/cse-324/blob/main/src/Models/RESNET/augment_image.py): `src/Models/RESNET/augment_image.py`

### Data Services

- [Database Requester](https://github.com/aryan-virdi/cse-324/blob/main/src/Database/data_requester.py): `src/Database/data_requester.py`
- [Database Setup](https://github.com/aryan-virdi/cse-324/blob/main/src/Database/database.py): `src/Database/database.py`
- [Field Data Models](https://github.com/aryan-virdi/cse-324/blob/main/src/Database/models.py): `src/Database/models.py`
- [Image Storage](https://github.com/aryan-virdi/cse-324/blob/main/src/Database/image_storage.py): `src/Database/image_storage.py`

### YOLO Detection

- [YOLO Processing](https://github.com/aryan-virdi/cse-324/blob/main/src/yolo/liveprocessing.py): `src/yolo/liveprocessing.py`
- [Carrot Detector](https://github.com/aryan-virdi/cse-324/blob/main/src/yolo/Scripts/carrotmodel.py): `src/yolo/Scripts/carrotmodel.py`

### Other components

- **Field User**
- **PostgreSQL**
- **S3 / MinIO**

## Connections

- Field User → Streamlit App: uses (evidence: `src/Visualization_App/app.py`)
- Streamlit App → Field Management: routes to (evidence: `src/Visualization_App/app.py`)
- Streamlit App → Authentication: routes to (evidence: `src/Visualization_App/app.py`)
- Streamlit App → Image Upload: routes to (evidence: `src/Visualization_App/app.py`)
- Streamlit App → Heatmap View: routes to (evidence: `src/Visualization_App/app.py`)
- Streamlit App → Field Export: routes to (evidence: `src/Visualization_App/app.py`)
- Streamlit App → Database Setup: initializes (evidence: `src/Visualization_App/app.py`)
- Field Management → Database Requester: uses (evidence: `src/Visualization_App/createField.py`)
- Image Upload → ResNet Processing: processes images (evidence: `src/Visualization_App/dataUpload.py`)
- Heatmap View → Database Requester: retrieves data (evidence: `src/Visualization_App/heatmap.py`)
- Field Export → Database Requester: retrieves data (evidence: `src/Visualization_App/exportData.py`)
- ResNet Processing → Foliage Segmentation: segments foliage (evidence: `src/Models/resnet_liveprocessing.py`)
- ResNet Processing → Count Inference: predicts count (evidence: `src/Models/resnet_liveprocessing.py`)
- ResNet Processing → Database Requester: writes density (evidence: `src/Models/resnet_liveprocessing.py`)
- ResNet Training → Image Augmentation: imports augmentation (evidence: `src/Models/RESNET/resnet.py`)
- YOLO Processing → Carrot Detector: runs detection (evidence: `src/yolo/liveprocessing.py`)
- YOLO Processing → Database Requester: writes density (evidence: `src/yolo/liveprocessing.py`)
- Database Requester → Database Setup: uses engine (evidence: `src/Database/data_requester.py`)
- Database Setup → Field Data Models: creates tables (evidence: `src/Database/database.py`)
- Database Requester → Field Data Models: queries records (evidence: `src/Database/data_requester.py`)
- Database Requester → Image Storage: fetches images (evidence: `src/Database/data_requester.py`)
- Database Setup → PostgreSQL: connects
- Image Storage → S3 / MinIO: stores images (evidence: `src/Database/image_storage.py`)
