tschnz / Live-Video-Magnification

An OpenCV/Qt based realtime application for Eulerian Video Magnification / Motion Magnification. Works with multiple videos and cameras at the same time and let's you export the magnified videos.
GNU General Public License v3.0
445 stars 104 forks source link
amplification camera color-magnification eulerian-video-magnification image-pyramid motion-amplification motion-magnification movements opencv phase-based qt qtcreator realtime-application realtime-video-magnification riesz riesz-pyramid video video-amplification video-magnification webcam

Live Motion Magnification

An OpenCV/Qt based realtime application for Eulerian Video Magnification. Works with multiple videos and cameras at the same time and let's you export the magnified videos.

Examples

Color Magnified Video

Image shows the color magnified output for a video. In the pictures you can see the effects of the cardiac cycle on the skins color. The upper image shows the skin of the face during a diastole, the lower one during a ventricular systole of the cycle.

Motion Magnified Camerastream

(Un-)Wanted artifacts from a realtime motion magnified camerastream. The strong b/w areas around torso and head are resulting from a fast backwards movement and excessive amplification. The white points (the ones bigger than the noise) on the left side are awhirled dust particles, not visible in the original camera source.

Dependencies

License

This application is licensed under GPLv3, read the LICENSE.

Credits

Thanks to Nick D'Ademo whose qt-opencv-multithreaded application served as basis and to Joseph Pan whose algorithms in the QtEVM application were adapted for this project.

Also take a look at the MITs webpage for Eulerian Video Magnification. They provide demo videos on their page and the team did a fantastic job in researching and developing this field of science.

How do I use it?

Connect

Connect Dialog

Main Window

When succesfully connected to a camera or opened a window, you can draw a box in the video, to scale and only amplify this Region Of Interest in a video source. Setting the video back to normal can be done via menu that opens with a right click in the video. There is also the option to show the unmagnified image besides the processed one.

Right-click Menu in Frame Label

Magnify

Try experimenting with different option values. Furthermore tooltips are provided when hovering the cursor above a text label in the options tab. If you're using an older machine and processing is too slow, try enabling the Grayscale checkbox.

Low Level value High Level value
Color Magnification Slower and more accurate. Too low = no signal detection Faster magnification, inaccurate spatial resolution
Motion Magnification More noise, less movements by big objects Less noise, less movements by little objects

Color Magnification

Note that in the scene, absolutely NO MOVEMENTS are required to process the video correctly.

Panel for Color Magnification Options

Motion Magnification

Panel for Motion Magnification Options

Save

For saving videos or recording from camera you have to specify the file extension by your own. .avi is well supported. If you should encounter problems, please try a differenct saving codec in the toolbar under File->Set Saving Codec.

MainWindow with saving codec menu

How does it work?

The image below provides you the class structure and the dataflow (blue = images, red = options) throughout the application.

Class structure

Algorithm

The algorithms are using a combination of spatial filters (e.g. image pyramids) and temporal filters to determine motions of different spatial wavelength in videos. These can be amplified separately before collapsing the image pyramid and adding the motion image back to the original.

Idea of the Video Magnification Algorithm

Color Magnification

For further informations look at the comments in the .h/.cpp files in /main/magnification/*

Color Magnification UML

Motion Magnification

For further informations look at the comments in the .h/.cpp files in /main/magnification/*

Laplace Magnification UML