Pondet commited on
Commit
908adc7
·
verified ·
1 Parent(s): da82cc1

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +22 -16
README.md CHANGED
@@ -6,39 +6,44 @@ tags:
6
  - fintech
7
  - ocr-pre-processing
8
  - pytorch
 
9
  license: mit
10
  ---
11
 
12
  # 💳 Th-Slip-OCR-K: Precision Financial Detection
13
 
14
  ![Static Badge](https://img.shields.io/badge/Architecture-YOLOv8_Nano-blue?style=flat-square)
15
- ![Static Badge](https://img.shields.io/badge/Precision-99.5%25-green?style=flat-square)
 
16
  ![Static Badge](https://img.shields.io/badge/Device-Apple_M4_Silicon-grey?style=flat-square)
17
 
18
- **A lightweight, high-velocity object detection model engineered to extract key telemetry from Kasikorn Bank (K-Bank) transaction slips.**
19
 
20
  ---
21
 
22
  ## ⚡ Overview
23
  **Th-Slip-OCR-K** is a specialized computer vision model designed as a pre-processing engine for OCR pipelines. It isolates specific regions of interest within financial documents, eliminating noise and enabling higher accuracy for text extraction systems.
24
 
 
 
25
  * **Architecture:** Ultralytics YOLOv8 Nano (v8.3.0)
26
  * **Training Hardware:** Apple M4 Silicon (Metal Performance Shaders)
27
  * **Optimization:** Low-latency inference, suitable for edge devices and mobile deployment.
28
 
29
- ## 🎯 Detection Classes
30
- The model is trained to identify three critical zones with high confidence:
31
 
32
- | Class ID | Label | Description |
33
  | :--- | :--- | :--- |
34
- | `0` | **`amout`** | The numeric transaction value (net amount). |
35
- | `1` | **`date`** | The timestamp of the transaction. |
36
- | `2` | **`transaction`** | The type of operation (e.g., Transfer Success). |
37
-
38
- *> **Note:** Class `amout` preserves the original dataset labeling configuration.*
 
39
 
40
  ## 💻 Usage (Python)
41
- Seamlessly integrate into your workflow using the `ultralytics` library without manual downloads.
42
 
43
  ```python
44
  from ultralytics import YOLO
@@ -54,15 +59,16 @@ results[0].show()
54
  ```
55
 
56
  ## 📊 Performance Metrics
57
- Evaluated on a specific K-Bank validation set:
58
 
59
  * **mAP50:** 0.995 (99.5%)
60
- * **Precision:** 0.997
61
- * **Recall:** 1.0
62
 
63
  ## ⚠️ Scope & Limitations
64
  * **Domain Specific:** Optimized exclusively for Kasikorn Bank (Green Theme) slip layouts.
65
- * **Lighting Conditions:** Performs best on well-lit, digital receipts or clear screenshots.
66
  * **Educational Purpose:** Developed as a Proof-of-Concept for automated household accounting.
67
 
68
- Maintained by Pondet
 
 
6
  - fintech
7
  - ocr-pre-processing
8
  - pytorch
9
+ - banking
10
  license: mit
11
  ---
12
 
13
  # 💳 Th-Slip-OCR-K: Precision Financial Detection
14
 
15
  ![Static Badge](https://img.shields.io/badge/Architecture-YOLOv8_Nano-blue?style=flat-square)
16
+ ![Static Badge](https://img.shields.io/badge/Classes-6_Zones-orange?style=flat-square)
17
+ ![Static Badge](https://img.shields.io/badge/Precision-99.8%25-green?style=flat-square)
18
  ![Static Badge](https://img.shields.io/badge/Device-Apple_M4_Silicon-grey?style=flat-square)
19
 
20
+ **A lightweight, high-velocity object detection model engineered to extract full telemetry from Kasikorn Bank (K-Bank) transaction slips.**
21
 
22
  ---
23
 
24
  ## ⚡ Overview
25
  **Th-Slip-OCR-K** is a specialized computer vision model designed as a pre-processing engine for OCR pipelines. It isolates specific regions of interest within financial documents, eliminating noise and enabling higher accuracy for text extraction systems.
26
 
27
+ **🚀 V2 Update:** Enhanced detection capabilities to cover sender/receiver names and masked account numbers.
28
+
29
  * **Architecture:** Ultralytics YOLOv8 Nano (v8.3.0)
30
  * **Training Hardware:** Apple M4 Silicon (Metal Performance Shaders)
31
  * **Optimization:** Low-latency inference, suitable for edge devices and mobile deployment.
32
 
33
+ ## 🎯 Detection Classes (Updated)
34
+ The model is now trained to identify **6 critical zones** with high confidence:
35
 
36
+ | Label | Description | Context |
37
  | :--- | :--- | :--- |
38
+ | **`amount`** | Numeric transaction value | Net transfer amount (e.g., 100.00) |
39
+ | **`accnum`** | Account Number | Supports masked formats (e.g., `xxx-2-x8574-x`) |
40
+ | **`date`** | Timestamp | Date and Time of transaction |
41
+ | **`pp1`** | Sender Name | Name of the person initiating the transfer |
42
+ | **`pp2`** | Receiver Name | Name of the beneficiary |
43
+ | **`transaction`** | Transaction Type | Operation status (e.g., Transfer Success) |
44
 
45
  ## 💻 Usage (Python)
46
+ Seamlessly integrate into your workflow using the `ultralytics` library.
47
 
48
  ```python
49
  from ultralytics import YOLO
 
59
  ```
60
 
61
  ## 📊 Performance Metrics
62
+ Evaluated on the latest K-Bank validation set (103 samples):
63
 
64
  * **mAP50:** 0.995 (99.5%)
65
+ * **Precision:** 0.998 (High fidelity)
66
+ * **Recall:** 1.0 (Zero miss rate)
67
 
68
  ## ⚠️ Scope & Limitations
69
  * **Domain Specific:** Optimized exclusively for Kasikorn Bank (Green Theme) slip layouts.
70
+ * **Privacy Aware:** The model detects masked account numbers (x) accurately but cannot reveal hidden digits without external database verification.
71
  * **Educational Purpose:** Developed as a Proof-of-Concept for automated household accounting.
72
 
73
+ ---
74
+ Maintained by **Pondet**