segment-toolkit 1.0.0__tar.gz → 1.0.2__tar.gz

{segment_toolkit-1.0.0/segment_toolkit.egg-info → segment_toolkit-1.0.2}/PKG-INFO

@@ -1,8 +1,12 @@
 Metadata-Version: 2.4
 Name: segment_toolkit
-Version: 1.0.0
+Version: 1.0.2
 Summary: A Python toolkit to convert between binary segmentation masks and YOLO labels
-Author: Antigravity
+Home-page: https://github.com/zkzkGamal/mask-to-yolo-toolkit
+Author: Zakria Gamal
+Author-email: zekogml11@gmail.com
+Project-URL: Source Code, https://github.com/zkzkGamal/mask-to-yolo-toolkit
+Project-URL: Bug Tracker, https://github.com/zkzkGamal/mask-to-yolo-toolkit/issues
 Requires-Python: >=3.6
 Description-Content-Type: text/markdown
 Requires-Dist: numpy
@@ -11,55 +15,65 @@ Requires-Dist: pillow
 Requires-Dist: pandas
 Requires-Dist: matplotlib
 Dynamic: author
+Dynamic: author-email
 Dynamic: description
 Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: project-url
 Dynamic: requires-dist
 Dynamic: requires-python
 Dynamic: summary
 
-# Segment Toolkit 🛠️
+# Segment Toolkit
 
-A modern, robust, and premium Python package designed to bridge the gap between pixel-level **binary segmentation masks** and **YOLO bounding box labels**. It provides a bidirectional pipeline with exception handling, extensive logging, a command-line interface (CLI), and a Python API.
+A modern, robust, and premium Python package designed to bridge the gap between pixel-level binary segmentation masks and YOLO bounding box labels. It provides a bidirectional pipeline with exception handling, extensive logging, a command-line interface (CLI), and a Python API.
 
 ---
 
-## 📌 Features
+## Features
 
 - **Bidirectional Conversion**:
   - **Forward Pipeline**: Convert binary masks to YOLO format labels (supports standard axis-aligned or advanced minimum area rotated bounding boxes).
   - **Reverse Pipeline**: Reconstruct binary masks from YOLO labels.
-- **Automatic Dependency Installer**: Missing required packages (`numpy`, `opencv-python`, `pillow`, `pandas`, `matplotlib`) are automatically detected and installed via `pip` upon package import or script execution.
+- **Automatic Dependency Installer**: Missing required packages (numpy, opencv-python, pillow, pandas, matplotlib) are automatically detected and installed via pip upon package import or script execution.
 - **Robust Exception Handling**: Try-catch blocks wrapped around file I/O, contour finding, and resizing to prevent application crashes on corrupted or missing files.
-- **Dynamic Dataset Matching**: Read classification mappings (in **CSV** or **JSON** format) to automatically assign multi-class IDs matching standard dataset schemas (like the ISIC dataset).
-- **YOLO Dataset Splitting**: Automatically shuffles and partitions images & labels into training and testing sets with customizable split ratios, creating standard `data.yaml` configs.
+- **Dynamic Dataset Matching**: Read classification mappings (in CSV or JSON format) to automatically assign multi-class IDs matching standard dataset schemas (like the ISIC dataset).
+- **YOLO Dataset Splitting**: Automatically shuffles and partitions images and labels into training and testing sets with customizable split ratios, creating standard data.yaml configs.
 - **Overlay Visualizer**: Overlay bounding boxes and class indicators directly onto source images for annotation inspection.
-- **Dual Interface**: Use as a command-line application (`segment-toolkit`) or import as a Python library (`import segment_toolkit`).
+- **Dual Interface**: Use as a command-line application (segment-toolkit) or import as a Python library (import segment_toolkit).
 
 ---
 
-## 📂 Installation
+## Installation
 
-To install the toolkit locally in editable mode (missing dependencies will install automatically):
+### 1. Standard Installation (via PyPI)
+To install the latest stable version of the package directly from PyPI:
 
 ```bash
-pip install -e .
+pip install segment-toolkit
 ```
 
-### Manual Installation
-If you prefer to install dependencies manually before installing the toolkit:
+### 2. Local Installation (via Git Clone)
+If you want to clone the repository for local development, run:
 
 ```bash
-pip install -r requirements.txt
-pip install .
+# Clone the repository
+git clone https://github.com/zkzkGamal/mask-to-yolo-toolkit.git
+
+# Navigate into the project folder
+cd LabelFile-for-yoloModel
+
+# Install in editable mode
+pip install -e .
 ```
 
 ---
 
-## 🚀 Usage
+## Usage
 
 ### 1. Command Line Interface (CLI)
 
-The package installs a console script called `segment-toolkit`.
+The package installs a console script called segment-toolkit.
 
 #### Convert Masks to YOLO Labels
 - **Single File Conversion**:
@@ -81,8 +95,8 @@ The package installs a console script called `segment-toolkit`.
   ```
 
 - **Options**:
-  - `--rotated`: Use rotated minimum area rectangles (`cv2.minAreaRect`) instead of standard axis-aligned rectangles.
-  - `--resize WIDTH HEIGHT`: Set target size for image and mask resizing (default: `640 640`).
+  - `--rotated`: Use rotated minimum area rectangles (cv2.minAreaRect) instead of standard axis-aligned rectangles.
+  - `--resize WIDTH HEIGHT`: Set target size for image and mask resizing (default: 640 640).
 
 #### Convert YOLO Labels to Masks
 - **Single File Conversion**:
@@ -109,7 +123,7 @@ segment-toolkit visualize \
 ```
 
 #### Split Dataset
-Organize folders into YOLO-compliant structure (`dataset/train` and `dataset/test` splits) and output `data.yaml`:
+Organize folders into YOLO-compliant structure (dataset/train and dataset/test splits) and output data.yaml:
 ```bash
 segment-toolkit split \
   --images images/ \
@@ -121,13 +135,32 @@ segment-toolkit split \
 
 ---
 
-### 2. Ground Truth Formats
+## Validation and Demonstration Outputs
+
+To verify the library, we run automated validation on sample datasets. All validation output files (YOLO coordinates, reconstructed masks, and drawing overlays) are stored in the [validate_data/](file:///home/aloha-zkaria/LabelFile-for-yoloModel/validate_data) folder.
+
+### Validation Overlays
+
+Here are the bounding box overlays generated by the toolkit visualizer:
+
+#### ISIC Melanoma Skin Lesion Validation
+![ISIC Validation Overlay](file:///home/aloha-zkaria/LabelFile-for-yoloModel/validate_data/scratch_val_isic_vis.png)
+
+#### Plant Leaf Disease Validation
+![Plant Leaf Validation Overlay](file:///home/aloha-zkaria/LabelFile-for-yoloModel/validate_data/scratch_val_plant_vis.png)
+
+### Video Demonstration
+A video demonstrating installation, CLI commands, and programming API pipelines can be placed in the [demo/](file:///home/aloha-zkaria/LabelFile-for-yoloModel/demo) directory.
+
+---
+
+## Ground Truth Formats
 
-The `--ground-truth` parameter in batch conversion supports both CSV and JSON formats.
+The --ground-truth parameter in batch conversion supports both CSV and JSON formats.
 
 #### CSV Format
-Assumes the first column contains the image identifier/filename, and the subsequent columns represent binary indicator classes (where `1` indicates class presence).
-Example `GroundTruth.csv`:
+Assumes the first column contains the image identifier/filename, and the subsequent columns represent binary indicator classes (where 1 indicates class presence).
+Example GroundTruth.csv:
 ```csv
 image,MEL,NV,BCC,AKIEC,BKL,DF,VASC
 ISIC_0024306,0,1,0,0,0,0,0
@@ -164,11 +197,11 @@ Supports three distinct schemas:
    ]
    ```
 
-*Note: Class name strings (like `"MEL"`, `"NV"`) are automatically mapped to standard ISIC IDs (`AKIEC=0, BCC=1, BKL=2, DF=3, MEL=4, NV=5, VASC=6`). Custom column names default to index-based IDs.*
+*Note: Class name strings (like "MEL", "NV") are automatically mapped to standard ISIC IDs (AKIEC=0, BCC=1, BKL=2, DF=3, MEL=4, NV=5, VASC=6). Custom column names default to index-based IDs.*
 
 ---
 
-### 3. Python API
+## Python API
 
 Import classes directly into your code to programmatically build custom pipelines:
 
@@ -195,23 +228,23 @@ yolo_conv.convert_dataset(
 
 ---
 
-## 🧠 Technical Details
+## Technical Details
 
 ### Coordinate Conversion Math
 
 #### Bounding Box Center Calculation (Pixel Space)
-For standard bounding boxes, the pixel coordinates from `boundingRect` are $(x_{min}, y_{min}, w_{pixel}, h_{pixel})$.
+For standard bounding boxes, the pixel coordinates from boundingRect are (xmin, ymin, w_pixel, h_pixel).
 $$\text{Center } X \quad x_{center} = x_{min} + \frac{w_{pixel}}{2.0}$$
 $$\text{Center } Y \quad y_{center} = y_{min} + \frac{h_{pixel}}{2.0}$$
 
 #### Coordinate Normalization (YOLO Format)
-All coordinates are normalized to the range $[0.0, 1.0]$:
+All coordinates are normalized to the range [0.0, 1.0]:
 $$x_{norm} = \frac{x_{center}}{img\_width}, \quad y_{norm} = \frac{y_{center}}{img\_height}$$
 $$w_{norm} = \frac{w_{pixel}}{img\_width}, \quad h_{norm} = \frac{h_{pixel}}{img\_height}$$
 
 ---
 
-## 🧑‍💻 Author
+## Author
 **Zakria Gamal**
-- Computer Vision & AI Engineer
-- 🧠 LinkedIn: [Zakria Gamal](https://www.linkedin.com/in/zkaria-gamal-82b486267/)
+- Computer Vision and AI Engineer
+- LinkedIn: [Zakria Gamal](https://www.linkedin.com/in/zkaria-gamal-82b486267/)

segment_toolkit-1.0.0/PKG-INFO → segment_toolkit-1.0.2/README.md

@@ -1,65 +1,53 @@
-Metadata-Version: 2.4
-Name: segment_toolkit
-Version: 1.0.0
-Summary: A Python toolkit to convert between binary segmentation masks and YOLO labels
-Author: Antigravity
-Requires-Python: >=3.6
-Description-Content-Type: text/markdown
-Requires-Dist: numpy
-Requires-Dist: opencv-python
-Requires-Dist: pillow
-Requires-Dist: pandas
-Requires-Dist: matplotlib
-Dynamic: author
-Dynamic: description
-Dynamic: description-content-type
-Dynamic: requires-dist
-Dynamic: requires-python
-Dynamic: summary
-
-# Segment Toolkit 🛠️
-
-A modern, robust, and premium Python package designed to bridge the gap between pixel-level **binary segmentation masks** and **YOLO bounding box labels**. It provides a bidirectional pipeline with exception handling, extensive logging, a command-line interface (CLI), and a Python API.
+# Segment Toolkit
+
+A modern, robust, and premium Python package designed to bridge the gap between pixel-level binary segmentation masks and YOLO bounding box labels. It provides a bidirectional pipeline with exception handling, extensive logging, a command-line interface (CLI), and a Python API.
 
 ---
 
-## 📌 Features
+## Features
 
 - **Bidirectional Conversion**:
   - **Forward Pipeline**: Convert binary masks to YOLO format labels (supports standard axis-aligned or advanced minimum area rotated bounding boxes).
   - **Reverse Pipeline**: Reconstruct binary masks from YOLO labels.
-- **Automatic Dependency Installer**: Missing required packages (`numpy`, `opencv-python`, `pillow`, `pandas`, `matplotlib`) are automatically detected and installed via `pip` upon package import or script execution.
+- **Automatic Dependency Installer**: Missing required packages (numpy, opencv-python, pillow, pandas, matplotlib) are automatically detected and installed via pip upon package import or script execution.
 - **Robust Exception Handling**: Try-catch blocks wrapped around file I/O, contour finding, and resizing to prevent application crashes on corrupted or missing files.
-- **Dynamic Dataset Matching**: Read classification mappings (in **CSV** or **JSON** format) to automatically assign multi-class IDs matching standard dataset schemas (like the ISIC dataset).
-- **YOLO Dataset Splitting**: Automatically shuffles and partitions images & labels into training and testing sets with customizable split ratios, creating standard `data.yaml` configs.
+- **Dynamic Dataset Matching**: Read classification mappings (in CSV or JSON format) to automatically assign multi-class IDs matching standard dataset schemas (like the ISIC dataset).
+- **YOLO Dataset Splitting**: Automatically shuffles and partitions images and labels into training and testing sets with customizable split ratios, creating standard data.yaml configs.
 - **Overlay Visualizer**: Overlay bounding boxes and class indicators directly onto source images for annotation inspection.
-- **Dual Interface**: Use as a command-line application (`segment-toolkit`) or import as a Python library (`import segment_toolkit`).
+- **Dual Interface**: Use as a command-line application (segment-toolkit) or import as a Python library (import segment_toolkit).
 
 ---
 
-## 📂 Installation
+## Installation
 
-To install the toolkit locally in editable mode (missing dependencies will install automatically):
+### 1. Standard Installation (via PyPI)
+To install the latest stable version of the package directly from PyPI:
 
 ```bash
-pip install -e .
+pip install segment-toolkit
 ```
 
-### Manual Installation
-If you prefer to install dependencies manually before installing the toolkit:
+### 2. Local Installation (via Git Clone)
+If you want to clone the repository for local development, run:
 
 ```bash
-pip install -r requirements.txt
-pip install .
+# Clone the repository
+git clone https://github.com/zkzkGamal/mask-to-yolo-toolkit.git
+
+# Navigate into the project folder
+cd LabelFile-for-yoloModel
+
+# Install in editable mode
+pip install -e .
 ```
 
 ---
 
-## 🚀 Usage
+## Usage
 
 ### 1. Command Line Interface (CLI)
 
-The package installs a console script called `segment-toolkit`.
+The package installs a console script called segment-toolkit.
 
 #### Convert Masks to YOLO Labels
 - **Single File Conversion**:
@@ -81,8 +69,8 @@ The package installs a console script called `segment-toolkit`.
   ```
 
 - **Options**:
-  - `--rotated`: Use rotated minimum area rectangles (`cv2.minAreaRect`) instead of standard axis-aligned rectangles.
-  - `--resize WIDTH HEIGHT`: Set target size for image and mask resizing (default: `640 640`).
+  - `--rotated`: Use rotated minimum area rectangles (cv2.minAreaRect) instead of standard axis-aligned rectangles.
+  - `--resize WIDTH HEIGHT`: Set target size for image and mask resizing (default: 640 640).
 
 #### Convert YOLO Labels to Masks
 - **Single File Conversion**:
@@ -109,7 +97,7 @@ segment-toolkit visualize \
 ```
 
 #### Split Dataset
-Organize folders into YOLO-compliant structure (`dataset/train` and `dataset/test` splits) and output `data.yaml`:
+Organize folders into YOLO-compliant structure (dataset/train and dataset/test splits) and output data.yaml:
 ```bash
 segment-toolkit split \
   --images images/ \
@@ -121,13 +109,32 @@ segment-toolkit split \
 
 ---
 
-### 2. Ground Truth Formats
+## Validation and Demonstration Outputs
+
+To verify the library, we run automated validation on sample datasets. All validation output files (YOLO coordinates, reconstructed masks, and drawing overlays) are stored in the [validate_data/](file:///home/aloha-zkaria/LabelFile-for-yoloModel/validate_data) folder.
+
+### Validation Overlays
+
+Here are the bounding box overlays generated by the toolkit visualizer:
+
+#### ISIC Melanoma Skin Lesion Validation
+![ISIC Validation Overlay](file:///home/aloha-zkaria/LabelFile-for-yoloModel/validate_data/scratch_val_isic_vis.png)
+
+#### Plant Leaf Disease Validation
+![Plant Leaf Validation Overlay](file:///home/aloha-zkaria/LabelFile-for-yoloModel/validate_data/scratch_val_plant_vis.png)
+
+### Video Demonstration
+A video demonstrating installation, CLI commands, and programming API pipelines can be placed in the [demo/](file:///home/aloha-zkaria/LabelFile-for-yoloModel/demo) directory.
+
+---
+
+## Ground Truth Formats
 
-The `--ground-truth` parameter in batch conversion supports both CSV and JSON formats.
+The --ground-truth parameter in batch conversion supports both CSV and JSON formats.
 
 #### CSV Format
-Assumes the first column contains the image identifier/filename, and the subsequent columns represent binary indicator classes (where `1` indicates class presence).
-Example `GroundTruth.csv`:
+Assumes the first column contains the image identifier/filename, and the subsequent columns represent binary indicator classes (where 1 indicates class presence).
+Example GroundTruth.csv:
 ```csv
 image,MEL,NV,BCC,AKIEC,BKL,DF,VASC
 ISIC_0024306,0,1,0,0,0,0,0
@@ -164,11 +171,11 @@ Supports three distinct schemas:
    ]
    ```
 
-*Note: Class name strings (like `"MEL"`, `"NV"`) are automatically mapped to standard ISIC IDs (`AKIEC=0, BCC=1, BKL=2, DF=3, MEL=4, NV=5, VASC=6`). Custom column names default to index-based IDs.*
+*Note: Class name strings (like "MEL", "NV") are automatically mapped to standard ISIC IDs (AKIEC=0, BCC=1, BKL=2, DF=3, MEL=4, NV=5, VASC=6). Custom column names default to index-based IDs.*
 
 ---
 
-### 3. Python API
+## Python API
 
 Import classes directly into your code to programmatically build custom pipelines:
 
@@ -195,23 +202,23 @@ yolo_conv.convert_dataset(
 
 ---
 
-## 🧠 Technical Details
+## Technical Details
 
 ### Coordinate Conversion Math
 
 #### Bounding Box Center Calculation (Pixel Space)
-For standard bounding boxes, the pixel coordinates from `boundingRect` are $(x_{min}, y_{min}, w_{pixel}, h_{pixel})$.
+For standard bounding boxes, the pixel coordinates from boundingRect are (xmin, ymin, w_pixel, h_pixel).
 $$\text{Center } X \quad x_{center} = x_{min} + \frac{w_{pixel}}{2.0}$$
 $$\text{Center } Y \quad y_{center} = y_{min} + \frac{h_{pixel}}{2.0}$$
 
 #### Coordinate Normalization (YOLO Format)
-All coordinates are normalized to the range $[0.0, 1.0]$:
+All coordinates are normalized to the range [0.0, 1.0]:
 $$x_{norm} = \frac{x_{center}}{img\_width}, \quad y_{norm} = \frac{y_{center}}{img\_height}$$
 $$w_{norm} = \frac{w_{pixel}}{img\_width}, \quad h_{norm} = \frac{h_{pixel}}{img\_height}$$
 
 ---
 
-## 🧑‍💻 Author
+## Author
 **Zakria Gamal**
-- Computer Vision & AI Engineer
-- 🧠 LinkedIn: [Zakria Gamal](https://www.linkedin.com/in/zkaria-gamal-82b486267/)
+- Computer Vision and AI Engineer
+- LinkedIn: [Zakria Gamal](https://www.linkedin.com/in/zkaria-gamal-82b486267/)

{segment_toolkit-1.0.0 → segment_toolkit-1.0.2}/segment_toolkit/__init__.py

@@ -2,7 +2,7 @@
 Segment Toolkit: A library and CLI tool for converting binary segmentation masks to YOLO labels and vice versa.
 """
 
-__version__ = "1.0.0"
+__version__ = "1.0.1"
 
 import sys
 import subprocess

segment_toolkit-1.0.2/segment_toolkit/__main__.py

@@ -0,0 +1,17 @@
+"""
+Main execution entry point for segment_toolkit.
+Enables running the package directly via `python3 -m segment_toolkit` or `python3 segment_toolkit`.
+"""
+
+import sys
+import os
+
+# Add the parent folder of segment_toolkit to sys.path to resolve absolute imports
+parent_dir = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
+if parent_dir not in sys.path:
+    sys.path.insert(0, parent_dir)
+
+from segment_toolkit.cli import main
+
+if __name__ == "__main__":
+    sys.exit(main())

segment_toolkit-1.0.0/README.md → segment_toolkit-1.0.2/segment_toolkit.egg-info/PKG-INFO

@@ -1,46 +1,79 @@
-# Segment Toolkit 🛠️
-
-A modern, robust, and premium Python package designed to bridge the gap between pixel-level **binary segmentation masks** and **YOLO bounding box labels**. It provides a bidirectional pipeline with exception handling, extensive logging, a command-line interface (CLI), and a Python API.
+Metadata-Version: 2.4
+Name: segment_toolkit
+Version: 1.0.2
+Summary: A Python toolkit to convert between binary segmentation masks and YOLO labels
+Home-page: https://github.com/zkzkGamal/mask-to-yolo-toolkit
+Author: Zakria Gamal
+Author-email: zekogml11@gmail.com
+Project-URL: Source Code, https://github.com/zkzkGamal/mask-to-yolo-toolkit
+Project-URL: Bug Tracker, https://github.com/zkzkGamal/mask-to-yolo-toolkit/issues
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+Requires-Dist: numpy
+Requires-Dist: opencv-python
+Requires-Dist: pillow
+Requires-Dist: pandas
+Requires-Dist: matplotlib
+Dynamic: author
+Dynamic: author-email
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: project-url
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# Segment Toolkit
+
+A modern, robust, and premium Python package designed to bridge the gap between pixel-level binary segmentation masks and YOLO bounding box labels. It provides a bidirectional pipeline with exception handling, extensive logging, a command-line interface (CLI), and a Python API.
 
 ---
 
-## 📌 Features
+## Features
 
 - **Bidirectional Conversion**:
   - **Forward Pipeline**: Convert binary masks to YOLO format labels (supports standard axis-aligned or advanced minimum area rotated bounding boxes).
   - **Reverse Pipeline**: Reconstruct binary masks from YOLO labels.
-- **Automatic Dependency Installer**: Missing required packages (`numpy`, `opencv-python`, `pillow`, `pandas`, `matplotlib`) are automatically detected and installed via `pip` upon package import or script execution.
+- **Automatic Dependency Installer**: Missing required packages (numpy, opencv-python, pillow, pandas, matplotlib) are automatically detected and installed via pip upon package import or script execution.
 - **Robust Exception Handling**: Try-catch blocks wrapped around file I/O, contour finding, and resizing to prevent application crashes on corrupted or missing files.
-- **Dynamic Dataset Matching**: Read classification mappings (in **CSV** or **JSON** format) to automatically assign multi-class IDs matching standard dataset schemas (like the ISIC dataset).
-- **YOLO Dataset Splitting**: Automatically shuffles and partitions images & labels into training and testing sets with customizable split ratios, creating standard `data.yaml` configs.
+- **Dynamic Dataset Matching**: Read classification mappings (in CSV or JSON format) to automatically assign multi-class IDs matching standard dataset schemas (like the ISIC dataset).
+- **YOLO Dataset Splitting**: Automatically shuffles and partitions images and labels into training and testing sets with customizable split ratios, creating standard data.yaml configs.
 - **Overlay Visualizer**: Overlay bounding boxes and class indicators directly onto source images for annotation inspection.
-- **Dual Interface**: Use as a command-line application (`segment-toolkit`) or import as a Python library (`import segment_toolkit`).
+- **Dual Interface**: Use as a command-line application (segment-toolkit) or import as a Python library (import segment_toolkit).
 
 ---
 
-## 📂 Installation
+## Installation
 
-To install the toolkit locally in editable mode (missing dependencies will install automatically):
+### 1. Standard Installation (via PyPI)
+To install the latest stable version of the package directly from PyPI:
 
 ```bash
-pip install -e .
+pip install segment-toolkit
 ```
 
-### Manual Installation
-If you prefer to install dependencies manually before installing the toolkit:
+### 2. Local Installation (via Git Clone)
+If you want to clone the repository for local development, run:
 
 ```bash
-pip install -r requirements.txt
-pip install .
+# Clone the repository
+git clone https://github.com/zkzkGamal/mask-to-yolo-toolkit.git
+
+# Navigate into the project folder
+cd LabelFile-for-yoloModel
+
+# Install in editable mode
+pip install -e .
 ```
 
 ---
 
-## 🚀 Usage
+## Usage
 
 ### 1. Command Line Interface (CLI)
 
-The package installs a console script called `segment-toolkit`.
+The package installs a console script called segment-toolkit.
 
 #### Convert Masks to YOLO Labels
 - **Single File Conversion**:
@@ -62,8 +95,8 @@ The package installs a console script called `segment-toolkit`.
   ```
 
 - **Options**:
-  - `--rotated`: Use rotated minimum area rectangles (`cv2.minAreaRect`) instead of standard axis-aligned rectangles.
-  - `--resize WIDTH HEIGHT`: Set target size for image and mask resizing (default: `640 640`).
+  - `--rotated`: Use rotated minimum area rectangles (cv2.minAreaRect) instead of standard axis-aligned rectangles.
+  - `--resize WIDTH HEIGHT`: Set target size for image and mask resizing (default: 640 640).
 
 #### Convert YOLO Labels to Masks
 - **Single File Conversion**:
@@ -90,7 +123,7 @@ segment-toolkit visualize \
 ```
 
 #### Split Dataset
-Organize folders into YOLO-compliant structure (`dataset/train` and `dataset/test` splits) and output `data.yaml`:
+Organize folders into YOLO-compliant structure (dataset/train and dataset/test splits) and output data.yaml:
 ```bash
 segment-toolkit split \
   --images images/ \
@@ -102,13 +135,32 @@ segment-toolkit split \
 
 ---
 
-### 2. Ground Truth Formats
+## Validation and Demonstration Outputs
+
+To verify the library, we run automated validation on sample datasets. All validation output files (YOLO coordinates, reconstructed masks, and drawing overlays) are stored in the [validate_data/](file:///home/aloha-zkaria/LabelFile-for-yoloModel/validate_data) folder.
+
+### Validation Overlays
+
+Here are the bounding box overlays generated by the toolkit visualizer:
+
+#### ISIC Melanoma Skin Lesion Validation
+![ISIC Validation Overlay](file:///home/aloha-zkaria/LabelFile-for-yoloModel/validate_data/scratch_val_isic_vis.png)
+
+#### Plant Leaf Disease Validation
+![Plant Leaf Validation Overlay](file:///home/aloha-zkaria/LabelFile-for-yoloModel/validate_data/scratch_val_plant_vis.png)
+
+### Video Demonstration
+A video demonstrating installation, CLI commands, and programming API pipelines can be placed in the [demo/](file:///home/aloha-zkaria/LabelFile-for-yoloModel/demo) directory.
+
+---
+
+## Ground Truth Formats
 
-The `--ground-truth` parameter in batch conversion supports both CSV and JSON formats.
+The --ground-truth parameter in batch conversion supports both CSV and JSON formats.
 
 #### CSV Format
-Assumes the first column contains the image identifier/filename, and the subsequent columns represent binary indicator classes (where `1` indicates class presence).
-Example `GroundTruth.csv`:
+Assumes the first column contains the image identifier/filename, and the subsequent columns represent binary indicator classes (where 1 indicates class presence).
+Example GroundTruth.csv:
 ```csv
 image,MEL,NV,BCC,AKIEC,BKL,DF,VASC
 ISIC_0024306,0,1,0,0,0,0,0
@@ -145,11 +197,11 @@ Supports three distinct schemas:
    ]
    ```
 
-*Note: Class name strings (like `"MEL"`, `"NV"`) are automatically mapped to standard ISIC IDs (`AKIEC=0, BCC=1, BKL=2, DF=3, MEL=4, NV=5, VASC=6`). Custom column names default to index-based IDs.*
+*Note: Class name strings (like "MEL", "NV") are automatically mapped to standard ISIC IDs (AKIEC=0, BCC=1, BKL=2, DF=3, MEL=4, NV=5, VASC=6). Custom column names default to index-based IDs.*
 
 ---
 
-### 3. Python API
+## Python API
 
 Import classes directly into your code to programmatically build custom pipelines:
 
@@ -176,23 +228,23 @@ yolo_conv.convert_dataset(
 
 ---
 
-## 🧠 Technical Details
+## Technical Details
 
 ### Coordinate Conversion Math
 
 #### Bounding Box Center Calculation (Pixel Space)
-For standard bounding boxes, the pixel coordinates from `boundingRect` are $(x_{min}, y_{min}, w_{pixel}, h_{pixel})$.
+For standard bounding boxes, the pixel coordinates from boundingRect are (xmin, ymin, w_pixel, h_pixel).
 $$\text{Center } X \quad x_{center} = x_{min} + \frac{w_{pixel}}{2.0}$$
 $$\text{Center } Y \quad y_{center} = y_{min} + \frac{h_{pixel}}{2.0}$$
 
 #### Coordinate Normalization (YOLO Format)
-All coordinates are normalized to the range $[0.0, 1.0]$:
+All coordinates are normalized to the range [0.0, 1.0]:
 $$x_{norm} = \frac{x_{center}}{img\_width}, \quad y_{norm} = \frac{y_{center}}{img\_height}$$
 $$w_{norm} = \frac{w_{pixel}}{img\_width}, \quad h_{norm} = \frac{h_{pixel}}{img\_height}$$
 
 ---
 
-## 🧑‍💻 Author
+## Author
 **Zakria Gamal**
-- Computer Vision & AI Engineer
-- 🧠 LinkedIn: [Zakria Gamal](https://www.linkedin.com/in/zkaria-gamal-82b486267/)
+- Computer Vision and AI Engineer
+- LinkedIn: [Zakria Gamal](https://www.linkedin.com/in/zkaria-gamal-82b486267/)

{segment_toolkit-1.0.0 → segment_toolkit-1.0.2}/segment_toolkit.egg-info/SOURCES.txt

@@ -1,6 +1,7 @@
 README.md
 setup.py
 segment_toolkit/__init__.py
+segment_toolkit/__main__.py
 segment_toolkit/cli.py
 segment_toolkit/helpers.py
 segment_toolkit/source.py

{segment_toolkit-1.0.0 → segment_toolkit-1.0.2}/setup.py

@@ -10,11 +10,17 @@ except FileNotFoundError:
 
 setup(
     name="segment_toolkit",
-    version="1.0.0",
+    version="1.0.2",
     description="A Python toolkit to convert between binary segmentation masks and YOLO labels",
     long_description=long_description,
     long_description_content_type="text/markdown",
-    author="Antigravity",
+    author="Zakria Gamal",
+    author_email="zekogml11@gmail.com",
+    url="https://github.com/zkzkGamal/mask-to-yolo-toolkit",
+    project_urls={
+        "Source Code": "https://github.com/zkzkGamal/mask-to-yolo-toolkit",
+        "Bug Tracker": "https://github.com/zkzkGamal/mask-to-yolo-toolkit/issues",
+    },
     packages=find_packages(),
     install_requires=[
         "numpy",