semvec/pypi-packages huggingface dataset:
acycle-imageprocessor 0.1.0
Advanced Image Analysis Tool with magnification, color analysis, and data extraction
License: MIT
Requires Python: >=3.8
Keywords: image, processing, analysis, data-extraction, qt

# Acycle Image Processor

Advanced Image Analysis Tool with magnification, color analysis, and data extraction capabilities.

## Features

- **Image Magnification**: Real-time magnifier with adjustable zoom factor
- **Coordinate Calibration**: Set reference points to transform pixel coordinates to real-world coordinates
- **Color Analysis**: Automatic dominant color detection and custom color selection
- **Data Point Extraction**: Extract data points from images based on color matching
- **Drawing Tools**:
  - Box selection for region-based extraction
  - Freehand drawing for custom path selection
  - Manual point marking
- **Data Export**: Save extracted data points to text files
- **Undo/Redo**: Full undo/redo support for drawing operations (Ctrl+Z / Ctrl+Y)

## Installation

### From PyPI (once published)

```bash
pip install acycle-imageprocessor
```

### From Source

```bash
git clone https://github.com/yourusername/acycle-imageprocessor.git
cd acycle-imageprocessor
pip install -e .
```

## Usage

### Command Line

After installation, you can run the application using:

```bash
acycle-imageprocessor
```

Or as a Python module:

```bash
python -m acycle.imageprocessor
```

### As a Library

```python
from acycle.imageprocessor import ImageProcessor
from PySide6.QtWidgets import QApplication
import sys

app = QApplication(sys.argv)
window = ImageProcessor()
window.show()
sys.exit(app.exec())
```

## Workflow

1. **Load Image**: Click "Load Image" to open an image file
2. **Calibrate Coordinates** (optional):
   - Enter reference values for X1, X2, Y1, Y2
   - Click "Pick X1", "Pick X2", etc., then click on the image to set calibration points
3. **Select Tool**:
   - **Box**: Draw a rectangle to select a region
   - **Drawing**: Draw freehand paths to select custom regions
   - **Manual**: Click to manually mark individual points
4. **Analyze Colors**: The tool automatically detects dominant colors in the image
5. **Extract Data Points**:
   - Select a color (either from dominant colors or custom)
   - Adjust dx/dy sampling intervals
   - Click "Extract Data Points"
6. **Save Data**: Click "Save Data Points" to export extracted coordinates

## Requirements

- Python >= 3.8
- PySide6 >= 6.0.0
- numpy >= 1.20.0
- matplotlib >= 3.3.0
- scikit-image >= 0.18.0
- scikit-learn >= 0.24.0
- Pillow >= 8.0.0
- qt-material >= 2.0.0
- scipy >= 1.6.0

## License

MIT License - see LICENSE file for details

## Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

## Author

Your Name (your.email@example.com)
#\x00 \x00A\x00c\x00y\x00c\x00l\x00e\x00P\x00y\x00
\x00
\x00