To upgrade: `pip install 'deeplabcut[gui]'==2.2rc3`
We have updated and refactored major parts of the code base for seamless Tensorflow 2+ integration. This means:
(1) You should update: you can create a new installation from our new conda environment. This is easy, and you can keep your older env for safe keeping! In short, your older projects will work, and new projects will get all the cool advantages of TF2!), but in short its quite a bit easier to build on, so we hope this enables more researchers to play with the base code.
How do I easily update?
Simple: download the NEW conda environment file. You can keep your older DLC-GPU, DLC-CPU for safe keeping. Then, as this is a release candidate, just run: `pip install 'deeplabcut[gui]'==2.2rc3` in this new environment.
(2) deeplabcut-core is depreciated! ✅
(3) The latest NVIDIA GPUs, CUDA, etc are supported! 🥂🙌
(4) We tested it, a lot …. a big shout out to lead developer Dr. Jessy Lauer for the big PR and testing the code across platforms, GPUs, models and TF versions to be sure we did not slow you down! See full PR here: https://github.com/DeepLabCut/DeepLabCut/pull/1323 and here are some take homes:
Benchmarked on 4 datasets (single- and multi-animal, w/ grayscale and color images) with TensorFlow (TF)1.15.5 (which serves as reference), TF2.3, and TF2.5; batch size 8, 30k iterations (except for the marmosets: 20k); 3 backbones (resnet_50, mobilenet_v2_0.5, efficientnet-b0); 2 GPU devices (TITAN RTX & GEFORCE GTX 1080). No significant main effects of either backbone or TF version were found. Training duration is reported relative to TF1 training time (Y axis, and value printed above each bar), and in seconds (underneath/within the bar):
(5) We have new docs to help you with the transition. This is simpler to install in the long run (1 conda file!) and again just requires you have CUDA (and associated cuDNN, see docs!).
Along with this major change there are some excellent updates to the code base for RC3!
For the full change log, see here: https://github.com/DeepLabCut/DeepLabCut/compare/2.2rc2...master
Other highlights include:
- compatibility with matplotlib changes
- New projects created with Japanese character compatibility (thanks bobfromjapan !)
- Support images that are smaller (both sides or one side) than the desired crop size (1318), thanks lab member Shaokai Ye aka yeshaokai !
- Optionally ignore some body parts during tracking (1348) —> this is ideal in maDLC if you have an animal where most body parts are compact, but some far (i.e., the tail of the mouse). You can leverage this!
- better error messages, small 🐛 squashing, and other housekeeping things. Including one regarding destfolders found by new lab member Aristotelis Economides intergalactic-mammoth