Skip to content

Commit 40f2cb4

Browse files
authored
Initial commit for the keras-cv roadmap/community guide line (keras-team#61)
* Initial commit for the keras-cv roadmap/community guide line Mostly copy/pasted from internal roadmap doc (with some modifications). * Address some of the comments from Luke
1 parent 17dbaca commit 40f2cb4

File tree

1 file changed

+99
-4
lines changed

1 file changed

+99
-4
lines changed

README.md

Lines changed: 99 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,102 @@
11
# KerasCV
2-
KerasCV is a repository of modular building blocks (layers, metrics, losses, data-augmentation) that applied computer vision engineers can leverage to quickly assemble production-grade, state-of-the-art training and inference pipelines for common use cases such as image classification, object detection, image segmentation, image data augmentation, etc.
2+
KerasCV is a repository of modular building blocks (layers, metrics, losses, data-augmentation) that
3+
applied computer vision engineers can leverage to quickly assemble production-grade, state-of-the-art
4+
training and inference pipelines for common use cases such as image classification, object detection,
5+
image segmentation, image data augmentation, etc.
36

4-
KerasCV can be understood as a horizontal extension of the Keras API: they're new first-party Keras objects (layers, metrics, etc) that are too specialized to be added to core Keras, but that receive the same level of polish and backwards compatibility guarantees as the rest of the Keras API and that are maintained by the Keras team itself (unlike TFAddons).
7+
KerasCV can be understood as a horizontal extension of the Keras API: the components are new first-party
8+
Keras objects (layers, metrics, etc) that are too specialized to be added to core Keras, but that receive
9+
the same level of polish and backwards compatibility guarantees as the rest of the Keras API and that
10+
are maintained by the Keras team itself (unlike TFAddons).
511

6-
## Under Construction
7-
KerasCV is a relatively new project. Expect regular updates and changes in the near future.
12+
# Non-Goals
13+
- **KerasCV is not a repository of blackbox end-to-end solutions (like TF Hub or ModelGarden).**
14+
15+
For the time being, it is focused on modular and reusable building blocks. We expect models in
16+
ModelGarden or TF Hub to eventually be built on top of the building blocks provided by KerasCV.
17+
18+
In the process of developing these building blocks, we will by necessity implement end-to-end
19+
workflows, but they're intended purely for demonstration and grounding purposes, they're not
20+
our main deliverable.
21+
22+
23+
- **KerasCV is not a repository of low-level image-processing ops, like tf.vision.**
24+
25+
KerasCV is fundamentally an extension of the Keras API: it hosts Keras objects, like layers,
26+
metrics, or callbacks. Low-level C++ ops should go elsewhere.
27+
28+
29+
- **KerasCV is not a research library.**
30+
31+
Researchers may use it, but we do not consider researchers to be our target audience. Our target
32+
audience is applied CV engineers with experimentation and production needs. KerasCV should make
33+
it possible to quickly reimplement industry-strength versions of the latest generation of
34+
architectures produced by researchers, but we don't expect the research effort itself to be built
35+
on top of KerasCV. This enables us to focus on usability and API standardization, and produce
36+
objects that have a longer lifespan than the average research project.
37+
38+
## Areas of focus
39+
At the start of the project, we would like to take a task-oriented approach to outline our project,
40+
and the first 2 tasks we would like to focus are:
41+
42+
1. **Image classification** (Given an image and a list of labels, return the label and confidence for
43+
the image).
44+
2. **Object detection** (Given an image and a list of labels, return a list of bounding box,
45+
corresponding labels and confidence for the objects in the image).
46+
47+
For each of the tasks, we are targeting to provide user model architectures, layers, preprocessing
48+
functions, losses, metrics and other necessary components to achieve state of the art accuracy.
49+
50+
There will be common shareable components between those 2 tasks, like model building blocks, etc. We
51+
will have them in the repository as public API as well.
52+
53+
### Image Classification
54+
- Dataset to evaluate
55+
- [Imagenet](https://www.tensorflow.org/datasets/catalog/imagenet2012)
56+
- [Imagenet v2](https://www.tensorflow.org/datasets/catalog/imagenet_v2) (for testing)
57+
- Target Metric
58+
- Top1 Accuracy > 80% (Note that some existing SotA models might not achieve this, like
59+
original ResNet, but this serve as a guideline for newly added models)
60+
61+
### Object Detection
62+
- Dataset to evaluate
63+
- [Coco 2017](https://www.tensorflow.org/datasets/catalog/coco#coco2017)
64+
- [Open image v4](https://www.tensorflow.org/datasets/catalog/open_images_v4)
65+
- [PASCAL voc](https://www.tensorflow.org/datasets/catalog/voc)
66+
- Target Metric
67+
- COCO metric mean average precision (mAP)
68+
69+
## Overlapping between keras.application and Keras-CV
70+
As you might notice, some area we would like to focus has overlapping with existing keras.application,
71+
and we would like to clarify the reason of the potential code duplication here.
72+
73+
keras.application has a strong API contract that we can't easily make any backward incompatible
74+
change. On the other hand, there are a few of behavior we actually would like to change within the keras-cv
75+
- Fetch imagenet weights by default, which might not want to do for keras-cv.
76+
- Have the image preprocessing logic outside the model. We want to include all the preprocessing
77+
within the model, so that user won't need to call the extra preprocessing methods.
78+
- Only end-to-end model are exposed as public API, and Keras CV would like to include more building
79+
blocks as well.
80+
- Some legacy model architectures are no longer commonly used and can't reach SotA performance, which
81+
we might want to deprecate.
82+
83+
Once the keras-cv applications are mature enough, we would add a deprecation warning in the
84+
keras.applications code.
85+
86+
87+
## Community contribution guideline
88+
We would like to leverage/outsource the Keras community not only for bug reporting or fixes,
89+
but also for active development for feature delivery. To achieve this, we will have the predefined
90+
process for how to contribute to this repository.
91+
92+
The ideal workflow will be:
93+
94+
- Keras defines the API interface for a certain task, eg a layer, model, dataset, metrics, etc.
95+
- Post it to Github as a feature request.
96+
- Have a hotlist/tag for those items and advocate them to the community.
97+
- Let community members claim the task they would like to work on.
98+
99+
User requested features will be carefully evaluated by keras team member before acceptance.
100+
Based on the existing experience from tf-addons, even with a guideline of paper ref count > 50,
101+
the image/cv related contributions are still quite scattered. We will make sure the contributions
102+
are coherent with the tasks/themes we have in the repository, or widely used for CV tasks.

0 commit comments

Comments
 (0)