/EcoAssist

Simplify camera trap image analysis with ML species recognition models based around the MegaDetector model

Primary LanguagePythonMIT LicenseMIT

status Project Status: Active The project has reached a stable, usable state and is being actively developed. GitHub GitHub last commit

Official website: https://addaxdatascience.com/ecoassist/

EcoAssist is an application designed to streamline the work of ecologists dealing with camera trap images. It’s an AI platform that allows you to analyse images with machine learning models for automatic detection, offering ecologists a way to save time and focus on conservation efforts.

Cite

Please use the following citations if you used EcoAssist in your research.

EcoAssist

Link to paper

@article{van_Lunteren_EcoAssist_2023,
  author = {van Lunteren, Peter},
  doi = {10.21105/joss.05581},
  journal = {Journal of Open Source Software},
  month = aug,
  number = {88},
  pages = {5581},
  title = {{EcoAssist: A no-code platform to train and deploy custom YOLOv5 object detection models}},
  url = {https://joss.theoj.org/papers/10.21105/joss.05581},
  volume = {8},
  year = {2023}
}
MegaDetector

Link to paper

@article{Beery_Efficient_2019,
  title     = {Efficient Pipeline for Camera Trap Image Review},
  author    = {Beery, Sara and Morris, Dan and Yang, Siyu},
  journal   = {arXiv preprint arXiv:1907.06772},
  year      = {2019}
}

Contribute

Interested in contributing to this project? There are always things to do. Do you feel comfortable handling one of the tasks below? Let me know! And I will guide you in the right direction. Thanks!

  • Improve installation - At the moment users still have to install dependeceies and use CLI. Perferably, we would like to package EcoAssist as a standalone folder with all dependencies.
  • Camtrap DP format - Add a postprocess option to export results to camtrap DP format: https://camtrap-dp.tdwg.org/.
  • Improve human-in-loop - At the moment the human-in-the-loop feature works with two separate windows. Perferably, we would like to merge these two.
  • Sequence smoothing - There is no option to smoothen results based on sequences, yet. Dan Morris has already created the code to do so. This needs to be implemented into the existing workflow.
  • Sequence ID - Add column for unique sequence_id in CSV export.

Uninstall

All files are located in one folder, called EcoAssist_files. You can uninstall EcoAssist by simply deleting this folder. Please be aware that it's hidden, so you'll probably have to adjust your settings before you can see it (find out how to: macOS, Windows, Linux). If you're planning on updating EcoAssist, there is no need to uninstall it first. It will do that automatically.

Location on Windows 
# All users
─── 📁Program Files
    └── 📁EcoAssist_files

# Single user
─── 📁Users
    └── 📁<username>
        └── 📁EcoAssist_files
Location on macOS 
─── 📁Applications
    └── 📁.EcoAssist_files
Location on Linux 
─── 📁home
    └── 📁<username>
        └── 📁.EcoAssist_files