Fish Tracker is an application for semi-automatic tracking and counting of fish in a sonar video. This is a functioning program but also under development.
The easiest way to run the source code is by using Anaconda and a provided yml file to create an environment. At the project root, run:
conda env create --file environment.yml --name fish_tracking
Activate environment:
conda activate fish_tracking
And run the program:
python main.py
- Open *.aris file by choosing "File"→"Open...". Previously saved results (*.fish files) can be opened by choosing "File"→"Load..."
- The application computes a background model for background subtraction and an echogram. The progress of the application is printed on the "Log" tab.
- A vertical line seen in the echogram indicates the currently selected frame, which can be freely selected. The view can be zoomed with the scroll wheel and panned with the right mouse button.
- The quality of the background subtraction can be inspected by choosing the "Background subtraction" icon (topmost icon on the left-hand side of the sonar view).
- If fish seem to disappear from the view, it is recommended to lower the value of the "MOG var threshold" parameter. To confirm the changes, press "Apply Values".
- ”Calculate all” computes all detections for the entire data. "Log" tab can be used to follow the progress.
- "Detections" tab lists all detections in the currently selected frame.
- Detections are combined into counted fish at the "Tracker" tab by choosing "Primary Track". "Log" tab can be used to follow the progress.
- "Tracks" tab lists all the tracked fish from the entire file. The fish list can be edited if needed (change lengths, remove fish, combine paths, etc.)
- Final results can be saved to a file by choosing "File"→"Save as...".
- Detections and tracks can be exported to separate *.csv files by choosing "File"→"Export detections..." and "File"→"Export tracks...".
PyInstaller can be used to bundle the source code into a single package with all the required dependecies. The following command does this based on the configuration file "fish_tracker.spec". At the project root, run:
pyinstaller fish_tracker.spec
or
pyinstaller fish_tracker.spec --noconfirm
so the removal of the previous bundle does not have to be confirmed.
The resulting bundle can be found in the "dist" folder. It includes an executable, "fish_tracker.exe", which can be used to run the program. For easier distribution, an installer can be created using a program called NSIS or similar.
Copyright 2021, VTT Technical research centre of Finland Ltd.
Developed by: Mikael Uimonen and Otto Korkalo
This program is licensed under GNU General Public License version 3.
The above copyright notice and this license notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
The following pieces of software have additional or alternate copyrights, licenses, and/or restrictions:
| Program | Files |
|---|---|
| Fish Tracking | / file_handlers / * / UI / icons / * / file_handler.py / iconsLauncher.py / sonar_widget.py |
| Sort | / sort.py |