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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,12 +1,12 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: segment_toolkit
3
- Version: 1.0.1
3
+ Version: 1.0.2
4
4
  Summary: A Python toolkit to convert between binary segmentation masks and YOLO labels
5
- Home-page: https://github.com/zkzkGamal/LabelFile-for-yoloModel
5
+ Home-page: https://github.com/zkzkGamal/mask-to-yolo-toolkit
6
6
  Author: Zakria Gamal
7
7
  Author-email: zekogml11@gmail.com
8
- Project-URL: Source Code, https://github.com/zkzkGamal/LabelFile-for-yoloModel
9
- Project-URL: Bug Tracker, https://github.com/zkzkGamal/LabelFile-for-yoloModel/issues
8
+ Project-URL: Source Code, https://github.com/zkzkGamal/mask-to-yolo-toolkit
9
+ Project-URL: Bug Tracker, https://github.com/zkzkGamal/mask-to-yolo-toolkit/issues
10
10
  Requires-Python: >=3.6
11
11
  Description-Content-Type: text/markdown
12
12
  Requires-Dist: numpy
@@ -46,18 +46,25 @@ A modern, robust, and premium Python package designed to bridge the gap between
46
46
 
47
47
  ## Installation
48
48
 
49
- To install the toolkit locally in editable mode (missing dependencies will install automatically):
49
+ ### 1. Standard Installation (via PyPI)
50
+ To install the latest stable version of the package directly from PyPI:
50
51
 
51
52
  ```bash
52
- pip install -e .
53
+ pip install segment-toolkit
53
54
  ```
54
55
 
55
- ### Manual Installation
56
- If you prefer to install dependencies manually before installing the toolkit:
56
+ ### 2. Local Installation (via Git Clone)
57
+ If you want to clone the repository for local development, run:
57
58
 
58
59
  ```bash
59
- pip install -r requirements.txt
60
- pip install .
60
+ # Clone the repository
61
+ git clone https://github.com/zkzkGamal/mask-to-yolo-toolkit.git
62
+
63
+ # Navigate into the project folder
64
+ cd LabelFile-for-yoloModel
65
+
66
+ # Install in editable mode
67
+ pip install -e .
61
68
  ```
62
69
 
63
70
  ---
@@ -128,6 +135,25 @@ segment-toolkit split \
128
135
 
129
136
  ---
130
137
 
138
+ ## Validation and Demonstration Outputs
139
+
140
+ 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.
141
+
142
+ ### Validation Overlays
143
+
144
+ Here are the bounding box overlays generated by the toolkit visualizer:
145
+
146
+ #### ISIC Melanoma Skin Lesion Validation
147
+ ![ISIC Validation Overlay](file:///home/aloha-zkaria/LabelFile-for-yoloModel/validate_data/scratch_val_isic_vis.png)
148
+
149
+ #### Plant Leaf Disease Validation
150
+ ![Plant Leaf Validation Overlay](file:///home/aloha-zkaria/LabelFile-for-yoloModel/validate_data/scratch_val_plant_vis.png)
151
+
152
+ ### Video Demonstration
153
+ 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.
154
+
155
+ ---
156
+
131
157
  ## Ground Truth Formats
132
158
 
133
159
  The --ground-truth parameter in batch conversion supports both CSV and JSON formats.
@@ -1,29 +1,3 @@
1
- Metadata-Version: 2.4
2
- Name: segment_toolkit
3
- Version: 1.0.1
4
- Summary: A Python toolkit to convert between binary segmentation masks and YOLO labels
5
- Home-page: https://github.com/zkzkGamal/LabelFile-for-yoloModel
6
- Author: Zakria Gamal
7
- Author-email: zekogml11@gmail.com
8
- Project-URL: Source Code, https://github.com/zkzkGamal/LabelFile-for-yoloModel
9
- Project-URL: Bug Tracker, https://github.com/zkzkGamal/LabelFile-for-yoloModel/issues
10
- Requires-Python: >=3.6
11
- Description-Content-Type: text/markdown
12
- Requires-Dist: numpy
13
- Requires-Dist: opencv-python
14
- Requires-Dist: pillow
15
- Requires-Dist: pandas
16
- Requires-Dist: matplotlib
17
- Dynamic: author
18
- Dynamic: author-email
19
- Dynamic: description
20
- Dynamic: description-content-type
21
- Dynamic: home-page
22
- Dynamic: project-url
23
- Dynamic: requires-dist
24
- Dynamic: requires-python
25
- Dynamic: summary
26
-
27
1
  # Segment Toolkit
28
2
 
29
3
  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.
@@ -46,18 +20,25 @@ A modern, robust, and premium Python package designed to bridge the gap between
46
20
 
47
21
  ## Installation
48
22
 
49
- To install the toolkit locally in editable mode (missing dependencies will install automatically):
23
+ ### 1. Standard Installation (via PyPI)
24
+ To install the latest stable version of the package directly from PyPI:
50
25
 
51
26
  ```bash
52
- pip install -e .
27
+ pip install segment-toolkit
53
28
  ```
54
29
 
55
- ### Manual Installation
56
- If you prefer to install dependencies manually before installing the toolkit:
30
+ ### 2. Local Installation (via Git Clone)
31
+ If you want to clone the repository for local development, run:
57
32
 
58
33
  ```bash
59
- pip install -r requirements.txt
60
- pip install .
34
+ # Clone the repository
35
+ git clone https://github.com/zkzkGamal/mask-to-yolo-toolkit.git
36
+
37
+ # Navigate into the project folder
38
+ cd LabelFile-for-yoloModel
39
+
40
+ # Install in editable mode
41
+ pip install -e .
61
42
  ```
62
43
 
63
44
  ---
@@ -128,6 +109,25 @@ segment-toolkit split \
128
109
 
129
110
  ---
130
111
 
112
+ ## Validation and Demonstration Outputs
113
+
114
+ 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.
115
+
116
+ ### Validation Overlays
117
+
118
+ Here are the bounding box overlays generated by the toolkit visualizer:
119
+
120
+ #### ISIC Melanoma Skin Lesion Validation
121
+ ![ISIC Validation Overlay](file:///home/aloha-zkaria/LabelFile-for-yoloModel/validate_data/scratch_val_isic_vis.png)
122
+
123
+ #### Plant Leaf Disease Validation
124
+ ![Plant Leaf Validation Overlay](file:///home/aloha-zkaria/LabelFile-for-yoloModel/validate_data/scratch_val_plant_vis.png)
125
+
126
+ ### Video Demonstration
127
+ 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.
128
+
129
+ ---
130
+
131
131
  ## Ground Truth Formats
132
132
 
133
133
  The --ground-truth parameter in batch conversion supports both CSV and JSON formats.
@@ -1,3 +1,29 @@
1
+ Metadata-Version: 2.4
2
+ Name: segment_toolkit
3
+ Version: 1.0.2
4
+ Summary: A Python toolkit to convert between binary segmentation masks and YOLO labels
5
+ Home-page: https://github.com/zkzkGamal/mask-to-yolo-toolkit
6
+ Author: Zakria Gamal
7
+ Author-email: zekogml11@gmail.com
8
+ Project-URL: Source Code, https://github.com/zkzkGamal/mask-to-yolo-toolkit
9
+ Project-URL: Bug Tracker, https://github.com/zkzkGamal/mask-to-yolo-toolkit/issues
10
+ Requires-Python: >=3.6
11
+ Description-Content-Type: text/markdown
12
+ Requires-Dist: numpy
13
+ Requires-Dist: opencv-python
14
+ Requires-Dist: pillow
15
+ Requires-Dist: pandas
16
+ Requires-Dist: matplotlib
17
+ Dynamic: author
18
+ Dynamic: author-email
19
+ Dynamic: description
20
+ Dynamic: description-content-type
21
+ Dynamic: home-page
22
+ Dynamic: project-url
23
+ Dynamic: requires-dist
24
+ Dynamic: requires-python
25
+ Dynamic: summary
26
+
1
27
  # Segment Toolkit
2
28
 
3
29
  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.
@@ -20,18 +46,25 @@ A modern, robust, and premium Python package designed to bridge the gap between
20
46
 
21
47
  ## Installation
22
48
 
23
- To install the toolkit locally in editable mode (missing dependencies will install automatically):
49
+ ### 1. Standard Installation (via PyPI)
50
+ To install the latest stable version of the package directly from PyPI:
24
51
 
25
52
  ```bash
26
- pip install -e .
53
+ pip install segment-toolkit
27
54
  ```
28
55
 
29
- ### Manual Installation
30
- If you prefer to install dependencies manually before installing the toolkit:
56
+ ### 2. Local Installation (via Git Clone)
57
+ If you want to clone the repository for local development, run:
31
58
 
32
59
  ```bash
33
- pip install -r requirements.txt
34
- pip install .
60
+ # Clone the repository
61
+ git clone https://github.com/zkzkGamal/mask-to-yolo-toolkit.git
62
+
63
+ # Navigate into the project folder
64
+ cd LabelFile-for-yoloModel
65
+
66
+ # Install in editable mode
67
+ pip install -e .
35
68
  ```
36
69
 
37
70
  ---
@@ -102,6 +135,25 @@ segment-toolkit split \
102
135
 
103
136
  ---
104
137
 
138
+ ## Validation and Demonstration Outputs
139
+
140
+ 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.
141
+
142
+ ### Validation Overlays
143
+
144
+ Here are the bounding box overlays generated by the toolkit visualizer:
145
+
146
+ #### ISIC Melanoma Skin Lesion Validation
147
+ ![ISIC Validation Overlay](file:///home/aloha-zkaria/LabelFile-for-yoloModel/validate_data/scratch_val_isic_vis.png)
148
+
149
+ #### Plant Leaf Disease Validation
150
+ ![Plant Leaf Validation Overlay](file:///home/aloha-zkaria/LabelFile-for-yoloModel/validate_data/scratch_val_plant_vis.png)
151
+
152
+ ### Video Demonstration
153
+ 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.
154
+
155
+ ---
156
+
105
157
  ## Ground Truth Formats
106
158
 
107
159
  The --ground-truth parameter in batch conversion supports both CSV and JSON formats.
@@ -10,16 +10,16 @@ except FileNotFoundError:
10
10
 
11
11
  setup(
12
12
  name="segment_toolkit",
13
- version="1.0.1",
13
+ version="1.0.2",
14
14
  description="A Python toolkit to convert between binary segmentation masks and YOLO labels",
15
15
  long_description=long_description,
16
16
  long_description_content_type="text/markdown",
17
17
  author="Zakria Gamal",
18
18
  author_email="zekogml11@gmail.com",
19
- url="https://github.com/zkzkGamal/LabelFile-for-yoloModel",
19
+ url="https://github.com/zkzkGamal/mask-to-yolo-toolkit",
20
20
  project_urls={
21
- "Source Code": "https://github.com/zkzkGamal/LabelFile-for-yoloModel",
22
- "Bug Tracker": "https://github.com/zkzkGamal/LabelFile-for-yoloModel/issues",
21
+ "Source Code": "https://github.com/zkzkGamal/mask-to-yolo-toolkit",
22
+ "Bug Tracker": "https://github.com/zkzkGamal/mask-to-yolo-toolkit/issues",
23
23
  },
24
24
  packages=find_packages(),
25
25
  install_requires=[