Split nn layers (#892)

* split layers,test=develop

* split nn layers

* remove nn header, test=develop

doc/fluid/api/gen_doc.py

@@ -16,63 +16,48 @@ from __future__ import print_function
 import argparse
 import sys
 import types
+import os
+import contextlib
 
 import paddle.fluid as fluid
 
-
 def parse_arg():
     parser = argparse.ArgumentParser()
     parser.add_argument('--submodules', nargs="*")
     parser.add_argument(
-        '--module', type=str, help='Generate the documentation of which module')
+        '--module_name', type=str, help='Generate the documentation of which module')
     parser.add_argument(
         '--module_prefix', type=str, help='Generate the prefix of module')
+    parser.add_argument(
+        '--output', type=str, help='Output file or output directory for output rst')
+    parser.add_argument(
+        '--to_multiple_files', type=bool, default=False, help='Whether to separate to multiple files')
     return parser.parse_args()
 
-
-class DocGenerator(object):
-    def __init__(self, module_name=None, module_prefix=None, stream=sys.stdout):
-        if module_name == "":
-            module_name = None
-
-        if module_prefix == "":
-            module_prefix = None
-
-        self.stream = stream
-        if module_name is None:
-            self.module_name = "fluid"
-        else:
-            self.module_name = "fluid." + module_name
-        if module_name is None:
-            self.module = fluid
-        else: 
-            self.module = fluid
-            for each_module_name in module_name.split('.'): 
-                if not hasattr(self.module, each_module_name):
-                    raise ValueError("Cannot find fluid.{0}".format(module_name))
-                else:
-                    self.module = getattr(self.module, each_module_name)
-
-        if module_prefix is None:
-            self.module_prefix = self.module_name 
+    def print_item(self, name):
+        item = getattr(self.module, name, None)
+        if item is None:
+            return
+        if isinstance(item, types.TypeType):
+            self.print_class(name)
+        elif isinstance(item, types.FunctionType):
+            self.print_method(name)
         else:
-            self.module_prefix = "fluid." + module_prefix
-
-        self.stream.write('''..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
-    !DO NOT EDIT THIS FILE MANUALLY!
-
-''')            
+            pass
 
-        header_name = self.module_name
-        if module_prefix is not None:
-            prefix_len = len(self.module_prefix)
-            assert self.module_prefix == self.module_name[0:prefix_len],    \
-                "module_prefix must be prefix of module_name"
-            diff_name = self.module_name[prefix_len+1:]
-            if diff_name != "":
-                header_name = diff_name
-         
-        self._print_header_(header_name, dot='=', is_title=True)
+class DocGenerator(object):
+    def __init__(self, module_name=None, module_prefix=None): 
+        self.module_name = module_name
+        self.module_prefix = module_prefix
+        self.stream = None
+
+    @contextlib.contextmanager
+    def guard(self, filename):
+        assert self.stream is None, "stream must be None"
+        self.stream = open(filename, 'w') 
+        yield
+        self.stream.close()
+        self.stream = None
 
     def print_submodule(self, submodule_name):
         submodule = getattr(self.module, submodule_name)
@@ -118,6 +103,12 @@ class DocGenerator(object):
 
 '''.format(self.module_prefix, name))
 
+    def print_header_reminder(self):
+        self.stream.write('''..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+''')
+
     def _print_header_(self, name, dot, is_title):
         dot_line = dot * len(name)
         if is_title:
@@ -133,15 +124,66 @@ class DocGenerator(object):
         self.stream.write(".. _api_{0}_{1}:\n\n".format("_".join(
             self.module_prefix.split(".")), name))
 
+def generate_doc(module_name, module_prefix, output, to_multiple_files):
+    if module_name == "":
+        module_name = None
+
+    if module_prefix == "":
+        module_prefix = None
+
+    gen = DocGenerator()
+
+    if module_name is None:
+        gen.module = fluid
+        gen.module_name = 'fluid'
+    else:
+        gen.module = fluid
+        for each_module_name in module_name.split('.'):
+            if not hasattr(gen.module, each_module_name):
+                raise ValueError("Cannot find fluid.{0}".format(module_name))
+            else:
+                gen.module = getattr(gen.module, each_module_name)
+
+        gen.module_name = "fluid." + module_name
+
+    if module_prefix is None:
+        gen.module_prefix = gen.module_name
+    else:
+        gen.module_prefix = "fluid." + module_prefix
+
+    dirname = output if to_multiple_files else os.path.dirname(output) 
+    if len(dirname) > 0 and (not os.path.exists(dirname) or not os.path.isdir(dirname)): 
+        os.makedirs(dirname)
+
+    if not to_multiple_files:
+        header_name = gen.module_name
+        if module_prefix is not None:
+            prefix_len = len(gen.module_prefix)
+            assert gen.module_prefix == gen.module_name[0:prefix_len],    \
+                "module_prefix must be prefix of module_name"
+            diff_name = gen.module_name[prefix_len+1:]
+            if diff_name != "":
+                header_name = diff_name
+    else:
+        header_name = None
+
+    if not to_multiple_files:
+        with gen.guard(output):
+            gen.print_header_reminder()
+            gen._print_header_(header_name, dot='=', is_title=True)
+            gen.print_current_module()
+    else:
+        apis = sorted(gen.module.__all__,key=str.lower)
+        for api in apis:
+            header_name = api
+            with gen.guard(os.path.join(output, api + '.rst')):
+                gen.print_header_reminder()
+                gen.print_item(api)
+
 
 def main():
     args = parse_arg()
-    gen = DocGenerator(args.module, args.module_prefix)
-    if args.submodules is None:
-        gen.print_current_module()
-    else:
-        for submodule_name in args.submodules:
-            gen.print_submodule(submodule_name)
+    generate_doc(args.module_name, args.module_prefix, args.output, args.to_multiple_files)
 
 
 if __name__ == '__main__':

doc/fluid/api/gen_doc.sh

 #!/bin/bash
 
-mkdir -p layers
+for module in nn
+do
+  python gen_doc.py --module_name layers.${module} --module_prefix layers --output layers/${module} --to_multiple_files True
+done
 
-for module in control_flow io nn ops tensor learning_rate_scheduler detection metric_op
+for module in control_flow io ops tensor learning_rate_scheduler detection metric_op
 do
-  python gen_doc.py --module layers.${module} --module_prefix layers > layers/${module}.rst
+  python gen_doc.py --module_name layers.${module} --module_prefix layers --output layers/${module}.rst
 done 
 
 for module in data_feeder dataset clip metrics executor initializer io nets optimizer profiler regularizer transpiler recordio_writer backward average profiler unique_name
 do
-  python gen_doc.py --module ${module} --module_prefix ${module} > ${module}.rst
+  python gen_doc.py --module_name ${module} --module_prefix ${module} --output ${module}.rst
 done
 
-python gen_doc.py --module "" --module_prefix "" > fluid.rst
+python gen_doc.py --module_name "" --module_prefix "" --output fluid.rst
+
+python gen_module_index.py layers.nn nn
+python gen_module_index.py layers fluid.layers
 
 python gen_index.py
+

doc/fluid/api/gen_module_index.py

+import glob 
+import sys
+import os
+
+def print_module_index(module, header):
+    modules = module.split('.')
+    if len(modules) > 1:
+        os.chdir('/'.join(modules[0:-1]))
+        pattern = modules[-1] + '/*.rst'
+        stream = open(modules[-1] + '.rst', 'w')
+    else:
+        pattern = modules[0] + '/*.rst'
+        stream = open(modules[0] + '.rst', 'w')
+
+    stream.write('=' * len(header) + '\n')
+    stream.write(header + '\n')
+    stream.write('=' * len(header) + '\n')
+    stream.write('''
+..  toctree::
+    :maxdepth: 1
+
+''')
+
+    blank_num = 4 
+    files = sorted(glob.glob(pattern), key=str.lower)
+
+    for f in files: 
+        stream.write(' ' * blank_num)
+        stream.write(f)
+        stream.write('\n')
+
+    stream.close()
+
+if __name__ == '__main__':
+    if len(sys.argv) != 3:
+        print('Usage: python gen_module_index.py [module_name] [header_name]')
+        sys.exit(-1)
+
+    print_module_index(sys.argv[1], sys.argv[2])

doc/fluid/api/layers.rst

@@ -7,7 +7,6 @@ fluid.layers
 
     layers/control_flow.rst
     layers/detection.rst
-    layers/device.rst
     layers/io.rst
     layers/learning_rate_scheduler.rst
     layers/metric_op.rst

doc/fluid/api/layers/nn/adaptive_pool2d.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_adaptive_pool2d:
+
+adaptive_pool2d
+---------------
+
+..  autofunction:: paddle.fluid.layers.adaptive_pool2d
+    :noindex:
+

doc/fluid/api/layers/nn/adaptive_pool3d.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_adaptive_pool3d:
+
+adaptive_pool3d
+---------------
+
+..  autofunction:: paddle.fluid.layers.adaptive_pool3d
+    :noindex:
+

doc/fluid/api/layers/nn/add_position_encoding.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_add_position_encoding:
+
+add_position_encoding
+---------------------
+
+..  autofunction:: paddle.fluid.layers.add_position_encoding
+    :noindex:
+

doc/fluid/api/layers/nn/affine_channel.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_affine_channel:
+
+affine_channel
+--------------
+
+..  autofunction:: paddle.fluid.layers.affine_channel
+    :noindex:
+

doc/fluid/api/layers/nn/affine_grid.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_affine_grid:
+
+affine_grid
+-----------
+
+..  autofunction:: paddle.fluid.layers.affine_grid
+    :noindex:
+

doc/fluid/api/layers/nn/autoincreased_step_counter.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_autoincreased_step_counter:
+
+autoincreased_step_counter
+--------------------------
+
+..  autofunction:: paddle.fluid.layers.autoincreased_step_counter
+    :noindex:
+

doc/fluid/api/layers/nn/batch_norm.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_batch_norm:
+
+batch_norm
+----------
+
+..  autofunction:: paddle.fluid.layers.batch_norm
+    :noindex:
+

doc/fluid/api/layers/nn/beam_search.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_beam_search:
+
+beam_search
+-----------
+
+..  autofunction:: paddle.fluid.layers.beam_search
+    :noindex:
+

doc/fluid/api/layers/nn/beam_search_decode.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_beam_search_decode:
+
+beam_search_decode
+------------------
+
+..  autofunction:: paddle.fluid.layers.beam_search_decode
+    :noindex:
+

doc/fluid/api/layers/nn/bilinear_tensor_product.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_bilinear_tensor_product:
+
+bilinear_tensor_product
+-----------------------
+
+..  autofunction:: paddle.fluid.layers.bilinear_tensor_product
+    :noindex:
+

doc/fluid/api/layers/nn/bpr_loss.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_bpr_loss:
+
+bpr_loss
+--------
+
+..  autofunction:: paddle.fluid.layers.bpr_loss
+    :noindex:
+

doc/fluid/api/layers/nn/brelu.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_brelu:
+
+brelu
+-----
+
+..  autofunction:: paddle.fluid.layers.brelu
+    :noindex:
+

doc/fluid/api/layers/nn/chunk_eval.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_chunk_eval:
+
+chunk_eval
+----------
+
+..  autofunction:: paddle.fluid.layers.chunk_eval
+    :noindex:
+

doc/fluid/api/layers/nn/clip.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_clip:
+
+clip
+----
+
+..  autofunction:: paddle.fluid.layers.clip
+    :noindex:
+

doc/fluid/api/layers/nn/clip_by_norm.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_clip_by_norm:
+
+clip_by_norm
+------------
+
+..  autofunction:: paddle.fluid.layers.clip_by_norm
+    :noindex:
+

doc/fluid/api/layers/nn/continuous_value_model.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_continuous_value_model:
+
+continuous_value_model
+----------------------
+
+..  autofunction:: paddle.fluid.layers.continuous_value_model
+    :noindex:
+

doc/fluid/api/layers/nn/conv2d.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_conv2d:
+
+conv2d
+------
+
+..  autofunction:: paddle.fluid.layers.conv2d
+    :noindex:
+

doc/fluid/api/layers/nn/conv2d_transpose.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_conv2d_transpose:
+
+conv2d_transpose
+----------------
+
+..  autofunction:: paddle.fluid.layers.conv2d_transpose
+    :noindex:
+

doc/fluid/api/layers/nn/conv3d.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_conv3d:
+
+conv3d
+------
+
+..  autofunction:: paddle.fluid.layers.conv3d
+    :noindex:
+

doc/fluid/api/layers/nn/conv3d_transpose.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_conv3d_transpose:
+
+conv3d_transpose
+----------------
+
+..  autofunction:: paddle.fluid.layers.conv3d_transpose
+    :noindex:
+

doc/fluid/api/layers/nn/cos_sim.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_cos_sim:
+
+cos_sim
+-------
+
+..  autofunction:: paddle.fluid.layers.cos_sim
+    :noindex:
+

doc/fluid/api/layers/nn/crf_decoding.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_crf_decoding:
+
+crf_decoding
+------------
+
+..  autofunction:: paddle.fluid.layers.crf_decoding
+    :noindex:
+

doc/fluid/api/layers/nn/crop.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_crop:
+
+crop
+----
+
+..  autofunction:: paddle.fluid.layers.crop
+    :noindex:
+

doc/fluid/api/layers/nn/cross_entropy.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_cross_entropy:
+
+cross_entropy
+-------------
+
+..  autofunction:: paddle.fluid.layers.cross_entropy
+    :noindex:
+

doc/fluid/api/layers/nn/ctc_greedy_decoder.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_ctc_greedy_decoder:
+
+ctc_greedy_decoder
+------------------
+
+..  autofunction:: paddle.fluid.layers.ctc_greedy_decoder
+    :noindex:
+

doc/fluid/api/layers/nn/data_norm.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_data_norm:
+
+data_norm
+---------
+
+..  autofunction:: paddle.fluid.layers.data_norm
+    :noindex:
+

doc/fluid/api/layers/nn/deformable_conv.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_deformable_conv:
+
+deformable_conv
+---------------
+
+..  autofunction:: paddle.fluid.layers.deformable_conv
+    :noindex:
+

doc/fluid/api/layers/nn/dice_loss.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_dice_loss:
+
+dice_loss
+---------
+
+..  autofunction:: paddle.fluid.layers.dice_loss
+    :noindex:
+

doc/fluid/api/layers/nn/dropout.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_dropout:
+
+dropout
+-------
+
+..  autofunction:: paddle.fluid.layers.dropout
+    :noindex:
+

doc/fluid/api/layers/nn/dynamic_gru.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_dynamic_gru:
+
+dynamic_gru
+-----------
+
+..  autofunction:: paddle.fluid.layers.dynamic_gru
+    :noindex:
+

doc/fluid/api/layers/nn/dynamic_lstm.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_dynamic_lstm:
+
+dynamic_lstm
+------------
+
+..  autofunction:: paddle.fluid.layers.dynamic_lstm
+    :noindex:
+

doc/fluid/api/layers/nn/dynamic_lstmp.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_dynamic_lstmp:
+
+dynamic_lstmp
+-------------
+
+..  autofunction:: paddle.fluid.layers.dynamic_lstmp
+    :noindex:
+

doc/fluid/api/layers/nn/edit_distance.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_edit_distance:
+
+edit_distance
+-------------
+
+..  autofunction:: paddle.fluid.layers.edit_distance
+    :noindex:
+

doc/fluid/api/layers/nn/elementwise_add.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_elementwise_add:
+
+elementwise_add
+---------------
+
+..  autofunction:: paddle.fluid.layers.elementwise_add
+    :noindex:
+

doc/fluid/api/layers/nn/elementwise_div.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_elementwise_div:
+
+elementwise_div
+---------------
+
+..  autofunction:: paddle.fluid.layers.elementwise_div
+    :noindex:
+

doc/fluid/api/layers/nn/elementwise_floordiv.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_elementwise_floordiv:
+
+elementwise_floordiv
+--------------------
+
+..  autofunction:: paddle.fluid.layers.elementwise_floordiv
+    :noindex:
+

doc/fluid/api/layers/nn/elementwise_max.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_elementwise_max:
+
+elementwise_max
+---------------
+
+..  autofunction:: paddle.fluid.layers.elementwise_max
+    :noindex:
+

doc/fluid/api/layers/nn/elementwise_min.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_elementwise_min:
+
+elementwise_min
+---------------
+
+..  autofunction:: paddle.fluid.layers.elementwise_min
+    :noindex:
+

doc/fluid/api/layers/nn/elementwise_mod.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_elementwise_mod:
+
+elementwise_mod
+---------------
+
+..  autofunction:: paddle.fluid.layers.elementwise_mod
+    :noindex:
+

doc/fluid/api/layers/nn/elementwise_mul.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_elementwise_mul:
+
+elementwise_mul
+---------------
+
+..  autofunction:: paddle.fluid.layers.elementwise_mul
+    :noindex:
+

doc/fluid/api/layers/nn/elementwise_pow.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_elementwise_pow:
+
+elementwise_pow
+---------------
+
+..  autofunction:: paddle.fluid.layers.elementwise_pow
+    :noindex:
+

doc/fluid/api/layers/nn/elementwise_sub.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_elementwise_sub:
+
+elementwise_sub
+---------------
+
+..  autofunction:: paddle.fluid.layers.elementwise_sub
+    :noindex:
+

doc/fluid/api/layers/nn/elu.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_elu:
+
+elu
+---
+
+..  autofunction:: paddle.fluid.layers.elu
+    :noindex:
+

doc/fluid/api/layers/nn/embedding.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_embedding:
+
+embedding
+---------
+
+..  autofunction:: paddle.fluid.layers.embedding
+    :noindex:
+

doc/fluid/api/layers/nn/expand.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_expand:
+
+expand
+------
+
+..  autofunction:: paddle.fluid.layers.expand
+    :noindex:
+

doc/fluid/api/layers/nn/fc.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_fc:
+
+fc
+--
+
+..  autofunction:: paddle.fluid.layers.fc
+    :noindex:
+

doc/fluid/api/layers/nn/flatten.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_flatten:
+
+flatten
+-------
+
+..  autofunction:: paddle.fluid.layers.flatten
+    :noindex:
+

doc/fluid/api/layers/nn/fsp_matrix.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_fsp_matrix:
+
+fsp_matrix
+----------
+
+..  autofunction:: paddle.fluid.layers.fsp_matrix
+    :noindex:
+

doc/fluid/api/layers/nn/gather.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_gather:
+
+gather
+------
+
+..  autofunction:: paddle.fluid.layers.gather
+    :noindex:
+

doc/fluid/api/layers/nn/gaussian_random.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_gaussian_random:
+
+gaussian_random
+---------------
+
+..  autofunction:: paddle.fluid.layers.gaussian_random
+    :noindex:
+

doc/fluid/api/layers/nn/gaussian_random_batch_size_like.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_gaussian_random_batch_size_like:
+
+gaussian_random_batch_size_like
+-------------------------------
+
+..  autofunction:: paddle.fluid.layers.gaussian_random_batch_size_like
+    :noindex:
+

doc/fluid/api/layers/nn/get_tensor_from_selected_rows.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_get_tensor_from_selected_rows:
+
+get_tensor_from_selected_rows
+-----------------------------
+
+..  autofunction:: paddle.fluid.layers.get_tensor_from_selected_rows
+    :noindex:
+

doc/fluid/api/layers/nn/grid_sampler.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_grid_sampler:
+
+grid_sampler
+------------
+
+..  autofunction:: paddle.fluid.layers.grid_sampler
+    :noindex:
+

doc/fluid/api/layers/nn/group_norm.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_group_norm:
+
+group_norm
+----------
+
+..  autofunction:: paddle.fluid.layers.group_norm
+    :noindex:
+

doc/fluid/api/layers/nn/gru_unit.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_gru_unit:
+
+gru_unit
+--------
+
+..  autofunction:: paddle.fluid.layers.gru_unit
+    :noindex:
+

doc/fluid/api/layers/nn/hard_sigmoid.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_hard_sigmoid:
+
+hard_sigmoid
+------------
+
+..  autofunction:: paddle.fluid.layers.hard_sigmoid
+    :noindex:
+

doc/fluid/api/layers/nn/hash.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_hash:
+
+hash
+----
+
+..  autofunction:: paddle.fluid.layers.hash
+    :noindex:
+

doc/fluid/api/layers/nn/hsigmoid.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_hsigmoid:
+
+hsigmoid
+--------
+
+..  autofunction:: paddle.fluid.layers.hsigmoid
+    :noindex:
+

doc/fluid/api/layers/nn/huber_loss.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_huber_loss:
+
+huber_loss
+----------
+
+..  autofunction:: paddle.fluid.layers.huber_loss
+    :noindex:
+

doc/fluid/api/layers/nn/im2sequence.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_im2sequence:
+
+im2sequence
+-----------
+
+..  autofunction:: paddle.fluid.layers.im2sequence
+    :noindex:
+

doc/fluid/api/layers/nn/image_resize.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_image_resize:
+
+image_resize
+------------
+
+..  autofunction:: paddle.fluid.layers.image_resize
+    :noindex:
+

doc/fluid/api/layers/nn/image_resize_short.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_image_resize_short:
+
+image_resize_short
+------------------
+
+..  autofunction:: paddle.fluid.layers.image_resize_short
+    :noindex:
+

doc/fluid/api/layers/nn/kldiv_loss.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_kldiv_loss:
+
+kldiv_loss
+----------
+
+..  autofunction:: paddle.fluid.layers.kldiv_loss
+    :noindex:
+

doc/fluid/api/layers/nn/l2_normalize.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_l2_normalize:
+
+l2_normalize
+------------
+
+..  autofunction:: paddle.fluid.layers.l2_normalize
+    :noindex:
+

doc/fluid/api/layers/nn/label_smooth.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_label_smooth:
+
+label_smooth
+------------
+
+..  autofunction:: paddle.fluid.layers.label_smooth
+    :noindex:
+

doc/fluid/api/layers/nn/layer_norm.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_layer_norm:
+
+layer_norm
+----------
+
+..  autofunction:: paddle.fluid.layers.layer_norm
+    :noindex:
+

doc/fluid/api/layers/nn/leaky_relu.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_leaky_relu:
+
+leaky_relu
+----------
+
+..  autofunction:: paddle.fluid.layers.leaky_relu
+    :noindex:
+

doc/fluid/api/layers/nn/linear_chain_crf.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_linear_chain_crf:
+
+linear_chain_crf
+----------------
+
+..  autofunction:: paddle.fluid.layers.linear_chain_crf
+    :noindex:
+

doc/fluid/api/layers/nn/lod_reset.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_lod_reset:
+
+lod_reset
+---------
+
+..  autofunction:: paddle.fluid.layers.lod_reset
+    :noindex:
+

doc/fluid/api/layers/nn/log.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_log:
+
+log
+---
+
+..  autofunction:: paddle.fluid.layers.log
+    :noindex:
+

doc/fluid/api/layers/nn/log_loss.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_log_loss:
+
+log_loss
+--------
+
+..  autofunction:: paddle.fluid.layers.log_loss
+    :noindex:
+

doc/fluid/api/layers/nn/logical_and.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_logical_and:
+
+logical_and
+-----------
+
+..  autofunction:: paddle.fluid.layers.logical_and
+    :noindex:
+

doc/fluid/api/layers/nn/logical_not.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_logical_not:
+
+logical_not
+-----------
+
+..  autofunction:: paddle.fluid.layers.logical_not
+    :noindex:
+

doc/fluid/api/layers/nn/logical_or.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_logical_or:
+
+logical_or
+----------
+
+..  autofunction:: paddle.fluid.layers.logical_or
+    :noindex:
+

doc/fluid/api/layers/nn/logical_xor.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_logical_xor:
+
+logical_xor
+-----------
+
+..  autofunction:: paddle.fluid.layers.logical_xor
+    :noindex:
+

doc/fluid/api/layers/nn/lrn.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_lrn:
+
+lrn
+---
+
+..  autofunction:: paddle.fluid.layers.lrn
+    :noindex:
+

doc/fluid/api/layers/nn/lstm.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_lstm:
+
+lstm
+----
+
+..  autofunction:: paddle.fluid.layers.lstm
+    :noindex:
+

doc/fluid/api/layers/nn/lstm_unit.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_lstm_unit:
+
+lstm_unit
+---------
+
+..  autofunction:: paddle.fluid.layers.lstm_unit
+    :noindex:
+

doc/fluid/api/layers/nn/margin_rank_loss.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_margin_rank_loss:
+
+margin_rank_loss
+----------------
+
+..  autofunction:: paddle.fluid.layers.margin_rank_loss
+    :noindex:
+

doc/fluid/api/layers/nn/matmul.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_matmul:
+
+matmul
+------
+
+..  autofunction:: paddle.fluid.layers.matmul
+    :noindex:
+

doc/fluid/api/layers/nn/maxout.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_maxout:
+
+maxout
+------
+
+..  autofunction:: paddle.fluid.layers.maxout
+    :noindex:
+

doc/fluid/api/layers/nn/mean.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_mean:
+
+mean
+----
+
+..  autofunction:: paddle.fluid.layers.mean
+    :noindex:
+

doc/fluid/api/layers/nn/mean_iou.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_mean_iou:
+
+mean_iou
+--------
+
+..  autofunction:: paddle.fluid.layers.mean_iou
+    :noindex:
+

doc/fluid/api/layers/nn/merge_selected_rows.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_merge_selected_rows:
+
+merge_selected_rows
+-------------------
+
+..  autofunction:: paddle.fluid.layers.merge_selected_rows
+    :noindex:
+

doc/fluid/api/layers/nn/mul.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_mul:
+
+mul
+---
+
+..  autofunction:: paddle.fluid.layers.mul
+    :noindex:
+

doc/fluid/api/layers/nn/multiplex.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_multiplex:
+
+multiplex
+---------
+
+..  autofunction:: paddle.fluid.layers.multiplex
+    :noindex:
+

doc/fluid/api/layers/nn/nce.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_nce:
+
+nce
+---
+
+..  autofunction:: paddle.fluid.layers.nce
+    :noindex:
+

doc/fluid/api/layers/nn/npair_loss.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_npair_loss:
+
+npair_loss
+----------
+
+..  autofunction:: paddle.fluid.layers.npair_loss
+    :noindex:
+

doc/fluid/api/layers/nn/one_hot.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_one_hot:
+
+one_hot
+-------
+
+..  autofunction:: paddle.fluid.layers.one_hot
+    :noindex:
+

doc/fluid/api/layers/nn/pad.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_pad:
+
+pad
+---
+
+..  autofunction:: paddle.fluid.layers.pad
+    :noindex:
+

doc/fluid/api/layers/nn/pad2d.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_pad2d:
+
+pad2d
+-----
+
+..  autofunction:: paddle.fluid.layers.pad2d
+    :noindex:
+

doc/fluid/api/layers/nn/pad_constant_like.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_pad_constant_like:
+
+pad_constant_like
+-----------------
+
+..  autofunction:: paddle.fluid.layers.pad_constant_like
+    :noindex:
+

doc/fluid/api/layers/nn/pixel_shuffle.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_pixel_shuffle:
+
+pixel_shuffle
+-------------
+
+..  autofunction:: paddle.fluid.layers.pixel_shuffle
+    :noindex:
+

doc/fluid/api/layers/nn/pool2d.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_pool2d:
+
+pool2d
+------
+
+..  autofunction:: paddle.fluid.layers.pool2d
+    :noindex:
+

doc/fluid/api/layers/nn/pool3d.rst

+..  THIS FILE IS GENERATED BY `gen_doc.{py|sh}`
+    !DO NOT EDIT THIS FILE MANUALLY!
+
+.. _api_fluid_layers_pool3d:
+
+pool3d
+------
+
+..  autofunction:: paddle.fluid.layers.pool3d
+    :noindex:
+