Skip to content

README.md

Latest commit

 

History

History
103 lines (71 loc) · 3.75 KB

README.md

File metadata and controls

103 lines (71 loc) · 3.75 KB

PyImageLabeling logo

PyImageLabeling

PyPI version Python 3.12+ License: MIT

PyImageLabeling is a powerful tool with a user-friendly interface based on PyQT6 for creating image masks. These labeled images are used in the creation of machine learning models dedicated to computer vision tasks.

Two types of labeling are available:

  • Pixel-by-Pixel: allows to use the pixel-level precision (paintbrush, magic pen, contour filling).
  • Geometric shapes: allows to use different geometric shapes (polygon, rectangle, ellipse) for labeling.

PyImageLabeling Interface

Overview of PyImageLabeling in the context of an application related to pancreatic cancer.



PyImageLabeling Interface

Overview of PyImageLabeling with the Flood Area Segmentation dataset.

Installation and Run

Note that you need first Python 3 (version 3.12, or later) to be installed. You can do it, for example, from Python.org.

PyPi installation (Windows, Mac and Linux)

Check whether you have the last version of PyPi:

python3 -m pip install -U pip

Install PyImageLabeling:

python3 -m pip install -U PyImageLabeling

To launch PyImageLabeling:

python3 -m PyImageLabeling

Executable ".exe" (Windows)

You can download the Windows executable. Just double-click on the executable file to launch PyImageLabeling.

Github Installation (Windows, Mac and Linux)

Here is an illustration for Linux. We assume that Python 3 is installed, and consequently ‘pip3’ is also installed. In a console, type:

git clone https://github.com/crillab/PyImageLabeling.git

You may need to update the environment variable ‘PYTHONPATH’, by typing for example:

export PYTHONPATH="${PYTHONPATH}:${PWD}/.."

Get the last version of pip:

python3 -m pip install --upgrade pip

Executes the pyproject.toml inside the PyImageLabeling directory and installs dependencies ("numpy", "pyqt6", "opencv-python", "pillow", "matplotlib").

python3 -m pip install -e .

To launch PyImageLabeling:

python3 -m PyImageLabeling

License

This project is licensed under the MIT License - see the LICENSE file for details.

Use Cases

  • Computer Vision: Create training datasets for object detection and segmentation
  • Medical Imaging: Annotate medical scans and diagnostic images
  • Autonomous Vehicles: Label road scenes and traffic elements
  • Agriculture: Mark crop areas and plant health indicators
  • Quality Control: Identify defects and areas of interest in industrial applications