Semapp 1.0.5__py3-none-any.whl

semapp/__init__.py

@@ -0,0 +1,10 @@
+"""
+SEMapp - SEM Data Visualization Application
+
+A PyQt5-based application for visualizing and analyzing Scanning Electron Microscope (SEM) data.
+Supports both standard and COMPLUS4T KLARF file formats.
+"""
+
+__version__ = "1.0.2"
+__author__ = "Your Name"
+

semapp/main.py

@@ -0,0 +1,103 @@
+"""
+GUI for data visualization.
+
+This module implements the main window and core functionality
+for the SEM data visualization application.
+"""
+
+import sys
+import os
+from PyQt5.QtCore import QTimer
+from PyQt5.QtWidgets import QApplication, QWidget, QGridLayout
+from PyQt5.QtGui import QIcon
+
+# Add parent directory to path to allow imports
+sys.path.insert(0, os.path.abspath(os.path.join(os.path.dirname(__file__), '..')))
+
+from semapp.Layout.main_window_att import LayoutFrame
+from semapp.Layout.create_button import ButtonFrame
+from semapp.Plot.frame_attributes import PlotFrame
+
+# Constants
+TIMER_INTERVAL = 200  # Milliseconds
+BACKGROUND_COLOR = "#F5F5F5"
+
+
+class MainWindow(QWidget):  # pylint: disable=R0903
+    """
+    Main window for data visualization.
+    
+    This class handles the main application window and initializes all UI components.
+    It manages the layout, plotting area, and button controls for the application.
+    
+    Attributes:
+        canvas_widget (QWidget): The main widget container
+        canvas_layout (QGridLayout): The main layout manager
+        layout_frame (LayoutFrame): Handles layout configuration
+        button_frame (ButtonFrame): Contains all button controls
+        plot_frame (PlotFrame): Manages the plotting area
+        timer (QTimer): Updates the scroll area size
+    """
+
+    def __init__(self):
+        """Initialize the main window and UI components."""
+        super().__init__()
+        self.canvas_widget = None
+        self.canvas_layout = None
+        self.layout_frame = None
+        self.button_frame = None
+        self.plot_frame = None
+        self.timer = None
+        self.init_ui()
+
+    def init_ui(self):
+        """
+        Initialize the user interface.
+        
+        Sets up the window properties, layouts, and all UI components.
+        Configures the main layout, creates frames for different sections,
+        and initializes the update timer.
+        """
+        self.setWindowTitle("SEMapp")
+        self.setStyleSheet(f"background-color: {BACKGROUND_COLOR};")
+        
+        # Set window icon
+        icon_path = os.path.join(os.path.dirname(__file__), 'asset', 'icon.png')
+        if os.path.exists(icon_path):
+            self.setWindowIcon(QIcon(icon_path))
+        else:
+            print(f"[WARNING] Icon not found at: {icon_path}")
+
+        # Create the main layout (canvas_layout)
+        self.canvas_widget = QWidget(self)
+        self.canvas_layout = QGridLayout(self.canvas_widget)
+
+        # Use LayoutFrame for layout configuration
+        self.layout_frame = LayoutFrame(self)
+        self.layout_frame.setup_layout(self.canvas_widget, self.canvas_layout)
+
+        self.button_frame = ButtonFrame(self.canvas_layout)
+        self.plot_frame = PlotFrame(self.canvas_layout, self.button_frame)
+
+        # Set/adapt the maximum window size
+        self.layout_frame.set_max_window_size()
+        self.layout_frame.position_window_top_left()
+
+        self.timer = QTimer(self)
+        self.timer.timeout.connect(self.layout_frame.adjust_scroll_area_size)
+        self.timer.start(TIMER_INTERVAL)
+
+
+def main():
+    """
+    Main entry point for the SEMapp application.
+    
+    Creates and displays the main window, then starts the Qt event loop.
+    """
+    app = QApplication(sys.argv)
+    window = MainWindow()
+    window.show()
+    sys.exit(app.exec_())
+
+if __name__ == "__main__":
+    main()

semapp-1.0.5.dist-info/METADATA

@@ -0,0 +1,300 @@
+Metadata-Version: 2.4
+Name: Semapp
+Version: 1.0.5
+Summary: Package for SEM visualization
+Author-email: Thibaut Meyer <thibaut.meyer3@gmail.com>
+License-Expression: GPL-3.0-or-later
+Project-URL: Homepage, https://github.com/thi-mey/SEMapp
+Keywords: SEM,GUI
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: matplotlib==3.10.7
+Requires-Dist: numpy==2.3.5
+Requires-Dist: opencv-python==4.12.0.88
+Requires-Dist: pandas==2.3.3
+Requires-Dist: Pillow==12.0.0
+Requires-Dist: PyQt5==5.15.11
+Requires-Dist: PyQt5_sip==12.17.0
+Requires-Dist: pytesseract==0.3.13
+Requires-Dist: scipy==1.16.3
+Dynamic: license-file
+
+# SEMapp - SEM Data Visualization Application
+
+A comprehensive PyQt5-based desktop application for visualizing and analyzing Scanning Electron Microscope (SEM) data. SEMapp supports multiple KLARF file formats (Standard, COMPLUS4T, and KRONOS), providing an intuitive interface for defect mapping, image analysis, and batch processing.
+
+## Features
+
+### Core Functionality
+- **Multi-Format KLARF Support**: Parse and extract defect data from `.001` (KLARF) files
+  - Standard mode: Traditional KLARF format
+  - COMPLUS4T mode: Multi-wafer KLARF files with automatic wafer detection
+  - KRONOS mode: Special format with OCR-based number detection
+- **Interactive Wafer Mapping**: Visual representation of defect positions on wafer surface
+- **Image Visualization**: Display TIFF images corresponding to defect locations
+- **Dynamic Defect Filtering**: Real-time defect filtering based on size threshold
+- **Overview Window**: Full-screen mapping with image thumbnails
+
+### Data Processing
+- **Automatic File Organization**: Organize TIFF files into wafer-specific subfolders
+- **Coordinate Extraction**: Extract and convert defect coordinates from KLARF format
+- **TIFF Splitting**: Split multi-page TIFF files into individual images
+- **File Renaming**: Automatic renaming based on coordinates and settings
+- **CSV Export**: Save defect mapping data for external analysis
+- **Batch Processing**: Process multiple wafers in a single session
+
+### Image Processing
+- **Threshold Processing**: Detect and analyze particles in SEM images
+- **Particle Detection**: Configurable threshold and minimum size parameters
+- **Mapping Generation**: Create interpolated maps of particle density and statistics
+- **OCR Detection**: Automatic number detection in KRONOS mode using Tesseract
+
+### User Interface
+- **Wafer Selection**: Grid-based wafer slot selection (1-26)
+- **Image Type Selection**: Choose from different image scales and types
+- **Defect Size Slider**: Dynamic threshold control for defect visualization
+- **Interactive Plot**: Click on defect positions to view corresponding images
+- **Settings Configuration**: Customize image types and processing parameters
+- **Toast Notifications**: Non-intrusive feedback for operations
+- **Progress Dialogs**: Visual feedback during long operations
+
+## Installation
+
+### Prerequisites
+- Python 3.9 or higher
+- pip package manager
+- Tesseract OCR (optional, for KRONOS mode number detection)
+  - Windows: Download from [UB-Mannheim Tesseract](https://github.com/UB-Mannheim/tesseract/wiki)
+  - Linux: `sudo apt-get install tesseract-ocr`
+  - macOS: `brew install tesseract`
+
+### Install from PyPI
+```bash
+pip install semapp
+```
+
+### Install from Source
+```bash
+git clone https://github.com/thi-mey/SEMapp.git
+cd SEM_VF
+pip install -e .
+```
+
+### Dependencies
+All dependencies are automatically installed:
+- PyQt5 >= 5.15.11
+- matplotlib >= 3.10.3
+- pandas >= 2.2.3
+- Pillow >= 11.2.1
+- numpy >= 2.2.5
+- pytesseract (optional, for OCR features)
+
+## Quick Start
+
+### Launching the Application
+```bash
+# From command line after installation
+semapp
+
+# Or run directly from source
+python -m semapp.main
+```
+
+### Basic Workflow
+
+1. **Select a Directory**
+   - Click "Select Folder" to choose your data directory
+   - Application automatically detects standard, COMPLUS4T, or KRONOS mode
+
+2. **Choose a Wafer**
+   - Select a wafer slot from the grid (1-26)
+   - Available wafers are highlighted in green
+
+3. **Configure Settings** (Optional)
+   - Click "Settings" to configure image types and scales
+   - Define scale and image type combinations
+
+4. **Open TIFF Data**
+   - Click "Open TIFF" to load defect data and images
+   - Wafer mapping is displayed automatically
+
+5. **Analyze Defects**
+   - Click on defect points in the map to view corresponding images
+   - Use the defect size slider to filter by threshold
+   - Adjust threshold and min size sliders for particle detection
+
+6. **View Overview**
+   - Click "Overview" to see full-screen mapping with image thumbnails
+   - Save the overview as PNG, PDF, or SVG
+
+## File Structure
+
+### Standard Mode
+```
+project_directory/
+├── 1/                          # Wafer slot 1
+│   ├── data.tif               # TIFF image file
+│   ├── recipe_file.001        # KLARF defect file
+│   └── mapping.csv            # Generated coordinate mapping
+├── 2/                          # Wafer slot 2
+│   ├── data.tif
+│   ├── recipe_file.001
+│   └── mapping.csv
+└── ...
+```
+
+### COMPLUS4T Mode
+```
+project_directory/
+├── data.tiff                   # Single TIFF file with all defects
+├── recipe_file.001             # KLARF file containing multiple wafer IDs
+├── 16/                         # Subfolder created for wafer ID 16
+│   ├── data_page_331.tiff      # Split TIFF pages
+│   ├── -9.1_1.1.tif            # Renamed files
+│   └── mapping.csv             # Wafer-specific mapping
+├── 21/                         # Subfolder created for wafer ID 21
+│   └── mapping.csv
+└── ...
+```
+
+### KRONOS Mode
+```
+project_directory/
+├── 11/                         # Wafer ID 11
+│   ├── data.tiff               # Multi-page TIFF
+│   ├── recipe_file.001        # KLARF file
+│   ├── detection_results.csv   # OCR detection results
+│   ├── mapping.csv             # Filtered defect mapping
+│   └── data_page_10.tiff       # Split pages
+└── ...
+```
+
+## KLARF File Format
+
+SEMapp parses KLARF (`.001`) files to extract:
+- **Wafer IDs**: 
+  - `WaferID "@16";` (COMPLUS4T mode)
+  - `WaferID "Read Failed.11";` (KRONOS mode)
+- **Sample Size**: Total number of defects
+- **Die Pitch**: X and Y pitch values
+- **Die Origin**: Origin coordinates
+- **Sample Center Location**: Center coordinates
+- **Defect List**: Individual defect positions and sizes
+
+## Processing Operations
+
+### Split and Rename
+- **Split TIFF**: Split multi-page TIFF files into individual pages
+- **Rename Files**: Rename files based on coordinates and settings
+- **Batch Processing**: Process all wafers at once
+
+### Threshold Processing
+- **Particle Detection**: Detect particles using configurable threshold
+- **Statistics**: Calculate density, area, and particle counts
+- **CSV Export**: Save results for analysis
+
+### Mapping
+- **Interpolated Maps**: Generate interpolated maps of particle statistics
+- **Multiple Metrics**: Density, average area, total area percentage
+- **Visualization**: Save maps as PNG files
+
+### Clean Operations
+- **Remove Non-Conforming Files**: Clean up files that don't match naming conventions
+- **Organize Structure**: Create proper directory structure
+
+## Configuration
+
+### Settings File
+The application uses a JSON settings file to define image types and scales:
+```json
+[
+  {
+    "Scale": "5x5",
+    "Image Type": "SE"
+  },
+  {
+    "Scale": "10x10",
+    "Image Type": "BSE"
+  }
+]
+```
+
+### Detection Configuration (KRONOS)
+- **ROI**: Region of Interest for number detection (default: X: 1100, Y: 0, W: 250, H: 35)
+- **CPU Cores**: Configurable number of CPU cores for multiprocessing
+- **Resize Factor**: Optional image resizing for faster processing
+
+## Keyboard Shortcuts
+
+- **Escape**: Close overview window
+- **Ctrl+T**: Toggle theme (if enabled)
+
+## Troubleshooting
+
+### Tesseract Not Found
+If you encounter Tesseract errors in KRONOS mode:
+1. Install Tesseract OCR (see Prerequisites)
+2. On Windows, ensure it's installed in the default path or update the path in `detection.py`
+
+### No Images Displayed
+- Verify TIFF files are in the correct location
+- Check that KLARF files contain valid defect data
+- Ensure coordinates are correctly extracted (check `mapping.csv`)
+
+### Processing Errors
+- Verify file permissions
+- Check that all required files exist
+- Review console output for detailed error messages
+
+## Development
+
+### Project Structure
+```
+semapp/
+├── main.py                 # Main application entry point
+├── Layout/                 # UI layout components
+│   ├── create_button.py   # Button and control creation
+│   ├── main_window_att.py # Window layout management
+│   ├── settings.py        # Settings window
+│   └── styles.py          # UI styles
+├── Plot/                  # Plotting and visualization
+│   ├── frame_attributes.py # Main plot frame
+│   ├── overview_window.py  # Overview window
+│   └── utils.py            # Plot utilities
+└── Processing/            # Data processing modules
+    ├── klarf_reader.py     # KLARF file parsing
+    ├── processing.py       # Main processing class
+    ├── rename_tif.py        # File renaming
+    ├── split_tif.py         # TIFF splitting
+    ├── threshold.py        # Threshold processing
+    └── detection.py        # OCR detection
+```
+
+### Running Tests
+```bash
+# Run from project root
+python -m semapp.main
+```
+
+## License
+
+This project is licensed under the GPL-3.0-or-later License - see the LICENSE file for details.
+
+## Author
+
+**Thibaut Meyer**
+- Email: thibaut.meyer3@gmail.com
+- GitHub: [@thi-mey](https://github.com/thi-mey)
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## Acknowledgments
+
+- PyQt5 community for the excellent GUI framework
+- Tesseract OCR for number detection capabilities
+- All contributors and users of SEMapp

semapp-1.0.5.dist-info/RECORD

@@ -0,0 +1,27 @@
+semapp/__init__.py,sha256=b2lUJO2caElUIkLLSy7q7fIA2xgXbxZsaTL6LdvtoU0,266
+semapp/main.py,sha256=uu7W5uOaIArHTkQHH-8R8KkHPCYvqq6-i9f-elitV_0,3491
+semapp/Layout/__init__.py,sha256=Y60dNC2iCpGv7t9DkGZs1zqKCr1FfaZQ90fINmI1KMA,603
+semapp/Layout/create_button.py,sha256=6RL4pb6fzUnRv6NwFjzofQk_TTerRekc15Tcr5Z_x-M,51875
+semapp/Layout/main_window_att.py,sha256=bxefkRFZ9iUo-3Xy11rPEywKCAfZcNDrLPhCQxXoxUk,2249
+semapp/Layout/settings.py,sha256=Mrt88HSnKmPqMQP_k1cMsfrRJgfSjC1nIzpzWMO9eO0,6355
+semapp/Layout/styles.py,sha256=sjCcQItzBVkLLogCQlCWN7hfroUC4u_ou3GAk3qpiHI,3447
+semapp/Layout/toast.py,sha256=mJGRe6M0_XET-HtV76paBGRoi3Djetsn2VWhFKhzcZs,5048
+semapp/Plot/__init__.py,sha256=skjYnE2J9W9RVwHqJfCNDhJTniQDAzGlzVp94OFpC5A,144
+semapp/Plot/frame_attributes.py,sha256=FSe843sSuNW324jacFZkt8yQaQGgc9epIIhhlWWtSR8,29363
+semapp/Plot/overview_window.py,sha256=vUX0ALVS5s5g-XxyW4QzAaGHPdv4NfiOjNWGzW8gsCA,14290
+semapp/Plot/styles.py,sha256=191DG0n1KGx7NMg8CAzcQTXJ_USvWUsYCTSH0HL95-k,1197
+semapp/Plot/utils.py,sha256=mxk_VA7eZ76EYiKpXKD7D3Pu1kEUISG3IHX-vOhQUY0,11574
+semapp/Processing/__init__.py,sha256=BZOqbkPq0GpUcScdQ2H5K-9lC9__ACSemfM4I7NuhGU,97
+semapp/Processing/detection.py,sha256=Ko9CKD6PdnkRP-VLEI7B6FsePntfUaF5-sJF5iiBBnA,21564
+semapp/Processing/klarf_reader.py,sha256=IHue_TP_Wl2LRUJ4h8aw0-spHRQtdP4ZYo5J9ydZC5g,18395
+semapp/Processing/processing.py,sha256=Y6pSUf4j2MqIyigFube-NsylP1zqVgjzTTV0-HNQ9wI,28715
+semapp/Processing/rename_tif.py,sha256=1hYdB3SV7CKISrmSt9YXjcNkOsabMl-297KIiS-IHf4,17399
+semapp/Processing/split_tif.py,sha256=_U0ANmBLbDo0rUhEbAd1F_ZlrWCHz0kRD__qaSG81E8,10585
+semapp/Processing/threshold.py,sha256=bmubYUibJs5tZZNay5fIg5FZM9S87nM3eyF1x9cp3Xs,34969
+semapp/asset/icon.png,sha256=UHPUodH4NPedJKqvuyOUL-10LqWYOjBd4rzkuGwJ-8Y,236849
+semapp-1.0.5.dist-info/licenses/LICENSE,sha256=LoV48WtuomVBIWbotLHaBF_MEfKNsD1mSQhBASSi8B4,35801
+semapp-1.0.5.dist-info/METADATA,sha256=zk0Varqtj33LqwmHTU9zQuHPQ-6ed-0nQxpL5NVe_3g,10457
+semapp-1.0.5.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+semapp-1.0.5.dist-info/entry_points.txt,sha256=_rXPJS9aPfI3F8wcCv1PllnnDpvz3Mpd8FRL6Xivhwc,40
+semapp-1.0.5.dist-info/top_level.txt,sha256=jMlqZoYXBSCF-JQJ-vLlIYIFJurj438WgMBUMvoZtJo,7
+semapp-1.0.5.dist-info/RECORD,,

semapp-1.0.5.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

semapp-1.0.5.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[gui_scripts]
+Semapp = semapp.main:main