acycle 0.1.5

Advanced Image Analysis Tool with magnification, color analysis, and data extraction

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

pip install acycle

From Source

git clone https://github.com/yourusername/acycle.git
cd acycle
pip install -e .

Usage

Command Line

After installation, you can run the application using:

acycle-imageprocessor

Or as a Python module:

python -m acycle.imageprocessor

As a Library

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 ([e-mail]) #\x00 \x00A\x00c\x00y\x00c\x00l\x00e\x00P\x00y\x00 \x00 \x00