zamba changelog

v2.0.3 (2022-05-06)

Releasing to pick up #179.

• PR #179 removes the DensePose extra from the default dev requirements and tests. Docs are updated to clarify how to install and run tests for DensePose.

v2.0.2 (2021-12-21)

Releasing to pick up #172.

• PR #172 fixes bug where video loading that uses the YoloX model (all of the built in models) resulted in videos not being able to load.

v2.0.1 (2021-12-15)

Releasing to pick up #167 and #169.

• PR #169 fixes error in splitting data into train/test/val when only a few videos.
• PR #167 refactors yolox into an object_detection module

Other documentation fixes also included.

v2.0.0 (2021-10-22)

Previous model: Machine learning competition

The algorithms used by zamba v1 were based on the winning solution from the Pri-matrix Factorization machine learning competition, hosted by DrivenData. Data for the competition was provided by the Chimp&See project and manually labeled by volunteers. The competition had over 300 participants and over 450 submissions throughout the three month challenge. The v1 algorithm was adapted from the winning competition submission, with some aspects changed during development to improve performance.

The core algorithm in zamba v1 was a stacked ensemble which consisted of a first layer of models that were then combined into a final prediction in a second layer. The first level of the stack consisted of 5 keras deep learning models, whose individual predictions were combined in the second level of the stack to form the final prediction.

In v2, the stacked ensemble algorithm from v1 is replaced with three more powerful single-model options: time_distributed, slowfast, and european. The new models utilize state-of-the-art image and video classification architectures, and are able to outperform the much more computationally intensive stacked ensemble model.

New geographies and species

zamba v2 incorporates data from Western Europe (Germany). The new data is packaged in the pretrained european model, which can predict 11 common European species not present in zamba v1.

zamba v2 also incorporates new training data from 15 countries in central and west Africa, and adds 12 additional species to the pretrained African models.

Retraining flexibility

Model training is made available zamba v2, so users can finetune a pretrained model using their own data to improve performance for a specific ecology or set of sites. zamba v2 also allows users to retrain a model on completely new species labels.