You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
# 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)
# AcyclePy