Merge pull request tensorflow#421 from arovir01:toupstream/clustering…

…_docgen

PiperOrigin-RevId: 322239236

tensorflow_model_optimization/python/core/api/BUILD

@@ -8,6 +8,8 @@ py_library(
     name = "api",
     srcs = [
         "__init__.py",
+        "clustering/__init__.py",
+        "clustering/keras/__init__.py",
         "quantization/__init__.py",
         "quantization/keras/__init__.py",
         "quantization/keras/quantizers/__init__.py",
@@ -16,6 +18,7 @@ py_library(
     ],
     srcs_version = "PY2AND3",
     deps = [
+        "//tensorflow_model_optimization/python/core/clustering/keras",
         "//tensorflow_model_optimization/python/core/quantization/keras",
         "//tensorflow_model_optimization/python/core/sparsity/keras",
     ],

tensorflow_model_optimization/python/core/api/__init__.py

@@ -13,5 +13,6 @@
 # limitations under the License.
 # ==============================================================================
 """Import API modules for Tensorflow Model Optimization."""
+from tensorflow_model_optimization.python.core.api import clustering
 from tensorflow_model_optimization.python.core.api import quantization
 from tensorflow_model_optimization.python.core.api import sparsity

tensorflow_model_optimization/python/core/api/clustering/__init__.py

@@ -0,0 +1,16 @@
+# Copyright 2020 The TensorFlow Authors. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+# ==============================================================================
+"""Module containing code for clustering."""
+from tensorflow_model_optimization.python.core.api.clustering import keras

tensorflow_model_optimization/python/core/api/clustering/keras/__init__.py

@@ -0,0 +1,22 @@
+# Copyright 2020 The TensorFlow Authors. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+# ==============================================================================
+"""Module containing clustering code built on Keras abstractions."""
+# pylint: disable=g-bad-import-order
+from tensorflow_model_optimization.python.core.clustering.keras.cluster import cluster_scope
+from tensorflow_model_optimization.python.core.clustering.keras.cluster import cluster_weights
+from tensorflow_model_optimization.python.core.clustering.keras.cluster import strip_clustering
+
+from tensorflow_model_optimization.python.core.clustering.keras.cluster_config import CentroidInitialization
+# pylint: enable=g-bad-import-order