UCVTK : a python Useful Computer Vision Tool Kit for us, the vision engineers, who need to be efficient and productive.

We all know that there are now a lot of great and powerful computer vision, machine learning, deep learning, point clouds (and so many more) open source libraries available for anyone. But still, why are we (the vision engineer) still often using some private/commercial products? Because they are "more convenient". It is not just a matter of laziness: we need to be efficient, productive, easy to understand and be understood. During the development phase, but also the debugging, maintenance, bug fixes ... That is my conclusion after working more than 8 years in machine vision and robotics, using very different technologies. I search for a long time, and I am now convinced that we need to make the development, debugging and maintenance of computer vision codes easier, thanks to very useful, non-intrusive, extensible tool kits. That is the aim of this repository. Please, do not hesitate to give you feedback via the issues / via email. Sincerely, Boris Bocquet.

UCVTK helps you with tools, tool kits, functions, interactive GUIs in order to develop, debug, maintain your computer vision python codes in a more efficient, productive and professionnal way. Currently, the features are :

• Easy way to print images in your python console.

• Easy interactive drawing of Region Of Interests (ROIs) on your images.

• Easy interactive blob (connected components) informations and selections on your images.

• Easy interactive histograms showing the grayvalues distributions within a draggable rectangle ROI.

• Todo : grayval line profiles, interactive grayval threshold, interactive blob threshold, integration with IDEs (e.g. Spyder) ... And so much more. Please provide some proposals!

• napari>=0.4.9
• pyqt5
• opencv-python
• matplotlib
• numpy
• mplcursors

Tested with Python 3.8 (and I guess this should work with other python 3 version, if you can install the requirements).

Then you can clone the codes of this repository :

git clone https://github.com/borisboc/UCVTK.git

Install the requirements :

cd UCVTK
python3 pip install -r requirements.txt

You can run the samples (see Testing paragraph). You can call these modules in your own codes. There are currently no better packaging. This will come later.

If you sucessfully installed, you can run the samples in the root folder :

• example_print.py : a very simple and comprehensive example about how to print an image in your python console.
• example_roi.py : a very simple and comprehensive example about how to interactively draw Regions Of Interest on an image.
• example_blobs.py : a more specific (still simple and comprehensive) example about how to interactively get some informations and select blobs (connected components) on an image.
• example_histograms.py : a simple example about how to interactively get the histograms (distributions of grayvalues) inside a draggable rectangle on a color image.

I try to do my best to provide code with a certain level of quality even though python is not my main language. The code is commented and documented. With my IDE, I use some tools to check the syntax. But of course all your proposals and pull requests are welcome !

Please fork, improve and propose your pull request !

This work is definitly NOT to make money on it. My motivations are to provide easy and usefull codes that could help all people like me. Of course you may show your enthusiasm by giving a small donation =>