Free-LSPIV: A simple image velocimetry tool

This is an image velocimetry tool based on LSPIV methodology. This tool is able of applying image velocimetry directly on videos. It runs on MATLAB (compatible also with Octave version ≥ 5.1).
Please cite [1,2] for the Free-LSPIV algorithm. Details for the LoussiosUpstream and LoussiosDownstream projects can be found in [3].

QUICK START

- Start MATLAB/Octave and go into the folder of the normxcorr2_mex file.
- _Notes.m gives commands to perform (do not run it, copy paste only).
- Slightly different commands for MATLAB/Octave, see comments in _Notes.m.

REFERENCES

1. Rozos, E., Dimitriadis, P., Mazi, K., Lykoudis, S. and Koussis, A., 2020. On the Uncertainty of the Image Velocimetry Method Parameters. Hydrology, 7(3), p.65.

2. Rozos E, Mazi K, Koussis AD. Probabilistic Evaluation and Filtering of Image Velocimetry Measurements. Water. 2021; 13(16):2206. https://doi.org/10.3390/w13162206

3. E. Rozos, K. Mazi, and S. Lykoudis, On the Accuracy of Particle Image Velocimetry with Citizen Videos- Five Typical Case Studies, Hydrology, doi:10.3390/hydrology9050072, 9(5), 72, 2022.

本工具为基于大尺度粒子图像测速法（Large-Scale Particle Image Velocimetry，LSPIV）的图像测速工具，可直接对视频开展图像测速作业，支持在MATLAB环境下运行，同时兼容5.1及以上版本的Octave。使用Free-LSPIV算法时，请引用文献[1,2]；LoussiosUpstream与LoussiosDownstream项目的详细信息可参见文献[3]。

快速入门
- 启动MATLAB/Octave并进入normxcorr2_mex文件所在的目录。
- _Notes.m文件中包含需执行的命令（请勿直接运行该文件，仅需复制粘贴其中的命令即可）。
- MATLAB与Octave的命令存在细微差异，具体可参见_Notes.m文件中的注释说明。

参考文献
1. Rozos, E., Dimitriadis, P., Mazi, K., Lykoudis, S. and Koussis, A., 2020. 图像测速法参数的不确定性分析. Hydrology, 7(3), p.65.
2. Rozos E, Mazi K, Koussis AD. 图像测速测量结果的概率评估与滤波. Water. 2021; 13(16):2206. https://doi.org/10.3390/w13162206
3. E. Rozos, K. Mazi, and S. Lykoudis, 基于民用视频的粒子图像测速精度研究——五个典型案例. Hydrology, doi:10.3390/hydrology9050072, 9(5), 72, 2022.