|
5 | 5 | 
|
6 | 6 | 
|
7 | 7 |
|
8 |
| -This package contains a DeepLabCut inference pipeline for real-time applications that has minimal (software) dependencies. Thus, it is as easy to install as possible (in particular, on atypical systems like NVIDIA Jetson boards). |
| 8 | +This package contains a [DeepLabCut](http://www.mousemotorlab.org/deeplabcut) inference pipeline for real-time applications that has minimal (software) dependencies. Thus, it is as easy to install as possible (in particular, on atypical systems like [NVIDIA Jetson boards](https://developer.nvidia.com/buy-jetson)). |
9 | 9 |
|
10 | 10 | **Performance:** If you would like to see estimates on how your model might perform given a video size, neural network type, and hardware, please see: https://deeplabcut.github.io/DLC-inferencespeed-benchmark/ And, consider submitting your results too! https://github.com/DeepLabCut/DLC-inferencespeed-benchmark
|
11 | 11 |
|
@@ -66,7 +66,8 @@ dlc_live.get_pose(<your image>)
|
66 | 66 |
|
67 | 67 | ### Benchmarking/Analyzing Exported DeepLabCut Models
|
68 | 68 |
|
69 |
| -DeepLabCut-live offers some analysis tools that allow users to peform the following operations on videos, from python or from the command line: |
| 69 | +DeepLabCut-live offers some analysis tools that allow users to peform the following operations on videos, from python or from the command line: |
| 70 | + |
70 | 71 | 1. Test inference speed across a range of image sizes, downsizing images by specifying the `resize` or `pixels` parameter. Using the `pixels` parameter will resize images to the desired number of `pixels`, without changing the aspect ratio. Results will be saved (along with system info) to a pickle file if you specify an output directory.
|
71 | 72 | ##### python
|
72 | 73 | ```python
|
@@ -98,15 +99,32 @@ dlclive.benchmark_videos('/path/to/exported/model', '/path/to/video', resize=[1.
|
98 | 99 | ```
|
99 | 100 | dlc-live-benchmark /path/to/exported/model /path/to/video -r 0.5 --pcutoff 0.5 --display-radius 4 --cmap bmy --save-poses --save-video
|
100 | 101 | ```
|
101 |
| - |
| 102 | + |
102 | 103 | ### Citation:
|
103 | 104 |
|
104 |
| -If you find our code helpful, please consider citing: |
| 105 | +If you utilize our tool, please cite: |
| 106 | + |
105 | 107 | ```
|
106 | 108 | @Article{Kane2020dlclive,
|
107 | 109 | author = {Kane, Gary and Lopes, Gonçalo and Sanders, Jonny and Mathis, Alexander and Mathis, Mackenzie},
|
108 |
| - title = {Real-time DeepLabCut for closed-loop feedback based on posture}, |
| 110 | + title = {Real-time, low-latency closed-loop feedback using markerless posture tracking}, |
109 | 111 | journal = {BioRxiv},
|
110 | 112 | year = {2020},
|
111 | 113 | }
|
112 | 114 | ```
|
| 115 | + |
| 116 | +## License: |
| 117 | + |
| 118 | +This project is licensed under the GNU Lesser General Public License v3.0. Note that the software is provided "as is", without warranty of any kind, express or implied. If you use the code or data, please cite us! |
| 119 | + |
| 120 | +## Community Support, Developers, & Help: |
| 121 | + |
| 122 | +This is an actively developed package and we welcome community development and involvement. |
| 123 | + |
| 124 | +- We are a community partner on the [](https://forum.image.sc/tags/deeplabcut). Please post help and support questions on the forum with the tag DeepLabCut. Check out their mission statement [Scientific Community Image Forum: A discussion forum for scientific image software](https://journals.plos.org/plosbiology/article?id=10.1371/journal.pbio.3000340). |
| 125 | + |
| 126 | +- If you encounter a previously unreported bug/code issue, please post here (we encourage you to search issues first): https://github.com/DeepLabCut/DeepLabCut-live/issues |
| 127 | + |
| 128 | +- For quick discussions here: [](https://gitter.im/DeepLabCut/community?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge) |
| 129 | + |
| 130 | +- If you want to contribute to the code, please read our guide [here!](https://github.com/DeepLabCut/DeepLabCut/blob/master/CONTRIBUTING.md), which is provided at the main repository of DeepLabCut. |
0 commit comments