Matplotlib Image labeller for classifying images

Last update: Sep 24, 2022

Overview

mpl-image-labeller

Use Matplotlib to label images for classification. Works anywhere Matplotlib does - from the notebook to a standalone gui!

For more see the documentation.

Install

pip install mpl-image-labeller

Key features

Simple interface
Uses keys instead of mouse
Only depends on Matplotlib
- Works anywhere - from inside Jupyter to any supported GUI framework
Displays images with correct aspect ratio
Easily configurable keymap
Smart interactions with default Matplotlib keymap
Callback System (see examples/callbacks.py)

single class per image

multiple classes per image

Usage

import matplotlib.pyplot as plt
import numpy as np

from mpl_image_labeller import image_labeller

images = np.random.randn(5, 10, 10)
labeller = image_labeller(
    images, classes=["good", "bad", "meh"], label_keymap=["a", "s", "d"]
)
plt.show()

accessing the axis You can further modify the image (e.g. add masks over them) by using the plotting methods on axis object accessible by labeller.ax.

Lazy Loading Images If you want to lazy load your images you can provide a function to give the images. This function should take the integer idx as an argument and return the image that corresponds to that index. If you do this then you must also provide N_images in the constructor to let the object know how many images it should expect. See examples/lazy_loading.py for an example.

Controls

<- move one image back
-> move one image forward

To label images use the keys defined in the label_keymap argument - default 0, 1, 2...

Get the labels by accessing the labels property.

Overwriting default keymap

Matplotlib has default keybindings that it applied to all figures via rcparams.keymap that allow for actions such as s to save or q to quit. If you inlcude one of these keys as a shortcut for labelling as a class then that default keymap will be disabled for that figure.

Related Projects

This is not the first project to implement easy image labelling but seems to be the first to do so entirely in Matplotlib. The below projects implement varying degrees of complexity and/or additional features in different frameworks.

Implementation of Common Image Evaluation Metrics by Sayed Nadim (sayednadim.github.io). The repo is built based on full reference image quality metrics such as L1, L2, PSNR, SSIM, LPIPS. and feature-level quality metrics such as FID, IS. It can be used for evaluating image denoising, colorization, inpainting, deraining, dehazing etc. where we have access to ground truth.

Image Quality Evaluation Metrics Implementation of some common full reference image quality metrics. The repo is built based on full reference image q

10 Jan 1, 2023

This repository contains several image-to-image translation models, whcih were tested for RGB to NIR image generation. The models are Pix2Pix, Pix2PixHD, CycleGAN and PointWise.

RGB2NIR_Experimental This repository contains several image-to-image translation models, whcih were tested for RGB to NIR image generation. The models

5 Jan 4, 2023

Official implement of Paper：A deeply supervised image fusion network for change detection in high resolution bi-temporal remote sening images

A deeply supervised image fusion network for change detection in high resolution bi-temporal remote sensing images 深度监督影像融合网络DSIFN用于高分辨率双时相遥感影像变化检测 Of

135 Dec 19, 2022

The first dataset of composite images with rationality score indicating whether the object placement in a composite image is reasonable.

Object-Placement-Assessment-Dataset-OPA Object-Placement-Assessment (OPA) is to verify whether a composite image is plausible in terms of the object p

53 Nov 15, 2022

For auto aligning, cropping, and scaling HR and LR images for training image based neural networks

ImgAlign For auto aligning, cropping, and scaling HR and LR images for training image based neural networks Usage Make sure OpenCV is installed, 'pip

15 Dec 4, 2022

Rename Images with Auto Generated Neural Image Captions

Recaption Images with Generated Neural Image Caption Example Usage: Commandline: Recaption all images from folder /home/feng/Downloads/images to folde

3 May 1, 2022

A python-image-classification web application project, written in Python and served through the Flask Microframework. This Project implements the VGG16 covolutional neural network, through Keras and Tensorflow wrappers, to make predictions on uploaded images.

Image Classification in Python Implementing image classification in Flask using Keras. The VGG16 is a convolution neural network model architecture th

19 Dec 12, 2022

Image-to-Image Translation with Conditional Adversarial Networks (Pix2pix) implementation in keras

pix2pix-keras Pix2pix implementation in keras. Original paper: Image-to-Image Translation with Conditional Adversarial Networks (pix2pix) Paper Author

141 Dec 30, 2022

Learning Continuous Image Representation with Local Implicit Image Function

LIIF This repository contains the official implementation for LIIF introduced in the following paper: Learning Continuous Image Representation with Lo

1k Dec 25, 2022

Comments

BUG: Zooming in on one image messes up display of other images
will need something like:

# make sure the home button will work if hasattr(fig.canvas, "toolbar") and fig.canvas.toolbar is not None: fig.canvas.toolbar.push_current()

but that may also be wrong - may need to pop everytime an image is switched (right before switching) and then push the new one?
opened by ianhi 1
[pre-commit.ci] pre-commit autoupdate
updates:

github.com/asottile/setup-cfg-fmt: v1.17.0 → v1.19.0

github.com/PyCQA/flake8: 3.9.2 → 4.0.1

github.com/PyCQA/isort: 5.8.0 → 5.9.3

github.com/psf/black: 21.5b2 → 21.10b0

github.com/asottile/pyupgrade: v2.19.0 → v2.29.0

github.com/pre-commit/mirrors-mypy: v0.812 → v0.910-1
opened by pre-commit-ci[bot] 1

Releases(1.1.2)

1.1.2(Nov 18, 2022)

Fix a bug wiht one hot encodings

Full Changelog: https://github.com/ianhi/mpl-image-labeller/compare/1.1.1...1.1.2
Source code(tar.gz)
Source code(zip)
1.1.1(Nov 12, 2021)
What's Changed

add github actions test by @ianhi in https://github.com/ianhi/mpl-image-labeller/pull/20

Autoscale cmaps + add tests by @ianhi in https://github.com/ianhi/mpl-image-labeller/pull/21

Updated callbacks example to show how to adjust overlay extent

Full Changelog: https://github.com/ianhi/mpl-image-labeller/compare/1.1.0...1.1.1
Source code(tar.gz)
Source code(zip)
1.1.0(Nov 1, 2021)
What's Changed

Added ability for user to set the title https://github.com/ianhi/mpl-image-labeller/pull/15

Updated text positioning for single class labeller

Full Changelog: https://github.com/ianhi/mpl-image-labeller/compare/1.0.0...1.1.0
Source code(tar.gz)
Source code(zip)
1.0.0(Oct 30, 2021)
Created a docs readthedocs page

Added a multiclass labeller

Ability to use onehot encodings

Source code(tar.gz)
Source code(zip)
0.5.0(Oct 29, 2021)
Fixed xlims getting messed up when zooming in https://github.com/ianhi/mpl-image-labeller/pull/9

Allow passing imshow_kwargs https://github.com/ianhi/mpl-image-labeller/commit/27afa0bf9633c5f59e2d3089f9fef789147e2b3c

Source code(tar.gz)
Source code(zip)
0.4.0(Oct 29, 2021)

Callbacks!
Source code(tar.gz)
Source code(zip)
0.3.0(Oct 27, 2021)

Automatically adjust image extent to preserve the aspect ratio of the image
Source code(tar.gz)
Source code(zip)
0.2.0(Oct 27, 2021)
Full Changelog: https://github.com/ianhi/mpl-image-labeller/compare/0.1.1...0.2.0

Fixes:

init_labels is respected

new features:

ax is not accesible through the .ax attribute

images can now be a callable

Thanks to @jrussell25 for suggesting these improvements
Source code(tar.gz)
Source code(zip)
0.1.1(Oct 27, 2021)

Fix the qwerty keymap - previously it would break #2
Source code(tar.gz)
Source code(zip)

Owner

Ian Hunt-Isaak

The embodiment of entropy - He/Him

GitHub Repository http://mpl-image-labeller.rtfd.io/

基于DouZero定制AI实战欢乐斗地主

DouZero_For_Happy_DouDiZhu: 将DouZero用于欢乐斗地主实战本项目基于DouZero 环境配置请移步项目DouZero 模型默认为WP，更换模型请修改start.py中的模型路径运行main.py即可 SL (baselines/sl/): 基于人类数据进行深度学习

1.5k Jan 08, 2023

Diffgram - Supervised Learning Data Platform

Data Annotation, Data Labeling, Annotation Tooling, Training Data for Machine Learning

1.6k Jan 07, 2023

This repo implements a 3D segmentation task for an airport baggage dataset.

3D CT Scan Segmentation With Occupancy Network This repo implements a 3D superresolution segmentation task for an airport baggage dataset. Our final p

2 Mar 28, 2022

Simple tools for logging and visualizing, loading and training

TNT TNT is a library providing powerful dataloading, logging and visualization utilities for Python. It is closely integrated with PyTorch and is desi

1.5k Jan 02, 2023

A simple python stock Predictor

Python Stock Predictor A simple python stock Predictor Demo Run Locally Clone the project git clone https://github.com/yashraj-n/stock-price-predict

5 Nov 29, 2021

Code for PhySG: Inverse Rendering with Spherical Gaussians for Physics-based Relighting and Material Editing

PhySG: Inverse Rendering with Spherical Gaussians for Physics-based Relighting and Material Editing CVPR 2021. Project page: https://kai-46.github.io/

141 Dec 14, 2022

Res2Net for Instance segmentation and Object detection using MaskRCNN

Res2Net for Instance segmentation and Object detection using MaskRCNN Since the MaskRCNN-benchmark of facebook is deprecated, we suggest to use our mm

55 Oct 30, 2022

Python with OpenCV - MediaPip Framework Hand Detection

Python HandDetection Python with OpenCV - MediaPip Framework Hand Detection Explore the docs » Contact Me About The Project It is a Computer vision pa

2 Jan 07, 2022

Single-step adversarial training (AT) has received wide attention as it proved to be both efficient and robust.

Subspace Adversarial Training Single-step adversarial training (AT) has received wide attention as it proved to be both efficient and robust. However,

15 Sep 02, 2022

RoMa: A lightweight library to deal with 3D rotations in PyTorch.

RoMa: A lightweight library to deal with 3D rotations in PyTorch. RoMa (which stands for Rotation Manipulation) provides differentiable mappings betwe

90 Dec 27, 2022

Justmagic - Use a function as a method with this mystic script, like in Nim

justmagic Use a function as a method with this mystic script, like in Nim. Just

8 Oct 08, 2022

PassAPI is a password generator in hash format and fully developed in Python, with the aim of teaching how to handle and build

simple, elegant and safe Introduction PassAPI is a password generator in hash format and fully developed in Python, with the aim of teaching how to ha

2 Mar 02, 2022

Matplotlib Image labeller for classifying images

Related tags

Overview

mpl-image-labeller

Install

Key features

Usage

Controls

Overwriting default keymap

Related Projects

You might also like...

This repository contains several image-to-image translation models, whcih were tested for RGB to NIR image generation. The models are Pix2Pix, Pix2PixHD, CycleGAN and PointWise.

Official implement of Paper：A deeply supervised image fusion network for change detection in high resolution bi-temporal remote sening images

The first dataset of composite images with rationality score indicating whether the object placement in a composite image is reasonable.

For auto aligning, cropping, and scaling HR and LR images for training image based neural networks

Rename Images with Auto Generated Neural Image Captions

A python-image-classification web application project, written in Python and served through the Flask Microframework. This Project implements the VGG16 covolutional neural network, through Keras and Tensorflow wrappers, to make predictions on uploaded images.

Image-to-Image Translation with Conditional Adversarial Networks (Pix2pix) implementation in keras

Learning Continuous Image Representation with Local Implicit Image Function

Comments

BUG: Zooming in on one image messes up display of other images

[pre-commit.ci] pre-commit autoupdate

Releases(1.1.2)

1.1.2(Nov 18, 2022)

1.1.1(Nov 12, 2021)

What's Changed

1.1.0(Nov 1, 2021)

What's Changed

1.0.0(Oct 30, 2021)

0.5.0(Oct 29, 2021)

0.4.0(Oct 29, 2021)

0.3.0(Oct 27, 2021)

0.2.0(Oct 27, 2021)

0.1.1(Oct 27, 2021)

Owner

Ian Hunt-Isaak

基于DouZero定制AI实战欢乐斗地主

Diffgram - Supervised Learning Data Platform

This repo implements a 3D segmentation task for an airport baggage dataset.

Simple tools for logging and visualizing, loading and training

A simple python stock Predictor

Code for PhySG: Inverse Rendering with Spherical Gaussians for Physics-based Relighting and Material Editing

Res2Net for Instance segmentation and Object detection using MaskRCNN

Python with OpenCV - MediaPip Framework Hand Detection

Single-step adversarial training (AT) has received wide attention as it proved to be both efficient and robust.

RoMa: A lightweight library to deal with 3D rotations in PyTorch.

Justmagic - Use a function as a method with this mystic script, like in Nim

PassAPI is a password generator in hash format and fully developed in Python, with the aim of teaching how to handle and build

This repository includes the official project for the paper: TransMix: Attend to Mix for Vision Transformers.

Copy Paste positive polyp using poisson image blending for medical image segmentation

QAT(quantize aware training) for classification with MQBench

NumQMBasic - A mini-course offered to Undergrad physics students

Film review classification

TensorFlow-based implementation of "Pyramid Scene Parsing Network".

XViT - Space-time Mixing Attention for Video Transformer

scalingscattering