Hey guys. I see quite a few of you are having problems using this software, so here is a quick guide. Like I said earlier, this isn't a plug-n-play
experience. You need to put effort both into the video that you use [ensure that the subject, camera, and light sources are all still] as well as the
settings you use. Anyways, this might help some of you.
----------------------------------------------------------
1. Extract the ZIP to a folder. To keep things tidy, extract it to a new folder.
2. You should now have a folder with the following contents:
-changelog [unimportant]
-evm [this is the program, but you will never have to use this, so just leave it be]
-LICENSE [unimportant]
-README [explains how to use the software]
-reproduce_results [batch file]
3. create a folder called "data" and a folder called "results" in the same folder you extracted the ZIP to
The easiest way to use this software is by executing "batch files". A batch file is basically a text file that contains commands. When you extract the
ZIP, it comes with a batch file called "reproduce_results". If you right-click the file, and select "edit" it will open the batch file in notepad, or
whatever your default text editor is.
The batch file that extracts from the ZIP contains the commands needed to reproduce the results that MIT shows on its site. The baby, face, shadow,
wrist etc. It contains a lot of stuff that isn't really important to an amateur users. I'll try and break down the contents the best that I can
though, without dragging this on. I won't cover every single line/command.
----------------------------------------------------------
-":: Windows Batch Script for generating example results" - This is simply a "comment". Anything in the batch file that follows two colons "::" does
not actually execute anything. It is just a note. If you want, you can just get rid of these to make the file a bit easier on the eyes.
Everything between "set f=evm" and "mkdir %RDIR%" is necessary. It is just for finding, calling, defining directories and other boring stuff. Don't
change any of this unless you know what you're doing.
This is the part that we will actually play with.
-"set inFile=%SDIR%/file.mov" - This is just a bunch of coding jargon that essentially finds/defines the file that the program will analyse. In your
batch file, it will probably say "baby.mp4" or something like that. This line has to have the name and correct filetype in order for the software to
actually find and choose the video that it will analyse. With all my batch files, I have the filetypes set to "file.mov" and "file.mp4". When I want
to analyse a video, I drop it into the "data" folder that I made, rename it "file" and then double click the batch file. Simple.
-"%f% %inFile% %RDIR%" - This here is again just a bunch of nifty coding. %f% is just the EVM program, and %inFile% is just the file name and type,
%RDIR% is just the directory to save the file to etc. All this can be left alone, as it is all defined in earlier bits of the script.
And finally, the fun bits. "30 color 140/60 160/60 150 ideal 1 6". These are the actually parameters for the analysis. The "README" actually lays out
and defines all these terms plainly for us.
EVM_BIN vidFile outDir samplingRate magType lo cutoff hi cutoff alpha filterType [mag par]
vidFile: the input video file
outDir: directory under which the output video will be stored (the actual
name of the output video file is set automatically according to the
choice of filter, amplification, etc.)
samplingRate: the sampling frequency of video [Hz] (notice this may be different
from the frame rate of the actual video file)
magType: type of magnification (without quotes):
"color": for amplifying color
"motion": for amplifying motion
lo: low frequency cutoff [Hz]
hi: high frequency cutoff [Hz]
alpha: amplification factor
filterType: the type of temporal filter (without quotes)
"ideal" [default]
"butter"
----------------------------------------------------------
So there you go. The readme will explain some stuff in better detail, like the magnification parameters. Also note that the lo and hi cutoffs are
written as fractions in the default batch, but the software accepts plain decimals too. Just play around with it. I'll post an example batch file
below, so you guys have an easy place to start from. Everything will be good to go, and you can just tweak the settings. Just make a copy of the
"reproduce_results" batch, erase all the text inside, and copy what I've pasted below. Everything from "@echo" and down. Then save the batch, put a
video in the data folder, call the video "file", and then run the batch file. That's it! If it doesn't work, check the filetype. The batch below is
set to use .mp4 files, so if you are using .mov or some other file, just change that one part in the batch file. Note that the space after "C:" is
added by me, because it is interpretted as a emoticon and then lost in copy/paste. So just make sure to remove spaces in "C: P".
@echo off
::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
set f=evm
set SDIR=./data
set MCR=C: Program FilesMATLABMATLAB Compiler Runtimev80runtimewin64
set PATH=%MCR%;%PATH%
set verNum=v80
set RDIR=Results
mkdir %RDIR%
::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
::----------------------------------------------------------
set inFile=%SDIR%/file.mp4
call:printFun
%f% %inFile% %RDIR% 30 color 2 2.4 50 ideal 1 4
:: printing helper Function, should NOT come before all others
:printFun
echo Processing %inFile%
echo.
goto:eof
:: MCR verNum:v80
:: MCR defaultPath: C: Program FilesMATLABMATLAB Compiler Runtimev80
----------------------------------------------------------
Hope this helps folks. I'm excited to what what this community does with this software!
edit on 24-3-2014 by LeviWardrobe because: (no
reason given)
edit on 24-3-2014 by LeviWardrobe because: (no reason given)
edit on 24-3-2014 by LeviWardrobe because:
(no reason given)