colorevo 1.0.0

Analize color evolution in ROIs of videos

colorevo

A Graphical User Interface to register color changes in regions of interest (ROI) of a video source.

The data source can either be a pre-recorded video file or a live stream from an attached camera. The user can interactively define any number of ROIs of arbitrary shapes for which the evolution of their average Hue, Saturation and Brightness values will be independently computed and plotted as a function of time.

The data processing can take place live (i.e while the video is being acquired) and/or later on based on the saved video (which allows the user to re-analyze the same data with different ROIs, for example).

The code is Free Software under the GPL, and written in pure Python. It uses OpenCV for accessing the video source. The Graphical user interface is based on PyQt and PyqtGraph. The video sources are internally converted and stored with HDF5 and processed with numpy.

Install

Using uv (recommended):

1. Install uv (follow the official installation instructions)
2. Use uv to install the latest release of colorevo:

   uv tool install colorevo
   

Tip: to install the latest development version, replace colorevo by git+https://gitlab.com/c-p/colorevo.git@master in the previous command

Using pip

1. Create a python virtual environment (e.g. with conda, or pyhon -m venv or ...) and activate it.
2. Run pip install colorevo

Launch

Run:

colorevo

Credits

This software was originally developed for the CROMAPOC project (DPI2015-68917-R) of the Ministerio de Economia y Competitividad (MINECO, Spain)