Skip to content

Commit 9708469

Browse files
author
Justas Birgiolas
committed
Create README.md
1 parent 97b17dc commit 9708469

File tree

1 file changed

+43
-0
lines changed

1 file changed

+43
-0
lines changed

README.md

+43
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,43 @@
1+
# SwarmVision
2+
SwarmVision is a video motion analysis tool to assess the aggregate movement or activity levels of groups or swarms of animals. It is used by behavioral scientists to study the behavior of insects, birds, fish, and other animals. It's free, open-source, and runs on Windows.
3+
4+
##Analyze Video Motion
5+
6+
SwarmVision provides frame-by-frame motion data from any video. Vary the sensitivity to find just the moving objects you want. Amplify the size of the detected motion to quickly spot fast moving objects. Pick between processing speed or accuracy. You can even restrict to a specific region in the video.
7+
8+
![Main UI](https://raw.githubusercontent.com/justasb/SwarmVision/master/Screenshots/Main.JPG)
9+
10+
Motion of fast-moving [stingless bees](https://en.wikipedia.org/wiki/Tetragonisca_angustula) shown in yellow & blue.
11+
12+
##Compare Motion
13+
14+
Have videos with a control and treatment group? Load their motion activity files and compare the two. SwarmVision will also compare parts of the same video. Just load it twice and pick different times in the video to compare.
15+
16+
![SwarmVision Compare Videos UI](https://raw.githubusercontent.com/justasb/SwarmVision/master/Screenshots/Compare.JPG)
17+
18+
##Motion Comparison Statistics
19+
20+
Need to know if the motion between two videos is different in a statistically significant way? Just load the video motion data and click "Compute Statistics". You'll get a the results of a tow-tailed T-Test, including the p-value, and its *** significance. Will also show a chart of the two videos with error bars showing the 0.05 significance thresholds.
21+
22+
![SwarmVision Statistics](https://raw.githubusercontent.com/justasb/SwarmVision/master/Screenshots/Stats.JPG)
23+
24+
#Download - Download, Unzip, & Install
25+
26+
1. [Download the ZIP file](https://github.com/justasb/SwarmVision/raw/master/Download/SwarmVision.zip)
27+
2. Unzip the downloaded file
28+
3. Install by clicking setup.exe
29+
30+
#Problems
31+
If you run into problems, please [report them as issues](https://github.com/justasb/SwarmVision/issues).
32+
33+
#Source
34+
35+
The app is written in C#. To make changes, you will need [.Net Framework](https://www.microsoft.com/net) and [Visual Studio (free)](https://www.visualstudio.com/products/visual-studio-community-vs).
36+
37+
Once you get the [source code](https://github.com/justasb/SwarmVision/tree/master/Source), click on SwarmVision.sln to load the project into Visual Studio. Then click "Start" to launch the app.
38+
39+
If you run into problems, please [report them as issues](https://github.com/justasb/SwarmVision/issues).
40+
41+
#Legal
42+
43+
You may use the app for any purpose (commercial or otherwise) and can modify, copy, and redistribute it as long as you cite me, Justas Birgiolas, as the developer. The app comes with NO WARRANTY.

0 commit comments

Comments
 (0)