lazylabel-gui 1.3.6__py3-none-any.whl → 1.3.7__py3-none-any.whl

lazylabel/ui/main_window.py

@@ -1582,6 +1582,19 @@ class MainWindow(QMainWindow):
         # Reset AI mode state
         self.ai_click_start_pos = None
 
+        # Reset all link states to linked when navigating to new images
+        config = self._get_multi_view_config()
+        num_viewers = config["num_viewers"]
+        self.multi_view_linked = [True] * num_viewers
+
+        # Reset unlink button appearances to default linked state
+        if hasattr(self, "multi_view_unlink_buttons"):
+            for i, button in enumerate(self.multi_view_unlink_buttons):
+                if i < num_viewers:
+                    button.setText("X")
+                    button.setToolTip("Unlink this image from mirroring")
+                    button.setStyleSheet("")
+
         # Update UI lists to reflect cleared state
         self._update_all_lists()
 
@@ -2829,7 +2842,8 @@ class MainWindow(QMainWindow):
         for i in range(num_viewers):
             image_path = self.multi_view_images[i]
 
-            if not image_path:
+            # Skip if no image or if this viewer is unlinked
+            if not image_path or not self.multi_view_linked[i]:
                 continue
 
             # Filter segments for this viewer
@@ -6802,21 +6816,20 @@ class MainWindow(QMainWindow):
 
     def _toggle_multi_view_link(self, image_index):
         """Toggle the link status for a specific image in multi-view."""
-        if 0 <= image_index < 2:
-            self.multi_view_linked[image_index] = not self.multi_view_linked[
-                image_index
-            ]
+        # Check bounds and link status - only allow unlinking when currently linked
+        if (
+            0 <= image_index < len(self.multi_view_linked)
+            and self.multi_view_linked[image_index]
+        ):
+            # Currently linked - allow unlinking
+            self.multi_view_linked[image_index] = False
 
-            # Update button appearance
+            # Update button appearance to show unlinked state
             button = self.multi_view_unlink_buttons[image_index]
-            if self.multi_view_linked[image_index]:
-                button.setText("X")
-                button.setToolTip("Unlink this image from mirroring")
-                button.setStyleSheet("")
-            else:
-                button.setText("↪")
-                button.setToolTip("Link this image to mirroring")
-                button.setStyleSheet("background-color: #ffcccc;")
+            button.setText("↪")
+            button.setToolTip("This image is unlinked from mirroring")
+            button.setStyleSheet("background-color: #ff4444; color: white;")
+        # If already unlinked or invalid index, do nothing (prevent re-linking)
 
     def _start_background_image_discovery(self):
         """Start background discovery of all image files."""

lazylabel/ui/modes/multi_view_mode.py

@@ -369,12 +369,20 @@ class MultiViewModeHandler(BaseModeHandler):
 
         paired_segment = {"type": "Polygon", "views": {}}
 
-        # Add view data for all viewers with same coordinates
+        # Add view data for current viewer and mirror to linked viewers only
+        paired_segment["views"][viewer_index] = view_data
+
+        # Mirror to other viewers only if they are linked
         for viewer_idx in range(num_viewers):
-            paired_segment["views"][viewer_idx] = {
-                "vertices": view_data["vertices"].copy(),
-                "mask": None,
-            }
+            if (
+                viewer_idx != viewer_index
+                and self.main_window.multi_view_linked[viewer_idx]
+                and self.main_window.multi_view_images[viewer_idx] is not None
+            ):
+                paired_segment["views"][viewer_idx] = {
+                    "vertices": view_data["vertices"].copy(),
+                    "mask": None,
+                }
 
         # Add to segment manager
         self.main_window.segment_manager.add_segment(paired_segment)
@@ -783,9 +791,13 @@ class MultiViewModeHandler(BaseModeHandler):
         # Add the current viewer's data
         paired_segment["views"][viewer_index] = view_data
 
-        # Mirror to all other viewers with same coordinates (they should align between linked images)
+        # Mirror to all other viewers with same coordinates (only if they are linked)
         for other_viewer_index in range(num_viewers):
-            if other_viewer_index != viewer_index:
+            if (
+                other_viewer_index != viewer_index
+                and self.main_window.multi_view_linked[other_viewer_index]
+                and self.main_window.multi_view_images[other_viewer_index] is not None
+            ):
                 mirrored_view_data = {
                     "vertices": view_data[
                         "vertices"
@@ -807,11 +819,27 @@ class MultiViewModeHandler(BaseModeHandler):
 
         # Update UI
         self.main_window._update_all_lists()
-        viewer_count_text = "all viewers" if num_viewers > 2 else "both viewers"
-        self.main_window._show_notification(
-            f"Polygon created and mirrored to {viewer_count_text}."
+
+        # Count linked viewers (excluding the source viewer)
+        linked_viewers_count = sum(
+            1
+            for i in range(num_viewers)
+            if i != viewer_index
+            and self.main_window.multi_view_linked[i]
+            and self.main_window.multi_view_images[i] is not None
         )
 
+        if linked_viewers_count == 0:
+            viewer_count_text = "created (no linked viewers to mirror to)"
+        elif linked_viewers_count == 1:
+            viewer_count_text = "created and mirrored to 1 linked viewer"
+        else:
+            viewer_count_text = (
+                f"created and mirrored to {linked_viewers_count} linked viewers"
+            )
+
+        self.main_window._show_notification(f"Polygon {viewer_count_text}.")
+
         # Clear polygon state for this viewer
         self._clear_multi_view_polygon(viewer_index)
 

lazylabel_gui-1.3.7.dist-info/METADATA

@@ -0,0 +1,227 @@
+Metadata-Version: 2.4
+Name: lazylabel-gui
+Version: 1.3.7
+Summary: An image segmentation GUI for generating ML ready mask tensors and annotations.
+Author-email: "Deniz N. Cakan" <deniz.n.cakan@gmail.com>
+License: MIT License
+        
+        Copyright (c) 2025 Deniz N. Cakan
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Project-URL: Homepage, https://github.com/dnzckn/lazylabel
+Project-URL: Bug Tracker, https://github.com/dnzckn/lazylabel/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Scientific/Engineering :: Image Processing
+Classifier: Environment :: X11 Applications :: Qt
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: PyQt6>=6.9.0
+Requires-Dist: pyqtdarktheme==2.1.0
+Requires-Dist: torch>=2.7.1
+Requires-Dist: torchvision>=0.22.1
+Requires-Dist: segment-anything==1.0
+Requires-Dist: numpy>=2.1.2
+Requires-Dist: opencv-python>=4.11.0.86
+Requires-Dist: scipy>=1.15.3
+Requires-Dist: requests>=2.32.4
+Requires-Dist: tqdm>=4.67.1
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: pytest-mock>=3.10.0; extra == "dev"
+Requires-Dist: pytest-qt>=4.2.0; extra == "dev"
+Requires-Dist: ruff>=0.8.0; extra == "dev"
+Dynamic: license-file
+
+# LazyLabel
+
+<div align="center">
+  <img src="https://raw.githubusercontent.com/dnzckn/LazyLabel/main/src/lazylabel/demo_pictures/logo2.png" alt="LazyLabel Logo" style="height:60px; vertical-align:middle;" />
+  <img src="https://raw.githubusercontent.com/dnzckn/LazyLabel/main/src/lazylabel/demo_pictures/logo_black.png" alt="LazyLabel Cursive" style="height:60px; vertical-align:middle;" />
+</div>
+
+**AI-Assisted Image Segmentation for Machine Learning Dataset Preparation**
+
+LazyLabel combines Meta's Segment Anything Model (SAM) with comprehensive manual annotation tools to accelerate the creation of pixel-perfect segmentation masks for computer vision applications.
+
+<div align="center">
+  <img src="https://raw.githubusercontent.com/dnzckn/LazyLabel/main/src/lazylabel/demo_pictures/gui.PNG" alt="LazyLabel Screenshot" width="800"/>
+</div>
+
+---
+
+## Quick Start
+
+```bash
+pip install lazylabel-gui
+lazylabel-gui
+```
+
+**From source:**
+```bash
+git clone https://github.com/dnzckn/LazyLabel.git
+cd LazyLabel
+pip install -e .
+lazylabel-gui
+```
+
+**Requirements:** Python 3.10+, 8GB RAM, ~2.5GB disk space (for model weights)
+
+---
+
+## Core Features
+
+### AI-Powered Segmentation
+LazyLabel leverages Meta's SAM for intelligent object detection:
+- Single-click object segmentation
+- Interactive refinement with positive/negative points  
+- Support for both SAM 1.0 and SAM 2.1 models
+- GPU acceleration with automatic CPU fallback
+
+### Manual Annotation Tools
+When precision matters:
+- Polygon drawing with vertex-level editing
+- Bounding box annotations for object detection
+- Edit mode for adjusting existing segments
+- Merge tool for combining related segments
+
+### Image Processing & Filtering
+Advanced preprocessing capabilities:
+- **FFT filtering**: Remove noise and enhance edges
+- **Channel thresholding**: Isolate objects by color
+- **Border cropping**: Define crop regions that set pixels outside the area to zero in saved outputs
+- **View adjustments**: Brightness, contrast, gamma correction
+
+### Multi-View Mode
+Process multiple images efficiently:
+- Annotate up to 4 images simultaneously
+- Synchronized zoom and pan across views
+- Mirror annotations to all linked images
+
+---
+
+## Export Formats
+
+### NPZ Format (Semantic Segmentation)
+One-hot encoded masks optimized for deep learning:
+
+```python
+import numpy as np
+
+data = np.load('image.npz')
+mask = data['mask']  # Shape: (height, width, num_classes)
+
+# Each channel represents one class
+sky = mask[:, :, 0]
+boats = mask[:, :, 1]
+cats = mask[:, :, 2]
+dogs = mask[:, :, 3]
+```
+
+### YOLO Format (Object Detection)
+Normalized polygon coordinates for YOLO training:
+```
+0 0.234 0.456 0.289 0.478 0.301 0.523 ...
+1 0.567 0.123 0.598 0.145 0.612 0.189 ...
+```
+
+### Class Aliases (JSON)
+Maintains consistent class naming across datasets:
+```json
+{
+  "0": "background",
+  "1": "person",
+  "2": "vehicle"
+}
+```
+
+---
+
+## Typical Workflow
+
+1. **Open folder** containing your images
+2. **Click objects** to generate AI masks (mode 1)
+3. **Refine** with additional points or manual tools
+4. **Assign classes** and organize in the class table
+5. **Export** as NPZ or YOLO format
+
+### Advanced Preprocessing Workflow
+
+For challenging images:
+1. Apply **FFT filtering** to reduce noise
+2. Use **channel thresholding** to isolate color ranges
+3. Enable **"Operate on View"** to pass filtered images to SAM
+4. Fine-tune with manual tools
+
+---
+
+## Advanced Features
+
+### Multi-View Mode
+Access via the "Multi" tab to process multiple images:
+- 2-view (side-by-side) or 4-view (grid) layouts
+- Annotations mirror across linked views automatically
+- Synchronized zoom maintains alignment
+
+### SAM 2.1 Support
+LazyLabel supports both SAM 1.0 (default) and SAM 2.1 models. SAM 2.1 offers improved segmentation accuracy and better handling of complex boundaries.
+
+To use SAM 2.1 models:
+1. Install the SAM 2 package:
+   ```bash
+   pip install git+https://github.com/facebookresearch/sam2.git
+   ```
+2. Download a SAM 2.1 model (e.g., `sam2.1_hiera_large.pt`) from the [SAM 2 repository](https://github.com/facebookresearch/sam2)
+3. Place the model file in LazyLabel's models folder:
+   - If installed via pip: `~/.local/share/lazylabel/models/` (or equivalent on your system)
+   - If running from source: `src/lazylabel/models/`
+4. Select the SAM 2.1 model from the dropdown in LazyLabel's settings
+
+Note: SAM 1.0 models are automatically downloaded on first use.
+
+---
+
+## Key Shortcuts
+
+| Action | Key | Description |
+|--------|-----|-------------|
+| AI Mode | `1` | SAM point-click segmentation |
+| Draw Mode | `2` | Manual polygon creation |
+| Edit Mode | `E` | Modify existing segments |
+| Accept AI Segment | `Space` | Confirm AI segment suggestion |
+| Save | `Enter` | Save annotations |
+| Merge | `M` | Combine selected segments |
+| Pan Mode | `Q` | Enter pan mode |
+| Pan | `WASD` | Navigate image |
+| Delete | `V`/`Delete` | Remove segments |
+| Undo/Redo | `Ctrl+Z/Y` | Action history |
+
+---
+
+## Documentation
+
+- [Usage Manual](src/lazylabel/USAGE_MANUAL.md) - Comprehensive feature guide
+- [Architecture Guide](src/lazylabel/ARCHITECTURE.md) - Technical implementation details
+- [GitHub Issues](https://github.com/dnzckn/LazyLabel/issues) - Report bugs or request features
+
+---

{lazylabel_gui-1.3.6.dist-info → lazylabel_gui-1.3.7.dist-info}/RECORD

@@ -18,14 +18,14 @@ lazylabel/ui/editable_vertex.py,sha256=ofo3r8ZZ3b8oYV40vgzZuS3QnXYBNzE92ArC2wggJ
 lazylabel/ui/hotkey_dialog.py,sha256=U_B76HLOxWdWkfA4d2XgRUaZTJPAAE_m5fmwf7Rh-5Y,14743
 lazylabel/ui/hoverable_pixelmap_item.py,sha256=UbWVxpmCTaeae_AeA8gMOHYGUmAw40fZBFTS3sZlw48,1821
 lazylabel/ui/hoverable_polygon_item.py,sha256=gZalImJ_PJYM7xON0iiSjQ335ZBREOfSscKLVs-MSh8,2314
-lazylabel/ui/main_window.py,sha256=TZ1m7GxxyonhSMffwNe8sE264IzuoML8W-V9r7HOP1E,382538
+lazylabel/ui/main_window.py,sha256=PFbVzZ1jbOuz2q8MNY3BHjWmJU6YoBqKiPwLvlDdsNI,383320
 lazylabel/ui/numeric_table_widget_item.py,sha256=dQUlIFu9syCxTGAHVIlmbgkI7aJ3f3wmDPBz1AGK9Bg,283
 lazylabel/ui/photo_viewer.py,sha256=3o7Xldn9kJWvWlbpcHDRMk87dnB5xZKbfyAT3oBYlIo,6670
 lazylabel/ui/reorderable_class_table.py,sha256=sxHhQre5O_MXLDFgKnw43QnvXXoqn5xRKMGitgO7muI,2371
 lazylabel/ui/right_panel.py,sha256=D69XgPXpLleflsIl8xCtoBZzFleLqx0SezdwfcEJhUg,14280
 lazylabel/ui/modes/__init__.py,sha256=ikg47aeexLQavSda_3tYn79xGJW38jKoUCLXRe2w8ok,219
 lazylabel/ui/modes/base_mode.py,sha256=0R3AkjN_WpYwetF3uuOvkTxb6Q1HB-Z1NQPvLh9eUTY,1315
-lazylabel/ui/modes/multi_view_mode.py,sha256=TKdqTHokIk267aFVvwXikAtAcuxpG6ezIOlQwoque9c,50606
+lazylabel/ui/modes/multi_view_mode.py,sha256=IiInmNhdFEQAcKuY2QY5ABx-EXgOh1lVeTnJVGoLyNM,51713
 lazylabel/ui/modes/single_view_mode.py,sha256=khGUXVQ_lv9cCXkOAewQN8iH7R_CPyIVtQjUqEF1eC0,11852
 lazylabel/ui/widgets/__init__.py,sha256=6VDoMnanqVm3yjOovxie3WggPODuhUsIO75RtxOhQhI,688
 lazylabel/ui/widgets/adjustments_widget.py,sha256=5xldhdEArX3H2P7EmHPjURdwpV-Wa2WULFfspp0gxns,12750
@@ -47,9 +47,9 @@ lazylabel/utils/custom_file_system_model.py,sha256=-3EimlybvevH6bvqBE0qdFnLADVta
 lazylabel/utils/fast_file_manager.py,sha256=kzbWz_xKufG5bP6sjyZV1fmOKRWPPNeL-xLYZEu_8wE,44697
 lazylabel/utils/logger.py,sha256=R7z6ifgA-NY-9ZbLlNH0i19zzwXndJ_gkG2J1zpVEhg,1306
 lazylabel/utils/utils.py,sha256=sYSCoXL27OaLgOZaUkCAhgmKZ7YfhR3Cc5F8nDIa3Ig,414
-lazylabel_gui-1.3.6.dist-info/licenses/LICENSE,sha256=kSDEIgrWAPd1u2UFGGpC9X71dhzrlzBFs8hbDlENnGE,1092
-lazylabel_gui-1.3.6.dist-info/METADATA,sha256=wU3SVog5c0CafMdOiUD82IFoQwZ-LUdOTGxbLQWW7WU,7156
-lazylabel_gui-1.3.6.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-lazylabel_gui-1.3.6.dist-info/entry_points.txt,sha256=Hd0WwEG9OPTa_ziYjiD0aRh7R6Fupt-wdQ3sspdc1mM,54
-lazylabel_gui-1.3.6.dist-info/top_level.txt,sha256=YN4uIyrpDBq1wiJaBuZLDipIzyZY0jqJOmmXiPIOUkU,10
-lazylabel_gui-1.3.6.dist-info/RECORD,,
+lazylabel_gui-1.3.7.dist-info/licenses/LICENSE,sha256=kSDEIgrWAPd1u2UFGGpC9X71dhzrlzBFs8hbDlENnGE,1092
+lazylabel_gui-1.3.7.dist-info/METADATA,sha256=Mo6GD0ppauY9CxGQVxIT3BzwEcryP6D_Gs3alvGu5Eg,7754
+lazylabel_gui-1.3.7.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+lazylabel_gui-1.3.7.dist-info/entry_points.txt,sha256=Hd0WwEG9OPTa_ziYjiD0aRh7R6Fupt-wdQ3sspdc1mM,54
+lazylabel_gui-1.3.7.dist-info/top_level.txt,sha256=YN4uIyrpDBq1wiJaBuZLDipIzyZY0jqJOmmXiPIOUkU,10
+lazylabel_gui-1.3.7.dist-info/RECORD,,

lazylabel_gui-1.3.6.dist-info/METADATA

@@ -1,197 +0,0 @@
-Metadata-Version: 2.4
-Name: lazylabel-gui
-Version: 1.3.6
-Summary: An image segmentation GUI for generating ML ready mask tensors and annotations.
-Author-email: "Deniz N. Cakan" <deniz.n.cakan@gmail.com>
-License: MIT License
-        
-        Copyright (c) 2025 Deniz N. Cakan
-        
-        Permission is hereby granted, free of charge, to any person obtaining a copy
-        of this software and associated documentation files (the "Software"), to deal
-        in the Software without restriction, including without limitation the rights
-        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-        copies of the Software, and to permit persons to whom the Software is
-        furnished to do so, subject to the following conditions:
-        
-        The above copyright notice and this permission notice shall be included in all
-        copies or substantial portions of the Software.
-        
-        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-        SOFTWARE.
-        
-Project-URL: Homepage, https://github.com/dnzckn/lazylabel
-Project-URL: Bug Tracker, https://github.com/dnzckn/lazylabel/issues
-Classifier: Programming Language :: Python :: 3
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Classifier: Topic :: Scientific/Engineering :: Image Processing
-Classifier: Environment :: X11 Applications :: Qt
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: PyQt6>=6.9.0
-Requires-Dist: pyqtdarktheme==2.1.0
-Requires-Dist: torch>=2.7.1
-Requires-Dist: torchvision>=0.22.1
-Requires-Dist: segment-anything==1.0
-Requires-Dist: numpy>=2.1.2
-Requires-Dist: opencv-python>=4.11.0.86
-Requires-Dist: scipy>=1.15.3
-Requires-Dist: requests>=2.32.4
-Requires-Dist: tqdm>=4.67.1
-Provides-Extra: dev
-Requires-Dist: pytest>=7.0.0; extra == "dev"
-Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
-Requires-Dist: pytest-mock>=3.10.0; extra == "dev"
-Requires-Dist: pytest-qt>=4.2.0; extra == "dev"
-Requires-Dist: ruff>=0.8.0; extra == "dev"
-Dynamic: license-file
-
-# LazyLabel
-
-<div align="center">
-  <img src="https://raw.githubusercontent.com/dnzckn/LazyLabel/main/src/lazylabel/demo_pictures/logo2.png" alt="LazyLabel Logo" style="height:60px; vertical-align:middle;" />
-  <img src="https://raw.githubusercontent.com/dnzckn/LazyLabel/main/src/lazylabel/demo_pictures/logo_black.png" alt="LazyLabel Cursive" style="height:60px; vertical-align:middle;" />
-</div>
-
-**AI-Assisted Image Segmentation for Machine Learning Applications**
-
-LazyLabel integrates Meta's Segment Anything Model (SAM) with advanced editing capabilities to enable efficient, high-precision image annotation. Designed for computer vision research and machine learning dataset preparation.
-
-<div align="center">
-  <img src="https://raw.githubusercontent.com/dnzckn/LazyLabel/main/src/lazylabel/demo_pictures/gui.PNG" alt="LazyLabel Screenshot" width="800"/>
-</div>
-
----
-
-## Quick Start
-
-### Installation
-```bash
-pip install lazylabel-gui
-lazylabel-gui
-```
-
-### Optional: SAM 2.1 Support
-For enhanced performance with SAM 2.1 models:
-```bash
-pip install git+https://github.com/facebookresearch/sam2.git
-```
-**Note:** SAM 2.1 is optional - LazyLabel downloads SAM 1.0 models by default.
-
-### Usage
-1. **Open Folder** - Select your image directory
-2. **AI Segmentation** - Click on objects for automatic mask generation
-3. **Manual Refinement** - Edit polygons, merge segments, adjust classifications
-4. **Export** - Generate `.npz` files with one-hot encoded masks for ML training
-
----
-
-## Key Features
-
-- **One-click AI segmentation** with Meta's SAM and SAM 2.1 models
-- **Manual polygon drawing** with full vertex control
-- **Smart editing tools** - merge segments, adjust class names, and class order
-- **ML-ready exports** - One-hot encoded `.npz` format and `.json` for YOLO format
-- **Image enhancement** - brightness, contrast, gamma adjustment
-- **Advanced image viewer** - zoom, pan, and real-time adjustments
-- **Edge cropping** - define custom crop areas to focus on specific regions
-- **Undo/Redo system** - full history of all actions
-- **Auto-saving** - automatic saving of labels when navigating between images
-- **Advanced filtering** - FFT thresholding and color channel thresholding
-- **Customizable hotkeys** for all functions
-
----
-
-## Essential Hotkeys
-
-| Action | Key | Description |
-|--------|-----|-------------|
-| **AI Mode** | `1` | Point-click segmentation |
-| **Draw Mode** | `2` | Manual polygon drawing |
-| **Edit Mode** | `E` | Select and modify shapes |
-| **Save Segment** | `Space` | Confirm current mask |
-| **Merge** | `M` | Combine selected segments |
-| **Pan** | `Q` + drag | Navigate large images |
-| **Positive Point** | `Left Click` | Add to segment |
-| **Negative Point** | `Right Click` | Remove from segment |
-
-**Note:** All hotkeys are fully customizable - Click "Hotkeys" button to personalize your workflow.
-
----
-
-## Output Format
-
-LazyLabel exports data in standardized formats optimized for machine learning workflows:
-
-```python
-import numpy as np
-
-# Load your labeled data
-data = np.load('your_image.npz')
-mask = data['mask']  # Shape: (height, width, num_classes)
-
-# Each channel is a binary mask for one class
-class_0_mask = mask[:, :, 0]  # Background
-class_1_mask = mask[:, :, 1]  # Object type 1
-class_2_mask = mask[:, :, 2]  # Object type 2
-```
-
-
-**Ideal for:**
-- Semantic segmentation datasets
-- Instance segmentation training
-- Computer vision research
-- Automated annotation pipelines
-
----
-
-## Development
-
-**Requirements:** Python 3.10+, ~2.5GB disk space for SAM models (auto-downloaded)
-
-### Installation from Source
-```bash
-git clone https://github.com/dnzckn/LazyLabel.git
-cd LazyLabel
-pip install -e .
-lazylabel-gui
-```
-
-### Testing & Quality
-```bash
-# Run test suite (272 tests)
-pytest --tb=short
-
-# Code quality checks
-ruff check --fix src/
-```
-
-### Architecture
-- **Modular design** with clean component separation
-- **Signal-based communication** between UI elements  
-- **Extensible model system** for SAM 1.0 and SAM 2.1 variants
-- **Comprehensive test suite** (272 tests with extensive coverage)
-- **Multi-view support** for simultaneous image processing
-
----
-
-## Contributing
-
-LazyLabel welcomes contributions! Please review:
-- [Usage Manual](src/lazylabel/USAGE_MANUAL.md) for comprehensive user documentation
-- [Architecture Guide](src/lazylabel/ARCHITECTURE.md) for technical implementation details
-- [Issues page](https://github.com/dnzckn/LazyLabel/issues) for feature requests and bug reports
-
----
-
-## Acknowledgments
-
-- [LabelMe](https://github.com/wkentaro/labelme)
-- [Segment-Anything-UI](https://github.com/branislavhesko/segment-anything-ui)