automatic import of python-us2deepposekit

3 files changed, 545 insertions, 0 deletions

diff --git a/.gitignore b/.gitignore
index e69de29..d60b5b7 100644
--- a/.gitignore
+++ b/.gitignore
@@ -0,0 +1 @@
+/us2deepposekit-0.3.9.tar.gz
diff --git a/python-us2deepposekit.spec b/python-us2deepposekit.spec
new file mode 100644
index 0000000..ac2b955
--- /dev/null
+++ b/python-us2deepposekit.spec
@@ -0,0 +1,543 @@
+%global _empty_manifest_terminate_build 0
+Name:		python-us2deepposekit
+Version:	0.3.9
+Release:	1
+Summary:	a toolkit for pose estimation using deep learning
+License:	Apache 2.0
+URL:		https://github.com/morbitech1/deepposekit
+Source0:	https://mirrors.nju.edu.cn/pypi/web/packages/e1/87/192422312a8c78d34031b99ab71be81199c80ca4400d624b080eb7c1ca3c/us2deepposekit-0.3.9.tar.gz
+BuildArch:	noarch
+
+
+%description
+<p align="center">
+<img src="https://github.com/jgraving/DeepPoseKit/blob/master/assets/deepposekit_logo.png" height="320px">
+</p>
+
+# You have just found DeepPoseKit.
+<p align="center">
+<img src="https://github.com/jgraving/jgraving.github.io/blob/master/files/images/Figure1video1.gif" height="128px">
+</p>
+
+DeepPoseKit is a software toolkit with a high-level API for 2D pose estimation of user-defined keypoints using deep learning—written in Python and built using [Tensorflow](https://github.com/tensorflow/tensorflow) and [Keras](https://www.tensorflow.org/guide/keras). Use DeepPoseKit if you need:
+
+- tools for annotating images or video frames with user-defined keypoints
+- a straightforward but flexible data augmentation pipeline using the [imgaug package](https://github.com/aleju/imgaug)
+- a Keras-based interface for initializing, training, and evaluating pose estimation models
+- easy-to-use methods for saving and loading models and making predictions on new data
+
+DeepPoseKit is designed with a focus on *usability* and *extensibility*, as being able to go from idea to result with the least possible delay is key to doing good research.
+
+DeepPoseKit is currently limited to *individual pose estimation*. If individuals can be easily distinguished visually (i.e., they have differently colored bodies or are marked in some way), then multiple individuals can simply be labeled with separate keypoints (head1, tail1, head2, tail2, etc.). Otherwise DeepPoseKit can be extended to multiple individuals by first localizing, tracking, and cropping individuals with additional software such as [idtracker.ai](https://idtracker.ai/), [pinpoint](https://github.com/jgraving/pinpoint), or [Tracktor](https://github.com/vivekhsridhar/tracktor).
+
+Localization (without tracking) can also be achieved with deep learning software like [keras-retinanet](https://github.com/fizyr/keras-retinanet), the [Tensorflow Object Detection API](https://github.com/tensorflow/models/tree/master/research/object_detection), or [MatterPort's Mask R-CNN](https://github.com/matterport/Mask_RCNN).
+
+[Check out our paper](https://doi.org/10.7554/eLife.47994) to find out more.
+
+<p align="center">
+<img src="https://github.com/jgraving/jgraving.github.io/blob/master/files/images/zebra.gif" height="256px">
+<img src="https://github.com/jgraving/jgraving.github.io/blob/master/files/images/locust.gif" height="256px">
+</p>
+
+# How to use DeepPoseKit
+
+DeepPoseKit is designed for easy use. For example, training and saving a model requires only a few lines of code:
+```python
+from deepposekit.io import DataGenerator, TrainingGenerator
+from deepposekit.models import StackedDenseNet
+
+data_generator = DataGenerator('/path/to/annotation_data.h5')
+train_generator = TrainingGenerator(data_generator)
+model = StackedDenseNet(train_generator)
+model.fit(batch_size=16, n_workers=8)
+model.save('/path/to/saved_model.h5')
+```
+Loading a trained model and running predictions on new data is also straightforward. For example, running predictions on a new video:
+```python
+from deepposekit.models import load_model
+from deepposekit.io import VideoReader
+
+model = load_model('/path/to/saved_model.h5')
+reader = VideoReader('/path/to/video.mp4')
+predictions = model.predict(reader)
+```
+
+## Using DeepPoseKit is a 4-step process:
+
+- **1.** [Create an annotation set](https://github.com/jgraving/DeepPoseKit/blob/master/examples/step1_create_annotation_set.ipynb) <a href="https://colab.research.google.com/github/jgraving/deepposekit/blob/master/examples/step1_create_annotation_set.ipynb" target="_parent"><img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open In Colab"/></a>
+- **2.** [Annotate your data](https://github.com/jgraving/DeepPoseKit/blob/master/examples/step2_annotate_data.ipynb) with our built-in GUI (no Colab support)
+- **3.** [Select and train](https://github.com/jgraving/DeepPoseKit/blob/master/examples/step3_train_model.ipynb) one our [pose estimation models](http://jakegraving.com/DeepPoseKit/html/deepposekit/models/index.html) including [`StackedDenseNet`](http://jakegraving.com/DeepPoseKit/html/deepposekit/models/StackedDenseNet.html), [`StackedHourglass`](http://jakegraving.com/DeepPoseKit/html/deepposekit/models/StackedHourglass.html), [`DeepLabCut`](http://jakegraving.com/DeepPoseKit/html/deepposekit/models/DeepLabCut.html), and [`LEAP`](http://jakegraving.com/DeepPoseKit/html/deepposekit/models/LEAP.html). <a href="https://colab.research.google.com/github/jgraving/deepposekit/blob/master/examples/step3_train_model.ipynb" target="_parent"><img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open In Colab"/></a>
+- **4.** Use the trained model to:
+	- a) [Initialize keypoints for unannotated data](https://github.com/jgraving/DeepPoseKit/blob/master/examples/step4a_initialize_annotations.ipynb) for faster annotations with *active learning*. <a href="https://colab.research.google.com/github/jgraving/deepposekit/blob/master/examples/step4a_initialize_annotations.ipynb" target="_parent"><img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open In Colab"/></a>
+	- b) [Predict on new data and refine the training set](https://github.com/jgraving/DeepPoseKit/blob/master/examples/step4b_predict_new_data.ipynb) to improve performance. <a href="https://colab.research.google.com/github/jgraving/deepposekit/blob/master/examples/step4b_predict_new_data.ipynb" target="_parent"><img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open In Colab"/></a>
+
+## For more details:
+
+- See [our example notebooks](https://github.com/jgraving/deepposekit/blob/master/examples/)
+- Check the [documentation](http://docs.deepposekit.org)
+- Read [our paper](https://doi.org/10.7554/eLife.47994)
+
+## "I already have annotated data"
+
+DeepPoseKit is designed to be extensible, so loading data in other formats is possible.
+
+If you have annotated data from DeepLabCut (http://deeplabcut.org), try [our (experimental) example notebook ](https://github.com/jgraving/DeepPoseKit/blob/master/examples/deeplabcut_data_example.ipynb) for loading data in this format. <a href="https://colab.research.google.com/github/jgraving/deepposekit/blob/master/examples/deeplabcut_data_example.ipynb" target="_parent"><img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open In Colab"/></a>
+
+Have data in another format? You can write your own custom generator to load it.
+Check out the [example for writing custom data generators](https://github.com/jgraving/DeepPoseKit/blob/master/examples/custom_data_generator.ipynb). <a href="https://colab.research.google.com/github/jgraving/deepposekit/blob/master/examples/custom_data_generator.ipynb" target="_parent"><img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open In Colab"/></a>
+
+# Installation
+
+DeepPoseKit requires [Tensorflow](https://github.com/tensorflow/tensorflow) for training and using pose estimation models. [Tensorflow](https://github.com/tensorflow/tensorflow) should be manually installed, along with dependencies such as CUDA and cuDNN, before installing DeepPoseKit:
+
+- [Tensorflow Installation Instructions](https://www.tensorflow.org/install)
+- Any Tensorflow version >=1.13.0 should be compatible (including 2.0).
+
+DeepPoseKit has only been tested on Ubuntu 18.04, which is the recommended system for using the toolkit. 
+
+Install the latest stable release with pip:
+```bash
+pip install --update deepposekit
+```
+
+Install the latest development version with pip:
+```bash
+pip install --update git+https://www.github.com/jgraving/deepposekit.git
+```
+
+You can download example datasets from our [DeepPoseKit Data](https://github.com/jgraving/deepposekit-data) repository:
+```bash
+git clone https://www.github.com/jgraving/deepposekit-data
+```
+
+## Installing with Anaconda on Windows
+
+To install DeepPoseKit on Windows, you must first manually install `Shapely`, one of the dependencies for the [imgaug package](https://github.com/aleju/imgaug):
+```bash
+conda install -c conda-forge shapely
+```
+We also recommend installing DeepPoseKit from within Python rather than using the command line, either from within Jupyter or another IDE, to ensure it is installed in the correct working environment:
+```python
+import sys
+!{sys.executable} -m pip install --update deepposekit
+```
+# Contributors and Development  
+   
+DeepPoseKit was developed by [Jake Graving](https://github.com/jgraving) and [Daniel Chae](https://github.com/dchaebae), and is still being actively developed. .
+
+We welcome community involvement and public contributions to the toolkit. If you wish to contribute, please [fork the repository](https://help.github.com/en/articles/fork-a-repo) to make your modifications and [submit a pull request](https://help.github.com/en/articles/creating-a-pull-request-from-a-fork).
+
+If you'd like to get involved with developing DeepPoseKit, get in touch (jgraving@gmail.com) and check out [our development roadmap](https://github.com/jgraving/DeepPoseKit/blob/master/DEVELOPMENT.md) to see future plans for the package.  
+
+# Issues  
+ 
+Please submit bugs or feature requests to the [GitHub issue tracker](https://github.com/jgraving/deepposekit/issues/new). Please limit reported issues to the DeepPoseKit codebase and provide as much detail as you can with a minimal working example if possible.
+
+If you experience problems with [Tensorflow](https://github.com/tensorflow/tensorflow), such as installing CUDA or cuDNN dependencies, then please direct issues to those development teams.
+
+# License
+
+Released under a Apache 2.0 License. See [LICENSE](https://github.com/jgraving/deepposekit/blob/master/LICENSE) for details.
+
+# References
+
+If you use DeepPoseKit for your research please cite [our open-access paper](http://paper.deepposekit.org):
+
+    @article{graving2019deepposekit,
+             title={DeepPoseKit, a software toolkit for fast and robust animal pose estimation using deep learning},
+             author={Graving, Jacob M and Chae, Daniel and Naik, Hemal and Li, Liang and Koger, Benjamin and Costelloe, Blair R and Couzin, Iain D},
+             journal={eLife},
+             volume={8},
+             pages={e47994},
+             year={2019},
+             publisher={eLife Sciences Publications Limited}
+             url={https://doi.org/10.7554/eLife.47994},
+             }
+
+You can also read [our open-access preprint](http://preprint.deepposekit.org).
+
+If you use the [imgaug package](https://github.com/aleju/imgaug) for data augmentation, please also consider [citing it](https://github.com/aleju/imgaug/blob/master/README.md#citation).
+
+If you [use data](https://github.com/jgraving/DeepPoseKit#i-already-have-annotated-data) that was annotated with the DeepLabCut package (http://deeplabcut.org) for your research, be sure to [cite it](https://github.com/AlexEMG/DeepLabCut/blob/master/README.md#references).
+
+Please also consider citing the relevant references for the pose estimation model(s) used in your research, which can be found in the documentation (i.e., [`StackedDenseNet`](http://jakegraving.com/DeepPoseKit/html/deepposekit/models/StackedDenseNet.html#references), [`StackedHourglass`](http://jakegraving.com/DeepPoseKit/html/deepposekit/models/StackedHourglass.html#references), [`DeepLabCut`](http://jakegraving.com/DeepPoseKit/html/deepposekit/models/DeepLabCut.html#references), [`LEAP`](http://jakegraving.com/DeepPoseKit/html/deepposekit/models/LEAP.html#references)).
+
+# News
+- **October 2019:** Our paper describing DeepPoseKit is published at eLife! (http://paper.deepposekit.org)
+- **September 2019**: 
+    - Nature News covers DeepPoseKit: [Deep learning powers a motion-tracking revolution](http://doi.org/10.1038/d41586-019-02942-5)
+    - v0.3.0 is released. See [the release notes](https://github.com/jgraving/DeepPoseKit/releases/tag/v0.3.0).
+- **April 2019:** The DeepPoseKit preprint is on biorxiv (http://preprint.deepposekit.org)
+
+%package -n python3-us2deepposekit
+Summary:	a toolkit for pose estimation using deep learning
+Provides:	python-us2deepposekit
+BuildRequires:	python3-devel
+BuildRequires:	python3-setuptools
+BuildRequires:	python3-pip
+%description -n python3-us2deepposekit
+<p align="center">
+<img src="https://github.com/jgraving/DeepPoseKit/blob/master/assets/deepposekit_logo.png" height="320px">
+</p>
+
+# You have just found DeepPoseKit.
+<p align="center">
+<img src="https://github.com/jgraving/jgraving.github.io/blob/master/files/images/Figure1video1.gif" height="128px">
+</p>
+
+DeepPoseKit is a software toolkit with a high-level API for 2D pose estimation of user-defined keypoints using deep learning—written in Python and built using [Tensorflow](https://github.com/tensorflow/tensorflow) and [Keras](https://www.tensorflow.org/guide/keras). Use DeepPoseKit if you need:
+
+- tools for annotating images or video frames with user-defined keypoints
+- a straightforward but flexible data augmentation pipeline using the [imgaug package](https://github.com/aleju/imgaug)
+- a Keras-based interface for initializing, training, and evaluating pose estimation models
+- easy-to-use methods for saving and loading models and making predictions on new data
+
+DeepPoseKit is designed with a focus on *usability* and *extensibility*, as being able to go from idea to result with the least possible delay is key to doing good research.
+
+DeepPoseKit is currently limited to *individual pose estimation*. If individuals can be easily distinguished visually (i.e., they have differently colored bodies or are marked in some way), then multiple individuals can simply be labeled with separate keypoints (head1, tail1, head2, tail2, etc.). Otherwise DeepPoseKit can be extended to multiple individuals by first localizing, tracking, and cropping individuals with additional software such as [idtracker.ai](https://idtracker.ai/), [pinpoint](https://github.com/jgraving/pinpoint), or [Tracktor](https://github.com/vivekhsridhar/tracktor).
+
+Localization (without tracking) can also be achieved with deep learning software like [keras-retinanet](https://github.com/fizyr/keras-retinanet), the [Tensorflow Object Detection API](https://github.com/tensorflow/models/tree/master/research/object_detection), or [MatterPort's Mask R-CNN](https://github.com/matterport/Mask_RCNN).
+
+[Check out our paper](https://doi.org/10.7554/eLife.47994) to find out more.
+
+<p align="center">
+<img src="https://github.com/jgraving/jgraving.github.io/blob/master/files/images/zebra.gif" height="256px">
+<img src="https://github.com/jgraving/jgraving.github.io/blob/master/files/images/locust.gif" height="256px">
+</p>
+
+# How to use DeepPoseKit
+
+DeepPoseKit is designed for easy use. For example, training and saving a model requires only a few lines of code:
+```python
+from deepposekit.io import DataGenerator, TrainingGenerator
+from deepposekit.models import StackedDenseNet
+
+data_generator = DataGenerator('/path/to/annotation_data.h5')
+train_generator = TrainingGenerator(data_generator)
+model = StackedDenseNet(train_generator)
+model.fit(batch_size=16, n_workers=8)
+model.save('/path/to/saved_model.h5')
+```
+Loading a trained model and running predictions on new data is also straightforward. For example, running predictions on a new video:
+```python
+from deepposekit.models import load_model
+from deepposekit.io import VideoReader
+
+model = load_model('/path/to/saved_model.h5')
+reader = VideoReader('/path/to/video.mp4')
+predictions = model.predict(reader)
+```
+
+## Using DeepPoseKit is a 4-step process:
+
+- **1.** [Create an annotation set](https://github.com/jgraving/DeepPoseKit/blob/master/examples/step1_create_annotation_set.ipynb) <a href="https://colab.research.google.com/github/jgraving/deepposekit/blob/master/examples/step1_create_annotation_set.ipynb" target="_parent"><img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open In Colab"/></a>
+- **2.** [Annotate your data](https://github.com/jgraving/DeepPoseKit/blob/master/examples/step2_annotate_data.ipynb) with our built-in GUI (no Colab support)
+- **3.** [Select and train](https://github.com/jgraving/DeepPoseKit/blob/master/examples/step3_train_model.ipynb) one our [pose estimation models](http://jakegraving.com/DeepPoseKit/html/deepposekit/models/index.html) including [`StackedDenseNet`](http://jakegraving.com/DeepPoseKit/html/deepposekit/models/StackedDenseNet.html), [`StackedHourglass`](http://jakegraving.com/DeepPoseKit/html/deepposekit/models/StackedHourglass.html), [`DeepLabCut`](http://jakegraving.com/DeepPoseKit/html/deepposekit/models/DeepLabCut.html), and [`LEAP`](http://jakegraving.com/DeepPoseKit/html/deepposekit/models/LEAP.html). <a href="https://colab.research.google.com/github/jgraving/deepposekit/blob/master/examples/step3_train_model.ipynb" target="_parent"><img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open In Colab"/></a>
+- **4.** Use the trained model to:
+	- a) [Initialize keypoints for unannotated data](https://github.com/jgraving/DeepPoseKit/blob/master/examples/step4a_initialize_annotations.ipynb) for faster annotations with *active learning*. <a href="https://colab.research.google.com/github/jgraving/deepposekit/blob/master/examples/step4a_initialize_annotations.ipynb" target="_parent"><img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open In Colab"/></a>
+	- b) [Predict on new data and refine the training set](https://github.com/jgraving/DeepPoseKit/blob/master/examples/step4b_predict_new_data.ipynb) to improve performance. <a href="https://colab.research.google.com/github/jgraving/deepposekit/blob/master/examples/step4b_predict_new_data.ipynb" target="_parent"><img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open In Colab"/></a>
+
+## For more details:
+
+- See [our example notebooks](https://github.com/jgraving/deepposekit/blob/master/examples/)
+- Check the [documentation](http://docs.deepposekit.org)
+- Read [our paper](https://doi.org/10.7554/eLife.47994)
+
+## "I already have annotated data"
+
+DeepPoseKit is designed to be extensible, so loading data in other formats is possible.
+
+If you have annotated data from DeepLabCut (http://deeplabcut.org), try [our (experimental) example notebook ](https://github.com/jgraving/DeepPoseKit/blob/master/examples/deeplabcut_data_example.ipynb) for loading data in this format. <a href="https://colab.research.google.com/github/jgraving/deepposekit/blob/master/examples/deeplabcut_data_example.ipynb" target="_parent"><img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open In Colab"/></a>
+
+Have data in another format? You can write your own custom generator to load it.
+Check out the [example for writing custom data generators](https://github.com/jgraving/DeepPoseKit/blob/master/examples/custom_data_generator.ipynb). <a href="https://colab.research.google.com/github/jgraving/deepposekit/blob/master/examples/custom_data_generator.ipynb" target="_parent"><img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open In Colab"/></a>
+
+# Installation
+
+DeepPoseKit requires [Tensorflow](https://github.com/tensorflow/tensorflow) for training and using pose estimation models. [Tensorflow](https://github.com/tensorflow/tensorflow) should be manually installed, along with dependencies such as CUDA and cuDNN, before installing DeepPoseKit:
+
+- [Tensorflow Installation Instructions](https://www.tensorflow.org/install)
+- Any Tensorflow version >=1.13.0 should be compatible (including 2.0).
+
+DeepPoseKit has only been tested on Ubuntu 18.04, which is the recommended system for using the toolkit. 
+
+Install the latest stable release with pip:
+```bash
+pip install --update deepposekit
+```
+
+Install the latest development version with pip:
+```bash
+pip install --update git+https://www.github.com/jgraving/deepposekit.git
+```
+
+You can download example datasets from our [DeepPoseKit Data](https://github.com/jgraving/deepposekit-data) repository:
+```bash
+git clone https://www.github.com/jgraving/deepposekit-data
+```
+
+## Installing with Anaconda on Windows
+
+To install DeepPoseKit on Windows, you must first manually install `Shapely`, one of the dependencies for the [imgaug package](https://github.com/aleju/imgaug):
+```bash
+conda install -c conda-forge shapely
+```
+We also recommend installing DeepPoseKit from within Python rather than using the command line, either from within Jupyter or another IDE, to ensure it is installed in the correct working environment:
+```python
+import sys
+!{sys.executable} -m pip install --update deepposekit
+```
+# Contributors and Development  
+   
+DeepPoseKit was developed by [Jake Graving](https://github.com/jgraving) and [Daniel Chae](https://github.com/dchaebae), and is still being actively developed. .
+
+We welcome community involvement and public contributions to the toolkit. If you wish to contribute, please [fork the repository](https://help.github.com/en/articles/fork-a-repo) to make your modifications and [submit a pull request](https://help.github.com/en/articles/creating-a-pull-request-from-a-fork).
+
+If you'd like to get involved with developing DeepPoseKit, get in touch (jgraving@gmail.com) and check out [our development roadmap](https://github.com/jgraving/DeepPoseKit/blob/master/DEVELOPMENT.md) to see future plans for the package.  
+
+# Issues  
+ 
+Please submit bugs or feature requests to the [GitHub issue tracker](https://github.com/jgraving/deepposekit/issues/new). Please limit reported issues to the DeepPoseKit codebase and provide as much detail as you can with a minimal working example if possible.
+
+If you experience problems with [Tensorflow](https://github.com/tensorflow/tensorflow), such as installing CUDA or cuDNN dependencies, then please direct issues to those development teams.
+
+# License
+
+Released under a Apache 2.0 License. See [LICENSE](https://github.com/jgraving/deepposekit/blob/master/LICENSE) for details.
+
+# References
+
+If you use DeepPoseKit for your research please cite [our open-access paper](http://paper.deepposekit.org):
+
+    @article{graving2019deepposekit,
+             title={DeepPoseKit, a software toolkit for fast and robust animal pose estimation using deep learning},
+             author={Graving, Jacob M and Chae, Daniel and Naik, Hemal and Li, Liang and Koger, Benjamin and Costelloe, Blair R and Couzin, Iain D},
+             journal={eLife},
+             volume={8},
+             pages={e47994},
+             year={2019},
+             publisher={eLife Sciences Publications Limited}
+             url={https://doi.org/10.7554/eLife.47994},
+             }
+
+You can also read [our open-access preprint](http://preprint.deepposekit.org).
+
+If you use the [imgaug package](https://github.com/aleju/imgaug) for data augmentation, please also consider [citing it](https://github.com/aleju/imgaug/blob/master/README.md#citation).
+
+If you [use data](https://github.com/jgraving/DeepPoseKit#i-already-have-annotated-data) that was annotated with the DeepLabCut package (http://deeplabcut.org) for your research, be sure to [cite it](https://github.com/AlexEMG/DeepLabCut/blob/master/README.md#references).
+
+Please also consider citing the relevant references for the pose estimation model(s) used in your research, which can be found in the documentation (i.e., [`StackedDenseNet`](http://jakegraving.com/DeepPoseKit/html/deepposekit/models/StackedDenseNet.html#references), [`StackedHourglass`](http://jakegraving.com/DeepPoseKit/html/deepposekit/models/StackedHourglass.html#references), [`DeepLabCut`](http://jakegraving.com/DeepPoseKit/html/deepposekit/models/DeepLabCut.html#references), [`LEAP`](http://jakegraving.com/DeepPoseKit/html/deepposekit/models/LEAP.html#references)).
+
+# News
+- **October 2019:** Our paper describing DeepPoseKit is published at eLife! (http://paper.deepposekit.org)
+- **September 2019**: 
+    - Nature News covers DeepPoseKit: [Deep learning powers a motion-tracking revolution](http://doi.org/10.1038/d41586-019-02942-5)
+    - v0.3.0 is released. See [the release notes](https://github.com/jgraving/DeepPoseKit/releases/tag/v0.3.0).
+- **April 2019:** The DeepPoseKit preprint is on biorxiv (http://preprint.deepposekit.org)
+
+%package help
+Summary:	Development documents and examples for us2deepposekit
+Provides:	python3-us2deepposekit-doc
+%description help
+<p align="center">
+<img src="https://github.com/jgraving/DeepPoseKit/blob/master/assets/deepposekit_logo.png" height="320px">
+</p>
+
+# You have just found DeepPoseKit.
+<p align="center">
+<img src="https://github.com/jgraving/jgraving.github.io/blob/master/files/images/Figure1video1.gif" height="128px">
+</p>
+
+DeepPoseKit is a software toolkit with a high-level API for 2D pose estimation of user-defined keypoints using deep learning—written in Python and built using [Tensorflow](https://github.com/tensorflow/tensorflow) and [Keras](https://www.tensorflow.org/guide/keras). Use DeepPoseKit if you need:
+
+- tools for annotating images or video frames with user-defined keypoints
+- a straightforward but flexible data augmentation pipeline using the [imgaug package](https://github.com/aleju/imgaug)
+- a Keras-based interface for initializing, training, and evaluating pose estimation models
+- easy-to-use methods for saving and loading models and making predictions on new data
+
+DeepPoseKit is designed with a focus on *usability* and *extensibility*, as being able to go from idea to result with the least possible delay is key to doing good research.
+
+DeepPoseKit is currently limited to *individual pose estimation*. If individuals can be easily distinguished visually (i.e., they have differently colored bodies or are marked in some way), then multiple individuals can simply be labeled with separate keypoints (head1, tail1, head2, tail2, etc.). Otherwise DeepPoseKit can be extended to multiple individuals by first localizing, tracking, and cropping individuals with additional software such as [idtracker.ai](https://idtracker.ai/), [pinpoint](https://github.com/jgraving/pinpoint), or [Tracktor](https://github.com/vivekhsridhar/tracktor).
+
+Localization (without tracking) can also be achieved with deep learning software like [keras-retinanet](https://github.com/fizyr/keras-retinanet), the [Tensorflow Object Detection API](https://github.com/tensorflow/models/tree/master/research/object_detection), or [MatterPort's Mask R-CNN](https://github.com/matterport/Mask_RCNN).
+
+[Check out our paper](https://doi.org/10.7554/eLife.47994) to find out more.
+
+<p align="center">
+<img src="https://github.com/jgraving/jgraving.github.io/blob/master/files/images/zebra.gif" height="256px">
+<img src="https://github.com/jgraving/jgraving.github.io/blob/master/files/images/locust.gif" height="256px">
+</p>
+
+# How to use DeepPoseKit
+
+DeepPoseKit is designed for easy use. For example, training and saving a model requires only a few lines of code:
+```python
+from deepposekit.io import DataGenerator, TrainingGenerator
+from deepposekit.models import StackedDenseNet
+
+data_generator = DataGenerator('/path/to/annotation_data.h5')
+train_generator = TrainingGenerator(data_generator)
+model = StackedDenseNet(train_generator)
+model.fit(batch_size=16, n_workers=8)
+model.save('/path/to/saved_model.h5')
+```
+Loading a trained model and running predictions on new data is also straightforward. For example, running predictions on a new video:
+```python
+from deepposekit.models import load_model
+from deepposekit.io import VideoReader
+
+model = load_model('/path/to/saved_model.h5')
+reader = VideoReader('/path/to/video.mp4')
+predictions = model.predict(reader)
+```
+
+## Using DeepPoseKit is a 4-step process:
+
+- **1.** [Create an annotation set](https://github.com/jgraving/DeepPoseKit/blob/master/examples/step1_create_annotation_set.ipynb) <a href="https://colab.research.google.com/github/jgraving/deepposekit/blob/master/examples/step1_create_annotation_set.ipynb" target="_parent"><img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open In Colab"/></a>
+- **2.** [Annotate your data](https://github.com/jgraving/DeepPoseKit/blob/master/examples/step2_annotate_data.ipynb) with our built-in GUI (no Colab support)
+- **3.** [Select and train](https://github.com/jgraving/DeepPoseKit/blob/master/examples/step3_train_model.ipynb) one our [pose estimation models](http://jakegraving.com/DeepPoseKit/html/deepposekit/models/index.html) including [`StackedDenseNet`](http://jakegraving.com/DeepPoseKit/html/deepposekit/models/StackedDenseNet.html), [`StackedHourglass`](http://jakegraving.com/DeepPoseKit/html/deepposekit/models/StackedHourglass.html), [`DeepLabCut`](http://jakegraving.com/DeepPoseKit/html/deepposekit/models/DeepLabCut.html), and [`LEAP`](http://jakegraving.com/DeepPoseKit/html/deepposekit/models/LEAP.html). <a href="https://colab.research.google.com/github/jgraving/deepposekit/blob/master/examples/step3_train_model.ipynb" target="_parent"><img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open In Colab"/></a>
+- **4.** Use the trained model to:
+	- a) [Initialize keypoints for unannotated data](https://github.com/jgraving/DeepPoseKit/blob/master/examples/step4a_initialize_annotations.ipynb) for faster annotations with *active learning*. <a href="https://colab.research.google.com/github/jgraving/deepposekit/blob/master/examples/step4a_initialize_annotations.ipynb" target="_parent"><img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open In Colab"/></a>
+	- b) [Predict on new data and refine the training set](https://github.com/jgraving/DeepPoseKit/blob/master/examples/step4b_predict_new_data.ipynb) to improve performance. <a href="https://colab.research.google.com/github/jgraving/deepposekit/blob/master/examples/step4b_predict_new_data.ipynb" target="_parent"><img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open In Colab"/></a>
+
+## For more details:
+
+- See [our example notebooks](https://github.com/jgraving/deepposekit/blob/master/examples/)
+- Check the [documentation](http://docs.deepposekit.org)
+- Read [our paper](https://doi.org/10.7554/eLife.47994)
+
+## "I already have annotated data"
+
+DeepPoseKit is designed to be extensible, so loading data in other formats is possible.
+
+If you have annotated data from DeepLabCut (http://deeplabcut.org), try [our (experimental) example notebook ](https://github.com/jgraving/DeepPoseKit/blob/master/examples/deeplabcut_data_example.ipynb) for loading data in this format. <a href="https://colab.research.google.com/github/jgraving/deepposekit/blob/master/examples/deeplabcut_data_example.ipynb" target="_parent"><img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open In Colab"/></a>
+
+Have data in another format? You can write your own custom generator to load it.
+Check out the [example for writing custom data generators](https://github.com/jgraving/DeepPoseKit/blob/master/examples/custom_data_generator.ipynb). <a href="https://colab.research.google.com/github/jgraving/deepposekit/blob/master/examples/custom_data_generator.ipynb" target="_parent"><img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open In Colab"/></a>
+
+# Installation
+
+DeepPoseKit requires [Tensorflow](https://github.com/tensorflow/tensorflow) for training and using pose estimation models. [Tensorflow](https://github.com/tensorflow/tensorflow) should be manually installed, along with dependencies such as CUDA and cuDNN, before installing DeepPoseKit:
+
+- [Tensorflow Installation Instructions](https://www.tensorflow.org/install)
+- Any Tensorflow version >=1.13.0 should be compatible (including 2.0).
+
+DeepPoseKit has only been tested on Ubuntu 18.04, which is the recommended system for using the toolkit. 
+
+Install the latest stable release with pip:
+```bash
+pip install --update deepposekit
+```
+
+Install the latest development version with pip:
+```bash
+pip install --update git+https://www.github.com/jgraving/deepposekit.git
+```
+
+You can download example datasets from our [DeepPoseKit Data](https://github.com/jgraving/deepposekit-data) repository:
+```bash
+git clone https://www.github.com/jgraving/deepposekit-data
+```
+
+## Installing with Anaconda on Windows
+
+To install DeepPoseKit on Windows, you must first manually install `Shapely`, one of the dependencies for the [imgaug package](https://github.com/aleju/imgaug):
+```bash
+conda install -c conda-forge shapely
+```
+We also recommend installing DeepPoseKit from within Python rather than using the command line, either from within Jupyter or another IDE, to ensure it is installed in the correct working environment:
+```python
+import sys
+!{sys.executable} -m pip install --update deepposekit
+```
+# Contributors and Development  
+   
+DeepPoseKit was developed by [Jake Graving](https://github.com/jgraving) and [Daniel Chae](https://github.com/dchaebae), and is still being actively developed. .
+
+We welcome community involvement and public contributions to the toolkit. If you wish to contribute, please [fork the repository](https://help.github.com/en/articles/fork-a-repo) to make your modifications and [submit a pull request](https://help.github.com/en/articles/creating-a-pull-request-from-a-fork).
+
+If you'd like to get involved with developing DeepPoseKit, get in touch (jgraving@gmail.com) and check out [our development roadmap](https://github.com/jgraving/DeepPoseKit/blob/master/DEVELOPMENT.md) to see future plans for the package.  
+
+# Issues  
+ 
+Please submit bugs or feature requests to the [GitHub issue tracker](https://github.com/jgraving/deepposekit/issues/new). Please limit reported issues to the DeepPoseKit codebase and provide as much detail as you can with a minimal working example if possible.
+
+If you experience problems with [Tensorflow](https://github.com/tensorflow/tensorflow), such as installing CUDA or cuDNN dependencies, then please direct issues to those development teams.
+
+# License
+
+Released under a Apache 2.0 License. See [LICENSE](https://github.com/jgraving/deepposekit/blob/master/LICENSE) for details.
+
+# References
+
+If you use DeepPoseKit for your research please cite [our open-access paper](http://paper.deepposekit.org):
+
+    @article{graving2019deepposekit,
+             title={DeepPoseKit, a software toolkit for fast and robust animal pose estimation using deep learning},
+             author={Graving, Jacob M and Chae, Daniel and Naik, Hemal and Li, Liang and Koger, Benjamin and Costelloe, Blair R and Couzin, Iain D},
+             journal={eLife},
+             volume={8},
+             pages={e47994},
+             year={2019},
+             publisher={eLife Sciences Publications Limited}
+             url={https://doi.org/10.7554/eLife.47994},
+             }
+
+You can also read [our open-access preprint](http://preprint.deepposekit.org).
+
+If you use the [imgaug package](https://github.com/aleju/imgaug) for data augmentation, please also consider [citing it](https://github.com/aleju/imgaug/blob/master/README.md#citation).
+
+If you [use data](https://github.com/jgraving/DeepPoseKit#i-already-have-annotated-data) that was annotated with the DeepLabCut package (http://deeplabcut.org) for your research, be sure to [cite it](https://github.com/AlexEMG/DeepLabCut/blob/master/README.md#references).
+
+Please also consider citing the relevant references for the pose estimation model(s) used in your research, which can be found in the documentation (i.e., [`StackedDenseNet`](http://jakegraving.com/DeepPoseKit/html/deepposekit/models/StackedDenseNet.html#references), [`StackedHourglass`](http://jakegraving.com/DeepPoseKit/html/deepposekit/models/StackedHourglass.html#references), [`DeepLabCut`](http://jakegraving.com/DeepPoseKit/html/deepposekit/models/DeepLabCut.html#references), [`LEAP`](http://jakegraving.com/DeepPoseKit/html/deepposekit/models/LEAP.html#references)).
+
+# News
+- **October 2019:** Our paper describing DeepPoseKit is published at eLife! (http://paper.deepposekit.org)
+- **September 2019**: 
+    - Nature News covers DeepPoseKit: [Deep learning powers a motion-tracking revolution](http://doi.org/10.1038/d41586-019-02942-5)
+    - v0.3.0 is released. See [the release notes](https://github.com/jgraving/DeepPoseKit/releases/tag/v0.3.0).
+- **April 2019:** The DeepPoseKit preprint is on biorxiv (http://preprint.deepposekit.org)
+
+%prep
+%autosetup -n us2deepposekit-0.3.9
+
+%build
+%py3_build
+
+%install
+%py3_install
+install -d -m755 %{buildroot}/%{_pkgdocdir}
+if [ -d doc ]; then cp -arf doc %{buildroot}/%{_pkgdocdir}; fi
+if [ -d docs ]; then cp -arf docs %{buildroot}/%{_pkgdocdir}; fi
+if [ -d example ]; then cp -arf example %{buildroot}/%{_pkgdocdir}; fi
+if [ -d examples ]; then cp -arf examples %{buildroot}/%{_pkgdocdir}; fi
+pushd %{buildroot}
+if [ -d usr/lib ]; then
+	find usr/lib -type f -printf "/%h/%f\n" >> filelist.lst
+fi
+if [ -d usr/lib64 ]; then
+	find usr/lib64 -type f -printf "/%h/%f\n" >> filelist.lst
+fi
+if [ -d usr/bin ]; then
+	find usr/bin -type f -printf "/%h/%f\n" >> filelist.lst
+fi
+if [ -d usr/sbin ]; then
+	find usr/sbin -type f -printf "/%h/%f\n" >> filelist.lst
+fi
+touch doclist.lst
+if [ -d usr/share/man ]; then
+	find usr/share/man -type f -printf "/%h/%f.gz\n" >> doclist.lst
+fi
+popd
+mv %{buildroot}/filelist.lst .
+mv %{buildroot}/doclist.lst .
+
+%files -n python3-us2deepposekit -f filelist.lst
+%dir %{python3_sitelib}/*
+
+%files help -f doclist.lst
+%{_docdir}/*
+
+%changelog
+* Thu May 18 2023 Python_Bot <Python_Bot@openeuler.org> - 0.3.9-1
+- Package Spec generated
diff --git a/sources b/sources
new file mode 100644
index 0000000..ab57929
--- /dev/null
+++ b/sources
@@ -0,0 +1 @@
+9d8302a80c48b05e94b5760a5504d991  us2deepposekit-0.3.9.tar.gz