|
| 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 | + |
| 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 | + |
| 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 | + |
| 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