Upload README.md

README.md

@@ -1,105 +1,106 @@
-# 🧠 KKT-HF-TransferLearning-Models  
-### Transfer Learning Models Collection for Image Classification  
-Created by **Thyagharajan K K**
-
----
-
-## 📁 Repository Structure
-```
-
-KKT-HF-TransferLearning-Models/          ← Root directory (your HF repo root)
-│
-├── Insect_Inception_V3/                 ← Model 1 directory
-│   ├── insect_inception_v3_model.keras  ← Saved model file
-│   ├── class_names.txt                  ← Corresponding class labels
-│   └── InsectTest/                      ← Test image folder
-│       ├── image_001.jpg
-│       ├── image_002.jpg
-│       └── ...
-│
-├── Insect_EfficientNetB0/               ← Model 2 directory (example)
-│   ├── insect_efficientnetb0_model.keras
-│   ├── class_names.txt
-│   └── InsectTest/
-│       ├── test1.jpg
-│       ├── test2.jpg
-│       └── ...
-│
-├── Insect_ResNet50/
-│   ├── insect_resnet50_model.keras
-│   ├── class_names.txt
-│   └── InsectTest/
-│       ├── imgA.jpg
-│       ├── imgB.jpg
-│       └── ...
-│
-└── README.md                            ← (optional, highly recommended)
-
-```
-Each subfolder contains:
-- A `.keras` TensorFlow model  
-- A `class_names.txt` file listing class labels  
-- An `Test/` folder with example test images  
-
----
-
-## ⚙️ Programmatic Usage
-
-You can load any model from this repository directly in Python using the helper functions in **`KKT_DL_Package`**.
-
-### 🧩 Example Code
-
-```python
-# -*- coding: utf-8 -*-
-"""
-Created on Sat Nov 8 14:07:38 2025
-@author: Thyagharajan
-
-Example: Using a Hugging Face model programmatically
-"""
-
-from KKT_DL_Package.utils.KKT_predictions import (
-    multiclass_prediction_return,
-    display_images_gui,
-    get_hf_model_img_labels_local_path
-)
-
-# Define image input size (must match the model's input)
-IMG_SIZE = (300, 300)
-
-# Load model, class labels, and test images from Hugging Face
-model_full_path, test_folder_path, class_names = get_hf_model_img_labels_local_path(
-    "kkthyagharajan/KKT-HF-TransferLearning-Models",
-    IMG_SIZE,
-    force_refresh=False   # Set True to force re-download
-)
-
-# Run predictions
-all_image_paths, all_predicted_labels, all_confidences = multiclass_prediction_return(
-    model_full_path, test_folder_path, class_names, IMG_SIZE
-)
-
-# Display results in a simple GUI window
-display_images_gui(all_image_paths, all_predicted_labels, IMG_SIZE)
-
-🧠 About the Helper Function
-get_hf_model_img_labels_local_path(repoid, img_size, force_refresh=False)
-
-This function:
-
-Downloads (or reuses cached) model and class label files from Hugging Face
-Loads test images from the repo
-
-Returns:
-The full local path to the model file
-The local test folder path
-The list of class names
-
-Parameters
-Argument	Description
-repoid	Hugging Face repo ID (e.g. "kkthyagharajan/KKT-HF-TransferLearning-Models")
-img_size	Tuple, e.g. (300, 300) matching model input
-force_refresh	If True, forces re-download even if cached locally
-
-Returns:
-`model_full_path, test_folder_path, class_names`
+# 🧠 KKT-HF-TransferLearning-Models  
+### Transfer Learning Models Collection for Image Classification  
+Created by **Thyagharajan K K**
+
+---
+
+## 📁 Repository Structure
+```
+
+KKT-HF-TransferLearning-Models/          ← Root directory (your HF repo root)
+│
+├── Insect_Inception_V3/                 ← Model 1 directory
+│   ├── insect_inception_v3_model.keras  ← Saved model file
+│   ├── class_names.txt                  ← Corresponding class labels
+│   └── InsectTest/                      ← Test image folder
+│       ├── image_001.jpg
+│       ├── image_002.jpg
+│       └── ...
+│
+├── Insect_MobileNetV2/               ← Model 2 directory (example)
+│   ├── insect_mobilenet_v2_model.keras
+│   ├── class_names.txt
+│   └── InsectTest/
+│       ├── test1.jpg
+│       ├── test2.jpg
+│       └── ...
+│
+├── Insect_ResNet50/
+│   ├── insect_resnet50_model.keras
+│   ├── class_names.txt
+│   └── InsectTest/
+│       ├── imgA.jpg
+│       ├── imgB.jpg
+│       └── ...
+│
+└── README.md                            ← (optional, highly recommended)
+
+```
+
+Each subfolder contains:
+- A `.keras` TensorFlow model  
+- A `class_names.txt` file listing class labels  
+- An `Test/` folder with example test images  
+
+---
+
+## ⚙️ Programmatic Usage
+
+You can load any model from this repository directly in Python using the helper functions in **`KKT_DL_Package`**.
+
+### 🧩 Example Code
+
+```python
+# -*- coding: utf-8 -*-
+"""
+Created on Sat Nov 8 14:07:38 2025
+@author: Thyagharajan
+
+Example: Using a Hugging Face model programmatically
+"""
+
+from KKT_DL_Package.utils.KKT_predictions import (
+    multiclass_prediction_return,
+    display_images_gui,
+    get_hf_model_img_labels_local_path
+)
+
+# Define image input size (must match the model's input)
+IMG_SIZE = (300, 300)
+
+# Load model, class labels, and test images from Hugging Face
+model_full_path, test_folder_path, class_names = get_hf_model_img_labels_local_path(
+    "kkthyagharajan/KKT-HF-TransferLearning-Models",
+    IMG_SIZE,
+    force_refresh=False   # Set True to force re-download
+)
+
+# Run predictions
+all_image_paths, all_predicted_labels, all_confidences = multiclass_prediction_return(
+    model_full_path, test_folder_path, class_names, IMG_SIZE
+)
+
+# Display results in a simple GUI window
+display_images_gui(all_image_paths, all_predicted_labels, IMG_SIZE)
+
+🧠 About the Helper Function
+get_hf_model_img_labels_local_path(repoid, img_size, force_refresh=False)
+
+This function:
+
+Downloads (or reuses cached) model and class label files from Hugging Face
+Loads test images from the repo
+
+Returns:
+The full local path to the model file
+The local test folder path
+The list of class names
+
+Parameters
+Argument	Description
+repoid	Hugging Face repo ID (e.g. "kkthyagharajan/KKT-HF-TransferLearning-Models")
+img_size	Tuple, e.g. (300, 300) matching model input
+force_refresh	If True, forces re-download even if cached locally
+
+Returns:
+`model_full_path, test_folder_path, class_names`