Skip to content

Commit c349140

Browse files
committed
update link and project name
1 parent 608445b commit c349140

File tree

5 files changed

+23
-17
lines changed

5 files changed

+23
-17
lines changed

README.md

Lines changed: 16 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,21 +1,27 @@
1-
[![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/multi-template-matching/mtm-skimage-shapely/main?filepath=tutorials)
1+
[![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/multi-template-matching/mtm-python-oop/main?filepath=tutorials)
22

33
# Multi-Template-Matching
4-
Multi-Template-Matching is a package to perform object-recognition in images using one or several smaller template images.
5-
This implementation relies on the packages scikit-image and shapely, but not on OpenCV contrary to the other implementation originally published.
6-
It is more objcet-oriented, especially it should be easier to adapt to other shapes (detection with rectangular template but outline detected region with a non-rectangular shape), by implementing another type of Detection object.
4+
Multi-Template-Matching is an accessible method to perform object-detection in images using one or several template images for the search.
5+
The strength of the method compared to previously available single-template matching, is that by combining the detections from multiple templates,
6+
one can improve the range of detectable patterns. This helps if you expect variability of the object-perspective in your images, such as rotation, flipping...
7+
The detections from the different templates are not simply combined, they are filtered using Non-Maxima Supression (NMS) to prevent overlapping detections.
78

8-
The template and images should have the same bitdepth (8,16,32-bit) and number of channels (single/Grayscale or RGB).
9-
The main function `MTM.matchTemplates` returns the best predicted locations provided either a score_threshold and/or the expected number of objects in the image.
9+
The python implementations of mtm only perform the detection and filtering with NMS.
10+
For the templates, you can provde a list of images to use. You can also perform geometrical transformation (kind of data augmentation) of existing templates if you expect these transformation in the image (ex: rotation/flipping).
1011

11-
# Installation
12-
Coming soon.
12+
This implementation relies on the packages scikit-image and shapely, but not on OpenCV contrary to the python implementation originally published (and still available).
13+
It is more object-oriented, especially it should be easier to adapt to other shapes (detection with rectangular template but outlining detected region with a non-rectangular shape), by implementing another type of Detection object.
14+
In this implementation the detection are of type `BoundingBox` which is derived from the shapely `Polygon` class. Therefore you can use all functions available for Polygon with a BoundingBox.
15+
16+
The main function `mtm.matchTemplates` returns the best predicted locations provided a scoreThreshold and an optional number of objects expected in the image.
1317

14-
# Documentation
18+
The website of the project https://multi-template-matching.github.io/Multi-Template-Matching/ references most of the information, including presetnations, posters and recorded talks/tutorials.
19+
20+
# Installation
1521
Coming soon.
1622

1723
# Examples
18-
Check out the [jupyter notebook tutorial](https://github.com/multi-template-matching/MultiTemplateMatching-Python/tree/master/tutorials) for some example of how to use the package.
24+
Check out the [jupyter notebook tutorial](https://github.com/multi-template-matching/mtm-python-oop/tree/master/tutorials) for some example of how to use the package.
1925
You can run the tutorials online using Binder, no configuration needed ! (click the Binder banner on top of this page).
2026
To run the tutorials locally, install the package using pip as described above, then clone the repository and unzip it.
2127
Finally open a jupyter-notebook session in the unzipped folder to be able to open and execute the notebook.

setup.cfg

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,14 @@
11
[metadata]
2-
name = mtm-skimage-shapely
2+
name = mtm-oop
33
version = attr: mtm.__version__
44
author = Laurent Thomas
55
author_email = laurent132.thomas@laposte.net
6-
description = Object-recognition in images using multiple templates
6+
description = Object-recognition in images using multiple templates (object-oriented implementation).
77
long_description = file: README.md
88
long_description_content_type = text/markdown
9-
url = https://github.com/multi-template-matching/mtm-skimage-shapely
9+
url = https://github.com/multi-template-matching/mtm-python-oop
1010
project_urls =
11-
Bug Tracker = https://github.com/multi-template-matching/mtm-skimage-shapely/issues
11+
Bug Tracker = https://github.com/multi-template-matching/mtm-python-oop/issues
1212
classifiers =
1313
Programming Language :: Python :: 3
1414
License :: OSI Approved :: MIT License

tutorials/Tutorial1-Introduction.ipynb

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,7 @@
2323
"\n",
2424
"mtm-skimage-shapely python package online - _Tutorial 1: Introduction_ \n",
2525
"Laurent Thomas - 2021 \n",
26-
"https://github.com/multi-template-matching/MultiTemplateMatching-Python/blob/master/tutorials/Tutorial1-Introduction.ipynb\n",
26+
"https://github.com/multi-template-matching/mtm-python-oop/blob/master/tutorials/Tutorial1-Introduction.ipynb\n",
2727
"\n",
2828
"## Let's code !"
2929
]

tutorials/Tutorial2-Template_Augmentation.ipynb

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@
2222
"\n",
2323
"mtm-skimage-shapely python package online tutorial - _Tutorial 2: Template Augmentation_ \n",
2424
"Laurent Thomas - 2021 \n",
25-
"https://github.com/multi-template-matching/MultiTemplateMatching-Python/blob/master/tutorials/Tutorial2-Template_Augmentation.ipynb\n",
25+
"https://github.com/multi-template-matching/mtm-python-oop/blob/master/tutorials/Tutorial2-Template_Augmentation.ipynb\n",
2626
"\n",
2727
"## Let's code !"
2828
]

tutorials/Tutorial3-SpeedingUp.ipynb

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@
1616
"\n",
1717
"Multi-Template Matching python package online tutorial - _III - Speed-up execution_ \n",
1818
"Laurent Thomas - 2019 \n",
19-
"https://github.com/multi-template-matching/MultiTemplateMatching-Python/blob/master/tutorials/Tutorial3-SpeedingUp.ipynb\n",
19+
"https://github.com/multi-template-matching/mtm-python-oop/blob/master/tutorials/Tutorial3-SpeedingUp.ipynb\n",
2020
"\n",
2121
"\n",
2222
"## Let's code !"

0 commit comments

Comments
 (0)