From 3c54817483e8b588a6bbab9f97243699b51a8afe Mon Sep 17 00:00:00 2001 From: apidwalin <84679338+Apidwalin@users.noreply.github.com> Date: Wed, 21 Jul 2021 22:32:18 +0700 Subject: [PATCH 1/9] Create blank.yml --- .github/workflows/blank.yml | 36 ++++++++++++++++++++++++++++++++++++ 1 file changed, 36 insertions(+) create mode 100644 .github/workflows/blank.yml diff --git a/.github/workflows/blank.yml b/.github/workflows/blank.yml new file mode 100644 index 0000000..f937a06 --- /dev/null +++ b/.github/workflows/blank.yml @@ -0,0 +1,36 @@ +# This is a basic workflow to help you get started with Actions + +name: CI + +# Controls when the workflow will run +on: + # Triggers the workflow on push or pull request events but only for the master branch + push: + branches: [ master ] + pull_request: + branches: [ master ] + + # Allows you to run this workflow manually from the Actions tab + workflow_dispatch: + +# A workflow run is made up of one or more jobs that can run sequentially or in parallel +jobs: + # This workflow contains a single job called "build" + build: + # The type of runner that the job will run on + runs-on: ubuntu-latest + + # Steps represent a sequence of tasks that will be executed as part of the job + steps: + # Checks-out your repository under $GITHUB_WORKSPACE, so your job can access it + - uses: actions/checkout@v2 + + # Runs a single command using the runners shell + - name: Run a one-line script + run: echo Hello, world! + + # Runs a set of commands using the runners shell + - name: Run a multi-line script + run: | + echo Add other actions to build, + echo test, and deploy your project. From cc86274241aa8fc35d6906408cadd7c4d646fc0f Mon Sep 17 00:00:00 2001 From: apidwalin <84679338+Apidwalin@users.noreply.github.com> Date: Wed, 21 Jul 2021 22:33:52 +0700 Subject: [PATCH 2/9] Update issue templates --- .github/ISSUE_TEMPLATE/bug_report.md | 38 +++++++++++++++++++++++ .github/ISSUE_TEMPLATE/custom.md | 10 ++++++ .github/ISSUE_TEMPLATE/feature_request.md | 20 ++++++++++++ 3 files changed, 68 insertions(+) create mode 100644 .github/ISSUE_TEMPLATE/bug_report.md create mode 100644 .github/ISSUE_TEMPLATE/custom.md create mode 100644 .github/ISSUE_TEMPLATE/feature_request.md diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md new file mode 100644 index 0000000..dd84ea7 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/bug_report.md @@ -0,0 +1,38 @@ +--- +name: Bug report +about: Create a report to help us improve +title: '' +labels: '' +assignees: '' + +--- + +**Describe the bug** +A clear and concise description of what the bug is. + +**To Reproduce** +Steps to reproduce the behavior: +1. Go to '...' +2. Click on '....' +3. Scroll down to '....' +4. See error + +**Expected behavior** +A clear and concise description of what you expected to happen. + +**Screenshots** +If applicable, add screenshots to help explain your problem. + +**Desktop (please complete the following information):** + - OS: [e.g. iOS] + - Browser [e.g. chrome, safari] + - Version [e.g. 22] + +**Smartphone (please complete the following information):** + - Device: [e.g. iPhone6] + - OS: [e.g. iOS8.1] + - Browser [e.g. stock browser, safari] + - Version [e.g. 22] + +**Additional context** +Add any other context about the problem here. diff --git a/.github/ISSUE_TEMPLATE/custom.md b/.github/ISSUE_TEMPLATE/custom.md new file mode 100644 index 0000000..48d5f81 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/custom.md @@ -0,0 +1,10 @@ +--- +name: Custom issue template +about: Describe this issue template's purpose here. +title: '' +labels: '' +assignees: '' + +--- + + diff --git a/.github/ISSUE_TEMPLATE/feature_request.md b/.github/ISSUE_TEMPLATE/feature_request.md new file mode 100644 index 0000000..bbcbbe7 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/feature_request.md @@ -0,0 +1,20 @@ +--- +name: Feature request +about: Suggest an idea for this project +title: '' +labels: '' +assignees: '' + +--- + +**Is your feature request related to a problem? Please describe.** +A clear and concise description of what the problem is. Ex. I'm always frustrated when [...] + +**Describe the solution you'd like** +A clear and concise description of what you want to happen. + +**Describe alternatives you've considered** +A clear and concise description of any alternative solutions or features you've considered. + +**Additional context** +Add any other context or screenshots about the feature request here. From f78af56dcbc77e170445d42e33856c8393077f20 Mon Sep 17 00:00:00 2001 From: apidwalin <84679338+Apidwalin@users.noreply.github.com> Date: Wed, 21 Jul 2021 22:52:46 +0700 Subject: [PATCH 3/9] Add files via upload From 0ad069064fedaddea08e307765e4e933499e35b0 Mon Sep 17 00:00:00 2001 From: apidwalin <84679338+Apidwalin@users.noreply.github.com> Date: Thu, 22 Jul 2021 13:36:35 +0700 Subject: [PATCH 4/9] SECURITY.md --- SECURITY.md | 184 ++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 184 insertions(+) create mode 100644 SECURITY.md diff --git a/SECURITY.md b/SECURITY.md new file mode 100644 index 0000000..a311fd9 --- /dev/null +++ b/SECURITY.md @@ -0,0 +1,184 @@ +# TensorFlow Object Detection API +[![TensorFlow 2.2](https://img.shields.io/badge/TensorFlow-2.2-FF6F00?logo=tensorflow)](https://github.com/tensorflow/tensorflow/releases/tag/v2.2.0) +[![TensorFlow 1.15](https://img.shields.io/badge/TensorFlow-1.15-FF6F00?logo=tensorflow)](https://github.com/tensorflow/tensorflow/releases/tag/v1.15.0) +[![Python 3.6](https://img.shields.io/badge/Python-3.6-3776AB)](https://www.python.org/downloads/release/python-360/) + +Creating accurate machine learning models capable of localizing and identifying +multiple objects in a single image remains a core challenge in computer vision. +The TensorFlow Object Detection API is an open source framework built on top of +TensorFlow that makes it easy to construct, train and deploy object detection +models. At Google we’ve certainly found this codebase to be useful for our +computer vision needs, and we hope that you will as well.

+

+Contributions to the codebase are welcome and we would love to hear back from +you if you find this API useful. Finally if you use the TensorFlow Object +Detection API for a research publication, please consider citing: + +``` +"Speed/accuracy trade-offs for modern convolutional object detectors." +Huang J, Rathod V, Sun C, Zhu M, Korattikara A, Fathi A, Fischer I, Wojna Z, +Song Y, Guadarrama S, Murphy K, CVPR 2017 +``` + +\[[link](https://arxiv.org/abs/1611.10012)\]\[[bibtex](https://scholar.googleusercontent.com/scholar.bib?q=info:l291WsrB-hQJ:scholar.google.com/&output=citation&scisig=AAGBfm0AAAAAWUIIlnPZ_L9jxvPwcC49kDlELtaeIyU-&scisf=4&ct=citation&cd=-1&hl=en&scfhb=1)\] + +

+ +

+ +## Support for TensorFlow 2 and 1 +The TensorFlow Object Detection API supports both TensorFlow 2 (TF2) and +TensorFlow 1 (TF1). A majority of the modules in the library are both TF1 and +TF2 compatible. In cases where they are not, we provide two versions. + +Although we will continue to maintain the TF1 models and provide support, we +encourage users to try the Object Detection API with TF2 for the following +reasons: + +* We provide new architectures supported in TF2 only and we will continue to + develop in TF2 going forward. + +* The popular models we ported from TF1 to TF2 achieve the same performance. + +* A single training and evaluation binary now supports both GPU and TPU + distribution strategies making it possible to train models with synchronous + SGD by default. + +* Eager execution with new binaries makes debugging easy! + +Finally, if are an existing user of the Object Detection API we have retained +the same config language you are familiar with and ensured that the +TF2 training/eval binary takes the same arguments as our TF1 binaries. + +Note: The models we provide in [TF2 Zoo](g3doc/tf2_detection_zoo.md) and +[TF1 Zoo](g3doc/tf1_detection_zoo.md) are specific to the TensorFlow major +version and are not interoperable. + +Please select one of the links below for TensorFlow version-specific +documentation of the Object Detection API: + + +### Tensorflow 2.x + * + Object Detection API TensorFlow 2
+ * + TensorFlow 2 Model Zoo
+ +### Tensorflow 1.x + * + Object Detection API TensorFlow 1
+ * + TensorFlow 1 Model Zoo
+ + +## Whats New + +### TensorFlow 2 Support + +We are happy to announce that the TF OD API officially supports TF2! Our release +includes: + +* New binaries for train/eval/export that are designed to run in eager mode. +* A suite of TF2 compatible (Keras-based) models; this includes migrations of + our most popular TF1.x models (e.g., SSD with MobileNet, RetinaNet, + Faster R-CNN, Mask R-CNN), as well as a few new architectures for which we + will only maintain TF2 implementations: + + 1. CenterNet - a simple and effective anchor-free architecture based on + the recent [Objects as Points](https://arxiv.org/abs/1904.07850) paper by + Zhou et al. + 2. [EfficientDet](https://arxiv.org/abs/1911.09070) - a recent family of + SOTA models discovered with the help of Neural Architecture Search. + +* COCO pre-trained weights for all of the models provided as TF2 style + object-based checkpoints. +* Access to [Distribution Strategies](https://www.tensorflow.org/guide/distributed_training) + for distributed training --- our model are designed to be trainable using sync + multi-GPU and TPU platforms. +* Colabs demo’ing eager mode training and inference. + +See our release blogpost [here](https://blog.tensorflow.org/2020/07/tensorflow-2-meets-object-detection-api.html). +If you are an existing user of the TF OD API using TF 1.x, don’t worry, we’ve +got you covered. + +**Thanks to contributors**: Akhil Chinnakotla, Allen Lavoie, Anirudh Vegesana, +Anjali Sridhar, Austin Myers, Dan Kondratyuk, David Ross, Derek Chow, Jaeyoun +Kim, Jing Li, Jonathan Huang, Jordi Pont-Tuset, Karmel Allison, Kathy Ruan, +Kaushik Shivakumar, Lu He, Mingxing Tan, Pengchong Jin, Ronny Votel, Sara Beery, +Sergi Caelles Prat, Shan Yang, Sudheendra Vijayanarasimhan, Tina Tian, Tomer +Kaftan, Vighnesh Birodkar, Vishnu Banna, Vivek Rathod, Yanhui Liang, Yiming Shi, +Yixin Shi, Yu-hui Chen, Zhichao Lu. + +### MobileDet GPU + +We have released SSDLite with MobileDet GPU backbone, which achieves 17% mAP +higher than the MobileNetV2 SSDLite (27.5 mAP vs 23.5 mAP) on a NVIDIA Jetson +Xavier at comparable latency (3.2ms vs 3.3ms). + +Along with the model definition, we are also releasing model checkpoints trained +on the COCO dataset. + +Thanks to contributors: Yongzhe Wang, Bo Chen, Hanxiao Liu, Le An +(NVIDIA), Yu-Te Cheng (NVIDIA), Oliver Knieps (NVIDIA), and Josh Park (NVIDIA). + +### Context R-CNN + +We have released [Context R-CNN](https://arxiv.org/abs/1912.03538), a model that +uses attention to incorporate contextual information images (e.g. from +temporally nearby frames taken by a static camera) in order to improve accuracy. +Importantly, these contextual images need not be labeled. + +* When applied to a challenging wildlife detection dataset + ([Snapshot Serengeti](http://lila.science/datasets/snapshot-serengeti)), + Context R-CNN with context from up to a month of images outperforms a + single-frame baseline by 17.9% mAP, and outperforms S3D (a 3d convolution + based baseline) by 11.2% mAP. +* Context R-CNN leverages temporal context from the unlabeled frames of a + novel camera deployment to improve performance at that camera, boosting + model generalizeability. + +Read about Context R-CNN on the Google AI blog +[here](https://ai.googleblog.com/2020/06/leveraging-temporal-context-for-object.html). + +We have provided code for generating data with associated context +[here](g3doc/context_rcnn.md), and a sample config for a Context R-CNN model +[here](samples/configs/context_rcnn_resnet101_snapshot_serengeti_sync.config). + +Snapshot Serengeti-trained Faster R-CNN and Context R-CNN models can be found in +the +[model zoo](https://github.com/tensorflow/models/blob/master/research/object_detection/g3doc/tf1_detection_zoo.md#snapshot-serengeti-camera-trap-trained-models). + +A colab demonstrating Context R-CNN is provided +[here](colab_tutorials/context_rcnn_tutorial.ipynb). + +Thanks to contributors: Sara Beery, Jonathan Huang, Guanhang Wu, Vivek +Rathod, Ronny Votel, Zhichao Lu, David Ross, Pietro Perona, Tanya Birch, and the +Wildlife Insights AI Team. + +## Release Notes +See [notes](g3doc/release_notes.md) for all past releases. + +## Getting Help + +To get help with issues you may encounter using the TensorFlow Object Detection +API, create a new question on [StackOverflow](https://stackoverflow.com/) with +the tags "tensorflow" and "object-detection". + +Please report bugs (actually broken code, not usage questions) to the +tensorflow/models GitHub +[issue tracker](https://github.com/tensorflow/models/issues), prefixing the +issue name with "object_detection". + +Please check the [FAQ](g3doc/faq.md) for frequently asked questions before +reporting an issue. + +## Maintainers + +* Jonathan Huang ([@GitHub jch1](https://github.com/jch1)) +* Vivek Rathod ([@GitHub tombstone](https://github.com/tombstone)) +* Vighnesh Birodkar ([@GitHub vighneshbirodkar](https://github.com/vighneshbirodkar)) +* Austin Myers ([@GitHub austin-myers](https://github.com/austin-myers)) +* Zhichao Lu ([@GitHub pkulzc](https://github.com/pkulzc)) +* Ronny Votel ([@GitHub ronnyvotel](https://github.com/ronnyvotel)) +* Yu-hui Chen ([@GitHub yuhuichen1015](https://github.com/yuhuichen1015)) +* Derek Chow ([@GitHub derekjchow](https://github.com/derekjchow)) From bfbb15e1aa431720ad2f0901d52cde58fe723a1b Mon Sep 17 00:00:00 2001 From: apidwalin <84679338+Apidwalin@users.noreply.github.com> Date: Thu, 22 Jul 2021 13:37:40 +0700 Subject: [PATCH 5/9] Update issue templates --- .github/ISSUE_TEMPLATE/feature_request.md | 20 -------------------- 1 file changed, 20 deletions(-) delete mode 100644 .github/ISSUE_TEMPLATE/feature_request.md diff --git a/.github/ISSUE_TEMPLATE/feature_request.md b/.github/ISSUE_TEMPLATE/feature_request.md deleted file mode 100644 index bbcbbe7..0000000 --- a/.github/ISSUE_TEMPLATE/feature_request.md +++ /dev/null @@ -1,20 +0,0 @@ ---- -name: Feature request -about: Suggest an idea for this project -title: '' -labels: '' -assignees: '' - ---- - -**Is your feature request related to a problem? Please describe.** -A clear and concise description of what the problem is. Ex. I'm always frustrated when [...] - -**Describe the solution you'd like** -A clear and concise description of what you want to happen. - -**Describe alternatives you've considered** -A clear and concise description of any alternative solutions or features you've considered. - -**Additional context** -Add any other context or screenshots about the feature request here. From bfe9302d09425034b611784e8b0eb1c4e07ea9ce Mon Sep 17 00:00:00 2001 From: apidwalin <84679338+Apidwalin@users.noreply.github.com> Date: Thu, 22 Jul 2021 14:01:31 +0700 Subject: [PATCH 6/9] Add files via upload From 96966675225810da8b7b39b9ea8040a66f421889 Mon Sep 17 00:00:00 2001 From: apidwalin <84679338+Apidwalin@users.noreply.github.com> Date: Thu, 22 Jul 2021 14:01:46 +0700 Subject: [PATCH 7/9] Delete README.md --- README.md | 22 ---------------------- 1 file changed, 22 deletions(-) delete mode 100644 README.md diff --git a/README.md b/README.md deleted file mode 100644 index 9e8042c..0000000 --- a/README.md +++ /dev/null @@ -1,22 +0,0 @@ -# TensorFlowObjectDetectionTutorial - - -This is a "short" (rather lengthy) tutorial that started off as self notes on how to set-up and get going with the TensorFlow Object Detection API. - -There currently exist several versions of the tutorial, corresponding to the various different versions of TensorFlow. The two major versions are outlined below. - -## TensorFlow 2 Object Detection API tutorial - -[![TensorFlow 2.5](https://img.shields.io/badge/TensorFlow-2.5-FF6F00?logo=tensorflow)](https://github.com/tensorflow/tensorflow/releases/tag/v2.5.0) [![Documentation Status](https://readthedocs.org/projects/tensorflow-object-detection-api-tutorial/badge/?version=latest)](http://tensorflow-object-detection-api-tutorial.readthedocs.io/en/latest/?badge=latest) - -Since July 10, 2020 TensorFlow [announced that the Object Detection API officially supports TensorFlow 2](https://blog.tensorflow.org/2020/07/tensorflow-2-meets-object-detection-api.html). Therefore, an updated version of the tutorial was created to cover TensorFlow 2. - -To read the tutorial, visit [http://tensorflow-object-detection-api-tutorial.readthedocs.io](http://tensorflow-object-detection-api-tutorial.readthedocs.io). - -## TensorFlow Object Detection API tutorial - -[![TensorFlow 1.14](https://img.shields.io/badge/TensorFlow-1.14-FF6F00?logo=tensorflow)](https://github.com/tensorflow/tensorflow/releases/tag/v1.14.0) [![Documentation Status](https://readthedocs.org/projects/tensorflow-object-detection-api-tutorial/badge/?version=tensorflow-1.14)](http://tensorflow-object-detection-api-tutorial.readthedocs.io/en/tensorflow-1.14/?badge=tensorflow-1.14) - -Originally, the tutorial was written with TensorFlow 1 in mind. Since it is possible that many users will still be interested in working with TensorFlow 1, a version of this tutorial will also be maintained for the foreseeable future. - -To read the tutorial, visit [https://tensorflow-object-detection-api-tutorial.readthedocs.io/en/tensorflow-1.14/](https://tensorflow-object-detection-api-tutorial.readthedocs.io/en/tensorflow-1.14/). From 5870337c43cb7a1ecb6bf731c6eba8dcd1e62a4f Mon Sep 17 00:00:00 2001 From: apidwalin <84679338+Apidwalin@users.noreply.github.com> Date: Thu, 22 Jul 2021 14:02:04 +0700 Subject: [PATCH 8/9] Create README.md --- README.md | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..9e8042c --- /dev/null +++ b/README.md @@ -0,0 +1,22 @@ +# TensorFlowObjectDetectionTutorial + + +This is a "short" (rather lengthy) tutorial that started off as self notes on how to set-up and get going with the TensorFlow Object Detection API. + +There currently exist several versions of the tutorial, corresponding to the various different versions of TensorFlow. The two major versions are outlined below. + +## TensorFlow 2 Object Detection API tutorial + +[![TensorFlow 2.5](https://img.shields.io/badge/TensorFlow-2.5-FF6F00?logo=tensorflow)](https://github.com/tensorflow/tensorflow/releases/tag/v2.5.0) [![Documentation Status](https://readthedocs.org/projects/tensorflow-object-detection-api-tutorial/badge/?version=latest)](http://tensorflow-object-detection-api-tutorial.readthedocs.io/en/latest/?badge=latest) + +Since July 10, 2020 TensorFlow [announced that the Object Detection API officially supports TensorFlow 2](https://blog.tensorflow.org/2020/07/tensorflow-2-meets-object-detection-api.html). Therefore, an updated version of the tutorial was created to cover TensorFlow 2. + +To read the tutorial, visit [http://tensorflow-object-detection-api-tutorial.readthedocs.io](http://tensorflow-object-detection-api-tutorial.readthedocs.io). + +## TensorFlow Object Detection API tutorial + +[![TensorFlow 1.14](https://img.shields.io/badge/TensorFlow-1.14-FF6F00?logo=tensorflow)](https://github.com/tensorflow/tensorflow/releases/tag/v1.14.0) [![Documentation Status](https://readthedocs.org/projects/tensorflow-object-detection-api-tutorial/badge/?version=tensorflow-1.14)](http://tensorflow-object-detection-api-tutorial.readthedocs.io/en/tensorflow-1.14/?badge=tensorflow-1.14) + +Originally, the tutorial was written with TensorFlow 1 in mind. Since it is possible that many users will still be interested in working with TensorFlow 1, a version of this tutorial will also be maintained for the foreseeable future. + +To read the tutorial, visit [https://tensorflow-object-detection-api-tutorial.readthedocs.io/en/tensorflow-1.14/](https://tensorflow-object-detection-api-tutorial.readthedocs.io/en/tensorflow-1.14/). From da8c416ca5e0d58cf007e6c1ce5316b66ebf9774 Mon Sep 17 00:00:00 2001 From: apidwalin <84679338+Apidwalin@users.noreply.github.com> Date: Thu, 22 Jul 2021 14:10:04 +0700 Subject: [PATCH 9/9] Update issue templates --- .github/ISSUE_TEMPLATE/feature_request.md | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) create mode 100644 .github/ISSUE_TEMPLATE/feature_request.md diff --git a/.github/ISSUE_TEMPLATE/feature_request.md b/.github/ISSUE_TEMPLATE/feature_request.md new file mode 100644 index 0000000..bbcbbe7 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/feature_request.md @@ -0,0 +1,20 @@ +--- +name: Feature request +about: Suggest an idea for this project +title: '' +labels: '' +assignees: '' + +--- + +**Is your feature request related to a problem? Please describe.** +A clear and concise description of what the problem is. Ex. I'm always frustrated when [...] + +**Describe the solution you'd like** +A clear and concise description of what you want to happen. + +**Describe alternatives you've considered** +A clear and concise description of any alternative solutions or features you've considered. + +**Additional context** +Add any other context or screenshots about the feature request here.